DIAGNOSE 制御ステートメントの構文とオプション

DIAGNOSE ユーティリティー制御ステートメントは、複数のオプションを使用して、 ユーティリティー・ジョブが実行する機能を定義します。

制御ステートメントは、ISPF/PDF 編集機能を使って作成することができます。 制御ステートメントを作成した後、それを順次データ・セットまたは区分データ・セットに保管します。 ジョブを実行するための JCL を作成するときは、SYSIN DD ステートメントを使用して、ユーティリティー 制御ステートメントを格納するデータ・セットの名前を指定してください。

構文図

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

diagnose statement:

>>-+---------------------+-------------------------------------->
   |       .-,-------.   |   
   |       V         |   |   
   '-TYPE(---integer-+-)-'   

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

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

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

display statement:

>>-DISPLAY------------------------------------------------------>

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

wait statement:

構文図を読む
         .-----------------------------------------------------.   
         V                                                     |   
>>-WAIT----+-MESSAGE--message-id--+-------------------+------+-+-><
           |                      '-INSTANCE--integer-'      |     
           '-TRACEID--+-X'trace-id'-+--+-------------------+-'     
                      '-整数----------'  '-INSTANCE--integer-'       

abend statement:

>>-ABEND--+-MESSAGE--message-id--+-------------------+------+--+--------+-><
          |                      '-INSTANCE--integer-'      |  '-NODUMP-'   
          '-TRACEID--+-X'trace-id'-+--+-------------------+-'               
                     '-整数----------'  '-INSTANCE--integer-'                 

オプションの説明

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

integer は、診断タイプの番号です。タイプの最大数 は 32 です。IBM® ソフトウェア・サポートが、IBM ユーティリティーでの問題を診断するために必要なタイプを定義しています。

ALLDUMPS(X'abend-code', …)
ユーティリティー異常終了コードに応答して、強制的にダンプをとります。

X'abend-code' は異常終了コードのリストのメンバーであり、 ALLDUMPS の有効範囲はこのリストに限定されます。

abend-code は、16 進数値です。

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

X'abend-code' は異常終了コードのリストのメンバーであり、 NODUMPS の有効範囲はこのリストに限定されます。

abend-code は、16 進数値です。

DISPLAY
指定のデータベース項目を SYSPRINT を使用してフォーマット設定します。
OBD database-name.table-space-name
表スペースのオブジェクト記述子 (OBD) をフォーマット設定します。

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

table-space-name は、OBD がフォーマット設定される表スペースの名前です。
ALL
表スペースのすべての OBD をフォーマット設定します。 表スペースに関連するいずれのオブジェクトの OBD もフォーマット設定されます。
TABLES
指定の表スペース内のすべての表の OBD をフォーマット設定します。
INDEXES
指定の表スペース内のすべての索引の OBD をフォーマット設定します。
SYSUTIL
SYSIBM.SYSUTIL のすべてのレコードをフォーマット設定します。 このディレクトリー表は、ユーティリティー・ジョブに関する情報を保管します。
MEPL
モジュール・エントリー・ポイント・リスト (MEPL) を SYSPRINT にダンプします。
AVAILABLE
このサブシステムにインストールされているユーティリティーを、 ビットマップ形式および読み取り可能形式の両方で表示します。 Db2® Utilities Suite for z/OS®(5655-W87) が存在するかどうかで、この表示結果が異なります。 メッセージ DSNU862I には、DIAGNOSE DISPLAY AVAILABLE からの出力が表示されます。
関連情報:
DBET
データベース例外表 (DBET) の内容を SYSPRINT にダンプします。
DATABASE database-name
指定されたデータベースに関連する DBET 項目をダンプします。

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

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

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

table-space-name は表スペースの名前です。

INDEX creator-name.index-name
指定された索引に関連する DBET 項目をダンプします。

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

index-name は、索引の名前です。

名前にブランクが含まれている場合は、索引名を引用符で囲みます。

CLONE
以下の指定されたオブジェクトのみに関する情報を DIAGNOSE で表示するよう指示します。
  • クローン表
  • クローン表を含む表スペース
  • クローン表の索引
  • クローン表の索引を含む索引スペース
WAIT
指定されたユーティリティー・メッセージもしくはユーティリティー・トレース ID を 検出すると、ユーティリティーの実行を中断します。DIAGNOSE はコンソールにメッセージを発行します。 オペレーターがそのメッセージに応答するか、ユーティリティー・ジョブがタイムアウトになるか、あるいはユーティリティー・ジョブが取り消されるまでは、ユーティリティーの実行が再開されません。 この待ち時間によって、並行性の問題を診断している間のイベントを同期化することができます。 ユーティリティーは、オペレーターがメッセージに応答するのを待ち、 イベントへの時点合せあるいは同期化ができるようにします。

ユーティリティー・メッセージまたはトレース ID が検出されない場合、処理は続行されます。

ABEND
指定されたユーティリティー・メッセージまたはユーティリティー・トレース ID が出されると、 実行中のユーティリティーを強制的に異常終了させます。
ユーティリティー・メッセージまたはトレース ID が検出されない場合、処理は続行されます
NODUMP
DIAGNOSE の異常終了によって生成されるダンプを抑制します。
MESSAGE message-id
メッセージが出されたときに待機または異常終了を発生させる、DSNUxxx また は DSNUxxxx メッセージを指定します。
message-id は、Uxxx または Uxxxx 形式のメッセージです。
INSTANCE integer
MESSAGE オプション・メッセージが指定した回数だけ検出されたときに、 待機もしくは異常終了が起こるように指定します。 INSTANCE を指定しない場合は、メッセージが検出されるたびに、 待機もしくは異常終了が起こります。

integer は、待機もしくは異常終了が起こるまでのメッセージの検出回数です。

TRACEID trace-id
ID を検出すると待機もしくは異常終了を発生させる、トレース ID を指定します。 有効なトレース ID はデータ・セット prefix.SDSNSAMP(DSNWEIDS) 内で見つけることができます。
trace-id は、ユーティリティー・トレース (RMID21) に関連するトレース ID です。trace-id は 10 進数 (integer) または 16 進数 (X'trace-id') 形式で 指定できます。
INSTANCE integer
TRACEID オプションが指定した回数だけ検出されたときに、 待機もしくは異常終了が起こるように指定します。 INSTANCE を指定しない場合は、トレース ID が検出されるたびに、 待機もしくは異常終了が起こります。

integer は、待機もしくは異常終了が起こるまでのトレース ID の検出回数です。

END
DIAGNOSE 処理を終了します。