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.