
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:
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.DFHSI1517 applid Control is being given to CICS
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.
