DSN トレース・ストリームのアクティブ化

DSN トレース・ストリームは、トレース・メッセージから構成されます。各メッセージは、実行された、あるいは間もなく実行される特定の機能を表します。 これらのメッセージを画面上に表示するか、データ・セットで収集するか、あるいはその両方を指定します。 これらのメッセージは、可能性がある待機およびループを診断する場合に特に有用です。

このタスクについて

DSN トレース・ストリームは、明示的な DSN コマンドまたは DB2I を使用してアクティブ化することができます。

手順

DSN トレース・ストリームをアクティブ化するには、以下のいずれかの方法を選択します。

  • 明示的な DSN コマンドを使用して DSN トレース・ストリームをアクティブ化します。
    1. DSN コマンドで TEST パラメーターを 100 より大きい数値に設定して DSN セッションを開始します。 100 より大きい数値を入力すると、すべての CSECT がトレースされます。
      次のコマンドを使用します。
      DSN SYSTEM(subsystem_name) TEST(255)
      ここで、subsystem_name はサイトで定義されたサブシステムの名前です。

      DSN セッションは、TSO 環境から DSN が入力されると開始されます。 DSN セッション中に DSN トレース・ストリームをオンにするには、現行の DSN セッション内で上記の DSN サブコマンドを再入力します。

    2. DSN トレースがアクティブ化されると、すべてのトレース・メッセージが TSO メッセージ発行者ルーチン (IKJEFF02) を介して TSO SYSTSPRT DD ステートメントに送られます。 オプションで、DD 名が DSNTRACE である別のデータ・セットを割り振ることで、DSN トレース情報を複製することができます。 その後、DSNTRACE データ・セットを使用して、オフライン参照および診断用に、DSN コマンドで生成されたトレース・メッセージのみが含まれる別個のログを保持することができます。 DSNTRACE データ・セットは、RECFM=F、および LRECL=132 を使用して、DSN を呼び出す前に順次データ・セットとして割り振る必要があります。
    3. 端末に表示される DSN トレース・メッセージ、あるいはトレース・ストリームを収集したデータ・セット内の DSN トレース・メッセージを確認します。

      多くの場合、DSN トレース・メッセージに含まれるテキストは、問題に関する手掛かりを提供します。 問題を診断するために、特別メッセージは、DSN から Db2® へ (およびその逆) の制御の受け渡しを明確に示します。 これらのメッセージは、問題が Db2、DSN、あるいはアプリケーション・プログラムのいずれで発生したかを判別するのに役立ちます。

      具体的には、等号を並べた区切り線を含むトレース・メッセージは、アプリケーションと Db2 の間で制御が受け渡されていたタイミングを示します。一連の等号は、DSN と Db2 の間の「壁」と見なすことができ、指定されたトレース・イベントがその領域で発生することを示します。 これらの各トレース・メッセージは、以下のいずれかの行で始まります。
      BEFORE some event =============
      AFTER  that event =============

      BEFORE メッセージが表示された場合は必ず、制御が Db2 に受け渡されたことを示します。AFTER メッセージが表示された場合は必ず、制御がアプリケーション・プログラムに戻されたことを示します。

    4. 追加情報については、DSN トレース・ストリームに関する注記を参照してください。
  • DB2I を使用して DSN トレース・ストリームをアクティブ化します。
    1. DB2I 基本メニュー (DSNEPRI) を起動します。
    2. オプション 0 を選択します (これは、メニューに表示されません)。
    3. ENTER キーを押して、Db2 TSO MAINTENANCE SYSTEM を紹介するパネルを通過します。 次のパネルでは、複数の TSO 接続機能のトレース方法を選択できます。
    4. TRACE DSN フィールドに 100 より大きい値を入力します。 ENTER キーを押して、DB2I 基本メニューに戻ります。
    5. アプリケーションを実行すると、DSN トレース・メッセージが表示されます。

例

