Administrator's Reference
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 257. 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 ]