DSN1SDMP
IBM® ソフトウェア・サポートから、IFS 指定域ダンプ (DSN1SDMP) スタンドアロン・ユーティリティーを使用するように指示されることがあります。DSN1SDMP を使用すると、選択した Db2® トレース・イベントが発生したときに強制的にダンプを作成したり、Db2 トレース・レコードをユーザー定義の z/OS® データ・セットに書き込んだり、別の Db2 トレースを開始したりできます。
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 コマンドを定義します。
Db2 サブシステム名は、ユーザーが入力する必要があります。DSN RUN コマンドでは、 ユーザーが実行権限を持っているプランを指定する必要があり ます。DSN1SDMP ダンプは、指定されたプランは実行しません。 このプランは、Db2 に接続するためにだけ使用されます。DSN SYSTEM(subsystem name) RUN PROG(DSN1SDMP) LIB('prefix.SDSNLOAD') PLAN(DSNEDCL)DSN RUN コマンドでプラン名の指定がない場合、デフォルトのプラン名はプログラム名になります。 プランなしで DSN1SDMP を実行すると、ユーザーが実行権限を 持っている DSN1SDMP プランが存在しない場合は、DSN はエラーを生成します。