Use request type FCQUERY to query a FlashCopy® relationship. This invokes ANTRQST
ILK=ESSRVCS REQUEST=FCQUERY.
- DEVN(devn)
- Specifies the hexadecimal device number of a local CKD device
that will be used for the query request. DEVN is required.
When
querying a local device, this specifies the 4–digit hexadecimal device
number of the device being queried.
When querying a local
fixed block device (OPENDVCS(YES) is specified), DEVN specifies a
CKD access volume located in the same subsystem cluster as the fixed
block device identified by the QRYDVC keyword.
When querying
a remote fixed block device (both OPENDVCS(YES) and REMOTE(YES) are
specified), DEVN specifies a CKD access volume located in the same
subsystem cluster as the PPRC primary device that is paired with the
PPRC secondary device that is being queried.
When querying
a remote CKD device (REMOTE(YES) is specified), DEVN specifies a PPRC
primary device that is paired with the PPRC secondary device that
is being queried.
- QRYINFO()
- Creates the data area where the query information is to be returned.
This area is the size specified with the QRYSIZE keyword. QRYINFO
is required.
- QRYSIZE(qrysize)
- Specifies the decimal length of the QRYINFO area. It is required.
- QRYSERIAL(qryserial)
- Specifies the 10-digit hexadecimal storage control serial number
for the device being queried. QRYSERIAL is required with REMOTE(YES)
or OPENDVCS(YES).
- QRYLSS(qrylss)
- Specifies the 2-digit hexadecimal logical subsystem number for
device being queried. QRYLSS is required with REMOTE(YES) or OPENDVCS(YES).
- QRYDVC(qrydvc)
- Specifies the 2-digit hexadecimal value for the device being queried,
either the connection address or the logical unit number. QRYDVC is
required with REMOTE(YES) or OPENDVCS(YES).
- QRYSSID(qrydvc)
- When REMOTE(YES) is specified without OPENDVCS(YES), this keyword
specifies the 4-digit hexadecimal value for subsystem for the device
being queried. This must be the same value as that specified for SSID
on the PPRC secondary volume on the PPRC establish pair command.
- OPENDVCS(NO | YES)
- Specifies whether Open System (fixed block) devices or CKD devices
are addressed by this command.
- NO
- The parameters identify a CKD device. This is the default.
- YES
- The parameters (QRYSERIAL, QRYLSS, QRYDVC) identify a fixed block
device using a CKD access device.
- REMOTE(NO | YES)
- Specifies whether the request is for a subsystem that is not directly
attached to the issuing processor.
- NO
- The request is directed to a device on a subsystem locally attached
to the issuing processor. This is the default.
- YES
- The request is directed to a remote subsystem using inband subsystem
functions.
When specifying an inband request for a CKD secondary
device, DEVN must identify a PPRC primary device in a subsystem accessible
by the host processor issuing the request, and the device being queried
must be the PPRC secondary of that DEVN.
When specifying an
inband request for an Open System (fixed block) secondary device,
DEVN must identify an online CKD device located in the same subsystem
cluster as the fixed block device of the PPRC primary paired with
the secondary being queried.
- FORMAT(NO | FQMAP)
- Specifies the format of the data returned in RETINFO.
- NO
- Message format, delimited by commas. This is the default. For
information on the data returned, see the description of messages
ANTF0095I and ANTF0425I in z/OS MVS System Messages, Vol 1 (ABA-AOM).
- FQMAP
- The data returned is in hexadecimal format, mapped by macro ANTFQMAP.
It will need to be interpreted by the calling script or program and
is not printable. If the RETINFO area is printed, (returned in variable
RESULT) the printed data would appear as ‘……..’.
The
data returned is the EBCDIC hexadecimal interpretation of the data
mapped by macro ANTFQMAP in variable RESULTX. This information will
need to be interpreted by the calling script or program, but will
contain printable characters.
The sample ANTFREXX
will display query information as in a dump formatter when QRYINFO
returns hexadecimal data. +00000000 C1D5E3C6 D8D4C1D7 01010000 00000000 000000BC 00000068 00000010 00000000 *ANTFQMAP.....................
+00000020 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 *.............................
+00000040 0F450000 C8004000 F0F0F0F0 F0F0F0F0 F1F6F9F1 00000000 F2F1F0F7 A8000000 *....H. .000000001691....2107y
+00000060 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 *.............................
+00000080 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 *.............................
+000000A0 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000002 *.............................
+000000C0 2C000000 00000002 00000000 00402000 00000000 C800C800 00001DF3 00010009 *............. ......H.H....3.
+000000E0 02010009 00001DF3 4A09FEE1 4A09FEE1 00000000 00000000 0040A000 00000000 *.......3................. ...
+00000100 C800C800 00001DF3 00010009 02010009 00001DF3 4A09FEE1 4A09FEE1 00000000 *H.H....3...........3.........
+00000120 00000000 00000002 0000413B 00020200 00000000 *....................
- WAITTIME(waittime | 0)
- Specifies how long in seconds SDM will wait for a request to complete.
A value of zero specifies that the request should not be timed.
If the time expires before the request is complete, the program
returns a return code of 7039 (RQST_WAITTIME_EXPIRED). For more information
about RQST_WAITTIME_EXPIRED, refer to the ANTRQSTL macro.
- 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.