Displaying ring status

The DISPLAY GRS (D GRS) command shows the state of each system in the complex. Note that D GRS shows system status only as it relates to the global resource serialization ring. D GRS does not reflect how well a system is running.

You can also use D GRS to display the local and global resources requested by the systems in the ring, contention information, the contents of the RNLs, and jobs that are delaying or suspended by a SET GRSRNL command. These uses are described in z/OS MVS System Commands.

You can issue D GRS from any system in the ring and at any time after the ring has been started. The D GRS display shows the status of the ring from that system's point of view; thus, the displays issued from different systems might show different results. Figure 1 shows an example of the information D GRS produces and explains the values that can appear in each field.

Figure 1. D GRS Explanation (Complex Matches Sysplex)

18.40.07  ISG343I  18:40:06  GRS STATUS 340
SYSTEM    STATE               SYSTEM    STATE
 SYS2      ACTIVE              SYS1      ACTIVE
 SYS3      QUIESCED            SYS4      QUIESCED

SYSTEM

The name of the system.

STATE

The state of the system at the time when the command was issued.

ACTIVE: The system is part of the ring and is actively participating in global resource serialization. ACTIVE is the normal condition.
QUIESCED: The system is temporarily suspended from the ring, in response to a ring disruption. The system does not have current information about global resources and is not currently processing global resource requests. Users of global resources retain ownership, but any users who try to obtain or free a global resource are suspended. The system will restart and become active as soon as it is able.
INACTIVE: The system is not part of the ring. INACTIVE appears when a ring disruption has occurred. The system has current information about global resources but is not currently processing global resource requests. Users of global resources retain ownership, but any users who try to obtain or release a global resource are suspended. Multiple systems can be INACTIVE, and an inactive system can restart the ring. A system will restart the ring as soon as possible.
JOINING: The system is joining the ring as part of its IPL process.
RESTARTING: The system is re-entering the ring after a ring disruption.
ACTIVE+VARY: The system is executing an internal command.
ACTIVE+WAIT: The system is waiting to process an internal command.
MIGRATING: The system is in the process of migrating from a ring to a star, as a result of issuing a SETGRS command. The system suspends all tasks from obtaining global resources.
Note: GQSCAN does not work during migration from a ring complex to a star complex.

As a part of your planning, decide what to do if a system remains quiesced or inactive for an extended period of time. See Recovery actions for global resource serialization to determine what recovery operations you should perform.