SET WLMHEALTH

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

Syntax

Warning: System commands are powerful as they provide information about the state of the system and allow changes to be made to it. System commands should be used only by authorized applications and users.

Activate security checks on commands by specifying the XCMD system initialization parameter and by ensuring that command security checking is active for the transaction (either by specifying CMDSEC(YES) on the TRANSACTION resource definition or by specifying ALWAYS on the CMDSEC system initialization parameter).

SET WLMHEALTH

Conditions: INVREQ, NOTAUTH

NOHANDLE, RESP, and RESP2 are common options that can be added to all EXEC CICS commands to process error conditions. They are not explicitly included in the command syntax diagram and option descriptions. For information about these common options and EXEC CICS command syntax, see EXEC CICS command format and programming considerations. For more information about the use of CVDAs, see CICS-value data areas (CVDAs).

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.