Use request type PESTPAIR to establish a PPRC volume pair. This
invokes ANTRQST ILK=PPRC REQUEST=PESTPAIR.
- DEVN(devn)
- Specifies the hexadecimal device number to be used for I/O. This
device number must identify a CKD device defined to the host system
making the request. It is required.
- PCCA(pcca)
- Specifies the hexadecimal channel connection address (CKD device
CCA) or logical unit number (fixed block device LUN) of the primary
device. It is required.
- PLSS(plss)
- Specifies the hexadecimal logical subsystem number (LSS) within
the primary storage subsystem. PLSS is required for storage subsystems
with logical subsystems and is invalid for 3990 and other 3990-compatible
storage controls.
- PSERIAL(pserial)
- Specifies the EBCDIC serial number of the primary storage control.
It is required.
- PSSID(pssid)
- Specifies the hexadecimal subsystem identifier (SSID) of the primary
storage control. It is required.
- SCCA(scca)
- Specifies the hexadecimal channel connection address (CKD device
CCA) or logical unit number (fixed block device LUN) of the secondary
device. It is required.
- SLSS(slss)
- Specifies the hexadecimal logical subsystem number (LSS) within
the secondary storage subsystem. SLSS is required for storage subsystems
with logical subsystems and is invalid for 3990 and other 3990-compatible
storage controls.
- SSERIAL(sserial)
- Specifies the EBCDIC serial number of the secondary storage control.
It is required.
- SSSID(sssid)
- Specifies the hexadecimal subsystem identifier (SSID) of the secondary
storage control. It is required.
- ACTION(FAILOVER | FAILBACK| MTFAILOVER)
- Specifies that an action is to be taken on an already existing
volume pair. This is mutually exclusive with MODE(INCRES) and INCRESYNC(START
| STOP).
- FAILOVER
- The direction of the PPRC pair is to be reserved and change recording
is to begin. Upon completion of the command, the specified primary
device will be a suspended primary of a PPRC pair. Be sure to reverse
devices when specifying primary and secondary values.
- FAILBACK
- The failure condition at the primary site has been resolved and
that the changes that have taken place at the recovery site since
the FAILOVER command was issued should now be copied to the original
primary site.
- MTFAILOVER
- Specifies that a multi-target configuration should be created from a
cascaded configuration. For example, in a cascaded configuration, H1->H2->H3, where H1 is the
primary, issuing a CESTPAIR command with ACTION(MTFAILOVER) to the middle device, H2, causes a
multi-target configuration (H2->H1 and H2-H3) in place of the previous cascaded failover
state.
For more information, see Failover/Failback in a PPRC environment.
- AUTORESYNC(YES |
NO)
- Specifies whether the auto resynchronization capability is to
be enabled for a global copy pair.
- NO
- Auto resynchronization is disabled for this volume pair
- YES
- Auto resynchronization is enabled for this volume pair. This is
the default.
- CASCADE(NO | YES)
- Indicates this request should identify the devices as part of
a cascading PPRC pair.
- NO
- Primary and secondary devices are marked as not cascading capable.
This is the default.
- YES
- Primary and secondary devices are marked as cascading capable
- CRIT(NO | YES)
- Indicates whether this is a critical volume.
- NO
- If an I/O error occurs, subsequent write requests to the PPRC
primary device are allowed. This is the default.
- YES
- If an I/O error occurs, writes to the primary device are either
allowed or not allowed, based on the 3990 maintenance panel VPD bit
setting or the CGROUP selection on the PPRC establish pair command
CRIT is mutually exclusive with OPTION(XD).
- FORCE(NO | YES)
- Specifies whether validation of the volumes involved in a MODE(INCRES)
should occur or be bypassed.
- NO
- Fail processing if the secondary device is online to a host system.
This is the default.
- YES
- Continue establish pair processing when the secondary device is
online to a host system
This parameter is valid only when MODE(INCRES)
is specified.
- INCRESYNC(START | STOP | NOCOPY)
- Specifies whether the incremental resync change recording mechanism
for Metro/Global Mirror should be enabled.
- START
- Start the change recording mechanism
- STOP
- Stop the change recording mechanism
- NOCOPY
- Used in recovery scenarios, when the incremental resync change
recording mechanism needs to be started. The assumption is that the
local and remote volumes involved in the cascading relationship are
identical; therefore, the bitmaps used are not initialized with a
full copy.
INCRESYNC(START) and INCRESYNC(STOP) are mutually
exclusive with ACTION(FAILOVER), ACTION(FAILBACK) and MODE(INCRES).
- MODE(COPY | NOCOPY
| RESYNC | INCRES)
- Specifies how a volume pair is to be set up.
- COPY
- Copy all tracks on the primary volume to the secondary volume.
This is the default.
- NOCOPY
- Copy to the secondary volume only those tracks on the primary
volume that are updated after this request is processed
- RESYNC
- Reestablish a suspended copy and copy to the secondary volume
any tracks updated since the suspension
- INCRES
- Requests an incremental resynchronization using the change recording
bitmaps. MODE(INCRES) is mutually exclusive with ACTION(FAILOVER |
FAILBACK) and INCRESYNC(START | STOP).
- MSGREQ(NO | YES)
- Indicates whether this request should wait for the initial copy
of a volume to complete.
- NO
- Processing should continue without waiting for the initial volume
copy to complete. This is the default.
- YES
- Processing should wait for the initial volume copy to complete.
- ONLINSEC(NO | YES)
- Specifies whether establish pair processing should continue if
the secondary device is online to a host system.
- NO
- Fail processing if the secondary device is online to a host system.
This is the default.
- YES
- Continue establish pair processing when the secondary device is
online to a host system
- OPENDVCS(NO | YES)
- Indicates if the request is for Open System (fixed block) devices.
- NO
- The device specified with DEVN, as well as the primary and secondary
devices, are CKD devices. This is the default.
- YES
- The values supplied for the primary and secondary devices (SSID,
Serial, LSS and LUN) apply to Open Systems devices and not the CKD
DEVN device. The DEVN parameter identifies a CKD device used for receiving
the request.
- OPTION(SYNC | XD)
- Indicates whether PPRC should copy tracks to the secondary volume
prior to updating the primary volume.
- SYNC
- Changed tracks should be copied to the secondary volume before
the updates are written to the primary volume. This is the default.
- XD
- PPRC should record track changes to the primary volume in a bitmap.
At intervals determined by the subsystem, PPRC will copy all changed
primary volume tracks to the secondary volume. The tracks are copied
in bitmap order, not necessarily in the order they were updated on
the primary volume.
- PACE(pace)
- Specifies the minimum number of tracks to be copied at one time
before allowing another host to interrupt. This parameter is used
only for 3990 storage controls.
- RESETRSV(NO | YES)
- Specifies whether an existing reserve on the specified fixed block
secondary device should be reset (removed) by the control unit during
the establish pair processing.
- NO
- Any reserve that exists on the specified secondary device should
not be reset. This is the default.
- YES
- If there is a reserve on the specified secondary device, that
reserve should be reset.
- SETGTOK(NO | YES)
- Specifies whether a secondary can be a space efficient volume
for this request.
- NO
- A space efficient volume will not be used as a PPRC secondary
device. This is the default.
- YES
- A space efficient volume may be used as a PPRC secondary device
on this request
- WAITTIME(waittime | 0)
- Specifies the number of seconds that SDM must wait for a request
to complete. A value of zero specifies that the request should not
be timed. Valid values are 0 through 65535. The default is 0.
- 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 supported by the host system's processor
and configured for the device.
If you omit the parameter, the command
is issued to the device that is 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.