WLMHEALTH

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 - 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 - 100. The default value is 25.

The health value is a number that shows, in percent, how well the server is performing. The specified health adjustment value adjusts the health value 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 value of the CICS region is set to 0 during CICS initialization, and the z/OS WLM health incrementing process must be initiated later by issuing a SET WLMHEALTH OPEN command.
• If the interval value is greater than 0, the CICS server health value 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 updates the z/OS WLM health value in increments of 10 every 5 seconds until the health value reaches 100.

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

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 that are 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, specify SHAREPORTWLM 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.

If you change the WLMHEALTH value while CICS is running, the change is cataloged in the local catalog. If WLMHEALTH is specified in the system initialization table, the cataloged value that is specified by the change overrides the value of the WLMHEALTH system initialization parameter on an initial or cold restart. The cataloged value is not used if you specify WLMHEALTH as a system initialization parameter override (for example, in SYSIN), or if you reinitialize the CICS catalog data sets.

A change to the value for the WLMHEALTH interval or health adjustment is cataloged in the local catalog, so it takes precedence on subsequent AUTO restarts of CICS and prevents an interval value of zero being used. You might want to specify the WLMHEALTH interval value as zero on startup (for example, WLMHEALTH=(0,25) ), then modify the setting after control is given to CICS and the system is deemed ready to allow z/OS WLM to increase the recommendation that is provided to Sysplex Distributor for that region. Specifying WLMHEALTH as a system initialization parameter override allows you to get this desired behavior.