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