Administrator's Reference

UPDATE VOLUME (Change the Attributes of One or More Storage Pool Volumes)

Use the UPDATE VOLUME command to change the access mode for one or more volumes in random or sequential access storage pools. You can also use this command to change the location information for one or more volumes in sequential access storage pools. This command can be used to update volumes assigned to primary or copy storage pools. If you do not explicitly update a parameter, it remains unchanged.

You can reset any error state associated with a volume by updating the volume to an access mode of READWRITE.

A random access volume must be varied offline before you can update the volume to unavailable or destroyed. To vary a volume offline, use the VARY command.

If a scratch volume with a status of EMPTY and an access mode of OFFSITE is updated so that the access mode is READWRITE, READONLY, or UNAVAILABLE, the volume is deleted from the database.

Use the QUERY VOLUME command to display the set of defined storage pool volumes.

Privilege Class

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

Syntax

                  (1)
>>-UPDate Volume-------volname---------------------------------->
 
>---+-------------------------------+--------------------------->
    '-ACCess--=--+-READWrite-----+--'
                 +-READOnly------+
                 +-UNAVailable---+
                 |           (2) |
                 +-DEStroyed-----+
                 |         (3)   |
                 '-OFfsite-------'
 
>---+----------------------------+------------------------------>
    |          (4)               |
    '-LOcation------=--location--'
 
    .-WHERESTGpool--=--*----------.
>---+-----------------------------+----------------------------->
    '-WHERESTGpool--=--poolname---'
 
     .-WHEREDEVclass--=--*--------------.
>----+----------------------------------+----------------------->
     '-WHEREDEVclass--=--devclassname---'
 
>----+---------------------------------------+------------------>
     |                 .-,---------------.   |
     |                 V                 |   |
     '-WHEREACCess--=----+-READWrite---+-+---'
                         +-READOnly----+
                         +-UNAVailable-+
                         +-OFfsite-----+
                         '-DEStroyed---'
 
>----+-----------------------------------+---------------------->
     |                 .-,-----------.   |
     |                 V             |   |
     '-WHERESTatus--=----+-ONline--+-+---'
                         +-OFfline-+
                         +-EMPty---+
                         +-PENding-+
                         +-FILling-+
                         '-FULl----'
 
     .-Preview--=--No-------.
>----+----------------------+----------------------------------><
     '-Preview--=--+-No--+--'
                   '-Yes-'

1	You must update at least one attribute (ACCESS or LOCATION).
2	This option is supported only for volumes in primary storage pools.
3	This option is supported only for volumes in copy storage pools.
4	This attribute can be specified only for volumes in sequential-access storage pools.

Parameters

volname

Specifies name of the storage pool volume to be updated. This parameter is required; however, you can use a pattern-matching expression to specify this name. All matching volumes are included in the update.

ACCess=newaccessmode

Specifies how users and system processes (like migration) can access files in the storage pool volume. The access mode of all updated volumes will be changed to this value. This parameter is optional. Possible values are:

READWrite

Specifies that users and system processes (like migration) 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 volume is deleted from the ADSM database.

READOnly

Specifies that users and system processes (like migration) 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 volume is deleted from the ADSM database.

UNAVailable

Specifies that neither users nor system processes (like migration) can access files stored on the volume.

If you update a random access volume to unavailable, you cannot vary the volume online.

If you update a sequential access volume to unavailable, ADSM 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 volume is deleted from the ADSM database.

DEStroyed

Specifies that a primary storage pool volume has been permanently damaged. Neither users nor system processes (like migration) can access files stored on the volume.

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

If you update a random access volume to destroyed, you cannot vary the volume online.

If you update a sequential access volume to destroyed, ADSM does not attempt to mount the volume.

This access mode is used to indicate an entire volume that should be restored by using the RESTORE STGPOOL command. After all files on a destroyed volume have been restored, the volume is automatically deleted from the database.

If a volume contains no files and the UPDATE VOLUME command is used to change the access mode to destroyed, the volume is deleted 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 be updated to offsite.

Use this mode to help you track volumes that you move to offsite locations. ADSM treats offsite volumes differently than other volumes:

Mount requests are not generated for volumes located offsite
Data can be reclaimed or moved from offsite volumes by retrieving files from other storage pools
Empty, offsite scratch volumes are not deleted from the copy storage pool

LOcation=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. The location must be enclosed in quotation marks if it contains any blank characters. To remove a previously defined description, specify the null string ("").

Note:

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 LOCATION for primary storage pool volumes, neither the access nor location values are updated because these volumes cannot be given an access mode of OFFSITE.

WHERESTGpool=poolname

Specifies the name of the storage pool for volumes to be updated. This parameter can be used to restrict the update by storage pool. This parameter is optional. You can use a pattern-matching expression to specify this name. If you do not specify a storage pool name, volumes belonging to any storage pool are updated.

WHEREDEVclass=devclassname

Specifies the name of the device class for volumes to be updated. This parameter can be used to restrict the update by device class. This parameter is optional. You can use a pattern-matching expression to specify this name. If you do not specify a device class name, volumes with any device class are updated.

WHEREACCess=accessmode

Specifies the current access mode of volumes to be updated. This parameter can be used to restrict the update to volumes that currently have the specified access mode.

This parameter is optional. You can specify more than one access mode in a list by separating each mode with a comma, with no intervening spaces. If you do not specify a value for this parameter, the update is not restricted by the volumes' current access mode. Possible values are:

READWrite: Specifies that volumes with an access mode of READWRITE are updated.
READOnly: Specifies that volumes with an access mode of READONLY are updated.
UNAVailable: Specifies that volumes with an access mode of UNAVAILABLE are updated.
OFfsite: Specifies that volumes with an access mode of OFFSITE are updated.
DEStroyed: Specifies that volumes with an access mode of DESTROYED are updated.

WHERESTatus=status

Specifies the status of volumes to be updated. This parameter can be used to restrict the update to volumes that have a specified status. This parameter is optional. You can specify more than one status in a list by separating each status with a comma, with no intervening spaces. If you do not specify a value for this parameter, the updated volumes are not restricted by volume status. Possible values are:

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

Preview=value

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

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

Examples

Task 1

Update a tape volume namedDSMT20 to make it unavailable to users and system processes (like migration).

Command:: update volume dsmt20 access=unavailable

Task 2

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

Command:: update volume * access=readwrite location="" wherestgpool=copystg whereaccess=offsite,unavailable wherestatus=empty

Related Commands

Table 250. 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 one or more storage pool volumes.
VARY Specifies whether a disk volume is available to the server for use.

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 one or more storage pool volumes.
VARY	Specifies whether a disk volume is available to the server for use.

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