VTAM バッファー・トレース

VTAM® バッファー・トレースは、メッセージが VTAM からインバウンドおよびアウトバウンドに流れるときのメッセージ・バッファーの内容を示します。

VTAM バッファー・トレースを開始するために、ユーザーは option=USR を指定して z/OS® 汎用トレース機能 (GTF) を最初に開始する必要があります。次に、z/OS 変更コマンドを使用して、トレースの開始と停止を行います。

トレースを開始するには、次のようにします。

   F VTAMDDF,TRACE,TYPE=BUF,ID=LUDBD2

トレースを停止するには、次のようにします。

   F VTAMDDF,NOTRACE,TYPE=BUF,ID=LUDBD2
     (F         is the z/OS modify command
      VTAMDDF   is the name of the VTAM startup procedure
      TRACE     indicates that the trace is being turned
                 on
      NOTRACE   indicates that the trace is being turned
                 off
      TYPE=BUF indicates that this command affects the
                buffer trace
      ID=LUDBD2 indicates which node is to be traced,
                 or is to no longer be trace.)

コマンドの「ID=」パラメーターにより、このリソースとの間の両方向のメッセージがトレースされます。セッションのセットアップ試行をトレースする場合、トレース対象のリソースの選択が重要です。

トレースが開始された後、診断が必要な問題状態を再現します。問題をトレースした後、GTF データ・セットへの不要なレコードの書き込みを避けるためにトレースを停止します。

VTAM バッファー・トレースのフォーマットに現在使用できるプログラムは ACFTAP と IPCS です。

VTAM バッファー・トレースは、セッションとネットワーク関連の問題の原因を判別するために主に使用されます。トレースには、伝送ヘッダー (TH)、要求/応答ヘッダー (RH)、および最大 256 バイトの要求単位 (RU) データが含まれています。分散データ機能は 4 KB の RUSIZE を使用するので、セッションから送信されるデータをキャプチャーしようとする場合、バッファー・トレースの使用が制限されます。IFCID 160 および 161 を指定する Db2® トレースを使用すると、データをトレースできます。

図 1. インバウンド VTAM およびユーザー・バッファー項目
   USRFD FEF ASCB 00F9D980            JOBN DBD2DIST
              BUFF    LUDBD2  /LUDBD1      LRC(000,000)    INBOUND
              VTAM    TH=40000000 20000010 0000000F 0000000E 1C00006E 006B0006 030D  RH=039020
                                              030AEFFE 41550010 D4C2C840 0000030A 41080060  *........MBH .......-*
                                              D4C9C240 000002FA 00000000 48000000 00030001  *MIB ................*
                                              A0EFCF14 37DA5B01 A0EFCF14 45E83700 4D000000  *......x......Y..(...*
                                              0003561E 4D000000 0002F9F6 00000000 00000000  *....(.....96........*
                                              00000000 00000000 00000000 00000000 00000000  *....................*
                                              00000000 00000000 00000000 E2D8D3C3 C1404040  *............SQLCA   *
                                              00000088 00000000 00004040 40404040 40404040  *...h......          *
                                              40404040 40404040 40404040 40404040 40404040  *                    *
                                              40404040 40404040 40404040 40404040 40404040  *                    *
                                              40404040 40404040 40404040 404040             *                    *
             TIME    48910.070212
   USRFD FF1 ASCB 00F9D980            JOBN DBD2DIST
              BUFF    LUDBD2  /LUDBD1      LRC(000,000)    INBOUND
              USER                            030AEFFE 41550010 D4C2C840 0000030A 41080060  *........MBH .......-*
                                              D4C9C240 000002FA 00000000 48000000 00030001  *MIB ................*
                                              A0EFCF14 37DA5B01 A0EFCF14 45E83700 4D000000  *......x......Y..(...*
                                              0003561E 4D000000 0002F9F6 00000000 00000000  *....(.....96........*
                                              00000000 00000000 00000000 00000000 00000000  *....................*
                                              00000000 00000000 00000000 E2D8D3C3 C1404040  *............SQLCA   *
                                              00000088 00000000 00004040 40404040 40404040  *...h......          *
                                              40404040 40404040 40404040 40404040 40404040  *                    *
                                              40404040 40404040 40404040 40404040 40404040  *                    *
                                              40404040 40404040 40404040 40404040 40404040  *                    *
                                              C4E2D540 40404040 00000000 00000000 00000000  *DSN     ............*
                                              436F24F0                                     *.?.0                *
             TIME    48910.070577
図 2. PRINT=YES を指定した ACFTAP フォーマット
   0000001 RNIO TRACE OUT ORIGIN(0000000F) DESTINATION(0000000E) TIME(10.08.48.174531) DATE(09.26.89)
           TH   40000000000000000000000E0000000F1C00006B006E00070350             OSAF OEF(0000000F 006E) DSAF DEF(0000000E 006B)
                              ERN(0) VRN(0) TP PRI(0) VR SEQ(000) TG SEQ(000) SEQ(0007) COUNT(00848)
           RH   0B90A0                      FM     DR1     EXC                BB    CD              FMT          REQ       UNKNOWN
           RU                               270502FF0003D0
   0000002 RNIO TRACE IN         ORIGIN(0000000E)    DESTINATION(0000000F)  TIME(10.08.48.371635)  DATE(09.26.89)
           TH   40000000200000100000000F0000000E1C00006E006B0006030D             OSAF OEF(0000000E 006B) DSAF DEF(0000000F 006E)
                              ERN(0) VRN(0) TP PRI(0) VR SEQ(010) TG SEQ(000) SEQ(0006) COUNT(00781)
           RH   039020                      FM     DR1     EXC                      CD                           REQ
           RU                               030AEFFE415500