Adding a CICS region to a CICSplex

You can use CICS® DA to install the CICSPlex® SM definitions in an unmanaged CICS region, and add the region to an existing CICSplex and, optionally, one or more of the system groups in the CICSplex.

Before you begin

Ensure that the CICS region you want to add is in the model and that the region start policy has been recorded. See Capturing the region start policy topic for more information about recording the start policy.

Procedure

  1. In the DA Projects view, double-click the unmanaged CICS region you want to add to a CICSplex, or right-click and click Open. The CICS region editor opens showing the details of the selected region.
  2. In the CICSPlex System Management section click Add to CICSplex. The Add CICS Region to CICSplex dialog opens:
    A screen capture of the Add CICS Region to CICSplex dialog showing the CICSplexes, groups and CMASes in the sysplex.
    .
  3. You must select the CICSplex and the CMAS to which you want to add the CICS region. Optionally, you can also select one or more groups to which to add the region. If f the region is started by a Batch job, you can choose to create new JCL for the job by clearing the Replace existing JCL check box and typing the name of the new JCL in the text field. Alternatively you can enter one or more of the qualifiers and click Browse to find the data set. Click Finish.

Results

CICSPlex SM definitions are added to the JCL that starts the region and a report is shown in the Console view. If the CICS region is run as a started task you must edit and update the JCL.

What to do next

You must restart the region for the changes to take effect. In addition, if the region is a version 3.1 region you must upgrade the CSD. The console report shows details of the changes that were made to the JCL and provides the following information:

  • An indication that the job completed successfully, showing the region name and the CICSplex to which it has been added
  • A list of the groups, if any, to which the region has been added
  • The name of the new JCL that was created, if any
  • A list of the SIT overrides that were added to the JCL
  • A list of the EYUPARM values that were added to the JCL
  • A list of SIT overrides that must be update manually
  • A list of the EYUPARM values that must be updated manually
Figure 1. An example Add CICS region to a CICSplex report
CICS region IYK2ZGVZ has been added to CICSplex JTPLEX2
The CICS region was added to CICSplex: 

JTPLEX2


The CICS region was added to the following CPSM groups: 
None.

New JCL was created for the new CICS region.
The new CICS region's JCL was created in:
JT1.OMEG.JCL(LMASGVZZ)

The following SIT overrides were added in the JCL:
CPSMCONN=LMAS

The following EYUPARM values were added in the JCL:
NAME(IYK2ZGVZ)
CICSPLEX(JTPLEX2)
CMASSYSID(JT3A)

The following SIT overrides still need to be added to the CICS region:
None.

The following EYUPARM values still need to be applied to the CICS region:
None.