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.
vary online ⁄adsm⁄stgvol⁄1
Make volume j:\storage\pool001 available
to the server for use as a storage pool volume.
vary online j:\storage\pool001
Related commands
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. |