sdsInitiateTakeover

sdsInitiateTakeover(takeoverMode:      Integer;
                    nextPrimaryServer: String);

The sdsInitiateTakeover method of the JadeDatabaseAdmin class initiates a negotiated take-over of the primary database by the secondary server specified in the nextPrimaryServer parameter.

The takeoverMode parameter specifies how the take-over operation will deal with potential conflicts between executing reader processes and database state that is being isolated, which will become visible when the secondary server assumes the role of a primary database. The values for the take-over mode are represented by one of the SDSTakeoverState category global constants listed in the following table.

Global Constant Integer Value Take-over is …
SDS_TakeoverConditional 1 Conditional on there being no conflicts
SDS_TakeoverForced 2 Forced if conflicts exist

A runtime exception is raised if this method is called for a Relational Population Service (RPS) node.

This method should be invoked only within an SDS primary system. Invoking this method from within a secondary system raises an exception.

For more details about take-over operations, see "SDS Takeover Operations", in Chapter 1 of the JADE Synchronized Database Service (SDS) Administration Guide.