Tivoli Header

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 280. 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 onsite and offsite.
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.


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