Defining the CICSplex and workload specification

Using the CICS Explorer®, you can define the CICSplex for your application, logically group the regions together, and implement workload management.

About this task

The CICSplex is the largest collection of CICS® regions that you can manage as a single entity. You can create CICS system groups to divide the regions into logical groupings in the CICSplex; for example, you can logically group TORs together, AORs together, and DORs together. The advantage of using this approach is that you can update or add definitions to the system group and apply the updates to all regions in that group with one action.

Procedure

  1. Open CICS Explorer and create a connection to the WUI server. The default port is 6346 on the CMCIPORT parameter.
  2. Define a CICSplex to CICSPlex® SM. The general insurance application has a job called @CPSMDE2 that creates a CICSplex called GNAPPLEX. You can run this job to create all the definitions that are required for the CICSplex, including the workload specification. If you want to create your own CICSplex, follow these steps:
    1. Create a CICSplex definition and add it to the data repository.
    2. Define CICS system groups to logically group regions of the same type together in the CICSplex.
    3. Define how those regions are workload managed by CICSPlex SM by creating a workload specification.
  3. Refresh the view in CICS Explorer to see the CICSplex. The CICSplex contains definitions for the regions and system groups.
    Screen capture showing the CICSplex Explorer view with a CICSplex defined called GNAPPLEX.
  4. Enable the CICS regions in your topology to be managed by the CMAS. For each region:
    1. Add the CICSPlex SM libraries to the STEPLIB and RPL concatenations.
    2. Add the CICSPlex SM EYUPARM data sets. Use the correct high-level qualifiers for your environment.
    3. Add the following system initialization parameters to the startup JCL:
      CPSMCONN=LMAS
      DTRPGM=EYU9XLOP
      DSRTPGM=EYU9XLOP
  5. Restart the CICS regions to pick up the changes. In the system log the following CICSPlex SM messages are reported for each region:
    +EYUXL00006I IYI1CICS ESSS link to IYI0CMAS established
    The TOR and AOR also report a message to confirm that the workload registration has occurred:
    +EYUNL0160I IYI1CICS Workload registration complete

Results

You defined the CICSplex, enabled each region to be managed by the CMAS, and added a workload specification to dynamically route application requests.

What to do next

You can verify the solution by checking the results in the CICS Explorer and running the application.


genapp_def_cicsplex.html | Timestamp icon Last updated: Sunday, 4 June 2017