rmremoteflash

The rmremoteflash command removes a relationship between remote FlashCopy volume pairs.

Read syntax diagramSkip visual syntax diagram
>>-rmremoteflash--+-------------------------+-- -conduit--LSS_ID--+---------+-->
                  '- -dev--storage_image_ID-'                     '- -quiet-'   

>--+-----------+--+------+-------------------------------------->
   '- -tgtonly-'  '- -cp-'   

>--+---------------------------------+--+----------------+------>
   '- -seqnum--flash_sequence_number-'  '- -srcss--SS_ID-'   

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

Parameters

Notes:
  1. Invoking this command and using the -cp parameter on a FlashCopy relationship that was previously marked with the -persist parameter does not remove the relationship. Instead, the source volume is copied to the target volume.
  2. Invoking this command resets the -tgtinhibit parameter option if it was previously set.
  3. All settings apply to all specified FlashCopy pairs.
  4. The -seqnum parameter is not supported for model 2105.
  5. When SS_IDs are specified, the source volumes are restricted to 1 LSS.
-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 and target volumes 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 (formerly PPRC) relationship that is to be used as a means 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 conduit LSS volumes serves as a primary volume.
This parameter allows the use of a fully qualified LSS ID, which includes the storage image 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).
-quiet
(Optional) Turns off the confirmation prompt for this command.
-tgtonly
(Optional) Specifies only the target volume of the remote FlashCopy pair that you want to remove. In addition, the Copy Indicator for the target volume is reset.
Note: You can use this parameter only with fixed block volumes.
-cp
(Optional) Specifies that the FlashCopy relationship be changed from the No Copy to the Copy mode. Additionally the remaining source volume tracks are copied to the target volume. The relationship is removed when all the data is copied unless the relationship is persistent. When the -cp parameter is specified, the copy is processed for all volume pairs where the source volume ID is identical to the source volume that is specified in the command.
-seqnum flash_sequence_num
(Optional) When a FlashCopy sequence number is specified, the rmremoteflash operation is performed only on those relations that are associated with the specified number.
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. 4. When you specify SS_IDs, the source volumes are restricted to one logical subsystem.
Example: FF10
SourceVolumeID:TargetVolumeID . . . | -
(Required) Specifies the remote FlashCopy relationships for the source and target volume pairs with the specified IDs that are to be removed.
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. When you use the -tgtonly parameter, enter volume IDs. Volume pair IDs cannot be used with the -tgtonly parameter.
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-68FA120/0004
Example of a shortened version: 0001:0004
Example of multiple pairs: 0001:0004 0003:00FF 0008:000C

Example (1750)

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

Are you sure you want to remove the FlashCopy pair 0100:0200? [y/n]: Y

Removal of the remote FlashCopy volume pair 0100:0200 has been initiated
 successfully. Use the lsremoteflash command to determine when the
  relationship is deleted.
Related reference
mkremoteflash
lsremoteflash
setremoteflashrevertible
resyncremoteflash
reverseremoteflash
commitremoteflash
revertremoteflash
mkflash
rmflash
lsflash
setflashrevertible
resyncflash
reverseflash
commitflash
revertflash
chsi
lssi
showsi
Library | Support | Terms of use | Feedback
© Copyright IBM Corporation 2004, 2007. All Rights Reserved.