setremoteflashrevertible

The setremoteflashrevertible command modifies a remote FlashCopy volume pair that is part of a Global Mirror relationship to revertible. This command must be run before the FlashCopy pair can be committed or reverted. When a pair is revertible, the data can be committed to the target to form a new consistency group, or it can be reverted back to the last consistency group.


>>-setremoteflashrevertible--+-------------------------+-- -conduit--LSS_ID-->
                             '- -dev--storage_image_ID-'                      

>--+--------------+--+------------------------------+----------->
   '- -tgtoffline-'  '- -seqnum--flash_sequence_num-'   

>--+----------------+------------------------------------------->
   '- -srcss--SS_ID-'   

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

Parameters

Note: The -nocp, -record, -persist, and -tgtinhibit (target inhibit) parameters that were specified when the FlashCopy pair was made (mkremoteflash command) are included automatically when the setremoteflashrevertible command processes.

-dev storage_image_ID: (Optional) Specifies the storage image ID, which includes manufacturer, type, and serial number. This parameter is required if you do not specify a fully qualified ID for the source volume or you do not specify a value for the devid variable in your profile file.
-conduit LSS_ID: (Required) Specifies the source logical subsystem (LSS) of an existing remote mirror and copy relationship that is to be used as a passage for communicating with the remote storage image. The source volume IDs that are specified in SourceVolumeID:TargetVolumeID must serve as secondary volumes in a remote mirror and copy relationship in which one of the passage LSS volumes serves as a primary volume.; When you use this parameter, you must specify a fully qualified LSS ID. The fully qualified LSS ID format is storage_image_ID/XX, where XX is a hexadecimal number in the range 00 - 1F (1750 only).
-tgtoffline: (Optional) Causes an establish FlashCopy volume pair command to be rejected if the target volume ID is online for host system access.; This parameter applies only to CKD volumes.
-seqnum flash_sequence_num: (Optional) Associates the remote FlashCopy relationships that are changed with the specified sequence number. Only the relationships that are successfully modified by the command get the specified sequence number, leaving the ones that failed with the previous number (if previously specified).; Example: 0010; This parameter is not supported for machine type 2105.
-srcss SS_ID: (Optional) Specifies the subsystem ID of the source logical subsystem at the remote site. The ID is 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: FF10
SourceVolumeID:TargetVolumeID . . . | -: (Required) Specifies that the remote FlashCopy relationships for the designated source and target volume pairs be modified.; 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 FlashCopy pair IDs with spaces.; A FlashCopy pair ID consists of two volume IDs, one designated as the source and the other as the target volume for a FlashCopy relationship. You must separate the two volume IDs of a FlashCopy 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 (for 1750) , and ZZ is the volume number (00 - FF).; If you specify the dash (-), this parameter information is automatically supplied.; Example of a fully qualified FlashCopy pair ID: IBM.1750-75FA120/0001:IBM.1750-75FA120/0004; Example of a shortened version: 0001:0004; Example of multiple pairs: 0001:0004 0003:00FF 0008:000C

Example (1750)

Invoking the setremoteflashrevertible command

dscli>setremoteflashrevertible -dev IBM.1750-68FA120 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 FlashCopy pair 0100:0200 successfully made revertible.