Administrator's Reference

DELETE VOLHISTORY (Delete Sequential Volume History Information)

Use this command to delete volume history file records that are no longer needed (for example, records for obsolete database backup volumes).

When you delete records for volumes that are not in storage pools (for example, database backup or export volumes), the volumes return to scratch status even if TSM acquired them as private volumes. Scratch volumes of device type FILE are deleted. When you delete the records for storage pool volumes, the volumes remain in the TSM database. When you delete records for recovery plan file objects from a source server, the objects on the target server are marked for deletion.

Notes:

1. Volumes for the most recent database backup series are not deleted.

2. Existing volume history files are not automatically updated with this command.

3. You can use the DEFINE SCHEDULE command to periodically delete volume history records.

4. Use the DELETE BACKUPSET command to delete specified backup set volume information in the volume history file. Do not use this DELETE VOLHISTORY command to delete backup set volume information in the volume history file.

5. For users of DRM, the database backup expiration should be controlled with the SET DRMDBBACKUPEXPIREDAYS command instead of this DELETE VOLHISTORY command. Using the DELETE VOLHISTORY command removes TSM's record of the volume. This can cause volumes to be lost that were managed by the MOVE DRMEDIA command. The recommended way to manage the automatic expiration of DRM database backup volumes is by using the SET DRMDBBACKUPEXPIREDAYS command.

Privilege Class

To issue this command, you must have system privilege.

Syntax

>>-DELete VOLHistory--TODate--=--date--+-----------------+------>
                                       '-TOTime--=--time-'
 
>--Type--=--+-All---------------------------------------+------><
            +-DBBackup--+------------------------+------+
            |           '-DEVclass--=--classname-'      |
            +-DBSnapshot--+------------------------+----+
            |             '-DEVclass--=--classname-'    |
            +-DBDump------------------------------------+
            +-DBRpf-------------------------------------+
            +-EXPort------------------------------------+
            |         .-DELETELatest--=--No------.      |
            +-RPFile--+--------------------------+------+
            |         '-DELETELatest--=--+-No--+-'      |
            |                            '-Yes-'        |
            |              .-DELETELatest--=--No------. |
            +-RPFSnapshot--+--------------------------+-+
            |              '-DELETELatest--=--+-No--+-' |
            |                                 '-Yes-'   |
            +-STGNew------------------------------------+
            +-STGReuse----------------------------------+
            '-STGDelete---------------------------------'
 
 

Parameters

TODate (Required)

Specifies the date to use to select sequential volume history information to be deleted. TSM deletes only those records with a date on or before the date you specify. You can specify the data using one of the values below:

Value	Description	Example
MM/DD/YYYY	A specific date	01/23/1999
TODAY	The current date	TODAY
TODAY-days or -days	The current date minus days specified. The maximum number of days you can specify is 9999.	TODAY-30 or -30. To delete records that are 30 or more days old, you can specify TODAY-30 or simply -30.

TOTime

Specifies that you want to delete records created on or before this time on the specified date. This parameter is optional. The default is midnight (00:00:00). You can specify the data using one of the values below:

Value	Description	Example
HH:MM:SS	A specific time on the specified date	12:30:22
NOW	The current time on the specified date	NOW
NOW+HH:MM or +HH:MM	The current time plus hours and minutes on the specified date	NOW+03:00 or +03:00. If you issue the DELETE VOLHISTORY command at 9:00 with TOTIME=NOW+03:00 or TOTIME=+03:00, TSM deletes records with a time of 12:00 or earlier on the specified date.
NOW-HH:MM or -HH:MM	The current time minus hours and minutes on the specified date	NOW-03:30 or -03:30. If you issue the DELETE VOLHISTORY command at 9:00 with TOTIME=NOW-3:30 or TOTIME=-3:30, TSM deletes records with a time of 5:30 or earlier on the specified date.

Type (Required)

Specifies the type of records, which also meet the date and time criteria, to delete from the volume history file. Possible values are:

