Use request type PQUERY to query PPRC status. This invokes ANTRQST
ILK=PPRC REQUEST=PQUERY.
- DEVN(devn)
- Specifies the hexadecimal device number to be used for I/O. It
is required. This device number must identify a CKD device that is
defined to the host system making the request.
- QRYSIZE(qrysize)
- Specifies the decimal length of the QRYINFO area. It is required.
- QRYINFO(qryinfo)
- Creates the data area where the query information is to be returned.
- QRYSERIAL(qryserial)
- Specifies the EBCDIC serial number of the storage control being
queried. QRYSERIAL is required when OPENDVCS(YES) is specified.
- QRYLSS(qrylss)
- Specifies the hexadecimal logical subsystem number (LSS) that
contains the Open System device being queried. QRYLSS is required
when OPENDVCS(YES) is specified.
- QRYDVC(qrydvc)
- Specifies the hexadecimal logical unit number (LUN) of the Open
System device being queried. QRYDVC is required when OPENDVCS(YES)
is specified.
- OPENDVCS(NO |
YES)
- Indicates if the request is for Open System (fixed block) devices.
- NO
- The device specified with DEVN, as well as the primary and secondary
devices, are CKD devices. This is the default.
- YES
- The values supplied for the primary and secondary devices (SSID,
Serial, LSS and LUN) apply to Open Systems devices and not to the
CKD DEVN device. The DEVN parameter identifies a CKD device used for
receiving the request.
- FORMAT(LONG |
PQMAP)
- Specifies the content of the PQUERY output.
- LONG
- All fields in the PQUERY output will be filled with relevant information
as available. This is the default.
- PQMAP
- The data is not to be formatted. The sample
ANTPREXX will display query information as in a dump formatter when
QRYINFO returns hexadecimal data.
For more information, see FORMAT.
- BITMAP(YES | NO)
- Specifies whether the bitmap for the primary device should be
accessed when determining the percentage of synchronization for a
pending or suspended pair.
- YES
- PPRC will read the bitmap for the primary volume that is specified
by DEVN, or by QRYDVC when OPENDVCS(YES) is also specified. This
is the default.
- NO
- PPRC will not read the bitmap
- PATHS(NO | YES | LNK)
- Specifies whether the query should display the pathing information
for the pair that is queried.
- NO
- PPRC will display the status of the volume specified by DEVN,
or by QRYDVC when OPENDVCS(YES) is also specified. This is the default.
- YES
- PPRC will display all of the paths associated with the application
site storage control, and the status of each path
- LNK
- PPRC displays all of the potential connectivity of the Fibre Channel
ports in the storage control specified by the DEVN parameter to each
system adapter port in the storage control specified by the SWWNN
or SDEVNUM parameter. If a device specified by SDEVNUM is the secondary
of an established PPRC pair, the query will fail. The exception to
this rule is if the secondary device is also the primary device of
another PPRC pair (cascading). Either SWWNN or SDEVNUM is required.
- SWWNN(swwnn)
- Specifies the hexadecimal world wide node name (WWNN) of the secondary
storage control. SWWNN is mutually exclusive with SDEVNUM.
- SDEVNUM(sdevnum)
- Specifies a hexadecimal device number in the secondary storage
control. SDEVNUM is mutually exclusive with SWWNN.
- WAITTIME(waittime | 0)
- Specifies the number of seconds that SDM must wait for a request
to complete. A value of zero specifies that the request should not
be timed. Valid values are 0 through 65535. The default is 0.
- 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 supported by the host system's processor
and configured for the device.
If you omit the parameter, the command
is issued to the device that is 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.
- SSUBCHSET (ssubchset | 0)
- Specifies the subchannel set for the secondary device specified
with the SDEVN parameter. The subchannel set is the subchannel set
as defined in the Hardware Configuration Dialog (HCD). The values
are determined by what is supported by the host system's processor
and configured for the device.
If you omit the parameter, the command is issued to the device
that is 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.)