rmvdiskcopy

Use the rmvdiskcopy command to remove a volume copy from a mirrored volume. Use the rmvolumecopy command for high availability volumes.

Syntax

Read syntax diagramSkip visual syntax diagram rmvdiskcopy -copy copy_id -forcevdisk_namevdisk_id

Parameters

-copy copy_id
(Required) Specifies the ID of the copy to delete.
-force
(Optional) Forces the deletion of the last synchronized copy of a volume, which deletes the entire volume.
Important: Using the force parameter might result in a loss of access. Use it only under the direction of IBM® support personnel.
The parameter also forces the deletion of a nonmirrored volume, a copy that is migrating to image mode, or an image-mode copy that has virtual medium errors.
Important: To prevent an active volume from being deleted unintentionally, you can use a global system setting to enable volume protection (see the chsystem command). You can specify a time period for which the volume must be idle before you can delete it. If volume protection is enabled and the time period has not expired, the volume deletion fails even if the -force parameter is used.
Note: When you use the -force parameter to delete a synchronized copy from a mirrored volume, where the synchronized copy is in a storage pool with volume protection inactive, but it has an unsynchronized copy in a different storage pool with volume protection active, then volume protection applies to the volume. It is because the unsynchronized copy is also deleted and it is in a storage pool with volume protection active, as the -force is deleting both copies in a mirrored volume the command fails if host I/O is being sent to the volume in the defined volume protection time period.
vdisk_name | vdisk_id
(Required) Specifies the volume to delete the copy from. You must specify this parameter last on the command line.

Description

The rmvdiskcopy command deletes the specified copy from the specified volume. The command fails if all other copies of the volume are not synchronized; in this case, you must specify the -force parameter, delete the volume or more, or wait until the copies are synchronized.
Remember: This command is unsuccessful if:
  • Volume protection is enabled
  • The last volume copy being deleted has received I/O within the defined volume protection time period

These changes apply to this command only when deleting the last synchronized copy of a volume or removing the entire volume.

An invocation example

This example forces a deletion.
Important: Using the force parameter might result in a loss of access. Use it only under the direction of your product support information.
rmvdiskcopy -copy 0 -force 134

The resulting output:

No feedback

An invocation example

This example deletes a mirrored copy from a volume, where 1 is the ID of the copy to delete and vdisk8 is the volume to delete the copy from.

rmvdiskcopy -copy 1 vdisk8

The resulting output:

No feedback