INITIATE OLC return and reason codes

A return and reason code is returned to OM by the INITIATE OLC command. The return and reason codes for all IMS commands that are routed from OM are defined in the DFSCMDRR macro in the IMS.SDFSMAC data set.

The INITIATE OLC command master usually performs the online change phase locally first. If the online change phase fails locally, the command master usually skips sending the online change phase to the other IMS systems, sets a completion code for each other IMS indicating that the online change phase was not attempted, and terminates command processing. However, if the INITIATE OLC PHASE(COMMIT) command fails on the local IMS because of work in progress, the command master still sends the commit phase 1 to the other IMS systems. The purpose is to report work in progress for all the IMS systems in the IMSplex, to facilitate completion of work in progress.

In a mixed IMSplex, you might have some IMS systems that support a particular version of online change and some that do not. For the command to be considered successful, at least one IMS in the IMSplex must successfully perform the online change phase. If no IMS in the IMSplex supports the same version of online change, the command reason code indicates that none of the IMS systems performed the online change phase. If you enter a version of the INITIATE OLC PHASE(PREPARE) command that does not apply to any IMS in the IMSplex, you must terminate the online change by using a TERMINATE OLC command.