Start of change

SET WLMHEALTH

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

Read syntax diagramSkip visual syntax diagram
SET WLMHEALTH

>>-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 indicator 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 indicator 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 indicator of the CICS region. The CVDA values are as follows:
OPEN
Instructs CICS to start increasing the z/OS WLM health indicator. The first increase by the adjustment value happens immediately, after which the health indicator is increased every interval by the adjustment value until it reaches a value of 100.
CLOSE
Instructs CICS to start decreasing the z/OS WLM health indicator. The first decrease by the adjustment value happens immediately, after which the health indicator 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 indicator to 0.

Conditions

INVREQ
RESP2 values:
4
WLMHEALTH not available (WLMHEALTH=OFF has been specified in the system initialization table).
6
A SET WLMHEATLH OPEN command is issued, but the CICS z/OS WLM health process is already starting.
7
A SET WLMHEALTH CLOSE 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 CLOSE 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.


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