- ,ALET=alet | 0
- Is an optional parameter input field that specifies the ALET value
to use if the QRYINFO field has an ALET value different from the one
associated with the caller.
The default is 0.
To code: Specify
the RS-type name, or address in register (2)-(12), of a fullword field.
- ,CCA=cca
- Is an optional input parameter field that specifies the 2-digit
hexadecimal value of the CCA for the device to be queried. The default
is 00 (no CCA). It is required if you specify TGTUCB=NO, and ignored
otherwise.
To code: Specify the RS-type address, or address
in register (2)-(12), of a 1-character field.
- ,ECB=ecb
- ,ECB=NO_ECB
- Is an optional fullword input field that SDM posts for an asynchronous
request. The name of the input field is a name (RS-type) or address
in register (2)-(12). The program ignores this field for synchronous
requests.
The default is NO_ECB.
- ,LSS=lss
- Is an optional input parameter field that specifies the 2-digit
hexadecimal value of the LSS that is to be queried. The default is
00 (no LSS). It is used only if you specify TGTUCB=NO.
To code: Specify
the RS-type address, or address in register (2)-(12), of a 1-character
field.
- ,QRYINFO=qryinfo
- specifies the name of a variable-character output field that returns
the result of the query.
If the field is not big enough to contain
the complete result, the program places a return code of (RQST_QHA_QRYSIZE_TOO_SMALL)
in the return code part of RETINFO and places the total space required
in the reason code part of RETINFO.
If the field is big enough
to contain the complete result, the program places a return code of
(RQST_QHA_QRYSIZE_BIG_ENOUGH) in the return code part of RETINFO and
places the total amount of space actually used in the reason code
part of RETINFO.
You can use the optional ALET
parameter to specify the location of the QRYINFO field.
If
the channel command is not supported by the storage control where
it was issued, the program places a return code of (RQST_QHA_NOT_SUPPORTED)
in the return code part of RETINFO.
To code: Specify
the RS-type name, or address in register (2)-(12), of a required variable-character
output field.
- ,RETINFO=retinfo
- Is a required 100-character output field that the
program uses to return detailed information about the results of executing the
request. The name of the output field is a name (RS-type) or address
in register (2)-(12). The program returns information about the
results of scheduling the request in the RETCODE and RSNCODE
fields. Align the area on a word boundary. The first 4 bytes contain
the return code. The second 4 bytes contain the reason code. The remainder
of the information depends on the return and reason codes. See the
coding example about how to coordinate the RETCODE, RSNCODE, and
RETINFO fields.
- ,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.
- ,TGTUCB=tgtucb
- ,TGTUCB=YES
- specifies whether the query results
are requested for a FlashCopy device with no target UCB.
- 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.
To code: Specify the RS-type address,
or address in register (2)-(12), of a 3-character field.
- ,WAITTIME=waittime | 0
- Is an optional halfword input field that contains how long in
seconds SDM waits for a request to complete. The name of the input
field is a name (RS-type) or address in register (2)-(12). A value
of zero specifies the requests should not be timed. If the time expires
before the request completes, the program returns a value of 7039
(RQST_WAITTIME_EXPIRED). For information about RQST_WAITTIME_EXPIRED,
see ANTRQSTL. If the request is a synchronous request, the program
places the value in the return code part of RETINFO. If the request
is an asynchronous request, the program uses the value as the ECB
post code.
The default is 0.