nxstat コマンド

目的

nxstat コマンドは、GZIP 機能を実装可能なオンチップ・ハードウェア・アクセラレーターの使用統計を表示します。

構文

nxstat {-S | [-AUWT] [-a accel_type] [-u unit_index ] [-w window_index] [-t window_type] interval [count]}

説明

AIX 論理区画内のアプリケーションは、zlibNX ライブラリーを使用して、GZIP アクセラレーターを持つ通信チャネルを開くことができます。この通信チャネルは、ウィンドウとも呼ばれます。通信チャネルのタイプについて詳しくは、ネスト・アクセラレーターを参照してください。

ウィンドウごとの低レベル使用統計には、システム管理者には重要でないデータが大量に含まれている場合があります。 nxstat コマンドは、コマンドで指定したオプションと引数に基づいて、特定のアクセラレーター・タイプまたは特定のハードウェア・アクセラレーター・ユニットのグローバル使用統計を提供するように、使用統計を集約できます。

以下の値が、各集約レベルの使用統計に、ウィンドウ・タイプと対応するクレジットとともに表示されます。

Opens: ウィンドウのオープン/クローズ操作の回数。
Bytes: ハードウェア・アクセラレーター・ユニットで処理されたバイト数。
Faults: ハードウェア・アクセラレーター・ユニットで検出されたページ・フォールト数。
Intrs: 完了割り込みの回数。この値は、アクセラレーター操作用のオプションです。
Polls: nxstat コマンドのポーリング・フェーズ中に検出された完了割り込みの回数。
Waits: 呼び出し側が実際にブロックされた後で完了した操作の回数。 Polls 値と Waits 値の合計は、特定の時間間隔中に完了した操作の合計回数を表します。

アクティブ GZIP 操作の完了をカーネル・サービスは最初に、スレッドがブロックされるまでの時間について completion ビットをポーリングします。 Polls 値と Waits 値の合計数は、ポーリング・フェーズの効率性と有用性に関する洞察を提供します。

nxstat コマンドは、特定の時間間隔中の特定のアクセラレーター・タイプの使用統計を集約します。 nxstat コマンドは、連続する時間間隔についてのアクセラレーター使用統計も表示することができます。フラグ -A、-U、-T、および -W で集約レベルが決まります。複数のフラグを指定 (例えば -AU) すると、nxstat コマンドは両方の集約レベルの使用統計を表示します。フラグ -a、-u、-t、-w を使用すると、統計データがアクセラレーター・ユニット、ウィンドウ、ウィンドウ・タイプなどの特定オブジェクトに限定されます。

フラグ

-S

これは、使用可能なアクセラレーターのタイプを表示します。

-A

特定アクセラレーター・タイプの使用統計を表示します。これはデフォルト・オプションです。

-U

特定ハードウェア・アクセラレーター・ユニットの使用統計を表示します。

-T

特定ウィンドウ・タイプの使用統計を表示します。

-W

各ウィンドウの使用統計を表示します。

-a

使用統計を表示するアクセラレーター・タイプを指定します。 GZIP アクセラレーターの -a フラグ値は 0 です。現在、 -a フラグでサポートされている値は 0 のみです。したがって、 -a フラグを指定しない場合は、デフォルト値の 0 が適用されます。

-u

使用統計を表示するアクセラレーター・ユニットを指定します。 -U フラグを使用する場合にのみ -u フラグを指定する必要があります。このフラグのアクセラレーター・ユニット索引値は、ゼロからアクセラレーター・ユニット数マイナス 1 までの数値です。例えば、 AIX 論理区画が 3 つのアクセラレーター・ユニットにアクセスできる場合、このフラグに指定できる有効な値は 0、1、および 2 です。

-U フラグとともに -u フラグを指定しないと、nxstat コマンドは、論理区画からアクセス可能なすべてのハードウェア・アクセラレーター・ユニットのデータを表示します。

-w

使用統計を表示する特定ウィンドウを指定します。論理区画から n 個のウィンドウにアクセス可能な場合、ウィンドウには 0 から n-1 までの番号が付けられます。 -W フラグを指定する場合にのみ -w フラグを指定できます。

-t

使用統計を表示する特定ウィンドウ・タイプ (Quality of Service (QoS) の場合は 0、デフォルトの場合は 1) を指定します。 -T フラグを指定する場合にのみ -t フラグを指定できます。

注: -u、 -w 、および -t フラグは相互に排他的です。

Interval

使用統計を収集する必要のある時間間隔 (秒) を指定します。このフラグは必須です。デフォルトでは、カーネル・サービスは 2 秒ごとに使用統計を収集するため、有用なデータを表示するには、2 秒より長い時間間隔を指定する必要があります。

カウント

使用統計を表示する、連続する時間間隔の数を指定します。デフォルト値は 1 です。

例

すべてのアクセラレーター・タイプとすべてのウィンドウ・タイプの合計使用統計を表示するには、次のコマンドを実行します。

nxstat 10 4

次の例に示すような出力が表示されます。

Accelerator GZIP:   Window Types:  2    Units:  1   Credits:   72
Type Cred   Opens          Bytes   Faults      Intrs         Polls         Waits
 ALL   72  266826      35.747 GB        0      17281        222795         61223
 ALL   72  262812      35.638 GB        0      17524        220368         59641
 ALL   72  300647      33.583 GB        0      15990        257351         58969
 ALL   72  259405      35.557 GB        0      17111        216629         60048

 ** Average **
 ALL   72  272422      35.131 GB        0      16976        229285         59970

ウィンドウ・タイプごとのアクセラレーター・レベル統計を表示するには、次のコマンドを実行します。

nxstat -AT 10

次の例に示すような出力が表示されます。

Accelerator GZIP:   Window Types:  2    Units:  4   Credits:   92
Type Cred   Opens          Bytes   Faults      Intrs         Polls         Waits
 QOS   12         0    49.892 GB        0      28695          4998         52476
 DEF   80         0     4.406 GB        0       2561           422          4654

アクセラレーター・ユニットごとのユニット・レベル統計を表示するには、次のコマンドを実行します。

nxstat -U 10 4

次の例に示すような出力が表示されます。

  Unit Index  0:   SRAD ID         0  Window Types:  2    Credits:   23
Type Cred   Opens          Bytes   Faults      Intrs         Polls         Waits
 ALL   23       0      16.735 GB        0       9589          1551         17728

  Unit Index  1:   SRAD ID         1  Window Types:  2    Credits:   23
Type Cred   Opens          Bytes   Faults      Intrs         Polls         Waits
 ALL   23       0      12.438 GB        0       7219          1270         13058

  Unit Index  2:   SRAD ID         2  Window Types:  2    Credits:   23
Type Cred   Opens          Bytes   Faults      Intrs         Polls         Waits
 ALL   23       0      12.427 GB        0       7131          1310         13006

  Unit Index  3:   SRAD ID         3  Window Types:  2    Credits:   23
Type Cred   Opens          Bytes   Faults      Intrs         Polls         Waits
 ALL   23       0      12.430 GB        0       7230          1383         12935

使用可能なアクセラレーターのタイプを表示するには、次のコマンドを実行します。
```
nxstat -S
```
次の例に示すような出力が表示されます。
```
GZIP accelerator available
```