SET WLMHEALTH

Change the z/OS® WLM health service settings of a CICS® region.

SET WLMHEALTH

Read syntax diagramSkip visual syntax diagram SET WLMHEALTH ADJUSTMENT( data-value)INTERVAL( data-value)OPENSTATUS( cvda)

Conditions: INVREQ, NOTAUTH

Description

The SET WLMHEALTH command allows you to change the z/OS WLM health service settings of a CICS region.

Options

ADJUSTMENT(data-value)
Specifies the adjustment value that CICS uses to adjust the z/OS WLM health value of the region at each specified interval. This is a fullword binary value and must be in the range 1 through 100.
INTERVAL(data-value)
Specifies the amount of time, in seconds, between calls that CICS makes to adjust the z/OS WLM health value of the CICS region by using the z/OS Workload Manager Health API (IWM4HLTH). This is a fullword binary value and must be in the range 0 through 600.
OPENSTATUS(cvda)
Instructs CICS to increase or decrease the z/OS WLM health value of the CICS region. The CVDA values are as follows:
OPEN
Instructs CICS to start increasing the z/OS WLM health value. The first increase by the adjustment value happens immediately, after which the health value is increased every interval by the adjustment value until it reaches a value of 100.
CLOSED
Instructs CICS to start decreasing the z/OS WLM health value. The first decrease by the adjustment value happens immediately, after which the health value is decreased every interval by the adjustment value until it reaches a value of 0.
IMMCLOSE
Instructs CICS to immediately set the z/OS WLM health value to 0.

Conditions

INVREQ
RESP2 values:
4
WLMHEALTH not available (WLMHEALTH=OFF has been specified in the system initialization table).
6
A SET WLMHEALTH OPEN command is issued, but the CICS z/OS WLM health process is already starting.
7
A SET WLMHEALTH CLOSED command is issued, but the CICS z/OS WLM health process is already ending.
11
OPENSTATUS has an invalid CVDA value.
13
The OPEN request did not complete because INTERVAL is currently set to 0.
14
The CLOSED request did not complete because INTERVAL is currently set to 0.
16
INTERVAL is not in the range 0 through 600.
17
The ADJUSTMENT value is not in the range 1 through 100.
NOTAUTH
RESP2 values:
100
The user associated with the issuing task is not authorized to use this command.