UPDATE RETSET (Update attributes of a retention set)

A retention set inherits the attributes of the retention rule that triggered creation of the retention set. Use this command to update one or more of these attributes.

Privilege class

To issue this command, you must have system privilege or unrestricted policy privilege.

Syntax

Read syntax diagramSkip visual syntax diagram UPDate RETSet retset_id DESCription=descriptionRETention=daysNOLimit

Parameters

retset_id (Required)
Specifies the number of the retention set that you want to update. The retention set ID is a unique numeric value.
DESCription
Specifies a description for the retention set. The description of the retention set is copied from the description of the retention rule that triggered creation of the retention set. However, you can update the description according to your requirements. This parameter is optional.

The maximum length of the description is 255 characters. Enclose the description in quotation marks if it contains any blank characters.

RETention
Specifies the new length of time, in days, for which a retention set and its data are retained by the server. This parameter is optional.

The data that is contained within a retention set is retained by the server for the period that is defined by the retention rule. However, you can change this value. The server does not delete the data even if the management class and copy group that are associated with the data when it was backed up require data expiration. You can specify one of the following values:

days
Specify an integer value in the range 0 - 30,000.

After you determine the length of time to retain data, you can use the following table to convert the number of years to days. If the period includes a leap year, adjust the number of days accordingly.

Table 1. Sample number of days to years
Number of years Number of days to years
1 year 365
2 years 730
3 years 1095
4 years 1461
5 years 1826
6 years 2191
7 years 2556
8 years 2921
9 years 3287
10 years 3652
20 years 7304
30 years 10957
40 years 14609
50 years 18262
NOLimit
Specifies that you want to keep the retention set indefinitely. If you specify NOLimit, the server retains retention sets forever unless an authorized user or administrator deletes the retention set from server storage.

Example: Update a retention set

Update the description for retention set number 712634.

update retset 712634 desc="Quarterly backup data for clients FILEMAN1 and FILEMAN2"

Related commands

Table 2. Commands related to UPDATE RETSET
Command Description
DELETE RETSET Deletes a retention set.
QUERY RETSET Displays information about retention sets.
QUERY RETSETCONTENTS Displays information about the contents of retention sets.