- ,QRYSIZE=qrysize
- A required input parameter field that tells how big the area
is that QRYINFO refers to. The minimum size that can be specified
is the length of PSL20_HEADER (see QRYINFO).
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 information is described in mapping
macro ANTPSL20, which is included as part of Snapshot support. If
the field is large enough to hold all of the data PSL20_DATA_USED
will tell how much data was returned. If the field was not large
enough, PSL20_DATA_TRUNC will be turned on, PSL20_DATA_USED will tell
how much space was required, and a return code of RQST_SQRYDVCS_QRYSIZE_TOO_SMALL
(see ANTRQSTL) will be placed in the return 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. See the
coding example SDM API usability guide about how to coordinate the RETCODE,
RSNCODE, and RETINFO fields.
To code: Specify
the RS-type address, or address in register (2)-(12), of a 100-character
field.
- ,ALET=alet
- ,ALET=0
- An optional input parameter field that specifies the ALET value
to be used 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.
- ,SSFILTER=ssfilter
- ,SSFILTER=NO_FILTER
- An optional input parameter field containing a filter to be
used in determining what subsystem names to return. If this parameter
is not specified, or the value in SSFSIZE is zero, all subsystem names
will be returned. The rules for filter patterns are in item Character filtering. The default is NO_FILTER.
To
code: Specify the RS-type address, or address in register (2)-(12),
of a character field.
- ,SSFSIZE=ssfsize
- When SSFILTER=ssfilter is specified, a required input
parameter field that tells how big the area is that SSFILTER refers
to. If the value in the field is zero filtering will not be done.
To code: Specify the RS-type address, or address
in register (2)-(12), of a halfword 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 parameter field containing how long in seconds
SDM will wait for a request to complete. A value of zero says to
not time the request. If the time expires before the request is complete
a value of RQST_WAITTIME_EXPIRED (see ANTRQSTL) will be returned.
If the request is a synchronous request the value will be placed in
the RTNCODE field. If the request is an asynchronous request the value
will be used as the ECB post code. The default is 0.
To
code: Specify the RS-type address, or address in register (2)-(12),
of a halfword field.