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

Table 1. Commands related to UPDATE VOLHISTORY
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.