4.6.6 acsnap cancel (SnapOPC+ Copy Stop Command)

NAME

acsnap cancel - Stop of SnapOPC+ copy

SYNOPSIS

acsnap cancel -g copyGroup [-p copyPair | -v volumeName] [-r | -force][-xml]
acsnap cancel -estimate -v volumeName [-xml]

DESCRIPTION

The SnapOPC+ copy for a specified copy group or pair is cancelled.
If the -estimate option is specified, stop to estimate the number of updated blocks generated for the copy source volume.

OPTIONS

-g copyGroup: This option specifies the copy group name.

-p copyPair

This option specifies a copy pair.

When specifying the copy pair of the past snap generation (except the oldest snap generation), execute this command with the -force option.

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

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

-force

This option forcibly stops the session.

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

If no pair is specified, SnapOPC+ 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.

-v volumeName

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.

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

The extent start position and the extent size can be specified.

(1) ETERNUS name
(2) Logical volume number
(3) Extent start position (block units)
(4) Extent size (number of blocks)

A character string starting with "0x" expresses a hexadecimal value.

-estimate: This option stops the estimation of 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

Stopping the SnapOPC+ copy

> acsnap cancel -g group01

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

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

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

  Succeeded : 3
  Failed    : 0

Stopping the estimation of amount of snap data volume updates

> acsnap cancel -estimate -v ET001/0x1
Successful completion.

NOTES

If you stop a session of defined Concurrent OPC (Readying), specify a copy pair by using the -p option.
When the copy type of copy group is OPC, QuickOPC, EC or REC, this command cannot be executed.
This command is not available for ETERNUS Disk storage system registered as a remote device.
Use ETERNUS Web GUI or ETERNUS CLI to stop the monitor session started by the following methods.
- Operation by Copy command via SAN
  - Started by Copy command via LAN
  - Started by ETERNUS Web GUI
  - Started by ETERNUS CLI
- Operation by Copy command via LAN
  - Started by Copy command via SAN