Adding CICSPlex SM to the topology

Managing a topology with CICSPlex® SM provides additional benefits because you can add workload management, group related regions together to manage them, and add definitions to many regions in one action. To manage a topology with CICSPlex SM, you must set up a CMAS and a WUI server.

Before you begin

This task adds two additional CICS® regions to the existing topology of the general insurance application: a CMAS and a WUI server. To complete this step you must have two regions that you can use for this purpose.

About this task

CICSPlex SM provides a single point of management for the regions in the topology. You can use CICSPlex SM to set up workload management to scale and manage the application, add and move regions in the topology, and dynamically manage the routing rather than statically defining values in each PROGRAM definition.

To complete this task, use the jobs in the installation directory of the general insurance application.

Procedure

  1. Update the member CUST1 in the CB12.EXEC data set to add the details for the topology. The values must match the APPLIDs and SYSIDs of the regions in the topology that you created in the previous task.
    TORAPPL   = 'IYI1CICS'              
    AORAPPL   = 'IYI2CICS'              
    DORAPPL   = 'IYI3CICS'              
    TORSYSID  = 'IYI1'                  
    AORSYSID  = 'IYI2'                  
    DORSYSID  = 'IYI3'                  
    CMASAPPL  = 'IYI0CMAS'              
    CMASYSID  = 'ICMA'                  
    WUIAPPL   = 'IYI0WUI'               
    WUISYSID  = 'IWUI'   
    TORAPPL
    Specify the APPLID of the CICS terminal-owning region.
    AORAPPL
    Specify the APPLID of the application-owning region.
    DORAPPL
    Specify the APPLID of the data-owning region.
    TORSYSID
    Specify the system ID of the terminal-owning region.
    AORSYSID
    Specify the system ID of the application-owning region.
    DORSYSID
    Specify the system ID of the data-owning region.
    CMASAPPL
    Specify the APPLID of the CMAS for CICSPlex SM enablement.
    CMASSYSID
    Specify the system ID of the CMAS for CICSPlex SM enablement.
    WUIAPPL
    Specify the APPLID of the WUI server region for CICSPlex SM enablement.
    WUISYSID
    Specify the system ID of the WUI server region for CICSPlex SM enablement.
  2. Run the EXEC to customize the jobs for the general insurance application.
  3. Run the following jobs in the CNTL data set:
    1. @DEFDREP defines the data repository in a data set for CICSPlex SM.
    2. @DEFWREP defines the Web User Interface repository in a data set for CICSPlex SM.
    3. @CDEF123 creates the definitions for all the application programs. The difference between these definitions and the previous PROGRAM definitions in the topology is that they are all defined as DYNAMIC instead of REMOTESYSTEM. CICSPlex SM can dynamically manage where the work is routed in the application between the CICS regions. The job adds the definitions to the shared CSD.
  4. Configure the CICS region that acts as a CMAS. You can use the @SAMPCMA JCL or edit your own job. The sample contains all the definitions that are required by CICSPlex SM and is customized based on the values that you entered in the customization job. If you use your own job, ensure that the following conditions are satisfied:
    • Ensure that CPSMCONN=CMAS is specified in the list of system initialization parameters.
    • Ensure that the CICS region includes the CICSPlex SM libraries.
  5. Start the CMAS region and check the system log for the following CICSPlex SM message:
    +EYUXL0010I IYI0CMAS CMAS initialization complete.
    If the message is in the log, the CMAS is up and running.
  6. Configure the CICS region that acts as the WUI server. The WUI server is required to manage CICS regions from the CICS Explorer® or Web User Interface. You can use the @SAMPWUI job, because this sample is customized by the CUST1 job. If you use your own job, ensure that the following conditions are satisfied:
    • Ensure that the following parameters are specified in the list of system initialization parameters.
      GRPLIST=(DFHLIST,TORLIST)
      CPSMCONN=WUI
      TCPIP=YES
      NCPLDFT=GENA
      ISC=YES
      The TORLIST is a group that contains the required definitions for the WUI server.
    • Ensure that you specify the CMCIPORT WUI server initialization parameter to connect CICS Explorer to the region. The value used in the @SAMPWUI job is CMCIPORT=6346. You can use a different port for CMCI if preferred.
    • Ensure that the CICS region includes the CICSPlex SM libraries.
  7. Start the WUI server and check the system log for the following CICSPlex SM message:
    +EYUCL0006I IYI0WUI ESSS link to IYI0CMAS established.

Results

You successfully configured and started a CMAS and a WUI server.

What to do next

Connect to the WUI server from CICS Explorer to create a CICSplex and enable each CICS region to be managed by the CMAS.


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