Administrator's Reference
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.
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 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.
|
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.
Use this mode to help you track volumes that you move to offsite
locations. See Administrator's Guide for details.
- 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.
Examples
Task 1
Update a tape volume named DSMT20 to make it unavailable to client nodes
and server processes.
- Command:
- update volume dsmt20 access=unavailable
Task 2
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.
- Command:
- update volume * access=readwrite location="" wherestgpool=tapepool2
whereaccess=offsite wherestatus=empty
Related Commands
Table 298. 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.
|
[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]