IBM Tivoli Storage Manager, Version 7.1

BACKUP VOLHISTORY (Save sequential volume history information)

Use this command to back up sequential volume history information to one or more files.

Note: You must use volume history information when you reload the database and audit affected storage pool volumes. If you cannot start the server, you can use the volume history file to query the database about these volumes.

The volume history includes information about the following types of volumes:

Archive log volumes
Database backup volumes
Export volumes
Backup set volumes
Database snapshot volumes
Database recovery plan file volumes
Recovery plan file volumes
Recovery plan file snapshot volumes
The following sequential access storage pool volumes:
- Volumes added to storage pools
- Volumes reused through reclamation or MOVE DATA operations
- Volumes removed by using the DELETE VOLUME command or during reclamation of scratch volumes

Attention: To restore a database, the server must use information from the volume history file and the device configuration file. You must make and save copies of the volume history file and the device configuration file. These files cannot be recreated.

AIX operating systems HP-UX operating systems Linux operating systems Sun Solaris operating systems You must use the VOLUMEHISTORY server option to specify one or more volume history files. Tivoli® Storage Manager updates volume history files whenever server sequential volume history information is changed.

Windows operating systems At installation, the server options file includes a VOLUMEHISTORY option that specifies a default volume history file named volhist.out. Tivoli Storage Manager updates volume history files whenever server sequential volume history information is changed.

In order to ensure updates are complete before the server is halted, we recommend you:

Not halt the server for a few minutes after issuing the BACKUP VOLHISTORY command.
Specify multiple VOLUMEHISTORY options in the server options file.
Examine the volume history file to see if the file has been updated.

Privilege class

Any administrator can issue this command unless it includes the FILENAMES parameter. If the FILENAMES parameter is specified and the REQSYSAUTHOUTFILE server option is set to YES, the administrator must have system privilege. If the FILENAMES parameter is specified and the REQSYSAUTHOUTFILE server option is set to NO, the administrator must have operator, policy, storage or system privilege.

Syntax


>>-BAckup VOLHistory--+---------------------------------+------><
                      |               .-,-------------. |   
                      |               V               | |   
                      '-Filenames--=------file_name---+-'

Parameters

Filenames: Specifies the names of one or more files in which to store a backup copy of volume history information. Separate multiple file names with commas and no intervening spaces. This parameter is optional.
If you do not specify a file name, Tivoli Storage Manager stores the information in all files specified with the VOLUMEHISTORY option in the server options file.

Example: Back up the volume history information to a file

Back up the volume history information to a file called VOLHIST.

 backup volhistory filenames=volhist

Related commands

Table 1. Commands related to BACKUP VOLHISTORY
Command	Description
DELETE VOLHISTORY	Removes sequential volume history information from the volume history file.
DELETE VOLUME	Deletes a volume from a storage pool.
QUERY VOLHISTORY	Displays sequential volume history information that has been collected by the server.
UPDATE VOLHISTORY	Adds or changes location information for a volume in the volume history file.

Feedback