Displaying Information about Automatic Restart Management

To obtain information about elements of the automatic restart manager, you can issue:

The IXCQUERY macro
The D XCF,ARMSTATUS command
The COUPLE subcommand of IPCS.

The information requested through any of the above methods should be filtered by using element name, restart group name, and so on. For more information about the above methods, see:

z/OS MVS Programming: Sysplex Services Reference for more information about the IXCQUERY macro
z/OS MVS System Commands for more information about the DISPLAY command
z/OS MVS IPCS Commands for more information about the COUPLE subcommand.

All of the methods for displaying information about automatic restart management contain information about the state of the elements. An automatic restart management element can be in one of the following states, depending on the IXCARM requests it has issued or how the restart process has progressed: starting, available, available-to, failed, restarting, recovering. The states are defined as follows:

Starting

The element has initially registered but has not yet indicated it is ready to accept work.

Available

The element has indicated it is ready to accept work by issuing the IXCARM macro with the REQUEST=READY parameter.

Available-to

The element exceeded the ready timeout threshold before it issued the IXCARM macro with REQUEST=READY parameter. The system considers this element ready.

Note: For the IXCQUERY macro, elements in this state will be put with the elements in the available state. The available-to state is not applicable to status information available through the IXCQUERY macro.

Failed

The element has terminated and a restart has not been initiated by MVS™, yet. This condition should apply only for a short amount of time if automatic restart management restarts have been enabled. (This state is not related to the failed state for an XCF member.)

Restarting

MVS has initiated a restart of this element, but it has not re-registered with the automatic restart manager yet.

For IXCQUERY requests issued on the system where the restart is occurring, the following information is also available from IXCYQUAA:

QUAARMSRSTINGINERE — this bit indicates that the element is in a restarting state. Element restart exit processing is in progress. No exits may have been called, an exit may be in control, or all exits may have returned. It is possible that the restart will be vetoed.
QUAARMSRSTINGINEVE — this bit indicates that the element is in a restarting state. The element's event exit is currently in control or has been processed. It is possible that the restart will be vetoed.
QUAARMSRSTCOMMITED — this bit indicates that the element is in a restarting state. ARM has initiated the restart of the element by implementing the restart method.

Recovering

The element has been restarted and has re-registered with the automatic restart manager, but has not indicated that it is ready to accept work yet.

The following table summarizes the element state definitions.

Table 1. Automatic Restart Management Element States
Current® State	Event	IXCARM Command Issued	Resultant State
NOT DEFINED	Element successfully registers as an element	REQUEST =REGISTER	STARTING
STARTING	Element indicates ready to accept work	REQUEST =READY	AVAILABLE
FAILED	ARM starts the restart process		RESTARTING
RESTARTING	Element not yet restarted by ARM. Policy or exit vetoes the restart.		NOT DEFINED
RESTARTING	Element restarted, not yet reregistered		RESTARTING
RESTARTING	Element restarted, exceeds timeout threshold before reregistering (issuing REQUEST=REGISTER)		NOT DEFINED
NOT DEFINED	Element restarted, had exceeded timeout threshold before reregistering, and then registers	REQUEST =REGISTER	STARTING
RESTARTING	Element restarted, successfully reregisters	REQUEST =REGISTER	RECOVERING
RECOVERING	Element restarted, reregisters, and needs to wait for predecessors before being available.	REQUEST =WAITPRED	RECOVERING
RECOVERING	Exceeds timeout threshold before issuing REQUEST=READY	None (timed out)	AVAILABLE-TO
RECOVERING	Element indicates ready to accept work	REQUEST =READY	AVAILABLE