All

Specifies to delete all records.

DBBackup

Specifies to delete only records that contain information about volumes used for database full and incremental backups, that is with volume types of BACKUPFULL and BACKUPINCR, and that meet the specified date and time criteria. The latest database full and incremental backup series will not be deleted.

DEVclass=classname

Specifies the device class name that was used to create the database backups. This optional parameter can be used to delete database backups created using a server-to-server virtual volume device class. The type of the device class must be SERVER. This parameter can only be used to delete volume history entries of type BACKUPFULL, BACKUPINCR, or DBSNAPSHOT.

A full, incremental, or snapshot database backup volume is eligible to be deleted if all of the following conditions are met:

• The device class used to create the database backup volume matches the specified device class
• The volume was created on or before the specified date and time
• The volume is not part of the latest full plus incremental database backup series if the specified volume type is DBBackup, or snapshot database backup series if the volume type is DBSnapshot

DBSnapshot

Specifies to delete only records that contain information about volumes used for snapshot database backups, and that meet the specified date and time criteria. The latest snapshot database backup will not be deleted.

DEVclass=classname

Specifies the device class name that was used to create the database backups. This optional parameter can be used to delete database backups created using a server-to-server virtual volume device class. The type of the device class must be SERVER. This parameter can only be used to delete volume history entries of type BACKUPFULL, BACKUPINCR, or DBSNAPSHOT.

A full, incremental, or snapshot database backup volume is eligible to be deleted if all of the following conditions are met:

• The device class used to create the database backup volume matches the specified device class
• The volume was created on or before the specified date and time
• The volume is not part of the latest full plus incremental database backup series if the specified volume type is DBBackup, or snapshot database backup series if the volume type is DBSnapshot

DBDump

Specifies to delete only online database dump volumes.

DBRpf

Specifies to delete only records that contain information about full and incremental database backup volumes and recovery plan file volumes.

EXPort

Specifies to delete only records that contain information about export volumes.

RPFile

Specifies to delete only records that contain information about recovery plan file objects that are stored on a target server and that meet the specified date and time criteria.

DELETELatest

Specifies whether the latest recovery plan file is eligible for deletion. This optional parameter can be used to delete the latest recovery plan files created using a server-to-server virtual volume device class.

This parameter can only be used to delete volume history entries of type RPFILE (for instance, those recovery plan files that were created using the DEVCLASS parameter with the PREPARE command). If this parameter is not specified, the latest RPFILE entries are not deleted.

No

Specifies the latest RPFILE file is NOT deleted.

Yes

Specifies the latest RPFILE file is deleted if it meets the specified date and time criteria.

RPFSnapshot

Specifies to delete only records that contain information about recovery plan file objects that were created assuming snapshot database backups, that are stored on a target server and that meet the specified date and time criteria. The latest RPFSNAPSHOT file will not be deleted.

DELETELatest

Specifies whether the latest recovery plan file is eligible for deletion. This optional parameter can be used to delete the latest recovery plan files created using a server-to-server virtual volume device class.

This parameter can only be used to delete volume history entries of type RPFSNAPSHOT (for instance, those recovery plan files that were created using the DEVCLASS parameter with the PREPARE command). If this parameter is not specified, the latest RPFSNAPSHOT entries are not deleted.

No

Specifies the latest RPFSNAPSHOT file is NOT deleted.

Yes

Specifies the latest RPFSNAPSHOT file is deleted if it meets the specified date and time criteria.

STGNew

Specifies to delete only records that contain information about new sequential access storage volumes.

STGReuse

Specifies to delete only records that contain information about reused sequential storage pool volumes.

STGDelete

Specifies to delete only records that contain information about deleted sequential storage pool volumes.

Examples

Task

Delete all recovery plan file information created on or before 03/28/1998.

Command:

delete volhistory type=rpfile todate=03/28/1998

Related Commands

Table 123. Commands Related to DELETE VOLHISTORY