Figure 28 illustrates the relationship between a CMAS configuration and the end user interface views used to create and maintain that configuration. It also shows that CMAS configuration definitions are stored in the data repository associated with the CMAS identified as the maintenance point for the CICSplex. This CMAS ensures that any other CMASs involved in managing the CICSplex also know about the configuration definitions.
Additional views that you can use to manage configuration definitions once their associated CMASs or CICS® systems are active are identified in Table 4, and are described in Managing a CMAS configuration.
Online help is available for each view and for the fields in each view. CMAS configuration views
You can access a configuration view by:
27FEB2005 16:50:40 ----------- INFORMATION DISPLAY --------------------------- COMMAND ===> SCROLL ===> PAGE CURR WIN ===> 1 ALT WIN ===> W1 =MENU==============EYUPLX01=EYUPLX01=27FEB2005==16:50:40=CPSM==========6=== CMD Name Description --- ------------------------------- ADMCONFG CMAS Configuration Administration Views BATCHREP Batched Repository Updates CPLEXDEF CICSplex Definitions CPLXCMAS CMAS in CICSplex Definitions CMTCMDEF CMAS-to-CMAS Link Definitions CMTPMDEF CMAS-to-RMAS Link Definitions
For additional information about accessing these views, see Accessing end user interface administration views.
Reminders:
The remainder of this chapter contains detailed descriptions of the CMAS configuration views.
The batched repository-update facility allows you to create, update, remove, list, or dump one or more definitions from the data repository associated with the local CMAS. This is described in topic Using the batched repository-update facility.
To manage the direct LU 6.2 and MRO communication links between
the local CMAS and any other CMAS click Administration
views-->CMAS configuration administration views-->CMAS to CMAS link
definition. This view allows you to create update and remove links. In
order to create a link between CMASs, each must have a WUI attached.
Follow this procedure to create a link definition to another CMAS and add it to the data repository of the local CMAS.
The CMAS to CMAS link definitioncreate panel (EYUSTARTCMTCMDEF.CREATE) is displayed. If you first selected an existing link definition, this panel contains values from the selected link.
This name must match the name specified via the
SYSIDNT parameter in the CICS system initialization table (SIT). .
When the buffer sizes are not as recommended, recreate the definition on both sides, using the CMAS to CMAS link definition view, specifying appropriate buffer sizes.
For MRO links this value is ignored and the Security Name value used is the CICS region user ID associated with the target system.
For LU 6.2 links specify a user ID to be associated with incoming transactions. If no value is specified the CICS default user ID is used.
If transaction security is active in the CMAS, the user ID associated with the Security Name field needs to have access to attach the transactions listed in CICS RACF® Security Guide.
Depending on your requirements security administration may be simpler if the CICS region user ID or PLTPIUSR is specified for the CMAS.
For further details about the Security Name field and its relationship with the Attach Security field see the CICS RACF Security Guide.
The CICS resource definitions needed to establish communication with the designated CMAS are installed automatically using EXEC CICS CREATE interface.
Follow this procedure to update a CMAS to CMAS link definition description in the data repository.
The CMAS to CMAS link definition create panel is displayed containing details of the selected link. You can modify only the Description field.
Follow this procedure to remove a CMAS link definition from the data repository of the local CMAS. When you do this, the appropriate CICS resource definitions are automatically removed from the CICS system definition (CSD) file for that CMAS.
A confirmation panel is displayed.
To display information about the direct LU 6.2 and MRO communication links between the local CMAS and any other CMASs, issue the command:
CMTCMDEF [cmas]
where cmas is the specific or generic name of a CMAS defined to the local CMAS. If this parameter is omitted, the view, illustrated in Figure 30, includes information about all CMASs defined to that CMAS.
27FEB2005 17:26:32 ----------- INFORMATION DISPLAY --------------------------- COMMAND ===> SCROLL ===> PAGE CURR WIN ===> 1 ALT WIN ===> W1 =CMTCMDEF=CMTCMDEF=EYUCMS1A=EYUCMS1A=27FEB2005==17:26:30=CPSM==========1=== CMD Target Sys Sess --- CMAS---- Id-- Applid Type Prfx- Modename Description------------------- EYUCMS1B CM1B EYUCMS1B LU62 Starter Set CMAS on System B
Table 16 summarizes the action commands you can use with the CMTCMDEF view.
Primary command | Line command | Description |
---|---|---|
n/a | BRO | Browse a link definition in the data repository.
The format of the resulting, nonmodifiable panel is identical to that shown in Figure 31. |
CREate | CRE | Create a link definition to another CMAS and add it
to the data repository of the local CMAS, as described in topic Creating a CMAS-to-CMAS link definition.
When you use the primary command CREate, some fields in the new view may contain values supplied by CICSPlex SM; you may change these values. When you enter the line command CRE next to the name of a link definition, fields in the new view contain values to be modelled (from the existing link definition). |
n/a | REM | Remove a CMAS link definition from the data repository of the local CMAS. |
n/a | UPD | Update a link definition in the data repository.
The format of the resulting panel is identical to the panel shown in Figure 31. You can modify the contents of only the Description field. |
You can use the CMTCMLNK or CMTCMLND view, as indicated in Table 4, to discard a link definition without removing it from the data repository.
There are no hyperlink fields for the CMTCMDEF view.
Figure 31 shows the format of the panel produced when you use the create primary (CREate) or line (CRE) action command from the CMTCMDEF view.
------------------------- Define CMAS Link for EYUCMS01 ----------------------- COMMAND ===> Target CMAS Name ===> Description ===> Starter Set CMAS on System B Target Applid ===> EYUCMS1B Target CMAS VTAM Applid Target Sysid ===> CM1B Sysid of Target CMAS Protocol ===> LU62 Connection Type (LU62/MRO) Send Buffer ===> 8192 Size of send buffer (256 - 30720) Receive Buffer ===> 8192 Size of receive buffer (256 - 30720) Modename ===> Modename for LU62 Link Receive Prefix ===> Unique 2 character prefix for MRO Send Prefix ===> Unique 2 character prefix for MRO Attach Security ===> LOCAL Attach User Security (LOCAL/IDENTIFY) Security Name ===> Userid associated with link Press Enter to define CMAS Link with the options specified. Type END or CANCEL to cancel without defining.
Provide the information as described in Creating CMAS to CMAS links and press Enter to add the link definition to the data repository of the local CMAS.
Repeat this procedure for each CMAS with which the local CMAS is to have direct communication. Then, change the context to another CMAS and repeat this procedure for that CMAS. For example, to establish two-way communication between EYUCMS1A and EYUCMS1B, first set the context to EYUCMS1A and define a link to EYUCMS1B. Then, change the context to EYUCMS1B and define a link to EYUCMS1A.
The CICS resource definitions needed
to establish communication with the designated CMAS are installed automatically
using EXEC CICS CREATE interface.
A CMAS can communicate with other MASs.
A CICSplex consists of one or more CICS systems or CICS system groups and is managed by one or more CMASs. Establishing a CICSplex requires that you:
To display information about the CICSplexes associated with the local CMAS click Administration views-->CMAS configuration administration views-->CICSplex definition. This view lists summary information of the CICSplexes defined to the local CMAS in tabular form. To view details of one of the listed CICSPlexes, select from the Record column the adjacent check box. The CICSplex definition view includes action buttons that allow you to do the following:
Follow this procedure to create a CICSplex definition and add it to the data repository.
The CICSplex definition create panel is displayed. If you first selected an existing link definition, this panel contains values from the selected link.
There is no restriction on the number of CICSplexes that you can associate with a single CMAS.
The CICSplex becomes available as soon as its definition is added to the data repository for the local CMAS.
Follow this procedure to add a CMAS to a CICSPlex definition in the data repository.
When a CICSplex is to be managed by multiple CMASs, the CMAS in effect when you create the CICSplex becomes the maintenance point CMAS for that CICSplex. There is no restriction on the number of CMASs that can be involved in the management of a single CICSplex.
The CICSplex definition assign panel is displayed.
The specified CMAS is added to the CICSPlex definition in the data repository and the CICSplex definition tabular view is redisplayed.
To display information about the CICSplexes associated with the local CMAS, issue the command:
CPLEXDEF [cicsplex]
where cicsplex is the specific or generic name of a CICSplex known to the local CMAS. If this parameter is omitted, the view, illustrated in Figure 32, includes information about all CICSplexes that are associated with that CMAS.
27FEB2005 18:22:02 ----------- INFORMATION DISPLAY --------------------------- COMMAND ===> SCROLL ===> PAGE CURR WIN ===> 1 ALT WIN ===> W1 =CPLEXDEF==========EYUCMS1A=EYUCMS1A=27FEB2005==18:22:00=CPSM==========1=== CMD Name Mon Time Zone Day Cmd Res Xmp Res Description --- -------- Intv Zone Adj Save Chk Chk Chk Sta ---------------------------- EYUPLX01 480 Z 0 NO NO NO YES YES Starter Set Plex 1 on System
Table 17 summarizes the action commands you can use with the CPLEXDEF view.
Primary command | Line command | Description |
---|---|---|
n/a | ADD | Add a CMAS to a CICSplex definition in the data repository, as described in topic Adding a CMAS to a CICSplex. |
n/a | BRO | Browse a CICSplex definition in the data repository.
The format of the resulting, nonmodifiable panel is identical to that shown in Figure 33. |
CREate | CRE | Create a CICSplex definition and add it to the data repository, as described in topic Creating a CICSplex definition. The CMAS that is the current context becomes the maintenance point CMAS. |
n/a | REM | Remove a CICSplex definition from the data repository.
Note:
When you remove a CICSplex definition, all of its topology, workload management, real-time analysis, resource monitoring,
and business application services definitions are also removed. When multiple CMASs are involved
in managing the CICSplex, these definitions are removed from the data repository associated
with each CMAS. |
n/a | UPD | Update a CICSplex definition in the data repository.
The format of the resulting panel is identical to the panel shown in Figure 33. You can modify the contents of any field in the panel except the CICSplex definition name. |
Table 18 shows the hyperlink field on the CPLEXDEF view.
Hyperlink field | View displayed | Description |
---|---|---|
Name | CPLXCMAS | Information about the CMASs linked to the specified CICSplex |
Figure 33 shows the format of the panel produced when you use the create primary (CREate) or line (CRE) action command from the CPLEXDEF view.
------------------------- Create CICSPlex for EYUCMS1A ------------------------ COMMAND ===> CICSPlex name ===> Description ===> Monitor Interval ===> 480 Performance interval duration (15-1440 min) Daylight Savings Time ===> NO YES or NO Time Zone ===> B Time zone for interval (B-Z) Time Zone Adjustment ===> 0 Offset from time zone (0-59) Resource Status Operational status for resource Facility ===> NO status facility (NO, YES) CICS Command Checking ===> NO Simulated CICS Command Checks CICS Resource Checking ===> NO Simulated CICS Resource Checks Exemption Checking ===> YES Check for Exempt Users Press ENTER to create CICSplex. Type END or CANCEL to cancel without creating.
Provide the following information described in Creating a CICSplex definition. For more information about the time zone attributes and how to use them, see CICSPlex SM time zone attributes. Press Enter to add this definition to the data repository.
There is no restriction on the number of CICSplexes that you can associate with a single CMAS.
The CICSplex becomes available as soon as its definition is added to the data repository for the local CMAS.
When a CICSplex is to be managed by multiple CMASs, the CMAS in effect when you create the CICSplex becomes the maintenance point CMAS for that CICSplex. There is no restriction on the number of CMASs that can be involved in the management of a single CICSplex.
Figure 34 illustrates the panel produced when you use the add (ADD) line action command from the CPLEXDEF view.
------------------------ Add CMAS to CICSPlex for EYUCMS1A -------------------- COMMAND ===> CICSPlex name EYUPLX01 Description Starter Set Plex 1 on System A CMAS Name ===> Name of CMAS or Generic Press Enter to add CMAS to CICSplex. Type END or CANCEL to cancel without adding.
Specify the 1- to 8-character name of the CMAS that is to be associated with the designated CICSplex. Press Enter to add this information to the data repository.
To display information about CMASs associated with a CICSplex, where the local CMAS must be the maintenance point for that CICSplex, issue the command:
CPLXCMAS [cicsplex]
where cicsplex is specific or generic name of a CICSplex known to the local CMAS. If this parameter is omitted, the view, illustrated in Figure 35, includes information about all CICSplexes that are associated with that CMAS.
27FEB2005 18:22:17 ----------- INFORMATION DISPLAY --------------------------- COMMAND ===> SCROLL ===> PAGE CURR WIN ===> 1 ALT WIN ===> W1 =CPLXCMAS==========EYUCMS1A=EYUCMS1A=27FEB2005==18:22:17=CPSM==========2=== CMD CICSPlex CMAS --- Name---- Name---- MP State--- EYUPLX01 EYUCMS1A YES NORMAL EYUPLX01 EYUCMS1B NO NORMAL
You can use the CICSPLEX view, as indicated in Table 4, to display status information about CMASs associated with a CICSplex, where the local CMAS need not be the maintenance point for the CICSplex.
Table 19 summarizes the action commands you can use with the CPLXCMAS view.
Primary command | Line command | Description |
---|---|---|
n/a | BRO | Browse the definition of the association between a CICSplex and
the maintenance point CMAS in the data repository.
Figure 36 illustrates the panel produced when you issue the BROwse command from the CPLXCMAS view. |
n/a | FOR | Force an inaccessible CMAS associated with a CICSplex to be removed. |
n/a | REM | Remove a CMAS associated with a CICSplex. |
------------------------ Browse CPLXCMAS for CMAS EYUCMS1B -------------------- COMMAND ===> CICSplex name EYUPLX01 CMAS Name EYUCMS1B Maintenance Point YES State NORMAL Type END or CANCEL to cancel browse.
When you remove a CMAS from a CICSplex definition, the action command you use depends on whether the CMAS to be removed is currently accessible to the local CMAS.
This command causes the name of the designated CMAS to be immediately removed from the CICSplex definition in the data repository for the local CMAS. Then, if the designated CMAS is currently accessible, its data repository is updated to reflect this change; otherwise, the action is placed in a pending status until the CMAS becomes accessible.
This command causes the name of the designated CMAS to be removed from the CICSplex definition in the data repository for the local CMAS. Because the two CMASs are not accessible, the data repository for the designated CMAS is not altered to reflect this change.
In most cases, you should use the REM action command because the CMAS normally is or will become accessible to the local CMAS.
Table 20 shows the hyperlink field on the CPLXCMAS view.
Hyperlink field | View displayed | Description |
---|---|---|
CICSplex Name | CPLEXDEF | Information about the specified CICSplex. |