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.

Note:
The data repository is a critical component of CICSPlex SM system management. It is imperative that you take regular backups that are associated with each CMAS in your environment.

It is defined to CICS® as being a recoverable file which participates in SYNCPOINT and SYNCPOINT ROLLBACK operations. The CMAS must have a CICS system log in order for these operations to operate correctly. Do not, therefore, run a CMAS with a system log that is defined as type DUMMY as this would compromise data integrity on the CICSPlex SM data repository.

To create the data set that contains the data repository, you can use the post-installation job EYUDEFDS.

If you will be running multiple CMASs in the same MVS™ image, you must create a data repository for each CMAS. You can edit and resubmit the EYUISTAR job (as described in Using the EYUINST EXEC to tailor skeleton jobs), which generates the EYUDEFDS post-installation job. You may want to use the SELECT parameter to generate only the EYUDEFDS post-installation job. Once this job exists, you can edit it to make sure that the names specified with the SYSIDNT and CMASNAME parameters are unique each time you run the job.

Note:
If you have already run the EYUDEFDS job (when creating the CAS data sets), be sure to delete the following steps before you rerun EYUDEFDS: These steps create new screen and parameter repositories, deleting those already in existence. For more information about creating the screen and parameter repository data sets, see CAS-related data sets.

The EYUDEFDS job includes the following steps related to the creation of the data repository:

DREPALOC
This step allocates the VSAM KSDS cluster for the data repository data set:
    dsindex.EYUDREP.cmasname

where:

dsindex
Is defined by the DSINFO parameter of the EYUISTAR job.
cmasname
Is defined by the CMASNAME parameter of the EYUISTAR job.
Note:
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. You should accept the IDCAMS default of nonspanned records.
DREPINIT or DREPCNVT
One of these two steps is used to setup the data repository for a CICS Transaction Server for z/OS®, Version 3 Release 1 CMAS. The step that is generated in job EYUDEFDS depends on the OLDDREP parameter you specified when you ran the EYUISTAR job.

Step DREPINIT is generated if you did not specify a value with the OLDDREP parameter. This step executes 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
where:
  • You cannot change this name after the data repository is initialized.
  • This name must be unique within the CICSPlex SM environment. It should not be the same as the name 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
where:
  • 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 SIT 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
where x must be a single alphabetic character (B through Z), representing one of the Greenwich time zone codes (see CICSPlex System Manager Administration)
ZONEOFFSET=nn
where nn must be a two-digit numeric value (00 through 59), representing an adjustment (offset) to the TIMEZONE.
DAYLIGHT=x
where x must be a single character (Y or N), representing daylight saving time.

For information about defining the TIMEZONE, ZONEOFFSET, and DAYLIGHT parameters, see CICSPlex System Manager Administration.

Step DREPCNVT is generated if you specified the name of an existing data repository on the OLDDREP parameter. This step executes EYU9XDUT to convert existing data repository records from a previous release of CICSPlex SM for use by CICSPlex SM for CICS Transaction Server for z/OS, Version 3 Release 1. 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=0310
where 0310 represents the version of the new output data repository.
[[ Contents Previous Page | Next Page Index ]]