SYS1.PARMLIB updates

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.PARMLIB
CICSVR_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:
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)
Start of change 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. End of change
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 member
PRODUCT 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

Concept Concept

Feedback


Timestamp icon Last updated: Friday, 7 February 2014


http://pic.dhe.ibm.com/infocenter/cicsts/v5r1/topic///dwwig/dwwigsys1.html