fcstat コマンド

目的

指定されたファイバー・チャネル・デバイス・ドライバーが収集した統計情報を表示します。

構文

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

説明

fcstat コマンドは、指定されたファイバー・チャネル・デバイス・ドライバーが収集した統計情報を表示します。 オプションとして一般的なデバイスの統計情報のほかに、デバイス固有の統計情報を表示するように指定できます。フラグを指定しないと、fcstat コマンドは一般的なデバイスの統計情報のみを表示します。fcstat コマンドは、次の手順を使用して統計情報を収集します。
  1. fcstat のメッセージ・カタログをオープンし、パラメーター・リストを検査する。
  2. 選択されたアダプターに関連した情報を検索するために、オブジェクト・データ・マネージャー (ODM) データベースにアクセスする。
  3. 選択されたアダプターのポートに関連した情報を検索するために、ODM データベースにアクセスする。
  4. アダプター統計情報をオープンし、アクセスする。
  5. -z フラグが指定されている場合は、一部の統計情報をリセットする。
  6. 統計情報を報告して、終了する。

無効な Device_Name を指定すると、fcstat コマンドは ODM データベース内でデバイスを検索できないことを示すエラー・メッセージを戻します。

また、fcstat コマンドは、指定された Device_Name がネットワークに接続されていない (つまり、リンクが切断されている) 場合にも、-d フラグを使用して診断モードでデバイスをオープンすることにより統計情報を報告します。リンクが切断されていて、デバイスが診断モード以外のモードでオープンされると、fcstat コマンドによる出力の生成が遅れます。デバイスが既にオープンされていて、fcstat コマンドが -d フラグで開始すると、デバイスのオープン操作は EACCESS エラーで失敗します。

fcstat コマンドは、指定された Device_Name から統計情報を取り出すことができない場合も、ODM データベースから取り出した情報は報告します。

フラグ

項目 説明
-d 診断モードでアダプターをオープンして統計情報を表示します。
-e デバイス固有の統計情報 (ドライバー統計、リンク統計、FC4 タイプ) を含む、すべての統計情報を表示します。
-z 一部の統計情報をリセットして初期値に戻します。このフラグを発行できるのは、特権ユーザーのみです。

パラメーター

項目 説明
Device_Name ファイバー・チャネル・デバイスの名前。例: fcs0。

統計フィールド

注: アダプターによっては、特定の統計情報をサポートしない場合があります。 サポートされない統計フィールドの値は、常に 0 です。fcstat コマンドを –z フラグと一緒に使用すると、アスタリスク (*) の付いたパラメーターはすべてリセットされて初期値に戻ります。

fcstat コマンドの出力に表示される統計フィールドとその説明は次のとおりです。

項目 説明
  Device Type アダプターの記述を表示します。
  Serial Number アダプターのシリアル番号を表示します。
  Option ROM Version アダプターのオプション ROM のバージョンを表示します。
  ZA アダプターの VPD から ZA フィールドを表示します。
  Node WWN アダプターの worldwide name を表示します。
  Port FC ID アダプターの SCSI ID を表示します。
  Port Type アダプターの接続タイプを表示します。
  Port Speed アダプターのスピードを表示します。
  Port WWN ポートの worldwide name を表示します。
  Seconds Since Last Reset アダプター上の統計情報の最終リセット以後の秒数を表示します。
* Frames 送信および受信されたフレームの数を表示します。
* Words 送信および受信されたワードの数を表示します。
* LIP Count LIP カウントを表示します。
* NOS Count NOS カウントを表示します。
  Error Frames エラーのあるフレームの数を表示します。
* Dumped Frames ダンプされたフレームを表示します。
  Link Failure Count リンク障害カウントを表示します。
  Loss of Sync Count 同期が失われた回数を表示します。
  Loss of Signal シグナルが失われた回数を表示します。
  Primitive Seq Protocol Err Count プリミティブ・シーケンスのエラー回数を表示します。
  Invalid Tx Word Count 無効な転送の発生数を表示します。
  Invalid CRC Count CRC エラーの発生数を表示します。
  IP over FC Adapter Driver Information: No DMA Resource Count DMA リソースが使用不可であった回数を表示します。
  IP over FC Adapter Driver Information: No Adapter Elements Count 使用可能なアダプター・エレメントがなかった回数を表示します。
  FC SCSI Adapter Driver Information: No DMA Resource Count DMA リソースが使用不可であった回数を表示します。
  FC SCSI Adapter Driver Information: No Adapter Elements Count 使用可能なアダプター・エレメントがなかった回数を表示します。
  FC SCSI Adapter Driver Information: No Command Resource Count 使用可能なコマンド・リソースがなかった回数を表示します。
* IP over FC Traffic Statistics: Input Requests 入力要求の数を表示します。
* IP over FC Traffic Statistics: Output Requests 出力要求の数を表示します。
* IP over FC Traffic Statistics: Control Requests 制御要求の数を表示します。
* IP over FC Traffic Statistics: Input Bytes 入力バイトの数を表示します。
* IP over FC Traffic Statistics: Output Bytes 出力バイトの数を表示します。
* FC SCSI Traffic Statistics: Input Requests 入力要求の数を表示します。
* FC SCSI Traffic Statistics: Output Requests 出力要求の数を表示します。
* FC SCSI Traffic Statistics: Control Requests 制御要求の数を表示します。
* FC SCSI Traffic Statistics: Input Bytes 入力バイトの数を表示します。
* FC SCSI Traffic Statistics: Output Bytes 出力バイトの数を表示します。
  Adapter Effective Max Transfer Value 実効最大転送値を表示します。
  FC4 Types : Supported ULP サポートされる ULP を表示します。
  FC4 Types : Active ULP アクティブな ULP を表示します。

終了状況

項目 説明
0 コマンドは正常に完了しました。
>0 エラーが発生しました。

例

  1. ファイバー・チャネル・デバイス・ドライバー fcs0 の統計情報を表示するには、次のように入力します。
    fcstat fcs0
    次のような出力が表示されます。
    注: さまざまな AIX® コマンドの出力フォーマットは常に静的とは限りません。fcstat コマンドの出力が常に次のようになるという予想でプログラムを作成しないようにしてください。
    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

位置

/usr/sbin/fcstat