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
- 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.
- Run the EXEC to customize the jobs
for the general insurance application.
- Run the following jobs in the CNTL data set:
- @DEFDREP defines the data repository in a data set for CICSPlex SM.
- @DEFWREP defines the Web User Interface repository in
a data set for CICSPlex SM.
- @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.
- 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.
- 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.
- 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:
- 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.