Administrator's Reference

BACKUP VOLHISTORY (Save Sequential Volume History Information)

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

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, 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.

Command:
backup volhistory filenames=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.


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