Administrator's Reference

UPDATE BACKUPSET (Update a Retention Value Assigned to a Backup Set)

Use this command to update the retention value associated with a client's backup set.

Privilege Class

To issue this command, you must have system privilege or policy privilege for the domain to which the client node is assigned.

Syntax

                     .-,---------.  .-,---------------.
                     V           |  V                 |
>>-UPDate BACKUPSET----node_name-+----backup_set_name-+--------->
 
>--RETention--=--+-days----+--+--------------------+------------>
                 '-NOLimit-'  '-BEGINDate--=--date-'
 
>--+--------------------+--+------------------+----------------->
   '-BEGINTime--=--time-'  '-ENDDate--=--date-'
 
>--+------------------+--+--------------------------------+----->
   '-ENDTime--=--time-'  '-WHERERETention--=--+-days----+-'
                                              '-NOLimit-'
 
>--+----------------------------------+------------------------->
   '-WHEREDESCription--=--description-'
 
>--+-------------------+---------------------------------------><
   '-Preview=--+-No--+-'
               '-Yes-'
 
 

Parameters

node_name (Required)

Specifies the client node whose data is contained in the backup set to be updated. The node name you specify can contain wildcard characters. You can specify more than one node name by separating the names with commas and no intervening spaces.

backup_set_name (Required)

Specifies the name of the backup set to update. The backup set name you specify can contain wildcard characters. You can specify more than one backup set name by separating the names with commas and no intervening spaces.

RETention (Required)

Specifies the updated number of days to retain the backup set on the server. You can specify an integer from 0 to 32768. The values are:

days

Specifies the updated number of days to retain the backup set.

NOLimit

Specifies that the backup set is retained on the server indefinitely.

If you specify NOLIMIT, the server retains the volumes containing the backup set forever, unless a user or administrator deletes the volumes from server storage.

BEGINDate

Specifies the beginning date in which the backup set to update was created. This parameter is optional. The default is the current date. You can use this parameter with the BEGINTIME parameter to specify a range for the date and time. If you specify a begin date without a begin time, the time will be at 12:00 a.m. (midnight) on the date you specify.

You can specify the date by using one of the values below:

Value	Description	Example
MM/DD/YYYY	A specific date	09/15/1999
TODAY	The current date	TODAY
TODAY+days or +days	The current date plus days specified.	TODAY +3 or +3.
TODAY-days or -days	The current date minus days specified.	TODAY-3 or -3.

BEGINTime

Specifies the beginning time in which the backup set to update was created. This parameter is optional. The default is the current time. You can use this parameter with the BEGINDATE parameter to specify a range for the date and time. If you specify a begin time without a begin date, the date will be the current date at the time you specify.

You can specify the date by using one of the values below:

Value	Description	Example
HH:MM:SS	A specific time	10:30:08
NOW	The current time	NOW
NOW+HH:MM or +HH:MM	The current time plus hours and minutes on the specified end date	NOW+02:00 or +02:00.
NOW-HH:MM or -HH:MM	The current time minus hours and minutes on the specified end date	NOW-02:00 or -02:00.

ENDDate

Specifies the ending date in which the backup set to update was created. This parameter is optional. You can use this parameter with the ENDTIME parameter to specify a range for the date and time. If you specify an end date without an ending time, the time will be at 11:59:59 p.m. on the specified end date.

You can specify the date by using one of the values below:

Value	Description	Example
MM/DD/YYYY	A specific date	09/15/1999
TODAY	The current date	TODAY
TODAY+days or +days	The current date plus days specified.	TODAY +3 or +3.
TODAY-days or --days	The current date minus days specified.	TODAY -3 or -3.

ENDTime

Specifies the ending time in which the backup set to update was created. This parameter is optional. You can use this parameter with the ENDDATE parameter to specify a range for the date and time. If you specify an end time without an end date, the date will be the current date at the time you specify.

You can specify the date by using one of the values below:

Value	Description	Example
HH:MM:SS	A specific time	10:30:08
NOW	The current time	NOW
NOW+HH:MM or +HH:MM	The current time plus hours and minutes specified	NOW+02:00 or +02:00.
NOW-HH:MM or -HH:MM	The current time minus hours and minutes specified	NOW-02:00 or -02:00.

WHERERETention

Specifies the retention value, specified in days, that is associated with the backup set to update. The values are:

days

Specifies that the backup set that is retained this number of days is updated.

NOLimit

Specifies that the backup set retained indefinitely is updated.

WHEREDESCription

Specifies the description that is associated with the backup set to update. This parameter is optional. You can specify wildcard characters for the description.

Preview

Specifies whether to preview the list of backup sets to update, without actually updating the backup sets. This parameter is optional. The default is No. The values are:

No

Specifies that the backup sets are updated.

Yes

Specifies that the server displays the backup sets to update, without actually updating the backup sets.

Examples

Task

Update the retention period assigned to backup set PERS_DATA.3099 that contains data from client node JANE. Change the retention period to 70 days.

Command:

update backupset jane pers_data.3099 retention=70

Related Commands

Table 297. Commands Related to UPDATE BACKUPSET