rmvdiskcopy

Use the rmvdiskcopy command to remove a volume copy from a volume. This command cannot be used for high availability volumes.

Syntax

rmvdiskcopy   -copy   copy_id   [ -force ]   {  vdisk_name  |  vdisk_id  }

Parameters

-copycopy_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 your product support information.
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."
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