Use request type PSETCHAR to set the characteristics of a PPRC volume pair, including whether the
pair is to be used for a Preserve Mirror function in a Multi-Target Mirror configuration. This invokes ANTRQST ILK=PPRC
REQUEST=PSETCHAR.
- DEVN(devn)
- Specifies the binary device number to be used for I/O. It is required. 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..
- PCCA(pcca)
- Spepcifies the binary channel connection address of the primary device. It is required. For open
(fixed block) devices, this specifies the logical unit number (LUN).
- PSERIAL(pserial)
- Specifies the EBCDIC serial number of the primary storage control. It is required.
- PLSS(plss)
- Specifies the binary logical subsystem number (LSS) within the primary storage subsystem. It is
required.
- PSSID(pssid)
- Specifies the hexadecimal subsystem identifier (SSID) of the primary storage control. It is
required.
- SCCA(scca)
- Specifies the binary channel connection address of the secondary device. It is requried. For
open (fixed block) devices, this specifies the logical unit number (LUN).
- SSERIAL(sserial)
- Specifies the EBCDIC serial number of the secondary storage control. It is required.
- SLSS(slss)
- Specifies the binary logical subsystem number (LSS) within the secondary storage subsystem. SLSS
is required.
- OPENDVCS(NO | YES)
- Indicates if the request is for Open System (fixed block) devices.
- NO
- 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.
- YES
- Is the same as omitting the OPENDVCS keyword. This value indicates the DEVN device and primary
and secondary devices are CKD devices. This is the default.
- USEFORPM(NO | YES)
- Specifies whether the indicated pair is to be used for a Preserve Mirror function in a Multi-Target Mirror configuration. One and only one pair from a PPRC
primary can have this enabled or Preserve Mirror Required (Remote Pair FlashCopy) functions will
fail due to ambiguous settings.
- NO
- This pair is not to be used for a Preserve Mirror function in a Multi-Target Mirror configuration. This is the default.
- YES
- This pair is to be used for a Preserve Mirror function in a Multi-Target Mirror configuration.
- WAITTIME(waittime | 0)
- Specifies 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 7039 (RQST_WAITTIME_EXPIRED, refer to ANTRQSTL) or 7200 (RQST_PESTPAIR_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.
- SUBCHSET(subchset)
- subchset is a 1-character field that specifies the subchannel set for the device where
the command is to be issued. This is the subchannel set as defined in the Hardware Configuration
Dialog (HCD). Valid values are:
- 0
- Subchannel set 0. This is the default.
- 1
- Subchannel set 1
- 2
- Subchannel set 2
- 3
- Subchannel set 3.
If you omit this keyword, the command is issued to the default device that is logically in
subchannel set 0. If a swap has occurred, this could be the device that was physically defined in an
alternate subchannel set. This is the default.