Start of change

WLMHEALTH

The WLMHEALTH system initialization parameter specifies the time interval and the health adjustment value to be used by CICS® on z/OS® Workload Manager Health API (IWM4HLTH) calls, which CICS makes to inform z/OS WLM about the health state of a CICS region.

WLMHEALTH={(20|interval[,25|number])|OFF}]
interval
Specifies the amount of time, in seconds, between calls that CICS makes to the z/OS Workload Manager Health API (IWM4HLTH). The value specified must be in the range 0 through 600. The default value is 20.
number
Specifies the health adjustment value that CICS provides to the z/OS Workload Manager Health API (IWM4HLTH) in each call at the specified interval. The value must be in the range 1 through 100. The default value is 25.

The health indicator is a number which shows, in percent, how well the server is performing. The specified health adjustment value adjusts the health indicator of the region each time CICS invokes the z/OS WLM Health API:

  • If the interval value is 0, the initial z/OS WLM health indicator of the CICS region is set to 0 during CICS initialization, and the z/OS WLM health incrementing process must be initiated at a later time by issuing a SET WLMHEALTH OPEN command.
  • If the interval value is greater than 0, the CICS server health indicator is incremented at the specified intervals. The first interval starts when the following message is issued:
    DFHSI1517 applid Control is being given to CICS
    For example, WLMHEALTH=(5,10) specifies that CICS will update the z/OS WLM health indicator in increments of 10 every 5 seconds until the health indicator reaches 100.

For a normal CICS shutdown, the z/OS WLM health indicator is set to 0 during the shutdown process, regardless of the current z/OS WLM health indicator.

OFF
Specifies that CICS does not use the z/OS Workload Manager Health API (IWM4HLTH) to inform z/OS WLM about the health state of a CICS address space.

To use the health settings provided by CICS, Sysplex Distributor needs to be configured to use a value of SERVERWLM for VIPADISTRIBUTE DISTMETHOD. In this case, if the health value for a CICS region is less than 100, z/OS WLM reduces the recommendation that is provided to Sysplex Distributor for that region. For port sharing, if the shared port is a sysplex-distributed port and SERVERWLM is the distribution method that is in use, SHAREPORTWLM should be specified on the PORT statement of each target to take advantage of the z/OS WLM server-specific recommendations. For more information, see z/OS Communications Server: IP Configuration Reference and z/OS Communications Server: IP Configuration Guide.



dfha2-wlmhealth.html | Timestamp icon Last updated: Monday, 5 June 2017
End of change