- ,DEVN=devn
- A required input parameter field containing the binary device
number to use for I/O.
If OPENDVCS=YES is specified, then devn identifies
a System z® device to act
as a CKD access volume. This device must
be located in the same subsystem cluster as the primary device.
To
code: Specify the RS-type address, or address in register (2)-(12),
of a 2-byte field.
- ,PCCA=pcca
- A required input parameter field containing the binary channel
connection address of the primary CKD device. For open (fixed block)
devices, this specifies the logical unit number (lun).
To code: Specify
the RS-type address, or address in register (2)-(12), of a 1-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 OPENDVCS=YES 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.
- ,SCCA=scca
- A required input parameter field containing the binary channel
connection address of the secondary device. For open (fixed block)
devices, this specifies the logical unit number (lun).
To code: Specify
the RS-type address, or address in register (2)-(12), of a 1-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 OPENDVCS=YES 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 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.
- ,OPENDVCS=opendvcs
- ,OPENDVCS=NO
- An optional input parameter field containing a keyword that indicates
if the request is for Open System (Fixed Block) devices. The value
is left-justified and padded on the right with blanks. If the field
contains binary zeros, the OPENDVCS keyword is treated as omitted.
YES Specifying
this value indicates the information for the primary and secondary
devices (SSID, Serial, LSS, and CCA) applies to Open System devices,
not the CKD DEVN device. The CCA value is treated as a Fixed Block
Logical Unit Number (LUN). The DEVN parameter identifies a CKD device
for receiving the request, but is not affected by this PPRC request.
NO Specifying
this value is the same as omitting the OPENDVCS keyword. This value
indicates the DEVN device and primary and secondary devices are CKD
devices.
The default is NO.
To code: Specify
the RS-type address, or address in register (2)-(12), of an optional
3-character 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 | 0
- An optional input parameter 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 7140 (RQST_WAITTIME_EXPIRED with
a message ANTP0217E indicating I/O timeout) is returned. If the request
is an asynchronous request, the value is used as the ECB post code.
If the waittime is less than five seconds, then SDM changes waittime
to five seconds. If the waittime is greater than 255 seconds, SDM
changes waittime to 255 seconds.