SYS1.PARMLIB updates

The parameters required to activate the CICS VR server address space are discussed here with some example settings.

Figure 1. Example of CICS VR parameter settings in IGDSMSxx member of SYS1.PARMLIB

CICSVR_INIT(YES)
CICSVR_GRPNAME_SUFFIX(PROD)
CICSVR_DSNAME_PREFIX(DWWUSER.V630)
CICSVR_RCDS_PREFIX(DWWUSER.V630)
CICSVR_UNDOLOG_PREFIX(DWW) – Optional Parameter

There are two additional CICS VR parameters available, CICSVR_GENERAL_CONTROL and CICSVR_ZZVALUE_PARM. It is recommended that these additional CICS VR parameters are allowed to default. Either, do not specify them in the IGDSMSxx member or specify the following parameters:

CICSVR_GENERAL_CONTROL(NONE)
CICSVR_ZZVALUE_PARM(NONE)

The following parameters can be used:

CICSVR_INIT(YES): Specifies that the CICS VR server address space is activated during the initialization of the z/OS image. If NO is specified the server address space does not startup up automatically and you have to issue a SETSMS CICSVR_INIT(YES) command before you can manually activate the CICS VR server.
CICSVR_GRPNAME_SUFFIX(PROD): During initialization the server address space joins to an XCF group. In this example the default value of PROD is used as the group suffix. If PROD is specified, the name of the XCF group the server tries to connect to is DWWMPROD. You can run only one server address space per z/OS image. All active server address spaces in the sysplex that connect to the same XCF group must use the same set of RCDS data sets.
CICSVR_UNDOLOG_PREFIX(HLQ): This parameter is used to set the PREFIX for the UNDO Logstream. Only one level of qualifier is accepted. When specified, the HLQ is used by CICS VR during start-up to locate the UNDO Logstream. If the parameter is not specified, then CICS VR will use DWW as the default HLQ to locate the UNDO logstream.

CICSVR_DSNAME_PREFIX(DWWUSER.V630): During initialization of the server address space the dsname prefix is used to allocate two CICS VR message data sets, and the CICS VR trace and dump data sets. Above data sets can be pre-allocated or are allocated automatically during server initialization.
CICSVR_RCDS_PREFIX(DWWUSER.V630): The RCDS data sets contain the necessary recovery information. They must be pre-allocated before activating the server address space. You need three RCDS data sets allocated to the following DD statements: DWWCON1, DWWCON2, and DWWCON3.; The naming convention for the RCDS data sets is: cicsvr_rcds_prefix.DWWCONx.GRPcicsvr_grpname_suffix therefore in the example the RCDS data set names used for the server address space installation are:
DWWUSER.V630.DWWCON1.GRPPROD
DWWUSER.V630.DWWCON2.GRPPROD
DWWUSER.V630.DWWCON3.GRPPROD

You must enable the CICS VR program id by adding the following entry to the IFAPRDxx member, as shown in this example:

Figure 2. IFAPRDxx member

PRODUCT OWNER('IBM CORP')
NAME(CICSVR)
ID(5655-GY1)
VERSION(*) RELEASE(*) MOD(*)
FEATURENAME(CICSVR)
STATE(ENABLED)

If the IFAPRDxx member contains an older version of CICS VR, message DWW190E is issues when the server address space initializes.

Figure 3. Not licensed message

*DWW190E CICSVR IS NOT LICENSED FOR USE ON THE SYSTEM.
DWW016I TERMINATING ERROR DETECTED IN CICSVR SERVER ADDRESS SPACE. 252
RETURN CODE (HEX): 00000024
REASON CODE (HEX): 71112416
MODULE NAME: DWW1CNUP
RETURN ADDR (HEX): A4D044A2