BACKUP VOLHISTORY (Save sequential volume history information)
Use this command to back up sequential volume history information to one or more files.
- 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
You must use the VOLUMEHISTORY server option to specify one or more volume history files. IBM Spectrum Protect™ updates volume history files whenever server sequential volume history information is changed.
At installation, the server options file includes a VOLUMEHISTORY option that specifies a default volume history file named volhist.out. IBM Spectrum Protect updates volume history files whenever server sequential volume history information is changed.
- 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, IBM Spectrum Protect 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
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. |