UPDATE VOLHISTORY (Update sequential volume history information)
Use this command to update volume history information for a volume produced by a database backup or an export operation. This command does not apply to storage pool volumes.
Use the UPDATE BACKUPSET command to update specified backup set volume information in the volume history file. Do not use this UPDATE VOLHISTORY command to update backup set volume information in the volume history file.
Privilege class
You must have system privilege or unrestricted storage privilege to issue this command.
Syntax
>>-UPDate VOLHistory--volume_name-------------------------------> >--DEVclass--=--device_class_name--+-----------------------+----> '-LOcation--=--location-' >--+----------------------------------+------------------------>< '-ORMSTate--=--+-MOuntable-------+-' +-NOTMOuntable----+ +-COUrier---------+ +-VAult-----------+ '-COURIERRetrieve-'
Parameters
- volume_name (Required)
- Specifies the volume name. The volume must have been used for a database backup or an export operation.
- DEVclass (Required)
- Specifies the name of the device class for the volume.
- LOcation
- Specifies the volume location. This parameter is required
if the ORMSTATE parameter is not specified. The maximum text
length is 255 characters. Enclose the text in quotation marks if it
contains any blank characters. Note: The UPDATE VOLHISTORY command supports updates to the location information and ORMSTATE for snapshot database backup volumes.
- ORMSTate
- Specifies a change to the state of a database backup volume. This
parameter is required if the LOCATION parameter is not specified.
This parameter is only supported for systems licensed with Tivoli® Disaster
Recovery Manager. Possible states are:
- MOuntable
- The volume contains valid data and is accessible for on-site processing.
- NOTMOuntable
- The volume is on-site, contains valid data, and is not accessible for on-site processing.
- COUrier
- The volume is being moved off-site.
- VAult
- The volume is off-site, contains valid data, and is not accessible for on-site processing.
- COURIERRetrieve
- The volume is being moved on-site.
Example: Update the location of a volume used for database backup
Update the location of a volume used for database backup, BACKUP1, to show that it has been moved to an off-site location.update volhistory backup1 devclass=tapebkup
location="700 w. magee rd."
Related commands
Command | Description |
---|---|
BACKUP VOLHISTORY | Records volume history information in external files. |
DELETE VOLHISTORY | Removes sequential volume history information from the volume history file. |
MOVE DRMEDIA | Moves DRM media on-site and off-site. |
PREPARE | Creates a recovery plan file. |
QUERY DRMEDIA | Displays information about disaster recovery volumes. |
QUERY VOLHISTORY | Displays sequential volume history information that has been collected by the server. |