activateDeltaDatabase

activateDeltaDatabase(activate: Boolean;
                      timeout:  Integer): Boolean;

The activateDeltaDatabase method of the System class is used to perform one of the following actions.

Use the activate parameter to specify whether the delta database is being activated (true) or deactivated (false).

The DeltaDatabaseCapable parameter in the [JadeServer] section of the JADE initialization file on the database server node must be set to true for an activation request to succeed.

Use the timeout parameter to specify a maximum number of seconds to allow for deactivation to take place. A default timeout of 60 seconds is used if the specified value is zero (0). The timeout parameter is ignored when the activate parameter is set to true.

You cannot deactivate the delta database until all current processes apart from JADE tools (for example, the JADE Monitor and the SDS Administration application) and the process making the request are idle. The deactivation attempt is abandoned if this does not happen within the time specified in the timeout parameter, the delta database remains activated, and system exception 1163 is raised.

The return value indicates the delta database status prior to the method call. If the delta database is active at the time of the call, true is returned, or if it was inactive, false is returned.

The following code fragment is an example of activating a delta database.

system.activateDeltaDatabase(true, 0);

The following code fragment is an example of deactivating a delta database.

//Deactivate the Delta Database. Allow up to 2 minutes for deactivation.
system.activateDeltaDatabase(false, 120);

The following system exceptions can be raised from an activateDeltaDatabase method call.