トラブルシューティング用の DIAGNOSE ユーティリティー

DIAGNOSE ユーティリティーにより、Db2® サービス担当員は、ユーティリティーを使用した問題の診断が可能になります。 TYPE パラメーターを使用して、最大 32 個のアクティビティーをモニターすることができます。 これらのアクティビティーは、サービス担当員によって必要に応じて定義されます。

DIAGNOSE を使用して、以下のことを行うこともできます。

  • ユーティリティー異常終了のダンプを取得し、そのようなダンプを抑止する可能性がある考慮事項を解消する
  • OBD および SYSUTIL の情報を確認のために SYSPRINT に送信する (DISPLAY オプション)
  • SVC ダンプを強制せずに、Db2 MEPL およびアプリケーション・スペース (DSNUTILB) MEPL の両方を SYSPRINT にダンプする (DISPLAY MEPL オプション)
  • SYSIBM.SYSDATABASE 内のデータベースの項目を SYSPRINT にダンプする (DISPLAY オプション)
  • 特定の Db2 メッセージが指定された後、あるいはモジュール・トレース ID が発生した場合に、強制的に Db2 を異常終了させる (ABEND オプションと MESSAGE オプションまたは TRACEID オプションの連携)

構文図の診断

構文図を読む
>>-DIAGNOSE--+-diagnose statement-+----------------------------><
             '-END----------------'   

diagnose statement:

構文図を読む
>>-+---------------------+-------------------------------------->
   |       .-,-------.   |   
   |       V         |   |   
   '-TYPE(---integer-+-)-'   

>--+------------------------------------+----------------------->
   '-ALLDUMPS-+-----------------------+-'   
              |   .-,-------------.   |     
              |   V               |   |     
              '-(---X'abend-code'-+-)-'     

>--+-----------------------------------+------------------------>
   '-NODUMPS-+-----------------------+-'   
             |   .-,-------------.   |     
             |   V               |   |     
             '-(---X'abend-code'-+-)-'     

>--+----------------+--+-------------------+--+-----------------+-><
   '-wait statement-'  '-display statement-'  '-abend statement-'   

wait statement:

構文図を読む
         .-.----------------.   
         V                  |   
>>-WAIT----+-message spec-+-+----------------------------------><
           '-traceid spec-'     

abend statement:

構文図を読む
>>-ABEND--+-message spec-+--+--------+-------------------------><
          '-traceid spec-'  '-NODUMP-'   

display statement:

構文図を読む
>>-DISPLAY------------------------------------------------------>

>--+-OBD-+----------------+-table-space-name-+---------+-----+-><
   |     '-database-name.-'                  +-ALL-----+     |   
   |                                         +-TABLES--+     |   
   |                                         '-INDEXES-'     |   
   +-SYSUTIL-------------------------------------------------+   
   +-MEPL----------------------------------------------------+   
   '-DBET-+-DATABASE--database-name------------------------+-'   
          +-TABLESPACE-+----------------+-table-space-name-+     
          |            '-database-name.-'                  |     
          '-INDEX--index-name------------------------------'     

message spec:

構文図を読む
>>-MESSAGE--message-id--+-------------------+------------------><
                        '-INSTANCE--integer-'   

traceid spec:

構文図を読む
>>-TRACEID--+-X'trace-id'-+--+-------------------+-------------><
            '-integer-----'  '-INSTANCE--integer-'   

キーワードおよびパラメーターの説明

TYPE(integer, …)
実行する 1 つ以上の診断タイプを指定します。

integer は、診断タイプの数です。 タイプの最大数は 32 です。

ALLDUMPS(X'abend-code', …)
ユーティリティー異常終了コードから強制的にダンプを取得します。

X'abend-code' は、異常終了コードのリストのメンバーです。ALLDUMPS の適用範囲はこのリストに制限されます。 ALLDUMPS の適用範囲の制限はオプションです。

abend-code は 16 進値です。

NODUMPS(X'abend-code', …)
任意のユーティリティー異常終了コードのダンプを抑止します。

X'abend-code' は、異常終了コードのリストのメンバーです。NODUMPS の適用範囲はこのリストに制限されます。 NODUMPS の適用範囲の制限はオプションです。

