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              |
>>-UPDate BACKUPSET-------node_name---+------------------------->
 
      .-,------------------.
      V                    |
>--------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 281. Commands Related to UPDATE BACKUPSET

DEFINE BACKUPSET Defines a previously generated backup set to a server.
DELETE BACKUPSET Generates a backup set of a client's data.
GENERATE BACKUPSET Updates a retention value associated with a backup set.
QUERY BACKUPSET Displays backup sets.
QUERY BACKUPSETCONTENTS Displays contents contained in backup sets.


[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]