chfileset

Modifies the settings of a fileset.

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

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

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

>--+-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 name of a fileset to modify.
Specifies that in single-shot command mode you want this command to receive from the input stream (stdin)the name of a fileset to modify.

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 settings for multiple filesets at one time.

Example

Modify parameters of a fileset The following example changes the quota and threshold values for fileset cnt_A. It sets the quota to 1000 MB and specifies to send an alert when the quota reaches 70%.
sfscli> chfileset -quota 1000 -thresh 70 –qtype soft cnt_A
Fileset cnt_A modified.

Parent topic: Administrative commands

Related tasks
Changing fileset settings

Related reference
autofilesetserver
attachfileset
detachfileset
lsfileset
mkfileset
reportfilesetuse
rmfileset
setfilesetserver
statfileset

Library | Support | Terms of use | Feedback
(C) Copyright IBM Corporation 2003, 2004. All Rights Reserved.
IBM TotalStorage SAN File System v2.2