Parameters used in EYUJXBT1

The EYUJXBT1 JCL sample provides the initial definition of a CICSplex, the association of the CICSplex with a CMAS as the maintenance point, and the association, and grouping, of CICS systems with that CICSplex.

The CMAS that owns the repository in which you are creating definitions must be active when you run the EYUJXBT1 job. Also, the EYUJXBT1 job must run in the same z/OS image as the CMAS. The EYUJXBT1 JCL does not have a data set definition (DD) statement for the repository because all access to the repository is through the CMAS, using the API.

EYUJXBT1 has the following parameters, which you edit to specify your own names:
CONTEXT
Sets the CICSPlex® SM context in which the utility is to operate. Define the context as the CMAS only when you are defining a CICSplex. For actions that operate on an existing CICSplex, such as defining extra regions, or importing or exporting objects, set the context to the CICSplex.
The EYUJXBT1 job uses this parameter twice. The first use is to enable the utility to locate and communicate with your CMAS, (see below for the second use). The format of the parameter to set the CMAS context is:
CONTEXT cmasname
where cmasname is the name of the CMAS that will be the maintenance point for the CICSplex.
DEFINE CICSPLEX
Specifies the name of your CICSplex. When you define the CICSplex, the CMAS named on the CONTEXT parameter becomes the maintenance point for the CICSplex.
The format of this parameter is:
DEFINE CICSPLEX plexname
Choose a 1- to 8-character name for your CICSplex, perhaps using a naming convention that allows you to define more than one CICSplex. For example:
  • The first three letters might identify the location, such as HUR for Hursley
  • The middle letters the type, such as TEST or PROD for test and production CICSplexes.
  • The last a unique alphanumeric identifier for the CICSplex.

All other parameters required to complete the CICSplex definition are supplied by the EYUCPDEF file defined on the EYUCPDEF DD statement in the supplied EYUJXBTP sample.

The supplied EYUJXBT1 job is set up to define only one CICSplex. You are recommended to create a separate CICSplex for the Web User Interface server by adding the required definitions to EYUJXBT1.

CONTEXT
The second use of CONTEXT appears after the DEFINE CICSPLEX parameter, to reset the context to the CICSplex.
The format of the parameter to set the context to the CICSplex is:
CONTEXT plexname
where plexname is the name you specified on the DEFINE CICSPLEX parameter.
DEFINE CICSGRP
Defines a CICS system group, which is a subset of a CICSplex.
The format of this parameter is:
DEFINE CICSGRP group_name
where group_name is a 1- to 8-character alphanumeric name for the CICS system group. The first character must be alphabetic.
DEFINE REGION
Specifies the name and other key attributes of each CICS region you want to include in the CICSplex. The parameter and its subparameters have the following format:
DEFINE REGION   region_name    -
       APPLID   region_applid  -
       SYSID    region_sysidnt     
You are recommended to use the APPLID as the region name in these definitions. Making the region name the same as the APPLID has the following advantages:
  • You do not have to invent another name for the region
  • It avoids confusion if the names are the same instead of regions having two identifiers
  • By excluding the NAME EYUPARM, the EYUPARM parameters can be shared across CICS regions. The NAME EYUPARM for each CICS region defaults to the z/OS Communications Server APPLID as specified on the APPLID system initialization table parameter for each CICS region.

SYSID is the name specified on the region's SYSIDNT system initialization parameter.

The EYUJXBT1 job includes the DEFINE REGION parameters once, but you can define as many as you need, in any groupings that suit your requirements.

ADD TOGROUP
Specifies the name of the CICS region that you want to add to the CICS system group defined by a DEFINE CICSGRP command.
The format of this parameter for adding a CICS region to a group is:
ADD  TOGROUP   grpname -
     REGION    regname   
You can also nest CICS system groups by including a group in another group. The format of the parameter for adding a group to a group is:
ADD  TOGROUP   grpname1 -
     CICSGRP   grpname2   

After you have run the EYUJXBT1 job and created the initial definitions of your CICSplex, you might want to create another CICSplex, or add more regions or CICS system groups. If so, run the EYUJXBT1 job again, suitably modified to add the additional objects to your CMAS data repository. You can also save the previous definitions before making changes in case you have to back out the update.



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