Controlling a global resource serialization complex

Use the VARY GRS command to:

Temporarily remove a system from the global resource serialization ring complex.
Restore a quiesced system to the global resource serialization ring complex.
Remove a system from the global resource serialization ring complex.
Rebuild a disrupted global resource serialization ring complex. (that is, a group of inactive or quiesced systems)

Note: Because the VARY GRS command is not valid when all of the systems in a global resource serialization complex are in the same sysplex, use the V XCF,sysname,OFFLINE command.

For more information on GRS and the sysplex, refer to z/OS MVS Planning: Global Resource Serialization and z/OS MVS Setting Up a Sysplex.

The following table shows the support for the VARY GRS commands during that time when an installation is migrating to a cross-system coupling facility sysplex.

Command	COMPLEX=SYSPLEX	Mixed Complex
VARY GRS,QUIESCE	Command rejected; message ISG153I issued	Command accepted
VARY GRS,RESTART	Command rejected; message ISG153I issued	Command accepted
VARY GRS,PURGE	Command rejected; message ISG153I issued	Command accepted:

Note: If the target system of a VARY GRS,PURGE command is a member of a sysplex with more than one system, it will be put into a non-restartable wait state.

Use the VARY GRS command mainly for recovery situations.

 
V GRS{({sysname|*|ALL}),{RESTART|R}}
                                  
     {({sysname|*}),{QUIESCE|Q}    }
    
     {(sysname),{PURGE|P}          }

sysname: The name of the system (specified on the SYSNAME system parameter). This name can be up to eight characters long and can contain any characters except commas and blanks.
*: The name of the current system (the system on which you enter the command). Specifying an asterisk means you want to change the current system’s status in the global resource serialization ring.
ALL: You want to change the status of all systems in the global resource serialization ring.
RESTART or R: You want to restore a quiesced (or inactive) system to the global resource serialization ring or rebuild a global resource serialization ring that has been disrupted. (When rebuilding a disrupted ring, you can specify ALL with RESTART.) Once this command takes effect, the system processes all previously-suspended requests for global resources. Restarting a system or restarting the ring requires an active system. An inactive system can make itself active and restart the ring. If, however, all systems are quiesced, issuing VARY GRS with RESTART invokes the reactivate function. Reactivating the ring avoids a complex wide re-IPL but can introduce data integrity exposures. Allow the reactivate function to proceed only on instructions from your system programmer.
QUIESCE or Q: You want to temporarily remove a system from the global resource serialization ring. Requesters of global resources on the quiesced system hold on to all global resources they own and hold their position in the queues for those resources they do not own. Global resource serialization suspends processing of all new requests for global resources.
PURGE or P: You want to remove a quiesced system from the global resource serialization complex.
If the system specified on the purge command is active, global resource serialization issues messages that describe the situation. Depending on your response, GRS will quiesce the system and then continue with the purge. All global resources owned by the system you purge are released and all outstanding requests for global resources made by the system you purge are deleted. Use this option when a system is no longer running and needs a re-IPL.

Note: Indiscriminate use of the VARY GRS,PURGE command can cause resource integrity problems and can put the system in a non-restartable wait state. Notify the system programmer if the system you are purging holds any resources.