4.6.4 acsnap start (SnapOPC+ Copy Start Command)

NAME

acsnap start - Start 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 a copy group is specified only with the -g option, the copy pair for each copy source logical volume in the copy group is automatically selected according to "2.6.2 Logic for Selection of Copy Pair to Start SnapOPC+" and then the SnapOPC+ copy starts.
If a copy pair is specified with the -p option, SnapOPC+ copy starts for the specified copy pair.
If the specified copy destination is not the oldest snap generation (snap generation number is "2" or later), this command terminates with an error.
If a copy source logical volume is specified with the -v option, the copy pair for that logical volume is automatically selected according to "2.6.2 Logic for Selection of Copy Pair to Start SnapOPC+" and then the SnapOPC+ copy starts.

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.
When specifying with the LU to Partition format or the Partition to LU format, you must enclose the entire argument for this option within double quotations (") depending on the shell being used.

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

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

When specifying the extent start position and the extent size, you must enclose the entire argument for this option within double quotations (") depending on the shell being used.

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