Activating workload management

To activate workload management you must associate a workload specification with the CICS system and update the CICS system to use the dynamic routing or distributed routing program.

Before you begin

You must identify the CICS systems that you want to use for dynamic routing of your workloads. The requesting regions are where the requests are initiated, for example a terminal-owning region; the routing regions decided where to route transactions or programs; the target regions are where the transaction or program run, for example an application-owning region. Together, the requesting, routing, and target regions form a single entity within which you can route work.

About this task

For more information about dynamic routing, see Dynamic routing with CICSPlex SM.

Procedure

  1. Associate a workload specification with the CICS® system, using the WLMSPEC view, as described in Associating a CICS system or system group with a workload specification.
  2. Identify the dynamic routing program EYU9XLOP to the CICS systems acting as requesting regions and any routing region:
    • If the CICS system is not active, you can make workload management processing available the next time the CICS system starts up. Set the DTRPGM system initialization parameter in the requesting region and in any target region that acts as a routing region:
         DTRPGM=EYU9XLOP

      For non-terminal-related EXEC CICS START commands, BTS activities, and for all regions in a logical server, set the DSRTPGM system initialization parameter in the region that initiates the request and in all potential target regions:

         DSRTPGM=EYU9XLOP
    • If the CICS system is active, you can use the CICS regions detailed view, as described in CICS regions - CICSRGN, to set the name of the dynamic routing program and the distributed routing program.
  3. Activate workload management for the CICS system. You can do this using the following views:
    • Use the CICS system definitions view to change the CICS system definition in the data repository.
    • Use the MASs known to CICSplex view to temporarily activate workload management for an active CICS system.

Results

When either the first routing region associated with a CICSplex is started, or you use the MASs known to CICSplex detailed view to activate workload management for the first routing region in a CICSplex, the appropriate workload specifications are installed automatically. All CMASs involved in managing the CICSplex are also notified. All workload definitions and transaction groups, associated with the specification by workload groups, are also installed automatically. As long as the CICS system remains active, additional workload definitions can be installed manually in the CICS system.

Note: When a requesting region associated with a CICSplex, and defined with either DTRPGM=EYU9XLOP or DSRTPGM=EYU9XLOP, is starting, it connects to its target CMAS and workload management is activated. However, if the target CMAS is not active when the routing region is starting, any transactions initiated from that routing region and processed by the EYU9XLOP program wait indefinitely until the CMAS becomes active and the requesting region fully connects to it. After the requesting region connects to the CMAS and workload management is activated, the CMAS can become inactive and workload management remains active.

When a workload is active, subsequent changes to workload definitions and transaction groups are noted in the data repository. To include these changes in an active workload, you must use action commands to install or discard them.

Installed workload definitions become active immediately and remain active as long as the workload is active or until you discard them. To verify that the definition is installed in the workload and that all of the CMASs involved in managing the CICSplex using that workload know about the definition, you can use the Active workload definitions view.

How long a workload remains active depends on the affinity lifetime associated with the workload:
  • When an affinity lifetime of PERMANENT is in effect, the workload remains active as long as any CMAS involved in managing the workload is active.
  • When any other affinity lifetime, or no affinity lifetime, is associated with the workload, the workload remains active as long as any CICS system that is associated with that workload remains connected to a CMAS that manages the CICSplex to which that CICS system belongs.

What to do next

When workload management is active, do not attempt to deactivate it while any workloads are active. When CICSPlex SM is routing or separating the work in a workload, unpredictable results might occur if you attempt to deactivate workload management. Unacceptable results occur if you attempt this action when affinity relations are associated with active workloads. For details, see Discarding an active transaction from a workload.



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