IBM Tivoli Storage Manager, Version 7.1

VARY (Bring a random access volume online or offline)

Use this command to make a random access storage pool volume online or offline to the server.

Privilege class

This command is valid only for volumes on random access devices. For example, use this command during maintenance or corrective action of a random access volume. You cannot vary a random access volume online that is defined as unavailable.

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

Syntax


                                   .-Wait--=--No------.   
>>-VARy--+-ONline--+--volume_name--+------------------+--------><
         '-OFfline-'               '-Wait--=--+-No--+-'   
                                              '-Yes-'

Parameters

ONline

Specifies that the server can use the random access volume.

OFfline

Specifies that the server cannot use the volume.

volume_name (Required)

Specifies the volume identifier. Volume names cannot contain embedded blanks or equal signs.

Wait

Specifies whether to wait for the server to complete processing this command in the foreground. This parameter is optional. The default is NO. Possible values are:

No: Specifies that the server processes this command in the background, while other tasks run. The server displays messages created from the background process either in the activity log or the server console, depending on where messages are logged.
Yes: Specifies that the server processes this command in the foreground. Wait for the command to complete before you continue with other tasks. The server displays the output messages to the administrative client when the command completes.
You cannot specify WAIT=YES from the server console.

Example: Bring volume online

Make volume /adsm/stgvol/1 available to the server for use as a storage pool volume.

AIX operating systems

vary online ⁄adsm⁄stgvol⁄1

Make volume /storage/pool001 available to the server for use as a storage pool volume.

HP-UX operating systems

vary online ⁄storage⁄pool001

Make volume j:\storage\pool001 available to the server for use as a storage pool volume.

Windows operating systems

vary online j:\storage\pool001

Related commands

Table 1. Commands related to VARY
Command	Description
CANCEL PROCESS	Cancels a background server process.
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 PROCESS	Displays information about background processes.
QUERY VOLUME	Displays information about storage pool volumes.

Feedback