- ,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=pserialno
- An optional input parameter field containing the EBCDIC serial
number of the primary storage subsystem. This parameter field contains
12 characters. The serial number must be right justified in the field,
and padded on the left with character zeros as needed. This parameter
is required if the PWWNN parameter is not specified. If this
parameter field is set to binary zero, the PSERIAL parameter
is treated as omitted.
If the PSERIAL parameter is specified, the
SSERIAL parameter must be specified. If the PSERIAL and SSERIAL parameters
are specified, the PWWNN and SWWNN parameters cannot be specified.
To
code: Specify the RS-type address, or address in register (2)-(12),
of a 12-character field.
- ,PWWNN=pwwnn
- An optional input parameter field containing the WWNN of the primary
storage subsystem. This parameter field is 8 bytes in length. This
parameter is required if the PSERIAL parameter is not specified.
If this parameter field is set to binary zero, the PWWNN parameter
is treated as omitted.
If the PWWNN parameter is specified, the
SWWNN parameter must be specified. If the PWWNN and SWWNN parameters
are specified, the PSERIAL and SSERIAL parameters cannot be specified.
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 subsystem. When removing a path between
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=sserialno
- An optional parameter field containing the EBCDIC serial number
of the recovery storage control. This parameter field contains 12
characters. The serial number must be right justified in the field,
and padded on the left with character zeros as needed. This parameter
is required if the SWWNN parameter is not specified. If this parameter
field is set to binary zero, the SSERIAL parameter is treated
as omitted.
If the SSERIAL parameter is specified, the PSERIAL
parameter must be specified. If the PSERIAL and SSERIAL parameters
are specified, PWWNN and SWWNN parameters cannot be specified.
To
code: Specify the RS-type address, or address in register (2)-(12),
of a 12-character field.
- ,SWWNN=swwnn
- An optional input parameter field containing the WWNN of the recovery
storage control. This parameter field is 8 bytes in length. This parameter
is required if the SSERIAL parameter is not specified. If this
parameter field is set to binary zero, the SWWNN parameter
is treated as omitted.
If the SWWNN parameter is specified, the
PWWNN parameter must be specified. If the PWWNN and SWWNN parameters
are specified, the PSERIAL and SSERIAL parameters cannot be specified.
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 removing a path between
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 binary 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-byte 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 | 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 7160 (RQST_PDELPATH_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.
- ,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.