INQUIRE WLMHEALTH

Retrieve information about the z/OS® WLM health service settings for 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).

INQUIRE WLMHEALTH

Conditions: 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 INQUIRE WLMHEALTH command returns information about the z/OS WLM health service settings for a CICS region.

Options

ADJUSTMENT(data-area)

Returns the adjustment value that CICS uses to adjust the z/OS WLM health value of the CICS region at each interval. This is a fullword binary value.

HEALTH(data-area)

Returns the z/OS WLM health value of the CICS region. This is a fullword binary value.

HEALTHABSTIM(data-area)

Returns the last time, in ABSTIME format, when the z/OS WLM health value was reported to z/OS WLM. For more information about the format of the ABSTIME value, see FORMATTIME.

INTERVAL(data-area)

Returns the amount of time, in seconds, between calls that CICS makes to the z/OS Workload Manager Health API (IWM4HLTH) to adjust the health value of the region. This is a fullword binary value.

OPENSTATUS(cvda)

Returns the status of the z/OS WLM health service. The CVDA values are as follows:

OPEN: CICS has completed increasing the z/OS WLM health value, which has reached a value of 100.
OPENING: CICS has started increasing the z/OS WLM health value, which is currently in the range 0 through 99.
CLOSED: CICS has completed decreasing the z/OS WLM health value, which has reached a value of 0.
CLOSING: CICS has started decreasing the z/OS WLM health value by the specified adjustment value at each specified interval. The health value is currently in the range 100 through 1.
IMMCLOSING: CICS is in the process of immediately setting the z/OS WLM health value to 0.

Conditions

NOTAUTH

RESP2 values:

100: The user associated with the issuing task is not authorized to use this command.