Adding a CICS region to a CICSplex

Using CICS® DA, you can install CICSPlex® SM definitions in an unmanaged CICS region and add the region to an existing CICSplex. Optionally, you can also add the region to 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 is recorded. For more information about recording the start policy, see Specifying the region start policy.

Procedure

  1. In the DA Explorer view, double-click the unmanaged CICS region to add to a CICSplex, or right-click the region 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 window opens:
    A screen capture of the Add CICS Region to CICSplex window that shows the CICSplexes, groups, and CMASes in the sysplex.
    The window lists the CICSplexes in the system model. When you select a CICSplex, the CMASes and Groups in that CICSplex are shown.
  3. Select the CICSplex and the CMAS to which you want to add the CICS region. Optionally, select one or more groups to which to add the region.
  4. Optional: If the region is started as a batch job, create new JCL for the job by clearing the Replace existing JCL check box. Type the name of the new JCL in the field. Alternatively, enter one or more of the qualifiers and click Browse to find the data set.
  5. If your JCL contains any INCLUDE or SYSIN statements, CICS DA cannot always be sure whether the INCLUDE and SYSIN members are used by other regions. By default, CICS DA creates new members, and changes the INCLUDE and SYSIN statements to reference the new members. You can clear the Create new members for INCLUDEs and SYSIN if required if you want to change and use the existing INCLUDE or SYSIN members.
  6. Click Finish to start the process of adding the CICS region to the CICSplex.

Results

When you click Finish, CICSPlex SM definitions are added to the JCL that starts the region and a report is shown in the Console view.

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 system definition data set (CSD).

The console report shows details of the changes that are made to the JCL. The report also identifies some other tasks that you might consider carrying out for the new managed region, such as reviewing some SIT parameters and setting up monitoring.