Dynamically changing a CICS VR undo logging parameter in SYS1.PARMLIB

You can dynamically change the value of any of the CICS® VR undo logging PARMLIB parameters specified in the active IGDSMSxx member without updating the member itself. The SETSMS operator command, followed by the CICS VR parameter name and value, can be issued for each of the CICS VR undo logging parameters to change the current setting. However, some of the dynamically changed parameters are not used by CICS VR until the next time the CICS VR server address space is started.

Any values changed by issuing the SETSMS command are no longer available after a system has been reinitialized (re-IPL'd). The first time that the CICS VR server address space is started on a system after the system has been re-IPL'd, CICS VR uses the settings specified in the active IGDSMSxx member of SYS1.PARMLIB.

These are the available SETSMS commands that can be issued to change CICS VR undo logging parameters without updating the active IGDSMSxx member:

SETSMS CICSVR_UNDOLOG_PREFIX(prefix) 
SETSMS CICSVR_UNDOLOG_CONTROL(string) 
SETSMS CICSVR_BACKOUT_CONTROL(string)

Examples

SETSMS CICSVR_UNDOLOG_PREFIX(DWWPROD): The next time the CICS VR address space is started, when the default undo log is required, CICS VR writes before-image log records to the log stream named DWWPROD.UNDOLOG.
SETSMS CICSVR_UNDOLOG_CONTROL(ENABLE CONT): Enable CICS VR undo logging for all VSAM spheres defined with FRLOG ALL or UNDO and allow a client application (batch job) to continue when a logging error occurs. The VSAM sphere updates are not synchronized with CICS VR undo logging. The specified value is activated immediately and used for all subsequent batch jobs.
SETSMS CICSVR_BACKOUT_CONTROL(SUBMIT ABEND): CICS VR automatically submits a batch backout job when a batch job encounters a system or user abend. The specified value is activated immediately and used for all subsequent batch jobs.

Issuing the SETSMS command only changes the CICS VR parameter setting on the system that processes the command. Use the ROUTE command to issue the SETSMS command on multiple systems. For example, issuing the following command changes the CICSVR_UNDOLOG_PREFIX setting on all systems in the sysplex the next time each of the systems are reinitialized.

ROUTE *,ALL,SETSMS CICSVR_UNDOLOG_PREFIX(DWW)

See z/OS® MVS System Commands for further information about the ROUTE command.