reportfilesetuse

Displays the usage statistics for pools that currently store data for the specified fileset.

Read syntax diagramSkip visual syntax diagram
>>-reportfilesetuse--+--------+--------------------------------->
                     +- -?----+
                     +- -h----+
                     '- -help-'

>--+-----------------------------+--+--------------+------------>
   |        .-default----------. |  |      .-off-. |
   '- -fmt--+-delim--character-+-'  '- -p--+-on--+-'
            '-xml--------------'

>--+-----------------+--+-------------+--+--------------+------->
   |         .-on--. |  '- -r--number-'  |      .-off-. |
   '- -hdr --+-off-+-'                   '- -v--+-on--+-'

>--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.
–fmt
Specifies the format of the output. You can specify one of the following values:
default
Specify this value to display output in a tabular format using spaces as the delimiter between the columns. This is the default value. For example:
Pool     Fileset Usage   Total Rules That Enable Usage
======================================================
pool_3   In Use                                      7
delim character
Specify this value to display output in a tabular format using the specified character to separate the columns. If you use a shell metacharacter (for example, * or \t) as the delimiting character, enclose the character in single quotation marks (') or double quotation marks ("). A blank space is not a valid character. For example:
pool_3,In Use,7
xml
Specify this value to display output using XML format, for example:
<IRETURNVALUE>
<INSTANCE CLASSNAME="STC_Container">
<PROPERTY NAME="StgPoolName" TYPE="string"><VALUE TYPE="string">pool_3</VALUE>
</PROPERTY>
<PROPERTY NAME="InUse" TYPE="boolean"><<VALUE TYPE="boolean">true</VALUE>
</PROPERTY>
<PROPERTY NAME="PolicyRuleReferenceCount" TYPE="unit32"><VALUE TYPE="unit32">7</VALUE>
</PROPERTY>
</INSTANCE>
</IRETURNVALUE>
–p
Specifies whether to display one page of text at a time or all text at once.
off
Displays all text at one time. This is the default value when the sfscli command is run in single-shot mode.
on
Displays one page of text at time. Pressing any key displays the next page. This is the default value when the sfscli command is run in interactive mode.
–hdr
Specifies whether to display the table header.
on
Displays the table header. This is the default value.
off
Does not display the table header.
–r number
Specifies the number of rows per page to display when the –p parameter is on. The default is 24 rows. You can specify a value from 1 to 100.
–v
Specifies whether to enable verbose mode.
off
Disables verbose mode. This is the default value.
on
Enables verbose mode.
fileset_name
Specifies the name of the fileset to report.

Prerequisites

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

Description

This command displays the following information for each storage pool:
  • Storage pool name.
  • Fileset usage (In Use or Not In Use).
  • Number of rules in the active policy that place files into the storage pool.

Example

List fileset usage The following example displays usage statistics for fileset cnt_2:
sfscli> reportfilesetuse cnt_2
Pool     Fileset Usage   Total Rules That Enable Usage
======================================================
pool_1   In Use                                      0
pool_2   Not In Use                                  4
pool_3   In Use                                      7

Parent topic: Administrative commands

Related tasks
Viewing fileset statistics
Viewing storage pool statistics

Related reference
autofilesetserver
attachfileset
chfileset
detachfileset
lsfileset
mkfileset
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