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

11.59
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
<SV_name>
Specifies the snapshot name, using up to 31 characters in length.
<copy_of_VV | VV_set>
Specifies the parent volume name or volume set name, using up to 31 characters in length.
The
VV_set name must start with set:. If copy_of_VV is a VV_set then svname can
contain various patterns that are used to form the snapshot volume name. See Help
sub,
vvnamepat for details.
RESTRICTIONS
■ Use of this command requires a Virtual Copy license. Contact your local 3PAR representative
for information.
■ A read-only snapshot of a read-only source volume is not allowed.
■ A read/write snapshot of a read/write snapshot or base is not allowed.
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.