-DISPLAY STATS コマンド ( )Db2
-DISPLAY STATS コマンドは、 Db2 による特定のプロセスにおけるリソースの使用に関する統計を表示します。
環境 -DISPLAY STATS
このコマンドは z/OS® コンソール、TSO下のDSNセッション、パネル( DB2I パネル( DB2 COMMANDS)、 IMS または CICS® ターミナル、または計装ファシリティ・インターフェース(IFI)を使用するプログラムから発行できる。
データ共用範囲: グループ
承認 -DISPLAY STATS
このコマンドを実行するには、次のいずれかの特権または権限を含む処理の特権セットを 使用する必要があります。
- DISPLAY 特権
- システム DBADM 権限
- SYSOPR 権限
- SYSCTRL 権限
- SYSADM 権限
構文 -DISPLAY STATS
オプションの説明 -DISPLAY STATS
- INDEXMEMORYUSAGE
- Db2 が索引の高速全探索に使用しているメモリーの現在の量について、統計を表示することを指定します。
省略形: IDXMEMUSE または IMU
INDEXTRAVERSECOUNT
- 特定のインデックス、または降順で最も高いFTBファクターを持つ指定された数のインデックスのFTBファクターの表示を指定します。 以下のバリエーションが受け入れられます
省略形: IDXTRAVCNT または ITC
- DBNAME
- 索引全探索カウントが表示される 1 つ以上のデータベースを指定します。
略号：DBN
以下のバリエーションが受け入れられます。
- (データベース名,...)
- 1 つ以上のデータベース名をコンマまたはブランクで区切って指定します。
- (*)
- プロセスの特権セットに必要な許可がある Db2 サブシステムに定義されている、すべてのデータベース。
- ( dbname 1: dbname2 )
- 名前が UNICODE で、dbname1 と dbname2 の間 (両方を含む) にあるすべてのデータベース。
- (dbname*)
- dbnameという文字列で始まる名前で、1～7文字のデータベース。
- (*dbname)
- dbnameという文字列で終わる名前で、1～7文字のデータベース。
- (*dbname*)
- dbnameという文字列を含むすべてのデータベース。dbnameは 1～6文字で構成される。
- (* dbstring1 * dbstring2 *)
- 名前に文字列を含むすべてのデータベース dbstring1、 dbstring2 合わせて2文字から5文字の文字列を含むすべてのデータベース。
- SPACENAM
- 索引全探索カウントが表示される 1 つ以上の索引を指定します。
- PART
- 表示する 1 つ以上のパーティションのパーティション番号を示します。
指定する整数は、対応するスペース名とデータベース名の有効なパーティション番号を特定する必要があります。 整数 以下の値のいずれかを指定して書き込むことができます
- 1 つ以上のパーティションのリスト
- integer 1 以上、integer2 以下を照合する、すべてのパーティション番号の範囲
- リストと範囲の組み合わせ
- LOGREADERTASKS
- ログ読み取りタスク (SRB) に関する統計を表示することを指定します。
省略形: LOGREADER または LRT
- SCOPE(GROUP)
- LOGREADERTASKS が指定されている場合に、コマンドの有効範囲を指定します。 データ共用グループのすべてのアクティブ・メンバーで実行されているログ・リーダー・タスクに関する情報を表示します。 INDEXMEMORYUSAGE または INDEXTRAVERSECOUNT が指定されている場合、SCOPE(GROUP) は指定できません。 このオプションは、非データ共用環境では無視されます。
- LIMIT
- 表示されるメッセージの数を制限します。
- integer
- 表示されるメッセージの最大数。 この値は1～9999の範囲でなければなりません。 表示できるメッセージの最大数は、使用可能なスペースによって制限されます。
- ( * )
- 使用可能なスペースに収まる数のメッセージを表示するように制限します。
出力先 -DISPLAY STATS
DISPLAY STATSコマンド出力で発行されるメッセージは、コマンドで指定するオプション・キーワードによって異なる。 詳しくは、以下のセクションを参照してください。
- DISPLAY STATS(INDEXMEMORYUSAGE)の出力 (メッセージ DSNT783I )
- DISPLAY STATS(INDEXTRAVERSECOUNT)の出力 (メッセージ DSNT830I )
- DISPLAY STATS(LOGREADERTASKS)の出力 (メッセージ DSNT788I )
DISPLAY STATS(INDEXMEMORYUSAGE)の出力
DSNT783I メッセージは、DISPLAY STATS(INDEXMEMORYUSAGE)コマンドからの出力を表示します。 この出力は、高速索引全探索 (FTB) が使用されている索引に関する以下の情報を提供します。
DBID PSID DBNAME IX-SPACE LVL PART SIZE(KB)
----- ----- -------- -------- --- ---- --------
00279 00005 DB1 IX1 003 0001 00000816
******* DISPLAY OF STATS ENDED **************出力の行は、高速索引全探索に最大量のメモリーを使用している索引から高速索引全探索に最小量のメモリーを使用している索引へ、降順になっています。
- DBID
- 索引を含んでいるデータベースの内部 ID。
- PSID
- 索引スペースのページ・セット記述子。
- DBNAME
- 索引を含んでいるデータベースの名前。
- IX-SPACE
- 索引スペースの数。
- LVL
- 高速インデックス・トラバーサルが使用されているインデックスのインデックス・レベルの数。 高速インデックス・トラバーサル用のFTB（高速トラバース・ブロック）は、ルート・ページと非リーフ・インデックス・ページの情報を含むが、リーフ・ページの情報は含まない。
- PART
- 索引パーティション番号。
- SIZE(KB)
- 高速索引全探索に使用されているメモリーの量 (キロバイト単位)。
同じメモリー使用統計を持つ複数の連続索引パーティションの出力
ある索引の n 個のパーティションでメモリー使用統計が同一である場合は、最初のパーティションについて 1 行が表示され、残りのパーティションの行は出力から省略されます。 それらの行は、次のような出力に置き換えられます。
-THRU nn は、メモリー使用統計が同一である最後のパーティションの番号です。
出力の状況
出力は、次のメッセージで続行されるか終了します。
******* DISPLAY OF STATS status ***********************************- 状態
- 可能な値は以下のとおりです。
- CONTINUED
- 残りの情報が表示されることを示します。
- TERMINATED
- すべての情報が表示されたことを示します。
高速インデックス走査のためのメモリ使用状況の表示例（INDEXMEMORYUSAGE）
DISPLAY STATSコマンドを使用して、 Db2 が高速インデックス・トラバーサルを使用しているすべてのインデックス （
高速トラバーサル・ブロック
またはFTB
と呼ばれることもあります）に関する情報を表示できます。例えば、以下のコマンドを発行したとします-DISPLAY STATS(INDEXMEMORYUSAGE)コマンドを発行する Db2 サブシステムで高速インデックス・トラバーサルが使用されているインデックスが1つだけあり、そのインデックスには5つのレベルのインデックス・ページがあり、1つのパーティションがあり、高速インデックス・トラバーサルに18339 KBのメモリを使用していると仮定します。 結果は以下の出力のようになります。
DSNT783I - DBID PSID DBNAME IX-SPACE LVL PART SIZE(KB) ----- ----- -------- -------- --- ---- -------- 00278 00005 DB1 IX1 005 0001 00018339 ******* DISPLAY OF STATS ENDED ************** DSN9022I - DSNTDSTS 'DISPLAY STATS' NORMAL COMPLETIONここで、インデックスの5つのパーティションで高速インデックス・トラバーサルが使用されている Db2 サブシステム上で、
-DISPLAY STATS(INDEXMEMORYUSAGE)コマンドを実行したと仮定します。インデックス・ページのレベル数と高速インデックス・トラバーサルに使用されるメモリの量は、すべてのパーティションで同じです。 結果は以下の出力のようになります。DSNT783I - DBID PSID DBNAME IX-SPACE LVL PART SIZE(KB) ----- ----- -------- -------- --- ---- -------- 00017 00005 DB1 IX1 003 0006 00000061 -THRU 0010 ******* DISPLAY OF STATS ENDED ************** DSN9022I - DSNTDSTS 'DISPLAY STATS' NORMAL COMPLETION
DISPLAY STATS(INDEXTRAVERSECOUNT)の出力
DSNT830I メッセージは、DISPLAY STATS(INDEXTRAVERSECOUNT) コマンドからの出力を表示します。
出力は、1 つまたは複数の指定されたインデックスのトラバース カウントと FTB ファクターに関する以下の情報を提供します。 複数の行が含まれる場合は、FTBファクターの高いインデックスから降順となる。
- DBID
- 索引を含んでいるデータベースの内部 ID。
- PSID
- 索引スペースのページ・セット記述子。
- DBNAME
- 索引を含んでいるデータベースの名前。
- IX-SPACE
- 索引スペースの数。
- LVL
- 高速インデックス・トラバーサルが使用されているインデックスのインデックス・レベルの数。 高速インデックス・トラバーサル用のFTB（高速トラバース・ブロック）は、ルート・ページと非リーフ・インデックス・ページの情報を含むが、リーフ・ページの情報は含まない。
- PART
- 索引パーティション番号。
- TRAV。 COUNT
- インデックス空間に対するインデックスの移動平均のトラバース数。
- FTBファクター
- Db2 は、インデックス・トラバーサル・カウントとインデックス・ページの分割などの他の要因からFTBファクターの値を計算し、特定のインデックスがインデックス・トラバーサルの恩恵を受けられるかどうかを評価するための重みとして内部的に適用します。
インデックスの走査回数（INDEXTRAVERSECOUNT）に関する情報の表示例
- 特定のインデックス・パーティションのトラバース・カウントとFTBファクターを表示する
-DISPLAY STATS(INDEXTRAVERSECOUNT) DBNAME(DB1) SPACENAM(IX1) PART(1)このコマンド例では、以下のような出力が返されます。
DBID PSID DBNAME IX-SPACE LVL PART TRAV. COUNT FTB FACTOR ----- ----- -------- -------- --- ---- ----------- ----------- 00017 00005 DB1 IX1 003 0001 00000000999 -0000000001 ******* DISPLAY OF STATS ENDED ***************************** FTB 係数が最も高い5つのインデックススペースを表示します
-DISPLAY STATS(ITC) DBNAME(DB1) LIMIT(5)このコマンドの例では、FTB ファクターの高い順から降順でインデックスが並び、次の出力のような結果が返されます
Output (traverse counts are in descending order) DBID PSID DBNAME IX-SPACE LVL PART TRAV. COUNT FTB FACTOR ----- ----- -------- -------- --- ---- ----------- ----------- 00017 00005 DB1 IX2. 003 0008 00000030021 00000030021 00017 00005 DB1 IX2 003 0016 00000029999 00000029999 00017 00005 DB1 IX3 003 0001 00000000999 00000000999 00017 00005 DB1 IX1 003 0001 00000050099 00000000000 00017 00005 DB1 IX2 003 0010 00000050001 -0000000001 ******* DISPLAY OF STATS ENDED *****************************
DISPLAY STATS(LOGREADERTASKS)の出力
DSNT788I -SSID
SESSIONID STATUS CURR. POSITION NUM RECS AGE
CORR-ID LOCATION
---------------- ---------- -------------------- ---------- ------
EE00982796560801 READING 0000000000018898F400 32071 89s
014.LGRTSK01 SVLSSC0A
EE00DAC3E7842E02 SUSP EOS 00000000000188CA2280 30 6s
014.LGRTSK02 DG653758
******* DISPLAY OF STATS ENDED *********************************
DSN9022I -SSID DSNTDSTS 'DISPLAY STATS' NORMAL COMPLETION - SESSIONID
- ログ読み取りタスクを識別する固有のセッション ID。
- 状況
- ログ読み取りタスクの現在の状況:
- 実行しています
- ログ読み取りタスクは、現在ログ・レコードを読み取っています。
- READING
- ログ読み取りタスクは、ログ・レコードが受信されてマージされるのを待機しています。
- SUSP READ
- データが十分な速さで受信されなかったため、内部バッファーがいっぱいです。
- SUSP EOS
- ログの終わりに到達しました。 ログ読み取りタスクは、新しいログ・レコードを待機しています。
- CURR. POSITION
- ログ・レコード内のログ読み取りタスクの現在の RBA または LRSN 位置。
- NUM RECS
- 受信されたレコードの数。
- AGE
- ログ読み取りタスクの開始以降に経過した時間の長さ。
- CORR-ID
- システム・タスクを識別する相関 ID。 CORR-ID は 014.LGRTSK で始まり、固有のものにするために 2 桁の数字が付加されます。
- LOCATION
- 非同期ログ・リーダー・タスクを開始した IBM® Db2 Analytics Accelerator for z/OS または IBM Db2 for z/OS Data Gate インスタンスの名前。 伝送エラーが原因で名前が使用できない場合、LOCATION はリモート・リクエスターの IP アドレスを表示します。
ログ読み取りタスクに関する情報を表示する例（LOGREADERTASKS）
ローカルの Db2 サブシステム上のログ読み取りタスクのステータスに関する情報を表示します
-DISPLAY STATS(LRT)DISPLAY STATS (LOGREADERTASKS) コマンドの出力は、以下の出力のようになります。
DSNT788I -DB2A SESSIONID STATUS CURR. POSITION NUM RECS AGE CORR-ID LOCATION ---------------- ---------- -------------------- ---------- ------ EE00982796560801 READING 0000000000018898F400 32071 89s 014.LGRTSK01 SVLSSC0A EE00DAC3E7842E02 SUSP EOS 00000000000188CA2280 30 6s 014.LGRTSK02 DG653758 ******* DISPLAY OF STATS ENDED ********************************* DSN9022I -DB2A DSNTDSTS 'DISPLAY STATS' NORMAL COMPLETIONメッセージを参照して DSNT788I 返される情報の説明については、メッセージを参照してください。
データ共有グループのすべてのアクティブなメンバーで実行中のログリーダータスクに関する情報を表示します
-DISPLAY STATS(LRT) SCOPE(GROUP)SCOPE (GROUP) オプションを指定した DISPLAY STATS(LOGREADERTASKS) コマンドの出力は、以下の出力のようになります。
DSNT788I -DB2A SESSIONID STATUS CURR. POSITION NUM RECS AGE CORR-ID LOCATION ---------------- ---------- -------------------- ---------- ------ EE00982796560801 READING 00D9EE0DADE987256200 32071 89s 014.LGRTSK01 SVLSSC0A EE00DAC3E7842E03 SUSP EOS 00D9EE0DADE9872CA200 30 6s 014.LGRTSK03 DG653758 ******* DISPLAY OF STATS ENDED ********************************* DSN9035I -DB2A BEGIN OF DISPLAY FOR MEMBER: DB2B --------------------------------------------------- DSNT791I -DB2B NO LOG READER TASK STATISTICS AVAILABLE --------END OF DISPLAY FOR MEMBER: DB2B -------- DSN9035I -DB2A BEGIN OF DISPLAY FOR MEMBER: DB2C --------------------------------------------------- SESSIONID STATUS CURR. POSITION NUM RECS AGE CORR-ID LOCATION ---------------- ---------- -------------------- ---------- ------ EE00DAC2F9812803 SUSP EOS 00D9EE0DADE9872CA200 30 6s 014.LGRTSK03 DG658121 ******* DISPLAY OF STATS ENDED ********************************* --------END OF DISPLAY FOR MEMBER: DB2C -------- DSN9022I -DB2A DSNTDSTS 'DISPLAY STATS' NORMAL COMPLETIONメッセージを参照して DSNT788I 返される情報の説明については、メッセージを参照してください。