Create a CICSPlex SM address space

The CICSPlex SM address space (CMAS) is the hub of any CICSPlex SM configuration, because it is responsible for most of the work involved in managing and reporting on CICS systems and their resources.

Up to this point, you have been setting up the system for CICSPlex SM. The next step in the scenario is to create a CMAS on System A that will act as the maintenance point for three local regions and three regions on System B.
Figure 1. Create a CMAS maintenance point (MP)The diagram shows System A and System B with three CICS regions each.
On System A is a CMAS maintenance point (MP) called EYUCMS1A.
  1. Review and edit the CICSPlex SM system parameters. A sample is provided in member EYUCMS0P in the CICSTS31.CPSM.SEYUPARM data set. For a complete list of the parameters, see ../dfha1/dfha1b00246.htm#dfha1hd.
  2. Review and edit the CMAS-related CICS system initialization table (SIT) parameters in the CICSTS31.CPSM.SEYUPARM library. The parameters you should edit are as follows:
    Parameter Explanation
    APPLID=value VTAM application ID for this CICS, which is acting as a CMAS. Used as CMAS name when NAME(value) is not specified as a CICSPlex SM system parameter.
    CICSSVC=216 CICS SVC installed in LPA.
    DFLTUSER=value Non-CESN RACF user id.
    DUMPDS=A Transaction dump data set.
    DUMPSW=NEXT Switch to next transaction dump data set.
    GMTEXT='CICSPlex SM / ESA' Default logon message.
    GRPLIST=list_name Specify the name of the list that contains the group EYU310G0 that you specified when updating the CSD.
    SYSIDNT=value CICS System id.
    Note: The SYSIDNT value must match the EYU9XDUT SYSID parameter value used to initialize the data repository being referenced by the EYUDREP DD statement.
    XCMD={YES|name|NO} If you specify the CICSPlex SM system parameter SEC(YES), you must specify XCMD=NO to indicate that EXEC CICS system commands are not to be included in security checking.
    XDB2={NO|name} If you specify the CICSPlex SM system parameter SEC(YES), you must specify XDB2=NO to indicate that DB2 resources are not to be included in security checking.
    XFCT={YES|name|NO} If you specify the CICSPlex SM system parameter SEC(YES), you must specify XFCT=NO to indicate that file control entries are not to be included in security checking.
    XPCT={YES|name|NO} If you specify the CICSPlex SM system parameter SEC(YES), you must specify XPCT=NO to indicate that EXEC-started transactions are not to be included in security checking.
    XPPT={YES|name|NO} If you specify the CICSPlex SM system parameter SEC(YES), you must specify XPPT=NO to indicate that program entries are not to be included in security checking.
    The complete list of parameters can be found in the table ../dfha1/dfha1b00211.htm#cmssitt.
  3. Edit the sample procedure that is provided to start a CMAS. It is supplied in member EYUCMAS, which was generated by the EYUISTAR job. Figure 2 shows the segments of the EYUCMAS procedure that are unique to CICSPlex SM.
    Figure 2. CMAS-specific JCL requirements
    //EYUCMAS  PROC DSNCSD=CICSTS31.CPSM.DFHCSD, CSD Data Set name
    //             DSNTBL=CICSTS31.CPSM.RGNLOAD, CICS Table Module library
    //             RGNHLQ=CICSTS31.CPSM,         CICS Region DSN qualifier
    //             CICSPRM=EYUCnnI0,           CICS Parameters
    //             CPSMPRM=EYUCMS0P            CPSM Parameters
    //*
    //CICS    EXEC PGM=EYU9XECS,               CMAS Startup program
    //             PARM='SYSIN',               CICS Parameters location
    //             REGION=0K                   Region Size
    //*
    //STEPLIB  DD DISP=SHR,DSN=CICSTS31.CPSM.SEYUAUTH
    //         DD DISP=SHR,DSN=CICSTS31.CPSM.CICS.SDFHAUTH
    //DFHRPL   DD DISP=SHR,DSN=CICSTS31.CPSM.SEYULOAD
    //         DD DISP=SHR,DSN=CICSTS31.CPSM.CICS.SDFHLOAD
    //         DD DISP=SHR,DSN=&DSNTBL
    .
    .
    .
    //EYULOG   DD SYSOUT=*
    //DFHJ25A  DD DISP=SHR,DSN=CICSTS31.CPSM.SDFHJ25A
    //DFHJ25B  DD DISP=SHR,DSN=CICSTS31.CPSM.SDFHJ25B
    .
    .
    .
    //EYUDREP  DD DISP=SHR,DSN=CICSTS31.CPSM.EYUDREP.cmasname
    //EYUPARM  DD DISP=SHR,DSN=CICSTS31.CPSM.SEYUPARM(&CPSMPRM)
    1. Edit the EYUDREP DD statement to replace cmasname with the value of the CMASNAME parameter that you specified when running the EYUDEFDS job.
  4. Run the JCL
The CICS region will start and the CMAS should initialize. Check for message EYUXL0010I CMAS initialization complete in the output. A CMAS will run only in a CICS system at the same release level. During startup, the CMAS checks the CICS release level and terminates with message EYUXL0142 if the releases do not match.

To shut down and restart a CMAS, read ../dfha1/dfha1b00217.htm#dfha1a4 and ../dfha1/dfha1b00218.htm#dfha1az.