User manual

Using S.M.A.R.T. Disk Monitor 143
SANTOOLS® is registered in US Patent and Trademark Office No 3,107,854 All rights reserved.
1.40 Storage Area Network (SAN) I/O Stat
This function can be equated with the standard Unix iostat program. It is designed to show throughput and errors
measured at each fibre channel controller port. This feature does not issue any I/Os to any fibre channel peripherals.
It just queries your local HBAs via the SNIA HBA API library for cumulative totals it maintains.
Syntax:
smartmon-ux -fciostat [-h] [-k] [-r] [-t] [-x] [-?] [<interval>] [<count>]
Where:
-h Suppress descriptive headers between each polling interval
-k Convert words transmitted and received to kilobytes/sec (each word is 4 bytes long)
-r Display raw values (do not calculate totals over time)
-t Display timestamp column
-x Display Extended statistical data columns.
-? Displays Usage and header information. This must be only option after -fciostat
interval Period in seconds between each poll. If you do not enter an interval, program will display cumulative
totals
count Number of iterations program should perform before exiting. This must be used in conjunction with an
interval.
Example #1: Display Usage and Headers
./smartmon-ux -fciostat -?
SMARTMon-ux [Release 1.24, Build 25-JAN-2004] - Copyright 2001-2004 SANtools, Inc. http://www.SANtools.com
Usage: ./smartmon-ux -fciostat [ options...] [ <interval> ] [ <count> ]
Options are:
-h Suppress extra headers between each polling period
-k Display stats in KB/sec (1 KB = 1000 Bytes)
-r Display raw rules (don't calculate totals over time)
-t Display timestamp
-x Display extended information
-? Display help information
<interval> = seconds between each poll
<count> = number of iterations before exiting
Legend:
tps Transactions per second (Total frames transmitted & received)
Tx_Fr/s Transmitted frames per second
Rx_Fr/s Received frames per second
Words_T Words (4 bytes each) transmitted
Words_R Words (4 bytes each) received
LIPs LIP events on arbitrated loop
NOSs NOS events on switched fabric
Errs Error frames
DumpF Dumped frames
LinkF Link failures
SyncF Loss of SYNCs
SignF Loss of signals
ProtE Primitive sequential protocol errors
TrxE Invalid transmission words
CRCE Invalid CRCs
Note - Not all HBAs and/or HBA drivers support reporting any or all of this information
Example #2: Poll and report totals every 10 seconds.
This is how the fciostat will normally be used. The fields shown in blue are the ones that only appear if the -x (for
extended) flag is selected. Comments are in {violet}
smartmon-ux -fciostat -k -x -t -h 10
SMARTMon-ux [Release 1.23D, Build 7-JAN-2004] - Copyright 2001-2004 SANtools, Inc. http://www.SANtools.com
Linux 2.4.9-18smp (Itanium.sanmanager.com) 01/07/04 {O/S version followed by fully qualified host name,
then date}
143