Tivoli Storage Manager for Windows: Administrator's Reference
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:
- Volumes for the most recent database backup series are not deleted.
- Existing volume history files are not automatically updated with this
command.
- You can use the DEFINE SCHEDULE command to periodically delete volume
history records.
- 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.
- 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 later 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 125. Commands Related to DELETE VOLHISTORY
[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]