SPUFI トレース機能のアクティブ化

SPUFI トレース・ストリームは、ISPF ログに送信されたトレース・メッセージから構成されます。 ISPF ログには、ISPF トレース機能からのメッセージも表示されます。

手順

SPUFI トレース機能をアクティブ化するには、次のようにします。

  1. DB2I 基本メニュー (DSNEPRI) を起動します。
  2. オプション 0 を選択します (これは、メニューに表示されません)。
  3. ENTER キーを押して、Db2® TSO MAINTENANCE SYSTEM を紹介するパネルを通過します。次のパネルでは、複数の TSO 接続機能のトレース方法が表示されます。
  4. TRACE SPUFI オプションで、YES を入力します。(入力ファイル内の) SQL ステートメントの実行中に発行されたトレース・メッセージが、ISPF ログに書き込まれます。
  5. ISPF browse LOG オプションを使用して、SPUFI トレース・メッセージを参照します。

    ISPF browse LOG オプションおよび他の ISPF コマンドについて詳しくは、z/OS® ISPF プログラムの参照資料を参照してください。

  6. ログを保存するには、セッションの終了時に表示される ISPF パネルで KEEP オプションを指定します。
    SPUFI トレース・メッセージは、処理中のイベントの概略を提供します。 このリストは、ISPF ログおよびそれに含まれる SPUFI トレース・メッセージを確認する際に注意する必要がある重要な要因について説明しています。
    • ISPF ログの先頭には、次のメッセージが表示されます。
      START OF ISPF LOG - - - - - SESSION # nnn --------
      ここで、nnn は、セッションの数です。
    • 後続の各メッセージは、そのセッションに含まれていた処理の重要な側面に関連したものです。
    • 左側の列の項目は、対応する各トレース・メッセージが発行された時間 (分および秒) を示します。
    • メッセージの時間の右側は、メッセージ ID です。各 SPUFI トレース・メッセージは、DSNE から始まります。
    • ほとんどの SPUFI メッセージでは、メッセージ ID の右側は、トレース・メッセージを発行した CSECT の名前です。これらの各 CSECT の名前は、次のフォーマットです。
      DSNESMxx
      ここで、xx は、CSECT を一意的に識別する 0 から 99 の間の数値です。
    • ISPF ログの右側の列は、メッセージの発行時に何が発生したかを示します。
    • 処理が正常に完了した場合、ISPF ログの最後に、次の最終 ISPF メッセージが表示されます。
      END OF ISPF LOG - - - - - - SESSION # nnn --------
      ここで、nnn は、セッションの数です。
    • セッション中に異常終了が発生した場合は、SPUFI トレース・メッセージが中断され、1 つ以上の TSO エラー・メッセージまたは ISPF エラー・メッセージが ISPF ログの末尾に表示されます。 これらのエラー・メッセージは、異常終了完了コードおよびその他の関連情報を示します。

例

図 1. TSO 接続機能 SPUFI トレース・メッセージのサンプル
. SPUFI トレース・メッセージは、ISPF ログに書き込まれます。
16:13    - DSNE454I  DSNESM30  LEAVE YSTUFBUF WITH RBUFU NOW = 64
16:13    - DSNE420I  DSNESM30  LOOPTOP
16:13    - DSNE445I  DSNESM30  TYPE IS INTEGER OR SMALL INTEGER
16:13    - DSNE446I  DSNESM30  BEFORE CONVERSION
16:13    - DSNE447I  DSNESM30  AFTER CONVERSION
16:13    - DSNE449I  DSNESM30  NO TRUNCATION OCCURRED
16:13    - DSNE454I  DSNESM30  LEAVE YSTUFBUF WITH RBUFU NOW = 70
16:13    - DSNE454I  DSNESM30  LEAVE YSTUFBUF WITH RBUFU NOW = 72
16:13    - DSNE420I  DSNESM30  LOOPTOP
16:14    - DSNE445I  DSNESM30  TYPE IS INTEGER OR SMALL INTEGER
16:14    - DSNE446I  DSNESM30  BEFORE CONVERSION
16:14    - DSNE447I  DSNESM30  AFTER CONVERSION
16:14    - DSNE449I  DSNESM30  NO TRUNCATION OCCURRED
16:14    - DSNE454I  DSNESM30  LEAVE YSTUFBUF WITH RBUFU NOW = 80
16:14    - DSNE599I  DSNESM22  - BEGIN EXECUTION
16:14    - DSNE812I  DSNESM22  ABOUT TO WRITE A LINE OF OUTPUT
16:14    - DSNE812I  DSNESM22  ABOUT TO WRITE A LINE OF OUTPUT
16:14    - DSNE581I  DSNESM22  - END EXECUTION 0
16:14    - DSNE404I  DSNESM30  EXITED
16:14    - DSNE820I  DSNESM68  - BEGIN EXECUTION
                                - SQL REQUEST = FETCH
16:14    - DSNE821I  DSNESM68  - END EXECUTION -
                                - SQLCODE = 00000000
16:14    - DSNE403I  DSNESM30  ENTERED
16:14    - DSNE409I  DSNESM30  BEFORE MAIN LOOP
16:14    - DSNE420I  DSNESM30  LOOPTOP
16:14    - DSNE453I  DSNESM30  TYPE IS CHAR, VARCHAR, or LVARCHAR
16:14    - DSNE449I  DSNESM30  NO TRUNCATION OCCURRED
16:14    - DSNE454I  DSNESM30  LEAVE YSTUFBUF WITH RBUFU NOW = 8
16:14    - DSNE454I  DSNESM30  LEAVE YSTUFBUF WITH RBUFU NOW = 20
16:14    - DSNE420I  DSNESM30  LOOPTOP
16:14    - DSNE425I  DSNESM30  TYPE IS CHARACTER
16:14    - DSNE449I  DSNESM30  NO TRUNCATION OCCURRED
16:14    - DSNE454I  DSNESM30  LEAVE YSTUFBUF WITH RBUFU NOW = 28
16:14    - DSNE454I  DSNESM30  LEAVE YSTUFBUF WITH RBUFU NOW = 30
16:14    - DSNE420I  DSNESM30  LOOPTOP
16:14    - DSNE420I  DSNESM30  LOOPTOP
16:14    - DSNE425I  DSNESM30  TYPE IS CHARACTER
16:14    - DSNE449I  DSNESM30  NO TRUNCATION REQUIRED
16:14    - DSNE454I  DSNESM30  LEAVE YSTUFBUF WITH RBUFU NOW = 31
16:14    - DSNE454I  DSNESM30  LEAVE YSTUFBUF WITH RBUFU NOW = 36