Dynamically changing a CICS VR PARMLIB setting

You can dynamically change the value of any of the CICS® VR 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 parameters to change the current setting. However, note that some of the dynamically changed parameters are not used by CICS VR until the next time the CICS VR server address space is started.

For example, if the CICS VR server address space is active when the SETSMS CICSVR_DSNAME_PREFIX(PROD) command is issued, the CICS VR server address space must be terminated, then restarted for CICS VR to use the value specified in the SETSMS command.

Note: 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.

Below is a list of the available SETSMS commands that can be issued to change CICS VR parameters without updating the active IGDSMSxx member:

SETSMS CICSVR_INIT(YES | NO) 
SETSMS CICSVR_GRPNAME_SUFFIX(suffix) 
SETSMS CICSVR_DSNAME_PREFIX(hlq.slq) 
SETSMS CICSVR_RCDS_PREFIX(hlq.sql)
SETSMS CICSVR_ZZVALUE_PARM(zzvalue)

Examples

SETSMS CICSVR_INIT(NO): Changes the CICS VR initialization parameter to NO on the system that processed the command. If CICS VR is active on the system when this command is issued, CICS VR remains active. After this command is issued, and CICS VR is terminated, you is not able to restart the CICS VR server address space until the CICSVR_INIT parameter is reset to YES.
SETSMS CICSVR_GRPNAME_SUFFIX(TEST): Changes the CICS VR XCF group name parameter to TEST on the system that processed the command. The specified value is activated the next time the CICS VR server address space is started.
SETSMS CICSVR_DSNAME_PREFIX(PROD.ONE): Changes the CICSVR_DSNAME_PREFIX parameter value to PROD.ONE on the system that processed the command. The specified value is used for DWWMSGA, DWWMSGB, DWWDMSG, and DWWDUMP data sets naming convention the next time the CICS VR server address space is started. However, CICS VR uses the specified value immediately for DFSMSdss logical copy notification support and change accumulation data sets without restarting the CICS VR server address space
SETSMS CICSVR_RCDS_PREFIX(DWW2): Changes the RCDS prefix value used in the RCDS naming convention to DWW2. The specified value used by CICS VR the next time the CICS VR server address space is started.