Terminating an online change

The TERMINATE OLC command supports aborting a global online change across an IMSplex. The TERMINATE OLC command can also be shortened to TERM OLC.

A TERMINATE OLC command that aborts a global online change is similar to the /MODIFY ABORT command, except that a global command applies to all IMS systems in an IMSplex that are participating in the global online change.

OM sends the TERMINATE OLC command to an IMS in the IMSplex.

You can use TERMINATE OLC to abort an IMSplex-wide global online change initiated by a INITIATE OLC PHASE(PREPARE), before the online change is successfully committed with a INITIATE OLC PHASE(COMMIT).

Use TERMINATE OLC to abort an online change after an INITIATE OLC PHASE(COMMIT) failure that occurs before the OLCSTAT data set is updated. After the commit process has updated the OLCSTAT data set, the online change is considered to be successful and cannot be aborted.

TERMINATE OLC is not supported if local online change is enabled. The TERMINATE OLC command is rejected if the IMS to which the command is routed does not support global online change. If this occurs and there is an IMS that supports global online change, the user must route the command to a specific IMS that supports global online change.

You can specify TERMINATE OLC only through the OM API.

The TERMINATE OLC command can be processed by DB/DC, DBCTL, and DCCTL environments.

The TERMINATE OLC command is invalid on the XRF alternate and FDR system.

The OM command timeout default of 300 seconds (5 minutes) might not be enough time for the online change phase to complete. You might need to specify a timeout value on the command based on the needs of the installation.

The command syntax for this command is defined in XML and is available to automation programs which communicate with OM. For more information about command syntax, environments, and usage, see IMS Version 15.2 Commands, Volume 2: IMS Commands N-V.