Moving to a new maintenance point CMAS

If you need to move the maintenance point CMAS from one z/OS® image to another, submit the existing CMAS to run on the new z/OS image without changing any of its attributes. It's not possible to change the maintenance point CMAS for a CICSplex, but you can move to a new maintenance point CMAS for a CICSplex.

About this task

Each CMAS is identified by four attributes:
  • jobname
  • VTAM® applid
  • CICSPlex® SM 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 CICSPlex SM name or the CICS SYSIDNT. If you must change the CICSPlex SM name and/or CICS SYSIDNT of the maintenance point CMAS, this effectively creates a different maintenance point CMAS, and you need to remove the CICSplex and all of its associated definitions from the data repository and redefine them to the new maintenance point CMAS. If you are using the Web User Interface, you can follow this procedure:

Procedure

  1. Display the Administration > CMAS configuration administration > 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, and then click Refresh. A list of all CMASs that participate in the management of the CICSplex is displayed.
  2. Terminate normally all CMASs that participate in the management of the CICSplex, as follows:
    1. From the main menu, click CICSPlex SM operations > CMASs known to local CMAS.
    2. Click a CMAS name to display the CMAS detail view (CMAS object).
    3. Click the Shutdown... button. The Shutdown view is displayed. Click Yes to confirm that the CMAS is to be shut down.
    4. Repeat this process for each CMAS participating in the management of the CICSplex.

    Alternatively, you can use either the CICSPlex SM API equivalent or the COSD transaction.

    Note: It is imperative that you terminate the CMASs normally to ensure the integrity of the data repositories for the next step.
  3. Back up the data repositories for each CMAS that participates in the management of the CICSplex.
  4. Start all CMASs that currently participate in the management of the CICSplex.
  5. 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. See also Creating a data set for re-input to the batched repository-update facility for further guidance.

  6. 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.
  7. 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 > CMASs known to local CMAS view (CMASLIST object), with the context set to the old maintenance point CMAS.
  8. With the context still set to the old maintenance point CMAS, use the Administration > CMAS configuration administration > CMAS in CICSplex definitions view (CPLXCMAS object) to completely remove all non-maintenance point CMASs from the CICSplex.
    The corresponding records were removed from the non-MP data repositories of the CMASs that participate in the management of the CICSplex.
  9. If the WUI server is not defined as a MAS within the CICSplex, use the Administration > CMAS configuration administration > 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.
  10. 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.
  11. Start the CMAS that is to be defined as the new maintenance point for the CICSplex.
  12. With the context set to the new maintenance point CMAS 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.
  13. 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.
  14. With the new maintenance point CMAS still active, start all the other CMASs in the network.
  15. For each CMAS that should have a connection to the new maintenance point CMAS, use the EYU9XDBT utility to create the CMTCMDEF definitions.
  16. 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.
  17. With the CMAS context set to the new maintenance point CMAS, use the Administration > CMAS configuration administration > CICSplex definitions view (CPLEXDEF object) to assign the non-maintenance point CMASs to the CICSplex.
  18. Update the EYUPARMs for all MASs that are to connect to the new maintenance point CMAS, ensuring that if CMASSYSID is specified, it points to the new maintenance point.
  19. Start the MASs that are included in the CICSplex.