Administrator's Reference

DELETE VOLHISTORY (Delete Sequential Volume History Information)

Use the DELETE VOLHISTORY command to delete sequential volume history information collected by the server when the information is no longer needed. For example, you may want to delete information about volumes used for obsolete database backups.

When volume history information about volumes not in storage pools is deleted, the volumes return to scratch status if they were acquired by ADSM as scratch volumes. For scratch volumes with device type FILE, the files are deleted.

When volume history information about volumes in storage pools is deleted, the volumes themselves are not affected and remain in the ADSM database.

To delete records from volume history information on a regular basis, use the DEFINE SCHEDULE command.

Notes:

Existing volume history files are not automatically updated with this command.
Do not delete sequential volume history information until you no longer need that information. For example, do not delete dump volume information or storage volume reuse information, unless you have backed up or dumped the database at a later time than that specified for the delete operation.
Do not delete the volume history information for database dump, database backup, or export volumes that reside in automated libraries, unless you want to return the volumes to scratch status. When the DELETE VOLHISTORY command removes volume information for database dump, database backup, or export volumes, the volumes are automatically returned to scratch status if they reside in automated libraries. These volumes are then available for reuse by the server and the information stored on them may be overwritten when the server reuses the volume for some other purpose, such as storage pool volumes or other database backups.

Privilege Class

To issue this command, you must have system privilege.

Syntax

>>-DELete VOLHistory---TODate--=--date---+------------------+--->
                                         '-TOTime--=--time--'
 
>---Type--=--+-All-------+-------------------------------------><
             +-DBBackup--+
             +-EXPort----+
             +-STGNew----+
             +-STGReuse--+
             '-STGDelete-'

Parameters

TODate=date

Specifies the date to use to select sequential volume history information to be deleted. ADSM deletes only those records with a date on or before the date you specify.

This parameter is required. Possible values are:

MM/DD/YYYY: Specifies that you want to delete records created on or before a specific date in MM/DD/YYYY format (for example, 01/31/1997).
TODAY: Specifies that you want to delete records created on or before the current date.
TODAY-numdays or -numdays: Specifies that you want to delete records created on or before the current date minus a specific number of days. The maximum value for the number of days is 9999.
For example, to delete records that are 30 or more days old, you can specify TODATE=TODAY-30 or TODATE=-30.

TOTime=time

Specifies the time to use to select records to delete from the volume history file. This parameter is optional.

Of the records that match the date criteria you specify with the TODATE parameter, ADSM deletes only those records with a time that is the same as or earlier than the time you specify with the TOTIME parameter. This parameter is optional. The default value is midnight (00:00:00) on the specified date. Possible values are:

HH:MM:SS

Specifies that you want to delete records created on or before a specific time on the specified date in HH:MM:SS format (for example, 12:30:22).

NOW

Specifies that you want to delete records created on or before the current time on the specified date.

For example, if you issue the DELETE VOLHISTORY command at 9:00 with TOTIME=NOW, ADSM deletes records with a time of 9:00 or earlier on the specified date.

NOW+numhours:numminutes or +numhours:numminutes

Specifies that you want to delete records created on or before the current time plus a specific number of hours (and optionally, minutes) on the specified date.

For example, if you issue the DELETE VOLHISTORY command at 9:00 with TOTIME=NOW+3 or TOTIME=+3, ADSM deletes records with a time of 12:00 or earlier on the specified date.

NOW-numhours:numminutes or -numhours:numminutes

Indicates that you want to delete records created on or before the current time minus a specific number of hours (and optionally, minutes) on the specified date.

For example, if you issue the DELETE VOLHISTORY command at 9:00 with TOTIME=NOW-3:30 or TOTIME=-3:30, ADSM deletes records with a time of 5:30 or earlier on the specified date.

Type=typevalue

Specifies the type of records to delete from the volume history file. This parameter is required. Possible values are:

All

Specifies deleting all records that meet the date and time criteria you specify.

Note:

If you previously had an ADSM Version 1 server installed, and you used the DUMP DB command to create online database dumps, records related to the volumes used for those dumps can exist in your volume history information. When you specify TYPE=ALL for the DELETE VOLHISTORY command, ADSM deletes any of those records that meet the date and time criteria you specify.

DBBackup

Specifies deleting only records that both contain information about volumes used for backups (full or incremental), and meet the date and time criteria you specify.

EXPort

Specifies deleting only records that contain information about volumes used for exporting data, and that meet the date and time criteria you specify.

STGNew

Specifies deleting only records that contain information about new sequential access storage volumes, and that meet the specified date and time criteria.

STGReuse

Specifies deleting only records that contain information about reused sequential storage pool volumes, and that meet the date and time criteria you specify.

STGDelete

Specifies deleting only records that contain information about deleted sequential storage volumes, and that meet the date and time criteria you specify.

Examples

Task

Delete all volume history information created on or before 03/28/1996.

Command:: delete volhistory todate=03/28/1996 type=all

Related Commands

Table 87. Commands Related to DELETE VOLHISTORY

Command Description
BACKUP VOLHISTORY Records sequential 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.
QUERY VOLHISTORY Displays sequential volume history information that has been collected by the server.

Command	Description
BACKUP VOLHISTORY	Records sequential 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.
QUERY VOLHISTORY	Displays sequential volume history information that has been collected by the server.

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