activateDeltaDatabase

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

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

• Create a delta database and activate delta mode.

• Deactivate delta mode and delete the delta database.

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

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.

• 1162 - The system is not delta database capable

  This exception is raised if the database server node is not specified to be delta database-capable.

• 1163 - Could not change delta database mode because not all processes are idle

  This exception is raised and the deactivation attempt is abandoned if a deactivation request cannot be completed because not all applications have become idle within the time specified in the timeout parameter.

• 1165 - A delta database transition request is already in progress

  This exception is raised if a deactivation or activation request is currently in progress.