
Effect of the z/OS WLM health service on CPSM workload routing
In a CICS® region, if the z/OS® Workload Manager (z/OS WLM) health service is active, which is the default, CPSM WLM takes account of the region's z/OS WLM health state in the routing decision.
For CPSM WLM to take into account the z/OS WLM health state in the target regions, both the routing and target regions must be at a minimum of CICS TS V5.4 (CICS and CPSM libraries), otherwise the z/OS WLM health state will be ignored and the target regions will be deemed to be ready to receive work.
If the service is disabled, to activate this service for a CICS region, you must set the WLMHEALTH system initialization parameter.
The z/OS WLM health state of a region is reflected by a z/OS WLM health indicator in the range 0 - 100. A value of 1-100 means that the region is ready to receive work whereas a z/OS WLM health indicator of 0 means that it is not ready to receive work. When the WLMHEALTH SIT parameter is set to OFF, the region is deemed as always ready to receive work.
If the target region has a z/OS WLM health indicator of zero, it is assigned a very high penalizing weight in the routing algorithm. Therefore, the region is less likely to receive work. Note that the region remains active, so it might receive work if no other healthier regions are available in the same scope. This is different from quiescing a target region, which removes the region as a candidate target from all workloads, regardless of the availability of other target regions. For more information, see Quiescing a target region in an active workload.
During the CICS warm-up or cool-down process, CICS adjusts the z/OS WLM health indicator of the region. As a result, this affects the routing decision of CPSM WLM, which restricts workload into the region during that process. For more information about what happens during CICS warm-up or cool-down, see CICS warm-up and cool-down by use of z/OS Workload Manager health service.
You can deliberately make a region less favorable in CPSM routing decisions by setting its z/OS WLM open status to CLOSE or IMMCLOSE in the MVS workload management (MVSWLM) view.
