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.
- 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:
where cmasname is the name of the CMAS that will be the maintenance point for the CICSplex.CONTEXT cmasname - 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:
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:DEFINE CICSPLEX plexname- 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:
where plexname is the name you specified on the DEFINE CICSPLEX parameter.CONTEXT plexname - DEFINE CICSGRP
- Defines a CICS system group, which is a subset of a CICSplex.The format of this parameter is:
where group_name is a 1- to 8-character alphanumeric name for the CICS system group. The first character must be alphabetic.DEFINE CICSGRP group_name - 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:
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:DEFINE REGION region_name - APPLID region_applid - SYSID region_sysidnt- 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 regnameYou 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.