chvol

Modifies the settings of one or more volumes.

Read syntax diagramSkip visual syntax diagram
>>-chvol--+----------+--+----------------+---------------------->
          +- –?----+  '- –name--name-'
          +- –h----+
          '- –help-'

                                .-------------.
                                V             |
>--+-----------------------+--+---volume_name-+-+--------------><
   '- –desc--description-'  '- – -----------'

Parameters

–? | –h | –help
Displays a detailed description of this command, including syntax, parameter descriptions, and examples. If you specify a help option, all other command options are ignored.
–name name
Specifies the name to assign to the volume. The volume name must be unique within a cluster and can be up to 256 characters in length.
–desc description
Provides a description of the volume. The description must be enclosed in matching single (') or double (") quotation marks if it contains any blank characters and can be up to 256 characters in length.

The default is an empty string.

volume_name
Specifies the name of one or more volumes to modify.
Note: If you specify a name using the –name option, you may specify one only volume.
Specifies that you want to read the names of one or more volumes to modify from stdin (for example, – << /work/vol_list.txt).

Prerequisites

You must have Administrator privileges to use the command.

You must be logged in to the operating system on the engine hosting the master metadata server to run this command.

Description

You cannot modify the name of multiple volumes at one time.

Example

Modify settings for multiple volumes The following example modifies the description of all the volumes listed in the file /tmp/vol_list.txt to be "Engineering Volumes":
sfscli> chvol –desc "My SAN File System volumes" – << /tmp/vol_list.txt

Volume vol1 modified.
Volume vol2 modified.
Volume vol3 modified.

Parent topic: Administrative commands

Related reference
activatevol
expandvol
lslun
lsvol
mkvol
rediscoverluns
reportvolfiles
rmvol
suspendvol

Terms of use | Feedback
(C) Copyright IBM Corporation 2003, 2004. All Rights Reserved.