Use request type QHA to query a device and determine where path
groups are established. The device is considered online where path
groups are established. This might be useful, for example, when a
FlashCopy or Peer-to-Peer Remote Copy establish command fails due
to an online target.
This invokes ANTRQST ILK=ESSRVCS REQUEST=QHA.
- DEVN(devn)
- Specifies the MVS device number to which the command is to be
issued.
- ,CCA(cca)
- Specifies the 2-digit hexadecimal value of the CCA for the device
to be queried. It is required if you specify TGTUCB(NO) and ignored
otherwise.
- ,LSS(lss)
- Specifies the 2-digit hexadecimal value of the LSS that is to
be queried. It is required if you specify TGTUCB(NO) and ignored otherwise.
- 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.
- SUBCHSET(subchset)
- 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.
- TGTUCB(YES | NO)
- Specifies whether the query results are requested for a FlashCopy
device with no target UCB. The values are:
- YES
- Indicates that the query results are requested for the device
specified by DEVN. The LSS and CCA keywords are ignored. YES is the
default.
- NO
- Indicates that LSS and CCA keywords should be used to identify
the device to be queried. You must also use the DEVN keyword to specify
a device within the same SFI as the device to be queried.