Preparing to start a CMAS

You can start a CICSPlex® SM address space (CMAS) during the IPL of an MVS™ system, from the system console, or as a batch job.

Whichever method you use to start a CMAS, you must verify that the procedure references the appropriate parameters:

The purpose of the CMAS is to manage a CICSPlex SM managed application system (MAS), so it is important that the CMAS runs at a higher dispatching priority than any MAS in the sysplex. The CMAS communicates with other CMASs that it is connected to; these CMASs need to run at an equal dispatching priority, so that a CMAS on one LPAR does not process and send information out faster than other CMASs that need to receive that data. Therefore, define the CMAS jobs to the MVS service class SYSSTC. Failure to do so can result in severe performance problems for CICSPlex SM.

After you start a CMAS for the first time, you must configure the CMAS to your environment. This configuration includes establishing the CICSplexes that the CMAS is to manage, and any communication links that are required between this CMAS and another CMAS.

A sample procedure that you can use to start a CMAS is supplied in the EYUCMASP member. This member was generated when you ran the DFHISTAR job. The member is stored in the library that you specified on the LIB parameter of the DFHISTAR job.

You must create the data sets for this CICS region. JCL to create the CICS region data sets for the CMAS is supplied in the EYUCMSDS member of CICSTS54.CPSM.XDFHINST. This member was generated when you ran the DFHISTAR job.

Figure 1 illustrates segments of the EYUCMASP procedure that highlight the additional CICSPlex SM requirements.
Figure 1. CMAS-specific JCL requirements
//EYUCMASP  PROC DSNCSD=CICSTS54.CPSM.CMAS01.DFHCSD, CSD Data Set name
//             DSNTBL=CICSTS54.CPSM.RGNLOAD, CICS Table Module library
//             RGNHLQ=CICSTS54.CPSM.CMAS01,              CICS Region DSN qualifier
//             CICSHLQ=CICSTS54.CICS                    
//             CPSMHLQ=CICSTS54.CPSM                    
//             ACTHLQ=CICSTS54.CICS
//             PRMLIB=CICSTS54.XDFHINST 
//             ACTIVATE=SDFHLIC,                               
//             CICSPRM=EYUCMSSP,                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=&CPSMHLQ..SEYUAUTH
//         DD DISP=SHR,DSN=&CICSHLQ..SDFHAUTH
//         DD DISP=SHR,DSN=&ACTHLQ..SDFHLIC
//DFHRPL   DD DISP=SHR,DSN=&CPSMHLQ..SEYULOAD
//         DD DISP=SHR,DSN=&CICSHLQ..SDFHLOAD
//SYSIN    DD DISP=SHR,DSN=&PRMLIB,(&CICSPRM)
  ⋮
//EYULOG   DD SYSOUT=*
  ⋮
//EYUDREP  DD DISP=SHR,DSN=CICSTS54.CPSM.EYUDREP.cmasname
//EYUPARM  DD DISP=SHR,DSN=&PRMLIB(&CPSMPRM)                 
Review the following statements in the sample JCL that are illustrated in Figure 1. Verify that the JCL has been modified as follows:
EXEC PGM=EYU9XECS statement
Starts the CMAS and either verifies the existence of, or creates, the ESSS. EYU9XECS, the CMAS startup program, must be run so that the CMAS initializes.
STEPLIB DD statement
Includes the CICSTS54.CPSM.SEYUAUTH authorized load library, and the mandatory SDFHLIC license file.
DFHRPL DD statement
Includes the CICSTS54.CPSM.SEYULOAD load library. Include the load library that contains the CICS resource definition table load modules. These must be link-edited into a user-supplied load library, which you specify in the DFHRPL concatenation.

Do not include application load libraries in the DFHRPL concatenation.

SYSIN DD statement
Identifies the library member that contains the CICS system initialization override parameters.
EYULOG DD statement
Identifies the log to which messages from the CMAS and its associated managed application systems (MASs) are to be directed.

When you are using a sequential data set for the EYULOG, allocate three primary cylinders and one secondary cylinder.

EYUDREP DD statement
Identifies the library to be used as the data repository by the CMAS, where cmasname is the name you specified for the CMASNAME parameter on the DFHISTAR job. The CMASNAME value is used by EYU9XDUT to create the CICSPlex SM data repository.
EYUPARM DD statement
Identifies the library that contains the CICSPlex SM system parameters.


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