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 repository
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.
- 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)
- 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.
- 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].
- 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.
- 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.
- 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.
- 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);