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

Read syntax diagramSkip visual syntax diagramUPDate LIBVolumelibrary_namevolume_name STATus=PRIvateSCRatchOWNer=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.
Windows operating systemsLinux operating systemsAIX operating systemsOWNer
Windows operating systemsLinux operating systemsAIX operating systemsSpecifies 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.
Windows operating systemsLinux operating systemsAIX operating systemsLABEL LIBVOLUME Windows operating systemsLinux operating systemsAIX operating systemsLabels volumes in manual or automated libraries.
QUERY LIBRARY Displays information about one or more libraries.
QUERY LIBVOLUME Displays information about a library volume.