C.1.23 acsnap cancel (Snapshot type Advanced Copy stop command)

NAME

acsnap cancel - Stops snapshot type Advanced 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

Snapshot type copy for a specified copy group or pair is cancelled.

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 the copy group name.
Only when the type of a copy group is as follows, the copy group is specifiable.

SnapOPCP

-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.

When the acsnap start command was executed by specifying both -r option and -p option, it is necessary to specify this option to cancel the SnapOPC+ copy.

-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 name
(2) Logical volume number

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

-force

This option forcibly stops the session.

Cancelling Snapshot type process forcibly stops all the snap generations of a pair specified to stop and earlier snap operations.

If no pair is specified, Snapshot type process 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: Estimates the amount of snap data volume updates.

-xml: This option specifies when displaying the result of the command execution by the XML format.

EXIT STATUS

=0: Completed successfully

>0: Terminated abnormally

EXAMPLES

C:\>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:]
C:\>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 a remote device.
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 for the START Snapshot type COPY command (acsnap start (Snapshot type Advanced Copy start command)), specify only the -p option for this command.