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.
- To start a CMAS during the IPL of an MVS system,
complete the following steps:
- Verify that the CMAS startup procedure is in a system procedure library, such as SYS1.PROCLIB.
- Verify that the CMAS startup procedure is in the 'Started Tasks' table of the external security manager (ESM).
- Change the COMMNDaa member that is referenced by the IEASYSxx member of SYS1.PARMLIB, as
described in Noting IEASYSxx values for CICSPlex SM, to include a START command for
the CMAS.
The START command to be included is described in START command for a CMAS.
- To start a CMAS from the system console, complete the following
steps:
- Verify that the CMAS startup procedure is in a system procedure library, such as SYS1.PROCLIB.
- Verify that the CMAS startup procedure is in the 'Started Tasks' table of the external security manager (ESM).
- Have the operator issue the START command described in START command for a CMAS.
- To start a CMAS as a batch job, complete the following steps:
- Verify that the CMAS startup procedure is in a system procedure library, such as SYS1.PROCLIB.
- Construct a job stream to invoke the CMAS procedure.
- Submit the job to invoke a CMAS.
- CICS® SIT parameters, as described in CMAS-related CICS system initialization parameters.
- CICSPlex SM startup parameters, as described in CICSPlex SM system 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.
//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)
- 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.