3PAR InForm® OS 2.3.1 CLI Reference (320-200166 Rev B, March 2010)

11.35
InForm OS Version 2.3.1 Command Line Interface Reference
-retain <time>[d|D|h|H]
Specifies the amount of time, relative to the current time, that the volume will be retained.
<time> is a positive integer value and in the range of 1 - 43,800 hours (1,825 days).
Time can be optionally specified in days or hours providing either
d or D for day and h or H
for hours following the entered time value.
SPECIFIERS
<copy_of_VV>
Specifies the name of the Virtual Volume being copied (the parent volume).
<snapshot_VV>
Optional name of the snapshot Virtual Volumes. If <snapshot_VV> is not specified, the
system tries to automatically generate the snapshot name of the form
<copy_of_VV>.<type><number> where <type> is either ro or rw and <number> is
either empty or the lowest number starting from 0 that does not conflict with an existing
volume name. If the generated name is too long (because the
<copy_of_VV> name is too
long) the command will fail, and the user is required to specify
<snapshot_VV> explicitly.
[<ID>]
Optional ID of the <snapshot_VV>. If the <ID> is not specified, an ID is chosen
automatically.
RESTRICTIONS
Use of this command requires a Virtual Copy license. Contact your local 3PAR representative
for information.
NOTE: If the volume is not in any domain, then its retention time cannot exceed
the value of the system's
VVRetentionTimeMax. The default value for the
system's
VVRetentionTimeMax is 14 days. If the volume belongs to a domain,
then its retention time cannot exceed the value of the domain's
VVRetentionTimeMax, if set. The retention time cannot be removed or reduced
once it is set. If the volume has its retention time set, it cannot be removed within
its retention time. If both expiration time and retention time are specified, then
the retention time cannot be longer than the expiration time. This option
requires the 3PAR Virtual Lock License. Contact your local 3PAR Authorized
Service Provider for more information.