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
- 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.
- 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.
- 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.