図 1. TSO 接続機能 DSN トレース・メッセージのサンプル
. BEFORE SQL CALL トレース・メッセージと AFTER SQL CALL トレース・メッセージの各ペアは、1 つの SQL ステートメントの処理を表します。
DSNET20I  DSNECP13  CIBCORID :H443722 X'00000000' X'00000000'
DSNET20I  DSNECP13  ZINDOUBT :NO X'00000000' X'00000000'
DSNET20I  DSNECP13  BEFORE CREATE THREAD DB2 CALL======R6,CIBRFRB X'00187840' X'00187DA0'
DSNET20I  DSNECP13  AFTER CREATE THREAD DB2 CALL======R6,CIBRFRB X'00187840' X'00187DA0'
DSNET20I  DSNECP13  FOLLOWING ARE FRB FIELD CONTENTS, CIBCTFRM= X'00187DA0' X'00000000'
DSNET20I  DSNECP13  FRBRAL(PTR), FRBRALE(BIN15), FRBFVLE(BIN15) X'00000000' X'00010004'
DSNET20I  DSNECP13  FRBPARM(PTR), FRBPCNT(BIN15) X'00000000' X'00000000'
DSNET20I  DSNECP13  FRBRC1(BIN15), FRBRC2(CHAR4) X'00000000' X'00000000'
DSNET20I  DSNECP13  FRBFBACK PRT(31), FRBRHPC X'00000000' X'00000000'
DSNET20I  DSNECP13  FRBQUAL(BIN15), FRBRSV1(BIN15) X'00000001' X'00000000'
DSNET20I  DSNECP13  CIBPLNID :TSOAP1 X'00000000' X'00000000'
DSNET20I  DSNECP13  ZINDOUBT :NO X'00000000' X'00000000'
DSNET20I  DSNECP13  R6=, CIBCTRTN=X'00187840' X'E2E8D5C3'
DSNET20I  DSNECP13  EXIT DSNECP13 X'00000000' X'00187DA0'
DSNET20I  DSNECP28  AFTER DSNECP13, CIBCTRTN=,CIBCTFRB= X'E2E8D5C3' X'00187DA0'
DSNET20I  DSNECP28  HERE COMES THE FRB <<<<<<<<<<<<<<< CIBRFRB= X'80187DA0' X'00000000'
DSNET20I  DSNECP28  FRBRAL(PTR),    FRBRALE(BIN15), FRBFVLE(BIN15) X'00000000' X'00030001'
DSNET20I  DSNECP28  FRBPARM(PTR),   FRBPCNT(BIN15) X'001AB1E0' X'000000000'
DSNET20I  DSNECP28  FRBRC1(BIN15),  FRBRC2(CHAR4) X'00000000' X'00000000'
DSNET20I  DSNECP28  FRBFBACK:                                               X'00000000' X'00000000'
DSNET20I  DSNECP28  FRBFBACK PTR(31),FRBRHPC X'00000000' X'00000000'     840' X'00187DA0'
DSNET20I  DSNECP28  FRBQUAL(BIN15), FRBRSV1(BIN15) X'00000001' X'00000000'
DSNET20I  DSNECP28  EXIT DSNECP28,CIBRFRB,CIBFRMLI X'80187DA0' X'00000000'
DSNET20I  DSNETRAP  BEFORE SQL CALL=======================FRB,R1== X'80187DA0' X'00187870'
DSNET20I  DSNETRAP  AFTER SQL CALL=====================RC1,FBACK== X'00000000' X'00000000'
DSNET20I  DSNETRAP  BEFORE SQL CALL=======================FRB,R1== X'80187DA0' X'00187870'
DSNET20I  DSNETRAP  AFTER SQL CALL=====================RC1,FBACK== X'00000000' X'00000000'
DSNET20I  DSNETRAP  AFTER LINK GOOD, R15=, R1= X'00000000' X'0018753C'   40' X'00187DA0'
DSNET20I  DSNECP18  ENTER DSNECP18, CIBTRMOP= X'E2E8D5C3' X'00000000'
DSNET20I  DSNECP18  CIBTRMOP NOT BLANK, CIBTRMOP= X'E2E8D5C3' X'00000000'
DSNET20I  DSNECP18  FRB FIELDS FOLLOW (CIBFRB): X'00187DA0' X'00000000'
DSNET20I  DSNECP18  FRBRAL(PTR),    FRBRALE(BIN15), FRBFVLE(BIN15) X'00000000' X'00010001'
DSNET20I  DSNECP18  FRBPARM(PTR),   FRBPCNT(BIN15) X'001873A8' X'00000000'
DSNET20I  DSNECP18  FRBRC1(BIN15),  FRBRC2(CHAR4) X'00000000' X'00000000'
DSNET20I  DSNECP18  FRBFBACK(PTR),  FRBRHPC(BIN32) X'00000000' X'00000000'
DSNET20I  DSNECP18  FRBQUAL(BIN15), FRBRSV1(BIN15) X'00000001' X'00000000'
DSNET20I  DSNECP18  BEFORE TERMINATE DB2 CALL===============TRMOP= X'E2E8D5C3' X'00000000'
DSNET20I  DSNECP18  AFTER TERMINATE DB2 CALL====================== X'00000000' X'00000000'
DSNET20I  DSNECP18  FRB FIELDS FOLLOW (CIBFRB): X'00187DA0' X'00000000'
DSNET20I  DSNECP18  FRBRAL(PTR),    FRBRALE(BIN15), FRBRVLE(BIN15) X'00000000' X'00010001'