- ,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 device(s) being
suspended (primary or secondary).
To code: Specify
the RS-type address, or address in register (2)-(12), of a 2-byte
field.
- ,PRIMARY=primary
- ,PRIMARY=NO
- An optional input parameter field containing a keyword that indicates
ICKDSF media maintenance is wanted. 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 the request
is a normal suspend.
YES directs PPRC to suspend the
PPRC volume pair and to reject all write data I/O to the primary volume
except for ICKDSF media maintenance channel programs.
The default
is NO.
To code: Specify the RS-type address, or address
in register (2)-(12), of a 3-character field.
- ,QUIESCE=quiesce
- ,QUIESCE=NO
- An optional input parameter field containing a keyword that directs
PPRC to suspend the PPRC volume and to send a "state change pending" indication
to the system to prevent issuance of any application system I/O. 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 quiesce is not wanted.
YES indicates quiesce is
wanted.
The default is NO.
To code: Specify the
RS-type address, or address in register (2)-(12), of a 3-character
field.
- ,PCCA=pcca
- A required input parameter field containing the binary channel
connection address of the primary 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 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 hexadecimal 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-character 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
- ,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 7180 (RQST_PSUSPEND_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.