IBM System Storage DS3000, Programming Manual

Page: 152 / 652

Create VolumeCopy
This command creates a VolumeCopy and starts the VolumeCopy operation.
Attention: Starting a VolumeCopy operation overwrites all existing data on the target logical drive,
makes the target logical drive read-only to hosts, and fails all FlashCopy logical drives associated with
the target logical drive, if any exist. If you have used the target logical drive as a copy before, be sure
you no longer need the data or have it backed up.
This command creates VolumeCopies in two ways:
v
VolumeCopy without FlashCopy also called offline VolumeCopy
v
VolumeCopy with FlashCopy, also called online VolumeCopy
If you use VolumeCopy without FlashCopy you cannot write to the source logical drive until the copy
operation is complete. If you want to be able to write to the source logical drive before the copy
operation is complete, use VolumeCopy with FlashCopy . You can select VolumeCopy with FlashCopy
through the optional parameters in the command syntax.
After completion of the VolumeCopy with FlashCopy operation, the FlashCopy is disabled.
Note: You can have a maximum of eight VolumeCopies in progress at one time. If you try to create more
than eight VolumeCopies at one time, the controllers return a status of
Pending
until one of the logical
driveCopies that is in progress finishes and returns a status of Complete
Syntax
create VolumeCopy source="sourceName"
target="targetName"
[copyPriority=(highest | high | medium | low | lowest)
targetReadOnlyEnabled=(TRUE | FALSE)
copyType=(offline | online)
repositoryPercentOfBase=(20 | 40 | 60 | 120 | default) |
repositoryGroupPreference=(sameAsSource | otherThanSource | default)]
Parameters
Parameter Description
source The name of an existing logical drive that you want to
use as the source logical drive. Enclose the source
logical drive name in double quotation marks (“ ”).
target The name of an existing logical drive that you want to
use as the target logical drive. Enclose the target logical
drive name in double quotation marks (“ ”).
copyPriority
The priority that VolumeCopy has relative to host I/O
activity. Valid values are
highest
,
high
,
medium
,
low
, or
lowest
.
targetReadOnlyEnabled
The setting so that you can write to the target logical
drive or only read from the target logical drive. To
write to the target logical drive, set this parameter to
FALSE . To prevent writing to the target logical drive, set
this parameter to
TRUE
.
3-106
IBM System Storage DS3000, DS4000, and DS5000: Command Line Interface and Script Commands Programming Guide