abend-code は 16 進値です。

END
DIAGNOSE 処理を終了します。
WAIT
指定のユーティリティー・メッセージもしくはユーティリティー・トレース ID が検出されると、コンソールにメッセージが出され、ユーティリティーの実行は、オペレーターがそのメッセージに応答するか、ユーティリティー・ジョブがタイムアウトになるか、あるいはユーティリティー・ジョブが取り消されるまで延期されます。 これにより、並行性問題の診断中にイベントを同期化させることができます。 ユーティリティーは、オペレーターがメッセージに応答するまで待機し、イベントの時刻調整や同期化を可能にします。

ユーティリティー・メッセージとトレース ID のどちらも見つからない場合は、WAIT 処理が続行されます。

ABEND
指定のユーティリティー・メッセージまたはユーティリティー・トレース ID が検出されると、実行中のユーティリティーが強制的に異常終了されます。
ユーティリティー・メッセージとトレース ID のどちらも見つからない場合は、ABEND 処理が続行されます。
NODUMP
DIAGNOSE の異常終了によって生成されるダンプを抑止します。
DISPLAY
指定されたデータベース・エンティティーが、SYSPRINT を使用してフォーマットされることを示します。
OBD database-name.table-space-name
指定された表スペースのオブジェクト記述子 (OBD) が SYSPRINT にフォーマットされることを指定します。

database-name は、表スペースが属しているデータベースの名前です。

table-space-name は、OBD がフォーマット設定される表スペースの名前です。
ALL
指定された表スペースのすべての OBD が SYSPRINT でフォーマットされることを指定します。 表スペースに関連するすべての関係の OBD もフォーマットされます。
TABLES
指定された表スペース内のすべての表の OBD が SYSPRINT にフォーマットされることを指定します。
INDEXES
指定された表スペース内のすべての索引の OBD が SYSPRINT にフォーマットされることを指定します。
SYSUTIL
すべての SYSUTIL レコードが SYSPRINT にフォーマットされることを指定します。
MEPL
モジュール入り口点リスト (MEPL) が SYSPRINT にダンプされることを示します。
DBET
データベース例外表 (DBET) の表項目のコンテンツが SYSPRINT にダンプされることを示します。 このオプションは、IBM® サポート・センターに指示された場合にのみ使用してください。
DATABASE database-name
指定されたデータベースに関連する DBA 表項目が SYSPRINT にダンプされることを示します。

database-name は、データベースの名前です。

TABLESPACE database-name.table-space-name
指定された表スペースに関連する DBA 表項目が SYSPRINT にダンプされることを示します。

database-name は、データベースの名前です。

table-space-name は、SYSPRINT にダンプされる表スペースの名前です。

INDEX creator-name.index-name
指定された索引に関連する DBA 表項目が SYSPRINT にダンプされることを示します。

creator-name は、索引の作成者の ID です。

index-name は、SYSPRINT にダンプされる索引の名前です。

MESSAGE message-id
メッセージの発行時に待機または異常終了が発生する原因となる DSNUxxx メッセージまたは DSNUxxxx メッセージを指定します。
message-id は、Uxxx または Uxxxx の形式 (メッセージ番号の長さによって変わります) のメッセージ ID です。
INSTANCE integer
MESSAGE オプション・メッセージの検出が指定された回数に達すると、待機または異常終了が発生することを指定します。 INSTANCE を指定しないと、メッセージが検出されるたびに待機または異常終了が発生します。

integer は、待機または異常終了が発生するまでに許容されるメッセージの検出回数です。

TRACEID trace-id
ID が検出されると待機または異常終了が発生する原因となるトレース ID を指定します。 有効なトレース ID は、データ・セット prefix.SDSNSAMP(DSNWEIDS) で見つけることができます。
trace-id は、ユーティリティー・トレース (RMID21) に関連するトレース ID で、10 進 (integer) または 16 進 (trace-id') のどちらで指定することもできます。
INSTANCE integer
TRACEID オプションの検出が指定された回数に達すると、待機または異常終了が発生することを指定します。 INSTANCE を指定しないと、トレース ID が検出されるたびに待機または異常終了が発生します。

integer は、待機または異常終了が発生するまでに許容されるトレース ID の検出回数です。