- ,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 PSL30_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 ANTPSL30, which is included as part of Snapshot support. If
the field is large enough to hold all of the data PSL30_DATA_USED
will tell how much data was returned. If the field was not large
enough, PSL30_DATA_TRUNC will be turned on, PSL30_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 subsystems the devices being listed may come
from. If this parameter is not specified, or the value in SSFSIZE
is zero, subsystem names will not be considered when determining device
eligibility. 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.
- ,VLFILTER=vlfilter
- ,VLFILTER=NO_FILTER
- An optional input parameter field containing a filter to be
used in determining what volumes the devices being listed may come
from. If this parameter is not specified, or the value in VLFSIZE
is zero, volume serial numbers will not be considered when determining
device eligibility. 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.
- ,VLFSIZE=vlfsize
- When VLFILTER=vlfilter is specified, a required input
parameter field that tells how big the area is that VLFILTER 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.
- ,LOWDEVN=lowdevn
- , LOWDEVN=NO_DEVN
- An optional input parameter field containing the low binary
device number of a range of devices you are interested in. If the
field contains binary zeros, the program uses the default. The default
is NO_DEVN.
To code: Specify the RS-type
address, or address in register (2)-(12), of a 2-byte field.
- ,HIGHDEVN=highdevn
- When LOWDEVN=lowdevn is specified, a required input
parameter field. It contains the high binary device number of a range
of devices you are interested in.
To code: Specify
the RS-type address, or address in register (2)-(12), of a 2-byte
field.
- ,DEVTYPE=devtype
- ,DEVTYPE=NO
- An optional input parameter field containing a keyword that
indicates whether a device type is to be used as a selection criteria.
The value is left-justified and padded on the right with blanks. If
the field contains binary zeros, the program uses the default.
NO indicates that device type is not to be considered.
3380 indicates that selected devices must have a
device type of 3380.
3390 indicates that
selected devices must have a device type of 3390.
The default
is NO.
To code: Specify the RS-type address,
or address in register (2)-(12), of a 4-character field.
- ,PARTITION=partition
- ,PARTITION=NO
- An optional input parameter field containing a keyword that
indicates whether a RVA partition is to be used as a selection criteria.
The value is left-justified and padded on the right with blanks. If
the field contains binary zeros, the program uses the default.
NO indicates that partition type is not to be considered.
TEST indicates that selected devices must be in
a test partition.
PROD indicates that
selected devices must be in a production partition.
The default
is NO.
To code: Specify the RS-type address,
or address in register (2)-(12), of a 4-character field.
- ,ACCESS=access
- ,ACCESS=NO
- An optional input parameter field containing a keyword that
indicates whether a read/write status is to be used as a selection
criteria. The value is left-justified and padded on the right with
blanks. If the field contains binary zeros, the program uses the default.
NO indicates that read/write status is not to be
considered.
R indicates that selected
devices must be read-only devices.
RW indicates
that selected devices must be read/write devices.
The default
is NO.
To code: Specify the RS-type address,
or address in register (2)-(12), of a 2-character field.
- ,BEGINCYL0=begincyl0
- ,BEGINCYL0=YES
- An optional input parameter field containing a keyword that
indicates devices that do or do not begin on real cylinder 0 are to
be included in the device list. The value is left-justified and padded
on the right with blanks. If the field contains binary zeros, the
program uses the default.
YES indicates that only devices that begin at real cylinder 0 are
eligible to be in the list.
NO indicates
that all devices, whether they begin at real
cylinder 0 (e.g. VM minidisks), are eligible to be in the list.
The
default is YES.
To code: Specify the RS-type
address, or address in register (2)-(12), of a 3-character field.
- ,DEVN=devn
- ,DEVN=NO_DEVN
- ,VOLSER=volser
- ,UCBPTR=ucbptr
- Only one of the following three optional input parameters may
be coded:
- ,DEVN=devn
- A parameter field containing the binary device number of a device.
All devices on the same subsystem as the specified device are eligible
to be in the list. The default is NO_DEVN.
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 volser of a device. All devices
on the same subsystem as the specified device are eligible to be in
the list.
To code: Specify the RS-type address,
or address in register (2)-(12), of a 6-character field.
- ,UCBPTR=ucbptr
- A parameter field containing the UCB address of for a device.
All devices on the same subsystem as the specified device are eligible
to be in the list.
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 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.