D.1.26 acsnap cancel (Command for canceling SnapOPC+ copy)

NAME

acsnap cancel - Cancellation of SnapOPC+ copy.

SYNOPSIS

acsnap cancel -g COPY-GROUP [-p PAIR | -v VOLUME-NAME] [-r | -force] [-xml]

[When cancelling the estimation of the amount of snap data volume updates:]

acsnap cancel -estimate -v VOLUME-NAME [-xml]

DESCRIPTION

This command cancels SnapOPC+ copy for a specified copy group or copy pair.

It is also possible to cancel the estimation of the number of updated blocks generated for the copy-source volume.

OPTIONS

-g COPY-GROUP: This option specifies a copy group name.

-p PAIR

This option specifies a copy pair.

If neither a pair nor the -force option is specified, the copy process of the oldest snap generation is cancelled.
If a pair is not specified but the -force option is specified, the copy process of the latest snap generation is cancelled.

If -p option is specified at restore with -r option of the acsnap start command, specify also -p option at cancellation with this command.

-v VOLUME-NAME

The copy process of a specified logical volume is cancelled.

If the -force option is not specified, the copy process of the oldest snap generation is cancelled.
If the -force option is specified, the copy process of the latest snap generation is cancelled.
If the -r option is specified, the restore process of the latest snap generation is cancelled.

Also, when cancelling the estimation of the amount of snap data volume updates, specify a copy-source logical volume.

The following is an example of a format to specify a logical volume.

(1) ETERNUS Disk storage system name
(2) Logical volume number

In addition, you can specify extent start position and extent size, as well.

(1) ETERNUS Disk storage system name
(2) Logical volume number
(3) Extent start position (per block)
(4) Extent size (number of blocks)

A string starting with "0x" represents a hexadecimal number.

-r: This option stops copying in the reverse direction to the direction that has been specified.

-force

This option forcibly stops SnapOPC+ session.

Alll the snap generations of a specified copy pair are stopped.

If no pair is specified, SnapOPC+ copy is forcibly cancelled for the latest snap generation, so that all snap generations are stopped.

This option is specifiable even if there is only one snap generation.

-estimate: This option estimates the amount of snap data volume updates.

-xml: This option displays the result of the command execution in the XML format.

EXIT STATUS

=0: Terminate normally

>0: Terminate abnormally

EXAMPLES

> acsnap cancel -g group01

DX80/0x1:DX80/0x6
# DATE : 2008/06/24 16:28:00 - << SnapOPCP Disconnected >>

DX80/0x2:DX80/0x7 
# DATE : 2008/06/24 16:28:00 - << SnapOPCP Disconnected >>

DX80/0x3:DX80/0x8
# DATE : 2008/06/24 16:28:00 - << SnapOPCP Disconnected >>

  Succeeded : 3
  Failed    : 0

[When cancelling the estimation of the amount of snap data volume updates:]

> acsnap cancel -v DX80/0x1
Successful completion

NOTES

If the copy type of a copy group is OPC, QuickOPC, EC or REC, this command ends abnormally.
This command is not available for ETERNUS Disk storage systems registered as remote disk storage systems.
When specifying a pair of the past snap generations (excluding the oldest snap generation) with the -p option, specify the -force option.
If the -p option and the -r option are specified when starting copy with "acsnap start (Command for starting SnapOPC+ copy)", specify only the -p option at cancellation with this command.