The parameters required to activate the CICS VR server
address space are discussed below with some example settings.
Figure 1. Example of CICS VR parameter settings
in IGDSMSxx member of SYS1.PARMLIBCICSVR_INIT(YES)
CICSVR_GRPNAME_SUFFIX(PROD)
CICSVR_DSNAME_PREFIX(DWWUSER.V510)
CICSVR_RCDS_PREFIX(DWWUSER.V510)
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_DSNAME_PREFIX(DWWUSER.V510)
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.V510)
- 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.V510.DWWCON1.GRPPROD
DWWUSER.V510.DWWCON2.GRPPROD
DWWUSER.V510.DWWCON3.GRPPROD
You must enable the CICS VR program id by adding the following
entry to the IFAPRDxx member, as shown in the example below:
Figure 2. IFAPRDxx memberPRODUCT OWNER('IBM CORP')
NAME(CICSVR)
ID(5655-Y24)
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