4.6.4 acsnap start (SnapOPC+ Copy Start Command)

NAME

acsnap start - Start of SnapOPC+

SYNOPSIS

acsnap start -g copyGroup [-p copyPair | -v volumeName] [-r] [-xml]
acsnap start -g copyGroup -concur [-xml]
acsnap start -estimate -v volumeName [-xml]

DESCRIPTION

The SnapOPC+ is executed onto a specified copy group or copy pair.

If only the -g option is specified, start the SnapOPC+ copy for copy pair in a copy group.
If there are multiple copy pairs from the same copy source, start SnapOPC+ copy by auto-selecting a copy destination which has no sessions. If all copy destination volumes are generation-managed, discard the oldest snap generation and select it for creating a new copy destination.
If a copy pair is specified by the -p option, start the SnapOPC+ copy for the specified copy pair.
If a past snap generation (excluding the oldest snap generation) is specified as a copy destination, this command terminates abnormally.
If a logical volume of copy source is specified by the -v option and all copy destination volumes are generation-managed, discard the oldest snap generation and select it for creating a new copy destination.

If the -estimate option is specified, the monitor session of the update amount measurement starts for the specified volume.

OPTIONS

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

-p copyPair: This option specifies a copy pair.

-r: This option performs a copy in the reverse direction to the direction that has been specified.
The latest snap generation is selected as a copy source when the copy pair is not specified.

-v volumeName

Specify a logical volume.
If this option is specified when starting SnapOPC+ copy, the copy destination is automatically selected.
When starting the monitor session of the update amount measurement, specify a logical volume to be measured.

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: Specify this option when starting the monitor session of the update amount measurement.

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

-concur: This option executes SnapOPC+ by using Concurrent OPC function.

EXIT STATUS

=0: Completed successfully
>0: Terminated abnormally

EXAMPLES

Starting the SnapOPC+

> acsnap start -g group01

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

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

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

  Succeeded : 3
  Failed    : 0

Starting the monitor session of the update amount measurement
```
> acsnap start -estimate -v ET001/0x1
Successful completion.
```

Executing SnapOPC+ by using the Concurrent OPC function

> acsnap start -g group01 -concur
Successful completion.

NOTES

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.
This command terminates abnormally if the copy destination logical volume of the specified copy group or pair is protected by the acinhibit set command.