resumepprc

The resumepprc command resumes a remote mirror and copy (formerly PPRC) relationship for a volume pair.

Read syntax diagramSkip visual syntax diagram
>>-resumepprc--+-------------------------+---------------------->
               '- -dev--storage_image_ID-'   

>--+-------------------------------+-- -type--+-mmir-+---------->
   '- -remotedev--storage_image_ID-'          '-gcp--'   

>--+-----------+--+-------------+--+-----------+---------------->
   '- -cascade-'  '- -tgtonline-'  '- -tgtread-'   

>--+------------+--+-----------+--+----------------+------------>
   '- -critmode-'  '- -suspend-'  '- -resetreserve-'   

>--+--------+--+----------------+--+----------------+----------->
   '- -wait-'  '- -srcss--ss_ID-'  '- -tgtss--ss_ID-'   

>--+-SourceVolumeID:TargetVolumeID--+-------+-+----------------><
   |                                '-. . .-' |   
   '-" - "------------------------------------'   

Parameters

Notes:
  1. When you specify subsystem IDs, the source and target volumes are restricted to 1 LSS for the source and 1 LSS for the target.
  2. When you use the -wait parameter, periodically issue the lspprc command. This command allows you to verify which of the states that the pair has reached during processing.
  3. You cannot issue other commands while the -wait parameter is processing. The entire transaction must complete before you can proceed with commands other than status commands like list commands or show commands.
-dev storage_image_ID
(Optional) Specifies the source storage image ID, which includes manufacturer, machine type, and serial number. This parameter is required if you do not specify a fully qualified source volume ID.
Example: IBM.1750-68FA120
-remotedev storage_image_ID
(Optional) Specifies the target storage image ID, which includes manufacturer, machine type, and serial number. This parameter is required if you do not specify a fully qualified target volume ID or if you specify the -dev parameter.
-type mmir | gcp
(Required) Modifies one or more remote mirror and copy volume relationships to be either Metro Mirror (synchronous) or Global Copy (extended distance) relationships.
mmir
Metro Mirror processing maintains the remote mirror and copy relationship in a consistent (synchronous) manner when the updates are committed to the target. This process becomes slower as the physical distance between source and target increases.
gcp
Global Copy processing maintains the remote mirror and copy relationship in a nonsynchronous manner when the updates are committed to the source. Updates to the target volume are performed at a later point in time. The original order of updates is not strictly maintained.
-cascade
(Optional) Enables a remote mirror and copy target volume to be a remote mirror and copy source volume for a different remote mirror and copy volume relationship.
-tgtonline
(Optional) Establishes a remote mirror and copy volume relationship, including when the target volume is online to host systems. This parameter applies to S/390 or zSeries volumes. It does not apply to Open Systems volumes.
-tgtread
(Optional) Allows host servers to read from the remote mirror and copy target volume. For a host server to read the volume, the remote mirror and copy pair must be in a full-duplex state. This parameter applies to open systems volumes and does not apply to IBM S/390 or zSeries volumes. The default value for this parameter is disabled.
-critmode
(Optional) Protects the source volume from receiving new data. If the last path fails between the pairs which results in the inability to send information to the target, the source is protected. Current updates and subsequent attempts to update the source fail, with a unit check on S/390.
-suspend
(Optional) Specifies that the remote mirror and copy relationship be suspended when the task completes. This parameter is not valid for a Global Copy (extended distance) remote mirror and copy volume relationship. This parameter is not valid for a Metro Mirror (synchronous) remote mirror and copy volume relationship that is established with the No Copy option.
-resetreserve
(Optional) Establishes the remote mirror and copy relationship when the volume on the secondary logical subsystem is reserved by another host. If this parameter is not specified and the volume on the secondary logical subsystem is reserved, the command fails.
This parameter can only be used with fixed block volumes.
-wait
(Optional). Specifies that the command response be delayed until the remote copy and mirror volumes are in one of the final states: simplex, full duplex, suspended, secondary full duplex, secondary suspended or secondary simplex (until the pair is not in the Copy Pending state). This parameter cannot be used with the -type gcp or -mode nocp parameters.
-srcss SS_ID
(Optional) Specifies the subsystem ID of the primary logical subsystem in the format '0x0001 - 0xFFFF'.
This value is required for the IBM System Storage™ Enterprise Storage Server versions 2.4.0 and 2.4.1.
Example: 0010
-tgtss SS_ID
(Optional) Specifies the subsystem ID of the secondary logical subsystem in the format 0x0001 - 0xFFFF.
This value is required for the IBM System Storage Enterprise Storage Server versions 2.4.0 and 2.4.1.
Example: 0010
SourceVolumeID:TargetVolumeID . . . | -
(Required) Specifies that a remote mirror and copy volume relationship for the source and target volume pairs with the specified IDs be resumed.
This parameter accepts fully qualified volume IDs, which includes storage image IDs or a shortened version without storage image IDs, if the -dev parameter is specified. You must separate multiple remote mirror and copy pair IDs with spaces.
A remote mirror and copy pair ID consists of two volume IDs: one designated as the source and the other as the target volume for a remote mirror and copy relationship. You must separate the two volume IDs of a remote mirror and copy pair ID with a colon and no space. The first volume ID is the source volume. The second volume ID is the target volume.
The volume ID is a 32-bit number that can be represented as 4 hexadecimal digits in the form of XYZZ where X is the address group (0 - 1), XY together is the logical subsystem number 00 - 1E, and ZZ is the volume number (00 - FF).
If you specify the dash (-), this parameter information is automatically supplied.

Example (1750)

Invoking the resumepprc command
dscli>resumepprc -dev IBM.1750-68FA120 
-remotedev IBM.1750-68FA150 0100:0100 
The resulting output
Date/Time: Sun Aug 11 02:23:49 PST 2004 IBM DS CLI Version: 5.0.0.0 
DS: IBM.1750-68FA120

Remote Mirror and Copy volume pair IBM.1750-68FA120/0100:0103
 relationship successfully resumed. This message is being returned 
before the copy completes.
Related reference
mkesconpprcpath
mkpprcpath
rmpprcpath
lspprcpath
lsavailpprcport
mkpprc
failoverpprc
failbackpprc
rmpprc
lspprc
freezepprc
pausepprc
unfreezepprc
Library | Support | Terms of use | Feedback
© Copyright IBM Corporation 2004, 2007. All Rights Reserved.