Displaying the status of systems in a star complex

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 star. 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 star complex, the contents of the RNLs, and jobs that are delayed or suspended by a SET GRSRNL command. Issuing a D GRS command without any other parameters shows the same display as issuing a D GRS,SYSTEM command. These uses are described in z/OS MVS System Commands.

You can issue D GRS from any system in the star complex, and at any time after the star complex has been started. The D GRS display shows the status of the star 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 Star Explanation

20.30.03  ISG343I  20:30:02  GRS STATUS 540
SYSTEM    STATE               SYSTEM    STATE
 SYS2      CONNECTED           SYS1      CONNECTED
 SYS3      CONNECTING          SYS4      CONNECTING

SYSTEM

The name of the system.

STATE

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

CONNECTING: The system is processing the GRS=STAR parameter. It is not yet a member of the star complex.
CONNECTED: The system is part of the star complex.
REBUILDING: The system is not part of a star complex, but is rebuilding the ISGLOCK lock structure. All tasks that are trying to obtain global resources are suspended by the system.

In addition to the states defined for the star complex, the number of locks defined to the ISGLOCK lock structure is displayed. See z/OS MVS System Messages, Vol 9 (IGF-IWM) for a description of message ISG343I, which details the output of the DISPLAY GRS command.