UPDATE LIBVOLUME (Change the status of a storage volume)

Use this command to change the status of a sequential access storage volume in a library.

Privilege class

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

Syntax


>>-UPDate LIBVolume--library_name--volume_name--STATus--=--+-PRIvate-+-->
                                                           '-SCRatch-'   

>--+-----------------------+-----------------------------------><
   '-OWNer--=--server_name-'

Parameters

library_name (Required)

Specifies the name of the library.

volume_name (Required)

Specifies the volume name of the storage volume.

STATus (Required)

Specifies a change to the status of a storage volume. Possible values are as follows:

PRIvate: Specifies that the server updates the storage volume to a private volume.
SCRatch: Specifies that the server updates the storage volume to a scratch volume.

Restriction: You cannot change the status of a volume from private to scratch if the volume belongs to a storage pool or is defined in the volume history file. You can change the status if you make a mistake when you check in volumes to the library and assign the volumes the wrong status.

OWNer

Specifies which server owns a private volume in a shared library that is shared across a SAN. You can change the owner of a private volume in a shared library (SAN) when you issue the command from the library manager server. If you do not specify this parameter, the library manager server owns the private volume.

Important: Do not use OWNER as a value for scratch volumes. However, you can use OWNER when you change a scratch volume to private.

Example: Update a volume's status

Update the volume that is named WPDV00 in the library that is named AUTO to reflect a status of PRIVATE.

update libvolume auto wpdv00 status=private

Related commands

Table 1. Commands related to UPDATE LIBVOLUME
Command	Description
AUDIT LIBRARY	Ensures that an automated library is in a consistent state.
CHECKIN LIBVOLUME	Checks a storage volume into an automated library.
CHECKOUT LIBVOLUME	Checks a storage volume out of an automated library.
DEFINE VOLUME	Assigns a volume to be used for storage within a specified storage pool.
LABEL LIBVOLUME	Labels volumes in manual or automated libraries.
QUERY LIBRARY	Displays information about one or more libraries.
QUERY LIBVOLUME	Displays information about a library volume.