Querying Global Mirror summary output at device level

The RQUERY DVCSTAT request queries a Global Mirror session for volume count and consistency group revertible status information at the device level. Start of change

The following example is for a cascaded (non-multi-target) environment. End of change

RQUERY SNBR(BC) VOLSER(ZBOB60) ACTION(DVCSTAT)

11 Oct 2004  09:41:03.73                                                      
                                                                              
ANTP7000I RQUERY Output Volser(ZBOB60) Action(DVCSTAT) Version(001)           
ANTP7008I SNbr LSS Dvc VolStat              PriPPRCStat SecCascStat           
ANTP7002I --   --  --  -------------------- ----------  ----------            
ANTP7009I BC   07  09  InSession            DplxPendng  Simplex
ANTP7009I          15  InSession            DplxPendng  Simplex

When a specific, non-zero SNBR is specified in the RQUERY DVCSTAT command, the data lines in the summary output are repeated for each device in the requested session in the LSS. When SNBR is specified as zero, the data lines are repeated for each device in all currently defined sessions in the LSS when the command was issued.

In a multi-target environment, an additional ANTP7026I message is inserted for each device in the session, to display the secondary serial, LSS, and CCA, as follows:

ANTP7000I RQUERY Output Devn(0F51) SCHSET(0) Action(DVCSTAT) Version(002)
ANTP7008I SNbr LSS Dvc VolStat              PriPPRCStat SecCascStat     
ANTP7002I --   --  --  -------------------- ----------  ----------      
ANTP7009I 33   30  00  InSession            DplxPendng  Simplex         
ANTP7026I             SECINFO: SERIAL: 0000000CRB71 LSS: 30 CCA: 0A     
ANTP7009I      30  01  InSession            DplxPendng  Simplex         
ANTP7026I             SECINFO: SERIAL: 0000000CRB31 LSS: 30 CCA: 01     
ANTP7009I      30  02  InSession            DplxPendng  Simplex         
ANTP7026I             SECINFO: SERIAL: 0000000CRB31 LSS: 30 CCA: 02

If MTVOLLIST or MTVOLRANGE was not specified on the RVOLUME JOIN command, the values in the ANTP7026I messages are periods (.), for example:

ANTP7026I             SECINFO: SERIAL: ............ LSS: .. CCA: ..

The fields in RQUERY DVCSTAT formatted output are defined as follows:

Table 1. DVCSTAT Field Definitions
Header/Label	Valid Value(s)	Description
SNbr	Hex value X'01' - X'FF'	Global Mirror session number
LSS	Hex value X'01' - X'FF'	LSS number.
Dvc	Hex value X'01' - X'FF'	Device number. For a CKD device, this will be the Channel Connection Address (CCA). For a Fixed Block (FB) device, this will be a Logical Unit Number (LUN).
VolStat	10 character string, combining status values reported by the storage control, separated by dashes (-). InSession\|In NotInSession\|NIn CascOK JoinP RemvP 1st Unavailabl NoSessions NoVolumes	Global Mirror session status The volume is in a Global Mirror session. If no additional status is to be reported (cascading OK, remove pending, etc.), this will be displayed as 'InSession'. If additional status is to be reported, this will be displayed abbreviated as 'In'. The volume is not in a session. If no additional status is to be reported (join pending, 1st pass copy in progress, etc.), this will be displayed as 'NotInSession'. If additional status is to be reported, this will be displayed abbreviated as 'NIn'. The PPRC primary was established with CASCADE=YES. The PPRC pair has not fully joined the ASYNC session. The PPRC pair is in the process of being removed from the ASYNC session. The PPRC pair is in its initial (first pass) copy phase. Data could not be collected due to the unavailability of internal storage control structures (control blocks). No Global Mirror session has been defined to the LSS where the requested device resides. No volumes have been joined to the global mirror session.
PriPPRCStat	10-Character string Simplex DplxPending Duplex Suspended	The PPRC status for the primaries of the PPRC pairs in this LSS in the Global Mirror session: The device is simplex. The pair is in a duplex pending state. The pair is in full duplex state. The pair is suspended.
SecCascStat	10-Character string Simplex DplxPending Duplex Suspended	Status of the device as a cascaded secondary of a PPRC pair: The device is not participating in a cascaded PPRC relationship. The cascaded pair is in duplex pending state. The cascaded pair is in full duplex state. The cascaded pair is suspended.
SECINFO	SERIAL, LSS and CCA	SERIAL Serial number of the secondary for the relationship participating in the Global Mirror session. If MTVOLLIST or MTVOLRANGE was not specified on the RVOLUME JOIN command, the serial number is displayed as a string of periods (.). LSS LSS of the secondary for the relationship participating in the Global Mirror session. CCA CCA of the secondary for the relationship participating in the Global Mirror session.