fcstat command

Purpose

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

Syntax

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

fcstat -n wwpn device_name

fcstat -client

Description

The fcstat command displays the statistics of the virtual adapter gathered by the specified Fibre Channel device driver. It collects the statistics using the following process:
  1. Opens the message catalog of fcstat and checks the parameter list.
  2. Accesses the Object Data Manager (ODM) database for information that relates to the selected virtual adapter.
  3. Accesses the ODM database for information that relates to ports of the selected virtual adapter.
  4. Opens and accesses the statistics of the virtual adapter.
  5. 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 include 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 to their initial values. Only privileged users can issue this flag.

Exit Status

The following exit values are returned:

Value Description
0 Successful completion.
>0 An error occurred.

Examples

  1. To display the statistics for Fibre Channel device driver fcs0, type the following command: 
    fcstat fcs0
    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 remains as follows.

    The system displays the output as follows:

    FIBRE CHANNEL STATISTICS REPORT: fcs0

    Device Type: FC Adapter (df1000f9)
    Serial Number: 1E313BB001
    Option ROM Version: 02C82115
    Firmware Version: 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
  2. To display the statistics on a virtual port level specified by the WWPN of the virtual adapter, type the following command:
    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

    FC4 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        Frames: 1702630
    Words: 758610432       Words: 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
  3. To display the statistics of the virtual adapter per client, type the following command:
    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 remains 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
Parent topic: Virtual I/O Server and Integrated Virtualization Manager commands listed alphabetically
Parent topic: Maintenance commands


Last updated: Wed, November 18, 2020