- ,DEVN=devn
- A required input parameter field containing the binary device
number to use for I/O.
To code: Specify the RS-type address,
or address in register (2)-(12), of a 2-byte field.
- ,PSERIAL=pserial
- A required input parameter field containing the EBCDIC serial
number of the primary storage control.
To code: Specify
the RS-type address, or address in register (2)-(12), of a 12-character
field.
- ,PSSID=pssid
- A required input parameter field containing the binary subsystem
ID of the primary storage control. When stopping updates to open
device logical subsystems, this value should be specified as X'FFFF'.
To
code: Specify the RS-type address, or address in register (2)-(12),
of a 2-byte field.
- ,SSERIAL=sserial
- A required input parameter field containing the EBCDIC serial
number of the secondary storage control.
To code: Specify
the RS-type address, or address in register (2)-(12), of a 12-character
field.
- ,SSSID=sssid
- A required input parameter field containing the binary subsystem
ID of the secondary storage control. When stopping updates to
open device logical subsystems, this value should be specified as X'FFFF'.
To
code: Specify the RS-type address, or address in register (2)-(12),
of a 2-byte 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.
- ,PLSS=plss,PLSS=NO_PLSS
- An optional input parameter field containing the hexadecimal logical
subsystem number within the primary storage subsystem. This keyword
is required for storage subsystems with logical subsystems and is
invalid for 3990 and other 3990–compatible storage controls.
NO_PLSS Specifying
this value is the same as omitting the PLSS keyword.
The default
is NO_PLSS.
To code: Specify the RS-type address, or
address in register (2)-(12), of an optional 1-character field.
- ,SLSS=slss,SLSS=NO_SLSS
- An optional input parameter field containing the binary logical
subsystem number within the secondary storage subsystem. This keyword
is required for storage subsystems with logical subsystems and is
invalid for 3990 and other 3990–compatible storage controls.
NO_SLSS Specifying
this value is the same as omitting the SLSS keyword.
The default
is NO_SLSS.
To code: Specify the RS-type address, or
address in register (2)-(12), of an optional 1-byte 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.
- ,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.