Use this command to back up sequential volume history information to one or more files. You can 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:
You can use the VOLUMEHISTORY server option to specify one or more volume history files. TSM updates volume history files whenever server sequential volume history information is changed.
Privilege Class
To issue this command, you must have system privilege or unrestricted storage privilege.
Syntax
>>-BAckup VOLHistory----+--------------------------------+----->< | .-,--------------. | | V | | '-Filenames=-----file_name----+--'
Parameters
If you do not specify a file name, TSM stores the information in all files specified with the VOLUMEHISTORY option in the server options file.
Note: | TSM does not prefix a qualifier to the dataset name you provide. To
specify a fully qualified name, enclose the name in single quotation marks
surrounded by double quotation marks.
"'user1.volume.volhist1'","'user1.volume.volhist2'" For more information, see Command Entry Rules. A dataset name that is not enclosed in quotation marks is treated as a partially qualified name. When a dataset is opened, MVS/RACF may prefix a qualifier to the dataset name provided. The prefix depends on what has been set up during installation and on the TSM job submitted to start the server. |
Examples
Task
Back up the volume history information to a file called VOLHIST.
Related Commands
Table 20. 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. |