- ,DEVN=devn
- A required input parameter field containing the binary
device number to use for I/O. This device must be located in the same
subsystem cluster as the device specified in the QRYLSS and QRYDVC
parameters.
To code: Specify the RS-type address, or address
in register (2)-(12), of a 2-byte field.
- QRYLSS=qrylss
- A required input parameter field that specifies the two-digit
hexadecimal value for the logical subsystem (LSS).
To code: Specify
the RS-type address, or address in register (2)-(12), of a required
1-character field.
- ,QRYSIZE=qrysize
- A required input parameter field that tells how big the area is
that QRYINFO refers to.
To code: Specify the RS-type address,
or address in register (2)-(12), of a halfword field.
- ,QRYINFO=qryinfo
- A required output parameter field to be used to return the result
of the query. The returned data is mapped by mapping macro (DSECT)
ANTPQSCS. If the field is not big enough to contain the complete
result a return code of RQST_PQUERY_QRYSIZE_TOO_SMALL (see ANTRQSTL)
is placed in the return code part of RETINFO, and the total amount
of space required is placed in the reason code part of RETINFO. If
the field is big enough to contain the complete result a return
code of RQST_PQUERY_QRYSIZE_BIG ENOUGH (see ANTRQSTL) is placed in
the return code part of RETINFO, and the total amount of space actually
used is placed in the reason code part of RETINFO.
The optional
ALET parameter may be used to specify the location of the QRYINFO
field.
To code: Specify the RS-type address, or address
in register (2)-(12), of a character field.
- ,RETINFO=retinfo
- A required output parameter field that is used to return detailed
information about the results of executing the request. Information
about the results of scheduling the request are returned in
the RETCODE and RSNCODE fields. Align the area on a word boundary.
The first 4-bytes contain the return code and the second 4-bytes
contain the reason code. The remainder of the information is dependent
on the return and reason codes. For information about how to coordinate
the RETCODE, RSNCODE and RETINFO fields, refer to the coding example
in SDM API usability guide.
To code: Specify
the RS-type address, or address in register (2)-(12), of a 100-character
field.
- ,OPENDVCS=opendvcs
- , OPENDVCS=NO
- An optional input parameter field containing a keyword that indicates
if the request is for Open System (Fixed Block) devices. The value
is left-justified and padded on the right with blanks. If the field
contains binary zeros, the OPENDVCS keyword is treated as omitted.
YES indicates
the query applies to an Open System LSS or device.
NO is
the same as omitting the OPENDVCS keyword. This value indicates the
query applies to a CKD LSS or device.
The default is NO.
To
code: Specify the RS-type address, or address in register (2)-(12),
of an optional 3-character field.
- ,QRYDVC =qrydvc
- An optional input parameter field containing the two-digit hexadecimal
value of the channel connection address (CCA) for the device that
is to be queried. This parameter is required if SCOPE=RANK is specified;
otherwise it is ignored.
To code: Specify the RS-type address,
or address in register (2)-(12), of a required 1-character field.
- ,SCOPE=score
- ,SCOPE=LSS
- An optional input parameter field that specifies the content of
the PQSCSTAT output. The default is LSS.
LSS indicates
that device and LSS summary information only is to be returned.
RANK indicates
that device-specific rank information as well as the LSS and device
summary information are to be returned.
The default is LSS.
To
code: Specify the RS-type address, or address in register (2)-(12),
of a fullword field.
- ,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.
- ,ALET=alet
- ,ALET=0
- An optional input parameter 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 address, or address in register (2)-(12), of a fullword
field.
- ,ECB=ecb
- ,ECB=NO_ECB
- An optional input parameter field that SDM will post for an asynchronous
request. This field is ignored for synchronous requests. The default
is NO_ECB.
To code: Specify the RS-type address, or address
in register (2)-(12), of a fullword field.
- ,WAITTIME=waittime
- ,WAITTIME=0
- An optional input field containing how long in seconds
SDM waits for a request to complete. A value of zero indicates that
the system does not time the request. If the time expires before
the request is complete, a value of 7240 (RQST_PQUERY_ERROR, with
a message ANTP0217E indicating I/O timeout) is returned. If the request
is a synchronous request, the value is placed in the return code part
of RETINFO. If the request is an asynchronous request, the value
is used as the ECB post code. If waittime is
less than five seconds, then SDM changes waittime to
five seconds. If waittime is greater than
255 seconds, SDM changes waittime to 255
seconds.