statfileset

Displays the transaction statistics for one or more specified filesets.

Read syntax diagramSkip visual syntax diagram
>>-statfileset--+--------+--+-----------------------------+----->
                +- -?----+  |        .-default----------. |
                +- -h----+  '- -fmt--+-delim--character-+-'
                '- -help-'           '-xml--------------'

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

>--+--------------+--+------------------+----------------------><
   |      .-off-. |  | .--------------. |
   '- -v--+-on--+-'  | 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.
–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.
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.
xml
Specify this value to display output using XML format.
–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 names of one or more filesets whose statistics you want to view.
Specifies that in single-shot command mode you want this command to receive from the input stream (stdin) the names of one or more filesets.

Description

If you run this command from an engine hosting a subordinate metadata server, you can only view fileset statistics associated with the local metadata server. If you run this command from the engine hosting the master metadata server, you can view fileset statistics associated with all metadata servers in the cluster.

A transaction is a work request that is handled by the metadata server. You can use the number of transactions performed by each fileset on the metadata server to aid in balancing the workload among all of the metadata servers in the cluster.

This command displays the following information for each fileset:
  • Name of the fileset.
  • Name of the metadata server serving the fileset.
  • Number of transactions that are in progress.
  • Number of transactions that have been stopped.
  • Number of transactions that have been retried.
  • Number of transactions that have been initiated since the metadata server started (including those transactions that are initiated during startup). This count includes the transactions that are in progress, stopped, and completed.
  • Number of transactions that completed successfully.

Example

Displaying number of transactions The following example displays the number of started and completed transactions for filesets being served by the local metadata server:
sfscli> statfileset

Name    Server   Current Transactions  Stopped  Retried  Started  Completed
===========================================================================
cnt_A   ST1                     12344      234      344   908798      87656
cnt_B   ST1                    234445    21344     3444  1098768     987689

Parent topic: Administrative commands

Related tasks
Viewing fileset statistics

Related reference
autofilesetserver
attachfileset
chfileset
detachfileset
lsfileset
mkfileset
reportfilesetuse
rmfileset
setfilesetserver

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