IBM Tivoli Storage Manager, Version 7.1

UPDATE VOLUME (Change a storage pool volume)

Use this command to change the access mode for one or more volumes in storage pools.

You can correct an error condition associated with a volume by updating the volume to an access mode of READWRITE. You can also use this command to change the location information for one or more volumes in sequential access storage pools.

Privilege class

To issue this command, you must have system privilege or operator privilege.

Syntax


                 (1)                
>>-UPDate Volume------volume_name------------------------------->

>--+------------------------------+----------------------------->
   '-ACCess--=--+-READWrite-----+-'   
                +-READOnly------+     
                +-UNAVailable---+     
                |           (2) |     
                +-DEStroyed-----+     
                |         (3)   |     
                '-OFfsite-------'     

>--+---------------------------+-------------------------------->
   |          (4)              |   
   '-LOcation------=--location-'   

   .-WHERESTGpool--=--*---------.   
>--+----------------------------+------------------------------->
   '-WHERESTGpool--=--pool_name-'   

   .-WHEREDEVclass--=--*-----------------.   
>--+-------------------------------------+---------------------->
   '-WHEREDEVclass--=--device_class_name-'   

>--+-------------------------------------+---------------------->
   |                 .-,---------------. |   
   |                 V                 | |   
   '-WHEREACCess--=----+-READWrite---+-+-'   
                       +-READOnly----+       
                       +-UNAVailable-+       
                       +-OFfsite-----+       
                       '-DEStroyed---'       

>--+---------------------------------+-------------------------->
   |                 .-,-----------. |   
   |                 V             | |   
   '-WHERESTatus--=----+-ONline--+-+-'   
                       +-OFfline-+       
                       +-EMPty---+       
                       +-PENding-+       
                       +-FILling-+       
                       '-FULl----'       

   .-Preview--=--No------.   
>--+---------------------+-------------------------------------><
   '-Preview--=--+-No--+-'   
                 '-Yes-'

Notes:

You must update at least one attribute (ACCESS or LOCATION).
This value is valid only for volumes in primary storage pools.
This value is valid only for volumes in copy storage pools.
This parameter is valid only for volumes in sequential access storage pools.

Parameters

volume_name (Required)

Specifies the storage pool volume to update. You can use wildcard characters to specify names.

ACCess

Specifies how client nodes and server processes (such as migration) can access files in the storage pool volume. This parameter is optional. Possible values are:

READWrite

Specifies that client nodes and server processes can read from and write to files stored on the volume.

If the volume being updated is an empty scratch volume that had an access mode of offsite, the server deletes the volume from the database.

READOnly

Specifies that client nodes and server processes can only read files stored on the volume.

If the volume being updated is an empty scratch volume that had an access mode of offsite, the server deletes the volume from the database.

UNAVailable

Specifies that neither client nodes nor server processes can access files stored on the volume.

Before making a random access volume unavailable, you must vary the volume offline. After you make a random access volume unavailable, you cannot vary the volume online.

If you make a sequential access volume unavailable, the server does not attempt to mount the volume.

If the volume being updated is an empty scratch volume that had an access mode of offsite, the server deletes the volume from the database.

DEStroyed

Specifies that a primary storage pool volume has been permanently damaged. Neither client nodes nor server processes can access files stored on the volume. Use this access mode to indicate an entire volume that needs to be restored by using the RESTORE STGPOOL command. After all files on a destroyed volume have been restored to other volumes, the server automatically deletes the destroyed volume from the database.

Only volumes in primary storage pools can be updated to DESTROYED.

Before updating a random access volume to DESTROYED access, you must vary the volume offline. After you update a random access volume to DESTROYED, you cannot vary the volume online.

If you update a sequential access volume to DESTROYED, the server does not attempt to mount the volume.

If a volume contains no files and you change the access mode to DESTROYED, the server deletes the volume from the database.

OFfsite

Specifies that a copy storage pool volume is at an offsite location from which it cannot be mounted. Only volumes in copy storage pools can have the access mode of OFFSITE.

If you specify values for both the ACCESS and LOCATION parameters but the access mode cannot be updated for a particular volume, the location attribute is also not updated for that volume. For example, if you specify ACCESS=OFFSITE and a LOCATION value for a primary storage pool volume, neither the access nor location values are updated because a primary storage pool volume cannot be given an access mode of OFFSITE.

LOcation

Specifies the location of the volume. This parameter is optional. It can be specified only for volumes in sequential access storage pools. The maximum length of the location is 255 characters. Enclose the location in quotation marks if it contains any blank characters. To remove a previously defined location, specify the null string ("").

WHERESTGpool

Specifies the name of the storage pool for volumes to be updated. Use this parameter to restrict the update by storage pool. This parameter is optional. You can use wildcard characters to specify names. If you do not specify a storage pool name, volumes belonging to any storage pool are updated.

WHEREDEVclass

Specifies the name of the device class for volumes to be updated. Use this parameter to restrict the update by device class. This parameter is optional. You can use wildcard characters to specify names. If you do not specify a device class name, volumes with any device class are updated.

WHEREACCess

Specifies the current access mode of volumes to be updated. Use this parameter to restrict the update to volumes that currently have the specified access mode. This parameter is optional. You can specify multiple access modes by separating the modes with commas and no intervening spaces. If you do not specify a value for this parameter, the update is not restricted by the current access mode of a volume. Possible values are:

READWrite: Update volumes with an access mode of READWRITE.
READOnly: Update volumes with an access mode of READONLY.
UNAVailable: Update volumes with an access mode of UNAVAILABLE.
OFfsite: Update volumes with an access mode of OFFSITE.
DEStroyed: Update volumes with an access mode of DESTROYED.

WHERESTatus

Specifies the status of volumes to be updated. Use this parameter to restrict the update to volumes that have a specified status. This parameter is optional. You can specify multiple status values by separating the values with commas and no intervening spaces. If you do not specify a value for this parameter, the update is not restricted by volume status. Possible values are:

ONline: Update volumes with a status of ONLINE.
OFfline: Update volumes with a status of OFFLINE.
EMPty: Update volumes with a status of EMPTY.
PENding: Update volumes with a status of PENDING. These are volumes from which all files have been deleted, but the time specified by the REUSEDELAY parameter has not elapsed.
FILling: Update volumes with a status of FILLING.
FULl: Update volumes with a status of FULL.

Preview

Specifies whether you want to preview the update operation without actually updating volumes. This parameter is optional. The default value is NO. Possible values are:

No: Specifies that volumes are actually updated.
Yes: Specifies that you want only to preview the update operation. This option displays the volumes that will be updated if you actually perform the update operation.

Example: Make a tape volume unavailable

Update a tape volume named DSMT20 to make it unavailable to client nodes and server processes.

update volume dsmt20 access=unavailable

Example: Update the access mode of all offsite volumes in a specific storage pool

Update all empty, offsite volumes in the TAPEPOOL2 storage pool. Set the access mode to READWRITE and delete the location information for the updated volumes.

update volume * access=readwrite location="" wherestgpool=tapepool2
    whereaccess=offsite wherestatus=empty

Related commands

Table 1. Commands related to UPDATE VOLUME
Command	Description
DEFINE VOLUME	Assigns a volume to be used for storage within a specified storage pool.
DELETE VOLUME	Deletes a volume from a storage pool.
QUERY VOLUME	Displays information about storage pool volumes.
VARY	Specifies whether a disk volume is available to the server for use.

Feedback