Administrator's Reference

DELETE BACKUPSET (Delete a Backup Set)

Use this command to delete a backup set.

When the server creates a backup set, the retention period assigned to the backup set determines how long the backup set remains in the database. When that date passes, the server automatically deletes the backup set when expiration processing runs. However, you can also manually delete the client's backup set from the server before it is scheduled to expire by using the DELETE BACKUPSET command. After a backup set is deleted, the volumes return to scratch status if TSM acquired them as scratch volumes. Scratch volumes associated with a device type of FILE are deleted.

Privilege Class

If the REQSYSAUTHOUTFILE server option is set to YES (the default), the administrator must have system privilege. If the REQSYSAUTHOUTFILE server option is set to NO, the administrator must have system privilege or policy privilege for the domain to which the client node is assigned.

Syntax

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

Parameters

node_name (Required)
Specifies the name of the client node whose data is contained in the backup set that is to be deleted. 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 delete. 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.

BEGINDate
Specifies the beginning date in which the backup set to delete was created. This parameter is optional. 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 delete was created. This parameter is optional. You can use this parameter in conjunction 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 data 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.

ENDDate
Specifies the ending date in which the backup set to delete was created. This parameter is optional. You can use this parameter in conjunction with the ENDTIME parameter to specify a range for the date and time. If you specify an end date without an end 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 of the range in which the backup set to delete was created. This parameter is optional. You can use this parameter in conjunction 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 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.

WHERERETention
Specifies the retention value, specified in days, that is associated with the backup sets to delete. You can specify an integer from 0 to 9999. The values are:

days
Specifies that backup sets that are retained this number of days are deleted.

NOLimit
Specifies that the backup sets that are retained indefinitely are deleted.

WHEREDESCription
Specifies the description that is associated with the backup set to delete. The description you specify can contain a wildcard character. This parameter is optional.

Preview
Specifies whether to preview the list of backup sets to delete, without actually deleting the backup sets. This parameter is optional. The default value is NO. The values are:

No
Specifies that the backup sets are deleted.

Yes
Specifies that the server displays the list of backup sets to delete, without actually deleting the backup sets.

Examples

Task 1

Delete backup set named PERS_DATA.3099 that belongs to client node JANE. The backup set was generated on 11/19/1998 at 10:30:05.

Command:
delete pers_data.3099 jane mybackupset.3099 begindate=11/19/1998 begintime=10:30:05

Related Commands

Table 83. Commands Related to DELETE BACKUPSET

Command Description
DEFINE BACKUPSET Defines a previously generated backup set to a server.
DEFINE BACKUPSET Defines a previously generated backup set to a server.
DELETE BACKUPSET Deletes a backup set.
QUERY BACKUPSET Displays backup sets.
QUERY BACKUPSETCONTENTS Displays contents contained in backup sets.
UPDATE BACKUPSET Updates a retention value associated with a backup set.


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