POWER7 information

fcstat command

Purpose

Displays the statistics of the virtual adapter gathered by the specified Fibre Channel device driver.

Syntax

fcstat [-z | -e] [-d] -device_name

Description

The fcstat command displays the statistics gathered by the specified Fibre Channel device driver. It collects the statistics using the following process:

Opens the message catalog of fcstat and checks the parameter list.
Accesses the Object Data Manager (ODM) database for information that relates to the selected virtual adapter.
Accesses the ODM database for information that relates to ports of the selected virtual adapter.
Opens and accesses adapter statistics of the virtual adapter.
Reports statistics and exits program.

Flags

Flag name	Description
-client	Displays the statistics of the virtual adapter per client.
-d	Displays the statistics by opening the adapter in diagnostic mode.
-device_name	The name of the Fibre Channel device, for example, fcs0.
-e	Displays all the statistics, which includes the device-specific statistics.
-n wwpn device_name	Displays the statistics on a virtual port level that is specified by the worldwide port number (WWPN) of the virtual adapter.
-z	Resets some of the statistics back to their initial values. Only privileged users can issue this flag.

Exit Status

Return code	Description
0	Successful completion.
>0	An error occurred.

Examples

To display the statistics for Fibre Channel device driver fcs0, type the command as follows:

fcstat fcs0

Output similar to the following is displayed.

Note: The output format of various AIX® commands is not always static. Do not write programs with the expectation that the output for the fcstat command will remain as follows.

FIBRE CHANNEL STATISTICS REPORT: fcs0

    Device Type: FC Adapter (df1000f9)
    Serial Number: 1E313BB001
    Option ROM Version: 02C82115
    ZA: B1F2.10A5
    Node WWN: 20000000C9487B04
    Port WWN: 10000000C9416DA4

    FC4 Types 
      Supported: 0x0000010000000000000000000000000000000000000000000000000000000000
      Active:    0x0000010000000000000000000000000000000000000000000000000000000000
    Class of Service: 4
    Port FC ID: 011400
    Port Speed (supported): 2 GBIT
    Port Speed (running):   1 GBIT
    Port Type: Fabric

    Seconds Since Last Reset: 345422

    Transmit Statistics    Receive Statistics
    -------------------    ------------------
    Frames: 1              Frames: 1
    Words: 1               Words: 1

    LIP Count: 1
    NOS Count: 1
    Error Frames:  1
    Dumped Frames: 1
    Link Failure Count: 1
    Loss of Sync Count: 1
    Loss of Signal: 1
    Primitive Seq Protocol Err Count: 1
    Invalid Tx Word Count: 1
    Invalid CRC Count: 1

    IP over FC Adapter Driver Information
      No DMA Resource Count: 0               
      No Adapter Elements Count: 0               

    FC SCSI Adapter Driver Information
      No DMA Resource Count: 0               
      No Adapter Elements Count: 0               
      No Command Resource Count: 0               

    IP over FC Traffic Statistics
      Input Requests:   0               
      Output Requests:  0               
      Control Requests: 0               
      Input Bytes:  0               
      Output Bytes: 0               

    FC SCSI Traffic Statistics
      Input Requests:   16289           
      Output Requests:  48930           
      Control Requests: 11791           
      Input Bytes:  128349517       
      Output Bytes: 209883136

To display the statistics on a virtual port level specified by the WWPN of the virtual adapter, type the command as follows:

fcstat -n C050760547E90000 fcs0

The system displays the output as follows:

FIBRE CHANNEL STATISTICS REPORT: fcs0

Device Type: 8Gb PCI Express Dual Port FC Adapter (df1000f114108a03) (adapter/pciex/df1000f114108a0)
Serial Number: 1B03205232
Option ROM Version: 02781135
ZA: U2D1.10X5
World Wide Node Name: 0xC050760547E90000
World Wide Port Name: 0xC050760547E90000

FC-4 TYPES:
  Supported: 0x0000012000000000000000000000000000000000000000000000000000000000
  Active:    0x0000010000000000000000000000000000000000000000000000000000000000
Class of Service: 3
Port Speed (supported): 8 GBIT
Port Speed (running):   8 GBIT
Port FC ID: 0x010f00
Port Type: Fabric

Seconds Since Last Reset: 431494

        Transmit Statistics     Receive Statistics
        -------------------     ------------------
Frames: 2145085                 1702630
Words:  758610432               187172864

LIP Count: 0
NOS Count: 0
Error Frames:  0
Dumped Frames: 0
Link Failure Count: 0
Loss of Sync Count: 0
Loss of Signal: 0
Primitive Seq Protocol Error Count: 0
Invalid Tx Word Count: 61
Invalid CRC Count: 0

IP over FC Adapter Driver Information
  No DMA Resource Count: 0
  No Adapter Elements Count: 0

FC SCSI Adapter Driver Information
  No DMA Resource Count: 0
  No Adapter Elements Count: 0
  No Command Resource Count: 0

IP over FC Traffic Statistics
  Input Requests:   0
  Output Requests:  0
  Control Requests: 0
  Input Bytes:  0
  Output Bytes: 0

FC SCSI Traffic Statistics
  Input Requests:   336
  Output Requests:  6797
  Control Requests: 5
  Input Bytes:  5689607
  Output Bytes: 30281728

To display the statistics of the virtual adapter per client, type the command as follows:

fcstat -client

Note: The output format of various AIX commands is not always static. Do not write programs with the expectation that the output for the fcstat command will remain as follows. The system displays the output as follows:

hostname  dev                wwpn   inreqs  outreqs ctrlreqs    inbytes outbytes DMA_errs Elem_errs Comm_errs 

hina9v02 fcs0  0x10000000C995AECF    52648       30   528456   19695654      600        0         0         0 
hina901  fcs1  0xC05076029C360000     2592        9   523264    3780212      180        0         0         0 
hina902  fcs1  0xC05076029C360008     2136        4      428    4362876       80        0         0         0 
hina903  fcs1  0xC05076029C360010     2721       17     1348      21768      340        0         0         0 
hina904  fcs2  0xC05076029C360018        0        0        0          0        0        0         0         0 
hina905  fcs2  0xC05076029C360020        0        0        0          0        0        0         0         0 
hina908  fcs2  0xC05076029C360038        0        0        0          0        0        0         0         0 

hina9v02 fcs3  0x10000000C9978277    23109       40   852078   27628067      800        0         0         0 
hina901  fcs1  0xC05076029C360004     3954       17   844919   14264972      340        0         0         0 
hina902  fcs1  0xC05076029C36000C     2934        4      450    9906124       80        0         0         0 
hina903  fcs1  0xC05076029C360014     2752       19     1379      22016      380        0         0         0 
hina904  fcs1  0xC05076029C36001C        0        0        0          0        0        0         0         0 
hina905  fcs1  0xC05076029C360024        0        0        0          0        0        0         0         0 
hina908  fcs0  0xC05076029C36003C        0        0        0          0        0        0         0         0

Related Information

The enstat command.

Send feedback Rate this page

Last updated: Wed, June 03, 2015