Creating the CICSPlex SM data repository

The CMAS-related data set is the data repository. Each CMAS must have a unique data repository associated with it. The data repository contains the CICSPlex® SM administration definitions applicable to its associated CMAS.

The data repository is a critical component of CICSPlex SM system management. You must take regular backups that are associated with each CMAS in your environment.

The data repository is defined to CICS® as being a recoverable file that participates in SYNCPOINT and SYNCPOINT ROLLBACK operations. The CMAS must have a CICS system log so that these operations work correctly. Do not, therefore, run a CMAS with a system log that is defined as type DUMMY because you will compromise data integrity on the CICSPlex SM data repository.

To create the data set that contains the data repository, you can use the EYUCMSDS postinstallation job.

If you are running multiple CMASs in the same MVS™ image, you must create a data repository for each CMAS. You can edit and resubmit the DFHISTAR job, which generates the EYUCMSDS postinstallation job.

To ensure that you do not overwrite your existing customized jobs, you can use the SELECT parameter, as described in Setting up a CICSPlex SM address space (CMAS). Alternatively, if you prefer not to resubmit DFHISTAR, you can edit the EYUCMSDS job, giving the SYSIDNT and CMASNAME parameters unique names each time you run the job.

Note: If you execute step DREPCNVT to upgrade an existing CMAS DREP to the latest version, you should use the DREP dataset itself as input and not a copy of it. Failure to do so, can cause CMAS isolation issues when the CMAS is restarted.
The EYUCMSDS job includes the following steps relating to the creation of the data repository:
DELDREP
This step deletes the data repository set. It allows you to resubmit the job.
DEFDREP
This step allocates the VSAM KSDS cluster for the data repository data set:
    dsindex.EYUDREP.cmasname
dsindex
Is defined by the DSINFO parameter of the DFHISTAR job.
cmasname
Is defined by the CMASNAME parameter of the DFHISTAR job.
CICSPlex SM does not support VSAM records that span control intervals. Make sure that the IDCAMS job that you use to create a CICSPlex SM data repository does not specify the SPANNED parameter. Accept the IDCAMS default of nonspanned records.
DREPINIT
This step is used to set up the data repository for a CICS TS for z/OS®, Version 5.4 CMAS.
The DREPINIT step is generated in the EYUCMSDS job if you did not specify a value with the OLDDREP parameter when you ran the DFHISTAR job. This step runs EYU9XDUT to initialize the new data repository that was allocated by step DREPALOC. The new data repository does not contain any records from a previous version of CICSPlex SM. The EYU9XDUT utility uses the following parameters for step DREPINIT:
CMASNAME=xxxxxxxx
  • You cannot change this name after the data repository is initialized.
  • This name must be unique in the CICSPlex SM environment. Do not use the same name as that of another CMAS, a CICSplex, a CICS system, or a CICS system group.
  • Position 1 must be alphabetic or national, and cannot be numeric.
  • Positions 2 through 8 can be alphabetic, national, or numeric.
SYSID=xxxx
  • You cannot change this identifier after the data repository is initialized.
  • This value must match the SYSIDNT (SIT parameter) for the CMAS; see CMAS-related CICS system initialization parameters.
  • This value must not be the same as the SYSID for any other CMAS or CICS system that is defined to CICSPlex SM.
  • Positions 1 through 4 can be alphabetic, national, or numeric.
TIMEZONE=x
x must be a single alphabetic character (B through Z), representing one of the Greenwich time zone codes.
ZONEOFFSET=nn
nn must be a two-digit numeric value (00 through 59), representing an adjustment (offset) to the TIMEZONE.
DAYLIGHT=x
x must be a single character (Y or N), representing daylight saving time.
The DREPINIT step requires a DD statement for EYUXDPRM, which sets up the WUI parameters:
WUI=YES|NO
The default of WUI=YES creates the CICSPlex SM resource definitions required to start a WUI server and its CICSplex.This parameter allows you to create the resource definitions required to start a WUI server and its CICSplex when you create the data repository. To add a WUI to an existing system, use the EYU9XDBT or BATCHREP utilities.
WUIAPPLID=xxxxxxxx
xxxxxxxx must be alphabetic, national, or numeric characters, specifying the APPLID allocated to a WUI. The first character must be alphabetic or national. This parameter is mandatory if WUI=YES is specified.
WUINAME=xxxxxxxx
xxxxxxxx must be alphabetic, national, or numeric characters, specifying the name allocated to a WUI. The first character must be alphabetic or national. If WUINAME is not specified, it takes the value specified for WUIAPPLID.
WUIPLEX=xxxxxxxx
xxxxxxxx must be alphabetic, national, or numeric characters, specifying the name allocated to a WUI CICSplex. The first character must be alphabetic or national. The default is created from the characters WUIP, followed by the CMSSYSID. For example, using the default CMSSYSID, CM01, the default WUIPLEX name is WUIPCM01.
WUISYSID=xxxx
xxxx must be alphabetic, national, or numeric characters, specifying the name allocated to a WUI system identifier. The first character must be alphabetic or national. This parameter is mandatory if WUI=YES is specified.
DREPCNVT
This step is generated if you specified the name of an existing data repository on the OLDDREP parameter. This step runs EYU9XDUT to convert existing data repository records from a previous release of CICSPlex SM for use by CICSPlex SM for CICS TS for z/OS, Version 5.4.
Note: If you execute step DREPCNVT to upgrade an existing CMAS DREP to the latest version, you should use the DREP dataset itself as input and not a copy of it. Failure to do so, can cause CMAS isolation issues when the CMAS is restarted.
All the records from the input data repository specified on the OLDDREP parameter are added to the new data repository that was allocated by step DREPALOC. The input data repository is not modified. The EYU9XDUT utility uses the following parameter for step DREPCNVT:
TARGETVER=0530
0530 represents the version of the new output data repository.
See CMAS-related CICS system initialization parameters


dfha1as.html | Timestamp icon Last updated: Sunday, 4 June 2017