chfileset

Modifies the settings of one or more filesets.

Read syntax diagramSkip visual syntax diagram
>>-chfileset--+--------+--+----------------------+-------------->
              +- -?----+  '- -name--fileset_name-'
              +- -h----+
              '- -help-'

>--+---------------+--+----------------------+------------------>
   '- -quota--size-'  '- -thresh--percentage-'

>--+-------------------+--+---------------------+--------------->
   |          .-soft-. |  '- -desc--description-'
   '- -qtype--+-hard-+-'

     .--------------.
     V              |
>--+---fileset_name-+-+----------------------------------------><
   '- - --------------'

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
Specifies the name to assign to the fileset. This name can be up to 256 characters in length.
–quota size
Specifies the maximum size limit, in megabytes, for the specified fileset that, when exceeded, causes the metadata server to generate an alert. You can specify a number from 0 to 1 073 741 824 MB (1 PB). If set to 0, there is no quota size limit for this fileset, and alerts are not sent.
Note: If a hard quota already exists, you must not set the new size to a value less than the current quota size for this fileset.
–thresh percentage
Specifies the maximum percentage (alert threshold) of the specified quota size for this fileset that, when exceeded, causes the metadata server to generate an alert. You can specify a value between 0 and 100. If set to 0, no alerts are generated.
–qtype hard | soft
Specifies the quota type for the fileset. You can specify one of the following values:
hard
A hard quota produces a log message and potential alert when the quota is met, and denies requests for additional space.
soft
A soft quota produces a log message and potential alert when the quota size is exceeded, but grants requests space allocation.
–desc description
Specifies a description for the fileset. The description must be enclosed in matching single (') or double (") quotation marks if it contains any blank characters. This description can be up to 256 characters in length.

The default is an empty string.

fileset_name
Specifies the names of one or more filesets to modify.
Note: If you specify a name using the –name option, you may specify one only fileset.
Specifies that you want to read the names of one or more filesets to modify from stdin (for example, – << /work/cnt_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 for multiple filesets at one time.

Example

Modify parameters of two filesets The following example changes the quota and threshold values for two filesets (cnt_A and cnt_B). It, sets the quota to 1 000 MB and specifies to send an alert when the quota reaches 70%.
sfscli> chfileset -quota 1000 -thresh 70 -qtype soft cnt_A cnt_B
Fileset cnt_A modified.
Fileset cnt_B modified.

Parent topic: Administrative commands

Related reference
autofilesetserver
attachfileset
detachfileset
lsfileset
mkfileset
reportfilesetuse
rmfileset
setfilesetserver
statfileset

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