stfsstat

Displays statistics for the local client. Note that the sanfs_ctl stats command is the equivalent command on the Solaris operating system.

Clients for AIX®

Read syntax diagramSkip visual syntax diagram
>>-stfsstat--+-------+--+------+--+-------+--+--------+--------->
             '- -all-'  '- -cl-'  '- -gio-'  '- -help-'

>--+------+--+-------+--+------+--+------+--+-------+----------->
   '- -ho-'  '- -hos-'  '- -le-'  '- -lo-'  '- -los-'

>--+------+--+------+--+-------+--+---------+--+---------+------>
   '- -ls-'  '- -mc-'  '- -net-'  '- -pager-'  '- -reset-'

>--+--------+--+------+----------------------------------------->
   '- -svfs-'  '- -tm-'

>--+-------------------------------------------------------+---->
   '- -cm--+------------------------------+-- -i--interval-'
           '- -host--host_name-- -p--port-'

>--+-mount_point---------------+-------------------------------><
   +- –mountpoint--mount_point-+
   '- –vfsnumber--vfs_number---'

Clients for Windows®

Read syntax diagramSkip visual syntax diagram
>>-stfsstat----------------------------------------------------->

>--+---------------------------------------------------------------+-><
   |      .-------.                                                |
   |      V       |                                                |
   +- - ----+-?-+-+--+--------------+------------------------------+
   |        +-e-+    '-drive_letter-'                              |
   |        +-h-+                                                  |
   |        +-l-+                                                  |
   |        +-m-+                                                  |
   |        +-n-+                                                  |
   |        +-r-+                                                  |
   |        +-s-+                                                  |
   |        +-t-+                                                  |
   |        +-u-+                                                  |
   |        '-v-'                                                  |
   '-+-----------------------------------------+--+--------------+-'
     '- -c--+-----------------+-- -i--interval-'  '-drive_letter-'
            '-host-- -p--port-'

Parameters

Clients for AIX

–all
Displays all client for AIX statistics, except per-object statistics. This parameter is the same as specifying –tm, –mc, –ls, –le, –svfs, –gio, –pager, and –cl parameters.
–cl
Displays cleaner statistics.
–cm [–host host_name –p port] –i interval
Continuously monitors the specified statistics. The statistics are sent as a string to the specified host_name on the specified UDP port at every specified interval (in seconds). The minimum interval is 20 seconds. If no host or port is specified, the statistics are sent to stdout.
–gio
Displays I/O statistics per global disk (GDISK), including : blocks read and written, and the average number of bytes read and written.
–help
Displays a detailed description for this command.
–ho
Lists the states of all objects in the mcObject hash table, including object ID, flags, and attributes
–hos
Displays a short list of object hash table.
–le
Lists mutex and latch state of all objects in the mcObject hash table, including current holder, hold state, and waiters.
–lo
Lists the states of all objects in the mcObject LRU list, including object ID, flags, and attributes.
–los
Displays a short list of object LRU.
–ls
Lists mutex and latch statistics of metadata cache objects such as mcInstance and mcObject. Statistics include the number of attempts, wait time, and hold time.
–mc
Displays metadata-cache statistics.
–net
Displays network statistics per metadata server with which this client has a lease.
–pager
Displays pager statistics per client, including information about the page-in and page-out activity.
–reset
Resets all statistics to zero. Some statistics, such as object and latch state, cannot be reset because no counters are incremented, but data structures are shown.
–svfs
Displays file-system statistics. These metrics are mount-specific and distinguish between the different mount points. Statistics include the number of file, inode, address space, and super operations performed.
–tm
Displays Transaction Manager (TM) statistics per client related to TM data structures, including the number of messages sent and received (per message type), the maximum lengths and average lengths of the transaction queue, and the number of transactions, messages, and leases lost.
mount_point | –mountpoint mount_point
The mount point where you want to mount the file-system image (for example, the directory above which you want the global namespace image's directory tree to appear).
–vfsnumber vfs_number
Identifies the virtual-file-system (VFS) number associated with the global namespace image for which you want to display statistics. In AIX, every global namespace image has a unique VFS number.

The stfsmount command displays this number when it creates the global namespace image.

Clients for Windows

–?
Displays a detailed description for this command.
–c
Continuously monitors the specified statistics.
–e
Displays the latch state.
–h
Displays the object hashlist statistics.
–i
Displays the interval for sending statistics. This option must be used with the –c parameter.
–l
Lists mutex and latch statistics of metadata cache objects.
–m
Displays metadata-cache statistics.
–n
Displays the engine statistics.
–p
Displays the port for sending statistics. This option must be used with the –c parameter.
–r
Resets the CSM statistics
–s
Displays the object LRU statistics.
–t
Displays Transaction Manager (TM) statistics. This is the default option.
–u
Displays statistics in the short-output format.
–v
Displays file-system statistics
drive_letter
The drive letter mapped to SAN File System. The default letter is T.

Prerequisites

This task must be performed only by trained service technicians.

Description

On Windows machines running the client, the statistics parameters (?, e, h, l, m, n, r, s, t, u, and v) are appended together. For example, to choose to display the latch state and statistics, you would specify –el.

Example

Displays statistics from a client for AIX The following example displays transaction-manager statistics and metadata-cache statistics for the local client for AIX that is mounted on /mnt/sanfs:
stfsstat -tm -mc /mnt/sanfs
Displays statistics from a client for Windows The following example displays statistics for the object-hash list and latch state the local client for Windows mapped to drive S:
stfsstat –he s

Parent topic: Service commands and utilities

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