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 are prompted to name another CMAS, as illustrated
in Figure 25.
Figure 25. Prompt for temporary maintenance point CMAS name
-------------------------- Maintenance Point Required --------------------------
COMMAND ===>
Context: EYUPLX01
Maintenance Point CMAS: EYUCMS1A
Temporary CMAS: eyucms* Specify CMAS or generic to select
The view you have requested must run in the Maintenance Point CMAS for
the CICSplex specified, but communications to that CMAS is unavailable.
You may now direct the view to another CMAS that is part of this CICSplex.
WARNING
Any maintenance that is performed to this CMAS will be backed out
when communications with the Maintenance Point CMAS is again established.
Specify Temporary CMAS name and press Enter.
Enter END or CANCEL to terminate.
Note:
The maintenance point CMAS must be available when you are
creating or maintaining Business Application Services (BAS) definitions. The Business Application Services component does not support
temporary maintenance points.
Provide the following information if you want to identify a CMAS as the
temporary maintenance point:
- Temporary CMAS
- Specify a specific or generic name of a CMAS involved in managing
the designated CICSplex. Identifying a specific CMAS causes it to become the
temporary maintenance point CMAS. Identifying a generic name causes a selection
list of available CMASs to be displayed, as illustrated in Figure 26.
(For more information about displaying and using selection lists, see Using selection lists.)
Figure 26. Prompt for temporary maintenance point CMAS name
COMMAND ===> Scroll ==> Page
Temporary Maintenance Point requires a specific resource.
Select a single entry, change the key, or enter END or CANCEL to terminate.
Resource matching key: EYUCMS*
C Name Description Type Status
- -------- ------------------------------ ---------------- -----------------
_ EYUCMS1A CMASDEF INACTIVE
_ EYUCMS1B CMASDEF LOCAL
****************************** BOTTOM OF DATA *********************************
After establishing a temporary maintenance point CMAS, you can change
it to any other CMAS involved in managing the CICSplex. To do this, issue the
following primary action command from any view:
TEMPMP cmasid
where cmasid is the specific or generic name of a CMAS. When you identify
a specific CMAS, that CMAS becomes the new temporary maintenance point.
When you specify a generic name, you can choose the appropriate CMAS from
the resulting selection list of available CMASs.
The CMAS that you designate as the temporary maintenance point CMAS is
informed of any definitions that you add, update, or remove. It temporarily
stores this information in its data repository. The information is removed when the
maintenance point CMAS becomes available.
Notes:
- The temporarily stored information is not at any time passed to other CMASs
involved in managing the CICSplex. It exists only in the data repository for the CMAS designated
to serve as the temporary maintenance point.
- You can retrieve the names of definitions, but not
the actual definitions, that were added to or deleted from the data repository of
the temporarily designated maintenance point by setting the CICSPlex SM system
parameter JRNLDEFCH to YES. (For more information about JRNLDEFCH, see the CICS Transaction Server for z/OS® Installation Guide.)
- It is recommended that you select a temporary CMAS as the temporary maintenance
point at the same level as the inactive maintenance point.
When the maintenance point becomes available, you are reminded,
as illustrated in Figure 27, that any changes made while the
maintenance point CMAS was unavailable will be ignored.
Figure 27. Maintenance point availability notice
-------------------------- Maintenance Point Available ----------------------
COMMAND ===>
Context: EYUPLX01
Maintenance Point CMAS: EYUCMS1A
Temporary CMAS: EYUCMS1B
You requested that views requiring the Maintenance Point for this CICSplex
should be directed to the temporary CMAS specified until
communications with the Maintenance Point was again established.
The Maintenance Point is now available. All views requiring the Maintenance
Point will now run in the proper CMAS.
Any maintenance that was performed to the temporary CMAS will now be
backed out. You may want to review your actions and reissue them against
the Maintenance Point CMAS.
Press ENTER to continue.
You can remove the association between a CMAS and a CICSplex (as described
in CPLXCMAS (CMASs associated with a CICSplex)), as long as the CMAS is not the maintenance point
for the CICSplex.
CAUTION:
IBM® strongly recommends that you never change the maintenance point CMAS
for a CICSplex. If you need to move the maintenance point CMAS from one OS/390® image to another, the preferred method is to submit the existing CMAS
to run on the new OS/390 image without changing any of its attributes.
Each CMAS is identified by 4 attributes:
- jobname
- VTAM® applid
- CPSM name
- CICS SYSIDNT
Although it is possible to change the jobname and VTAM 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:
- With the context set to the old maintenance point CMAS, issue the CPLXCMAS
view against the CICSPlex to get the list of all CMASs that participate
in the management of the CICSPlex.
- Terminate normally all CMASs that participate in the management of the
CICSPlex. You can do this using the CMAS view SHUT command or CPSM API equivalent,
or through the COSD transaction. It is imperative that you teminate the CMASs
normally to ensure the integrity of the data repositories for the next step.
- 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.
- Ensure that all MASs for the CICSPlex are terminated. You can verify
this through the MASSTAT view, 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 CMAS view, with the context set
to the old maintenance point CMAS.
- With the context still set to the old maintenance point CMAS, use the
CPLXCMAS view to completely remove all non-maintenance point CMASs from the
CICSPlex, as described in CPLXCMAS (CMASs associated with a CICSplex).
- With the context still set to the old maintenance point CMAS, use the
CPLEXDEF view to remove the CICSPlex definition from the data repository,
as described in Managing CICSplex definitions using the end-user interface.
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.
- 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 CPLEXDEF view to create the CICSPlex definition
on the new maintenance point CMAS, as described in Creating a CICSplex definition.
- Using the output from the DUMP command, submit a batched repository-update facility job to recreate
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,
set the context to that CMAS and use the CMTCMDEF view to build a connection
to maintenance point CMAS, as descibed in Managing CMAS to CMAS links using the end-user interface.
- With the context set to the maintenance point CMAS, use the CMTCMDEF view
to build connections from the maintenance point CMAS to CMASs for which CMTCMDEFs
were created by the batched repository-update facility job.
- After all CMASs have been allowed to connect as defined, with the context
set to the new maintenance point CMAS, use the CPLEXDEF view to add the non-maintenance
point CMASs to the CICSPlex, as described in Managing CICSplex definitions using the end-user interface.
- 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 participate in the management of the CICSPlex.
[[ Contents Previous Page | Next Page Index ]]