Configure the CMAS on System A

Now that you have created a CMAS, you need to configure it and store the definitions in the data repository. You need to define the CMAS as the maintenance point (MP), define the CICSplex you want the CMAS to manage and the regions it should contain.

The easiest way to configure a CMAS is to use the batched repository-update facility. This facility enables you to use a standard input file to create all of the required definitions in the data repository at one time.
Figure 1. Running the batched repository-update facility against the CMAS creates definitions in the data repositoryThe
diagram shows the Batch rep facility running against the CMAS to create definitions
in a data repository. The three regions are now contained in a CICSplex called
EYUPLX01.
The format for creating definitions in the data repository is:
command object keyword1(value)
where command is the name of the batched repository-update facility command, object is one of the resource table names, keyword1 is the name of a field in the specified resource table, and value is the data that is appropriate for that field.
  1. Create a sequential data set or partitioned data set member to contain your input to the batched repository-update facility. The data set must have a fixed blocked format, RECFM(FB), and a logical record length of 80, LRECL(80)
  2. Create an input file. The following rules apply:
    • A control statement must be in upper case and terminated with a semicolon (;).
    • Control statements and comments can span multiple lines.
    • Comments must be delimited with /* at the beginning and */ at the end.
    1. Identify the CMAS that you want to define. Use the following control statement:
      CONTEXT plexid;
      where plexid is the name of the CMAS. For example, CONTEXT [EYUCMS1A].
    2. Define the CICSplex you want to manage. This definition indicates that the CMAS is the maintenance point. Use the following control statement:
      CREATE CPLEXDEF CICSPLEX(cicsplexname)
      For example, you could use EYUPLX01.
    3. Change the context to the CICSplex and create definitions for the CICS regions you want to manage as part of the CICSplex, including the Web User Interface server region. Use the following control statement:
      CREATE CSYSDEF NAME(regionname)
    To find out which options you can specify in your input file, use the resource table descriptions for each resource that you are specifying.
  3. Use the batched repository-update utility to submit the input file. To run the utility you need to prepare the necessary JCL and define input parameters for the utility itself. Here is an example of the JCL.
      //jobname  JOB (acct),'name',CLASS=x,MSGCLASS=x
      //BTCHUPD EXEC PGM=EYU9XDBC,REGION=2048K
      //STEPLIB  DD  DSN=CICSTS31.CPSM.SEYUAUTH,DISP=SHR
      //         DD  DSN=CICSTS31.CPSM.SEYULOAD,DISP=SHR
      //SYSPRINT DD  SYSOUT=*
      //SYSABEND DD  SYSOUT=*  
      //SYSIN    DD  *
      CMASNAME(EYUCMS1A)                                         
      CHECK                                                      
      INPUTDSN(EXAMPLE.INPUT.DATASET)     
      INPUTMEMBER(MEMBER1)                                       
      OUTPUTUSER(EXUSER)   
      PRINTNODE(LOCAL)                                           
      /*
    The parameters are described in detail in ../eyua7/eyua7b0034.htm#eyua7hs.
  4. Check the output from the utility and the output file associated with the CMAS to ensure that the job ran successfully. When you submit the batched repository-update job, the syntax of each command is checked for validity. If multiple commands are being issued, syntax checking can have the following results:
    • When a LIST, DUMP, MAPLEFT or MAPRIGHT command is invalid, that command is not executed; processing of all subsequent commands continues.
    • When a modification command (CREATE, UPDATE, or REMOVE) is invalid, that command is not executed. All subsequent modification commands are checked for validity; however, no subsequent modification commands are executed.
Using the learning path example values, your input file could look as follows. For brevity, only one MAS is defined using the CSYSDEF statement.
Figure 2. Sample input file for the batched repository-update facility
CONTEXT EYUCMS1A;
CREATE CPLEXDEF CICSPLEX(EYUPLX01)
				SECCMDCHK(NO)                                                
         SECRESCHK(NO)                                                
         DESC(Example CICSplex definition)                            
         INTVL(480)                                                   
         SECBYPASS(NO)                                                
*        STATUS(1)                                                    
         TMEZONEO(0)                                                  
         TMEZONE(Z)                                                   
         DAYLGHTSV(YES)                                               
         RODMPOP(NO)
;
CONTEXT EYUPLX01;
CREATE CSYSDEF NAME(EYUMAS1B)
.
.
.
;
CREATE CSYSDEF NAME(EYUMAS1C)
.
.
.;
CREATE CSYSDEF NAME(EYUMAS1D)
.
.
.
;
CREATE CSYSDEF NAME(EYUWUI1E)
         DYNROUTE(YES)                                                
         RETENTION(*)                                                 
         CICSSAMP(*)                                                  
         GLBLSAMP(*)                                                  
         DBXSAMP(*)                                                   
         CONNSAMP(*)                                                  
         FILESAMP(*)                                                  
         JRNLSAMP(*)                                                  
         PROGSAMP(*)                                                  
         TERMSAMP(*)                                                  
         TDQSAMP(*)                                                   
         TRANSAMP(*)                                                  
         MONSTATUS(INHERIT)                                           
         RTASTATUS(YES)                                               
         WLMSTATUS(YES)                                               
         SECCMDCHK(INHERIT)                                           
         SECRESCHK(INHERIT)                                           
         SECBYPASS(INHERIT)                                           
         SAMSEV(N_A)                                                  
         SOSSEV(N_A)                                                  
         SDMSEV(N_A)                                                  
         TDMSEV(N_A)                                                  
         MXTSEV(N_A)                                                  
         STLSEV(N_A)                                                  
         SAMACTION( )                                                 
         SOSACTION( )                                                 
         SDMACTION( )                                                 
         TDMACTION( )                                                 
         MXTACTION( )                                                 
         STLACTION( )                                                 
         PRICMAS(EYUCMS1A)                                             
         ACTVTIME( )                                                  
         DESC(Example WUI server region)                                 
         TMEZONEO(*)                                                  
         TMEZONE(*)                                                   
         DAYLGHTSV(INHERIT)                                           
         APPLID(EYUWUI1E)                                               
         AUTOINST(NEVER)                                              
         AINSFAIL(CONTINUE)                                           
         SYSID(EY1E);