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 if TSM acquired them as scratch 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----+
+-DBSnapshot--+
+-DBDump------+
+-DBRpf-------+
+-EXPort------+
+-RPFile------+
+-RPFSnapshot-+
+-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.
- 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.
- 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.
- 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.
- 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 106. Commands Related to DELETE VOLHISTORY
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.
|
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.
|
EXPIRE INVENTORY
| Manually starts inventory expiration processing.
|
MOVE DRMEDIA
| Moves DRM media onsite and offsite.
|
SET DRMRPFEXPIREDAYS
| Set criteria for recovery plan file expiration.
|
SET DRMDBBACKUPEXPIREDAYS
| Specifies criteria for database backup series expiration.
|
[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]