SET WLMHEALTH
Change the z/OS® WLM health service settings of a CICS® region.
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.