- ,DEVN=devn
- ,VOLSER=volser
- ,UCBPTR=ucbptr
- One of the following three input parameters is required:
- ,DEVN=devn
- A parameter field containing the binary device number of the
device you are interested in.
To code: Specify
the RS-type address, or address in register (2)-(12), of a 2-byte
field.
- ,VOLSER=volser
- A parameter field containing the volume serial of the device
you are interested in.
To code: Specify the
RS-type address, or address in register (2)-(12), of a 6-byte field.
- ,UCBPTR=ucbptr
- A parameter field containing the UCB address of the device you
are interested in.
To code: Specify the RS-type
address, or address in register (2)-(12), of a fullword field.
- ,BASICSIZE=basicsize
- A required input field that indicates the size of the area that
BASICINFO refers to. The minimum size that can be specified is the
length of PSL10_HEADER (see BASICINFO).
To code: Specify
the RS-type address of a halfword field, or register (2)-(12).
- ,BASICINFO=basicinfo
- A required output parameter field that is used to contain the
result of the query for the device you are interested in. The information
is described in mapping macro ANTPSL10, which is included as part
of Snapshot support. If the field is large enough to hold all of the
data, PSL10_DATA_USED tells how much data was returned. If the field
is not large enough, PSL10_DATA_TRUNC is turned on, PSL10_DATA_USED
tells how much space was required, and a return code of RQST_SDVCINFO_BASICSIZE_TOO_SMALL
(see ANTRQSTL) is placed in the return code part of RETINFO.
The
optional ALET parameter can be used to specify the location of the
BASICINFO field.
To code: Specify the
RS-type address of a variable-length field, or register (2)-(12).
- ,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 BASICINFO and EXTNDINFO fields have 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.
- ,EXTNDSIZE=extndsize
- ,EXTNDSIZE=0
- An optional input field that indicates the size of the area
that EXTNDINFO refers to. The minimum size that can be specified is
the length of PSL11_HEADER (see EXTNDINFO). The default is 0.
To code: Specify the RS-type address, or address
in register (2)-(12), of a halfword field.
- ,EXTNDINFO=extndinfo
- An optional output field used to contain the extended information
for the device you are interested in. The information is described
in mapping macro ANTPSL11, which is included as part of Snapshot support.
If the field is large enough to hold all of the data, PSL11_DATA_USED
tells how much data was returned. If the field is not large enough,
PSL11_DATA_TRUNC is turned on, PSL11_DATA_USED tells how much space
was required, and a return code of RQST_SDVCINFO_EXTNDSIZE_TOO_SMALL
(see ANTRQSTL) is placed in the return code part of RETINFO.
The
optional ALET parameter can be used to specify the location of the
EXTNDINFO field.
To code: Specify the
RS-type address, or address in register (2)-(12), of a variable-length
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.