DSN1SDMP

IBM® ソフトウェア・サポートから、IFS 指定域ダンプ (DSN1SDMP) スタンドアロン・ユーティリティーを使用するように指示されることがあります。DSN1SDMP を使用すると、選択した Db2® トレース・イベントが発生したときに強制的にダンプを作成したり、Db2 トレース・レコードをユーザー定義の z/OS® データ・セットに書き込んだり、別の Db2 トレースを開始したりできます。

IFCID 4 開始トレース・レコードまたは IFCID 5 終了トレース・レコード でアクションを実行しないことを確実にするため、制御ステートメントに以下を 追加することをお勧めします。
P4,00
DR,04,X'hhhh'
ここで、 hhhh は、トリガーを設定しようとしている IFCID の 16 進表記です。

出力

このユーティリティーの用途の 1 つは、システム問題の判別と修正の手助けをすることです。 Db2 を診断する際、このユーティリティーの出力を解釈するために ライセンス資料を参照しなければならない場合があります。

環境

DSN1SDMP を z/OS ジョブ として実行し、DSN TSO コマンド・プロセッサーを用いて実行してください。DSN1SDMP を実行するには、Db2 サブシステムが稼働中であることが必要です。

この z/OS ジョブは、 以下のいずれかの条件が該当する場合のみ完了します。

  • DSN1SDMP によって開始された TRACE および追加の選択基準が、FOR パラメーターで 指定された基準と一致する。
  • DSN1SDMP が開始した TRACE が、STOP TRACE コマンドを用いて停止される。
  • オペレーターがジョブを取り消す。

DSN1SDMP を停止させる必要がある場合は、STOP TRACE コマンドを使用します。

必要な許可

このユーティリティーを実行するには、このプロセスの特権セットの中に以下の特権または権限の いずれか 1 つが含まれている必要があります。

  • TRACE システム特権
  • SYSOPR 権限
  • SYSADM 権限
  • MONITOR1 特権または MONITOR2 特権 (ユーザー定義のデータ・セットを使用している場合)
  • SQLADM 権限
  • システム DBADM 権限
  • SECADM 権限

DSN1SDMP を実行するユーザーは、START TRACE キーワードの trace-parameters で指定されている プランの EXECUTE 権限を持っている必要があります。

必要なデータ・セット

DSN1SDMP は、以下の DD ステートメントを 使用します。

SDMPIN
DSN1SDMP への入力パラメーターを指定する、制御データ・セットを定義します。 この DD ステートメントは必須です。LRECL は 80 です。DSN1SDMP が検査する のは、先頭の 72 桁のみです。
SDMPPRNT
DSN1SDMP メッセージに使用される、順次メッセージ・データ・セットを定義し ます。SDMPPRNT DD ステートメントを省略すると、メッセージは何も書き込まれま せん。LRECL は 131 です。
SYSABEND
DSN1SDMP の異常終了時に ABEND ダンプを入れるデータ・セットを定義します。 この DD ステートメントはオプションです。
SDMPTRAC
Db2 が DSN1SDMP に戻す順次 Db2 トレース・レコード・データ・セット を定義します。この DD ステートメントは、トレース・データが OPX トレース宛先に書き込まれる場合にのみ必要です。 宛先が OPX バッファー以外の場合は、SDMPTRAC は無視されます。

Db2 が SDMPTRAC に 書き込むトレース・レコードのフォーマットは、SDMPTRAC トレース・ヘッダーに モニター・ヘッダー (これは DSNDQWIW によってマップされます) が含まれている点を除いて、SMF または GTF レコードと同じです。 DCB パラメーターは、VB、BLKSIZE=32760、LRECL=32756 です。

SYSTSIN
Db2 に接続し、IFC 指定域ダンプを実行するための、以下の DSN コマンドを定義します。
DSN SYSTEM(subsystem name)
RUN PROG(DSN1SDMP) LIB('prefix.SDSNLOAD') PLAN(DSNEDCL)
Db2 サブシステム名は、ユーザーが入力する必要があります。DSN RUN コマンドでは、 ユーザーが実行権限を持っているプランを指定する必要があり ます。DSN1SDMP ダンプは、指定されたプランは実行しません。 このプランは、Db2 に接続するためにだけ使用されます。

DSN RUN コマンドでプラン名の指定がない場合、デフォルトのプラン名はプログラム名になります。 プランなしで DSN1SDMP を実行すると、ユーザーが実行権限を 持っている DSN1SDMP プランが存在しない場合は、DSN はエラーを生成します。