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 Tivoli® Storage Manager 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 Tivoli Storage Manager database. When you delete records for recovery plan file objects from a source server, the objects on the target server are marked for deletion.
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 Tivoli Storage Manager'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.
To issue this command, you must have system privilege.
>>-DELete VOLHistory--TODate--=--date---------------------------> .-TOTime--=--23:59:59-. >--+---------------------+--------------------------------------> '-TOTime--=--time-----' >--Type--=--+-All---------------------------------------+------>< +-DBBackup--+-------------------------+-----+ | '-DEVclass--=--class_name-' | +-DBSnapshot--+-------------------------+---+ | '-DEVclass--=--class_name-' | +-DBRpf-------------------------------------+ +-EXPort------------------------------------+ | .-DELETELatest--=--No------. | +-RPFile--+--------------------------+------+ | '-DELETELatest--=--+-No--+-' | | '-Yes-' | | .-DELETELatest--=--No------. | +-RPFSnapshot--+--------------------------+-+ | '-DELETELatest--=--+-No--+-' | | '-Yes-' | +-STGNew------------------------------------+ +-STGReuse----------------------------------+ '-STGDelete---------------------------------'
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. |
EOLM (End Of Last Month) | The last day of the previous month. | EOLM |
EOLM-days | The last day of the previous month minus days specified. | EOLM-1 To include files that were active a day before the last day of the previous month. |
BOTM (Beginning Of This Month) | The first day of the current month. | BOTM |
BOTM+days | The first day of the current month, plus days specified. | BOTM+9 To include files that were active on the 10th day of the current month. |
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, Tivoli Storage Manager 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, Tivoli Storage Manager deletes records with a time of 5:30 or earlier on the specified date. |
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.
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.
delete volhistory type=rpfile todate=03/28/2005
Command | Description |
---|---|
BACKUP VOLHISTORY | Records volume history information in external files. |
DEFINE SCHEDULE | Defines a schedule for a client operation or an administrative command. |
DELETE VOLUME | Deletes a volume from a storage pool. |
EXPIRE INVENTORY | Manually starts inventory expiration processing. |
MOVE DRMEDIA | Moves DRM media on-site and off-site. |
PREPARE | Creates a recovery plan file. |
QUERY RPFILE | Displays information about recovery plan files. |
QUERY VOLHISTORY | Displays sequential volume history information that has been collected by the server. |
SET DRMRPFEXPIREDAYS | Set criteria for recovery plan file expiration. |
SET DRMDBBACKUPEXPIREDAYS | Specifies criteria for database backup series expiration. |