Administrator's Reference

UPDATE VOLHISTORY (Update Sequential Volume History Information)

Use this command to update volume history information for a volume produced by a database dump, a database backup, or an export operation. This command does not apply to storage pool volumes.

Note:

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

Note:

Specify this parameter only if Tivoli Disaster Recovery Manager is licensed for your system.

Possible states are:

MOuntable

The volume contains valid data and is accessible for onsite processing.

NOTMOuntable

The volume is onsite, contains valid data, and is not accessible for onsite processing.

COUrier

The volume is being moved offsite.

VAult

The volume is offsite, contains valid data, and is not accessible for onsite processing.

COURIERRetrieve

The volume is being moved onsite.

Examples

Task

Update the location of a volume used for database backup, BACKUP1, to show that it has been moved to an offsite location.

Command:

update volhistory backup1 devclass=tapebkup
location="700 w. magee rd."

Related Commands

Table 335. Commands Related to UPDATE VOLHISTORY