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 IGDSMS
xx 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.