Subparameters for REQUEST=RQUERY

REQUEST=RQUERY

Asks for the status on a Global Mirror for ESS session.

,SNBR=sessno

Is the name (RS-type) (or address in register (2)-(12) ASM only) of a required 1-byte value between 01 and FF identifying the session number. You may specify 0 with the GMLSTAT, GMPSTAT, or DVCSTAT ACTION parameters to query all Global Mirror sessions defined to the LSS.

,VOLSER=volno

Is the name (RS-type) (or address in register (2)-(12) ASM only) of a required 6-character MVS volume serial number of the device to be used for I/O. For CKD, volno must be in the same LSS as the target of the query. For FB, volno must be in the same cluster as the target of the query.

,DEVN=devn

A required input parameter field containing the binary device number to use for I/O.

The allowed values specified in this keyword are a 4 hexadecimal character MVS device number. This keyword is mutually exclusive with the VOLSER keyword.

To code: Specify the RS-type address, or address in register (2)-(12), of a 2-byte field.

,ACTION=action

Is the name (RS-type) (or address in register (2)-(12) ASM only) of a required 12-character value identifying the specific action to be performed.

STAT4ALSS: This query provides performance counters, consistency group information, FlashCopy® information, and out-of-sync tracks for the specified session within the specified LSS. This action will result in only unformatted output. The output is mapped by ANTRQMAP TYPE=STAT4A.
STAT4AESS: This query provides performance counters, consistency group information, FlashCopy information, and out-of-sync tracks for the specified session within the ESS the specified LSS is in. This action will result in only unformatted output. The output is mapped by ANTRQMAP TYPE=STAT4A.
STAT4ACGRP: This query provides performance counters, consistency group information, FlashCopy information, and out-of-sync tracks for the specified session within the ESS the specified LSS is in. This action will result in only unformatted output. The output is mapped by ANTRQMAP TYPE=STAT4A.
STAT4BLSS: This query provides out-of-sync information for the specified session within the specified LSS. This action will result in only unformatted output. The output is mapped by ANTRQMAP TYPE=STAT4B.
STAT4BESS: This query provides out-of-sync information for the specified session within the ESS the specified LSS is in. This action will result in only unformatted output. The output is mapped by ANTRQMAP TYPE=STAT4B.
STAT4C: This query provides summary information on all sessions in the ESS. This action results in only unformatted output. The output is mapped by ANTRQMAP TYPE=STAT4C.
STAT51: This query provides detailed performance information on all the sessions in an ESS. This action results in only unformatted output. The output is mapped by ANTRQMAP TYPE=STAT51. For more information, see the note that follows these values, at Note for ACTION=STAT51 and ACTION=GMLSTAT.
GMLSTAT: This query provides a formatted report, either to a data set or to the QRYINFO, with summary information pertaining to the Global Mirror session. For more information, see the note that follows these values, at Note for ACTION=STAT51 and ACTION=GMLSTAT.
GMPSTAT: This query provides a formatted report, either to a data set or to the QRYINFO, with summary information pertaining to the LSS specified in the request and the Global Mirror session.
DVCSTAT: This query provides a formatted report, either to a data set or to the QRYINFO, with information pertaining to all devices in the LSS joined to the Global Mirror session.

Note: For ACTION=STAT51 and ACTION=GMLSTAT, the control unit returns information for multiple sessions, with detail for sessions that were started in the same cluster as the device where the query was issued, and a status of NotOwnedCL, for sessions that were started in the other cluster, or NotMaster, for subordinate sessions. Information returned for sessions not owned by the cluster where the query was issued or for a subordinate session consists of:

Session ID
CG interval time
Coordination interval time
Max drain time
Master CU sequence number

If the IBM storage management software specified the SYSPLEXNAME keyword on START or RESUME, the following are included:

Current sysplex clock time
Drift
Last Good CG sysplex clock time
Sysplex name.

When multiple sessions are started for an SFI, ACTION=GMLSTAT with SNBR of 00 returns information for multiple sessions, separated by a line of asterisks (*). Specifying a SNBR other than 00 displays only query information for that session. The default is 00 (show all sessions in the query).

,LSSNBR=lss

lss is the name (RS-type) (or address in register (2)-(12) ASM only) of an optional 1-byte field specifying the LSS number for which the report is to be generated by an RQUERY request. Valid values are 00-FF.

,DVCNBR=dvc

dvc is the name (RS-type) (or address in register (2)-(12) of an optional 1-byte field specifying the device for which the query is being issued. When LSSTYPE is FB, this parameter is required and is the device LUN. When optionally specified for an LSSTYPE of CKD, this value is the device CCA.

,LSSTYPE=typ

,LSSTYPE=CKD

typ is the name (RS-type) (or address in register (2)-(12) of an optional 3-character field specifying the type of LSS. Valid values are FB (left-justified and padded on the right with a blank) or CKD. This parameter is required for FB. CKD is the default.

,QRYSIZE=size

size is the name (RS-type) or address in register (2)-(12) of a required half word input field that contains the length of QRYINFO area. This is mutually exclusive with the DSNAME keyword.

,QRYINFO=info

info is the name (RS-type) or address in register (2)-(12) of a required variable character output field to be used to return the results of the query. This keyword is mutually exclusive with DSNAME keyword.

,DSNAME=dsn

dsn is the name (RS-type) or address in register (2)-(12) of a 44-character input field containing the name of a data set that the query output will be placed in. The data set must already be allocated with a fixed record format and a logical record length of at least 79 bytes. The value is-left justified and padded on the right with blanks. The keyword is mutually exclusive with the QRYSIZE and QRYINFO keywords.

,DSDISP=disp

,DSDISP=OLD

disp is the name (RS-type) or address in register (2)-(12) of an optional 3-character input field containing a parameter that tells the disposition of the data set specified in the DSNAME keyword. The value is left justified and padded on the right with blanks. A value of binary zeros indicates that the default is to be used. Valid values that can be specified are:

OLD: A disposition of old. This is the default.
MOD: A disposition of mod.
SHR: A disposition of shr.

,SUBCHSET=subchset

,SUBCHSET=0

Specifies the subchannel set in which the command is to be issued. The subchannel set where the I/O will be issued is the subchannel set as defined in the Hardware Configuration Dialog (HCD). The valid values are determined by what is currently supported by the host system's processor and configured for the device.

If you specify a value of X'00' or omit this keyword, the command is issued to the device that is currently logically in subchannel set 0. If a swap has occurred, this could be the device that was defined in an alternate subchannel set in the I/O configuration (IODF), with HCD.

To code: Specify the RS-type name, or address in register (2)-(12), of an optional 1-byte (character) field.