Working with maintenance point CMASs
A CMAS provides the single-system image of the CICS® systems comprising each CICSplex it manages.
To do this, the CMAS uses the CICSPlex® SM definitions stored in the data repository.There is one data repository for each CMAS that you establish.
When a CICSplex consists of a large number of CICS systems or when the systems are spread across multiple MVS™ images, you may want multiple CMASs to be involved in managing the CICSplex. In cases like this, one of the CMASs is identified as the maintenance point for the CICSplex. The maintenance point CMAS is responsible for informing the other CMASs when any administration definitions relating to the CICSplex are added, updated, or changed. This ensures that the data repository for each CMAS involved in managing a CICSplex contains the same information.
If the maintenance point CMAS is unavailable when you attempt to perform an administration task, you will see an error message to this effect at the top of the related tabular view. Click the error message number to display the full text of message, which contains explanatory information and help on how to proceed.
You can remove the association between a CMAS and a CICSplex, as long as the CMAS is not the maintenance point for the CICSplex.
- jobname
- VTAM® applid
- CPSM name
- CICS SYSIDNT
Although it is possible to change the jobname and z/OS Communications Server applid of a CMAS, it is not possible to change the CPSM name and the CICS SYSIDNT. If it is necessary to have a different CPSM name or CICS SYSIDNT for a CMAS, you must create a new CMAS with the attributes you want.
If you must change the CPSM name and/or CICS SYSIDNT of the maintenance point CMAS, which creates a different CMAS to be the maintenance point CMAS, you need to remove the CICSplex and all of its associated definitions from the data repository and redefine them to the new CMAS, as follows:
- Display the Administration views > CMAS configuration administration views > CMAS in CICSplex definitions view (CPLXCMAS object). Set the CMAS context field to the old maintenance point CMAS and the CICSplex field to the name of the CICSplex, then click Refresh. A list of all CMASs that participate in the management of the CICSplex is displayed.
- Terminate normally all CMASs that participate in the management
of the CICSplex. To do this:
- From the main menu, click CICSPlex SM operations views > CMASs known to local CMAS.
- Click a CMAS name to display the CMAS detail view (CMAS object).
- Click the Shutdown... button. The Shutdown view is displayed. Click Yes to confirm that the CMAS is to be shut down.
- Repeat this process for each CMAS participating in the management of the CICSplex.
- Back up the data repositories for each CMAS that participates in the management of the CICSplex.
- Start all CMASs that currently participate in the management of the CICSplex.
- With the context set to the old maintenance point CMAS, use the
batched repository-update facility DUMP command to extract all the CICSPlex SM
definitions associated with the CICSplex from the data repository.
See the description of the DUMP command in Creating and maintaining CICSPlex SM definitions for guidance on ordering the command. This also describes possible editing requirements for the command output before it can be used as input in creating the new maintenance point CMAS. Also, see Creating a data set for re-input to the batched repository-update facility for further guidance.
- If the WUI server is defined as a MAS within the CICSplex, leave it running. Ensure that all other MASs for the CICSplex are terminated. You can verify this through the MASs known to CICSplex view (MAS object), specifying the CICSplex as the context and scope for the view.
- Ensure that all CMASs that participate in the management of the CICSplex are active and connected, either directly or indirectly, to the maintenance point CMAS. You can verify this through the CICSplex SM operations views > CMASs known to local CMAS view (CMASLIST object), with the context set to the old maintenance point CMAS.
- With the context still set to the old maintenance point CMAS, use the Administration views > CMAS configuration administration views > CMAS in CICSplex definitions view (CPLXCMAS object) to completely remove all non-maintenance point CMASs from the CICSplex.
- If the WUI server is not defined as a MAS within the CICSplex,
use the Administration views > CMAS configuration administration
views > CICSplex definitions view (CPLEXDEF object) view to remove
the CICSplex definition from the data repository.
If the WUI server is a MAS within the CICSplex, terminate the WUI server. Then use a CICSPlex SM API program to issue a REMOVE action against the CPLEXDEF definition for the CICSplex.
All of the topology, workload management, real-time analysis, resource monitoring, and business application services definitions associated with that CICSplex are also removed from the data repository.
- Terminate all CMASs in the network, whether or not they participate in the management of the CICSplex, by using the CICSPlex SM API or the COSD transaction.
- Start the CMAS that is to be defined as the new maintenance point for the CICSplex.
- With the context set to the CMAS that is to be the new maintenance point for the CICSplex, use the EYU9XDBT utility to create the CICSplex definition on the new maintenance point CMAS. An example of using the EYU9XDBT DEFINE CICSPLEX command is included in the EYUJXBT1 sample. That sample goes on to define CICS regions and groups. You just need to define the CICSplex.
- Using the output from the DUMP command, submit a batched repository-update facility job to re-create all the CICSPlex SM definitions for the CICSplex on the new CMAS data repository. For an example of using DUMP output from the batched repository-update facility to create new definitions, see Examples of managing records in the data repository.
- With the maintenance point CMAS still active, start all the other CMASs in the network.
- For each CMAS that should have a connection to the maintenance point CMAS, use the EYU9XDBT utility to create the CMTCMDEF definitions.
- Start a WUI server that is accessible from the new maintenance point CMAS either within the CICSplex you are moving or in a separate CICSplex.
- With the CMAS context set to the new maintenance point CMAS, use the WUI Administration views > CMAS configuration administration views > CICSplex definitions view (CPLEXDEF object) to assign the non-maintenance point CMASs to the CICSplex.
- Update the EYUPARMs for all MASs that are to connect to the maintenance point CMAS, ensuring that if CMASSYSID is specified, it points to the maintenance point.
- Start the MASs that are included in the CICSplex.