Activating workload management

This section contains the steps you need to perform to activate workload management.

For workload management to occur for a particular CICS® system, you must:

  1. Associate a workload specification with the CICS system, using the WLMSPEC view, as described in topic Adding a scope to a workload specification.
  2. Identify the dynamic routing program EYU9XLOP to the CICS systems acting as requesting regions and target regions.

    If the CICS system is not active, you can make workload management processing available the next time the CICS system starts by setting the CICS system initialization table DTRPGM (SIT) parameter in the requesting region which initiates the request and in any target region which is also to act as a routing region:

       DTRPGM=EYU9XLOP

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

       DSRTPGM=EYU9XLOP

    If the CICS system is active, you can use the CICSRGND view, described in CICSPlex SM Operations Views Reference, to set the name of the dynamic routing program and the distributed routing program.

    Note:
    For additional information about this program and dynamic routing, see Dynamic routing with CICSPlex SM.
  3. Activate workload management for the CICS system. You can do this using the views:
    CICSSYS
    To change the CICS system definition in the data repository.
    MAS
    To activate temporarily workload management for an active CICS system.

When either the first routing region associated with a CICSplex is started, or you use the MAS 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 will wait indefinitely until the CMAS becomes active and the requesting region fully connects to it. Note that once the requesting region connects to the CMAS and workload management is activated, the CMAS can become inactive and workload management remains active.

Once a workload is active, subsequent changes you make 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 WLMAWDEF view, as described in Table 5.)

How long a workload remains active depends on the affinity lifetime associated with the workload.

Important

Once workload management is active, you should not attempt to deactivate it while any workloads are active. When CICSPlex® SM is balancing or separating the work in a workload, unpredictable results may 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.

Related concepts
Workload management and dynamic routing
Workload requirements
Related tasks
Establishing a workload
Balancing the work in a workload
Separating the work in a workload
Taking affinity relations into consideration
Taking abend probabilities into consideration
[[ Contents Previous Page | Next Page Index ]]