拡張通信機能トレース分析プログラム (ACFTAP)

拡張通信機能トレース分析プログラム (ACFTAP) は、ACF/SSP (システム・サポート・プログラム) ライセンス製品の一部です。 このフォーマッターは、GTF レコードを解釈し、要求されたオプションに応じてさまざまなフォーマットでバッファー・トレース・レコードを発行します。

ACFTAP は、アプリケーション・インターフェース経由で VTAM® に提供されるデータをフォーマットしません。 この情報は、IPCS を使用してフォーマットする場合にのみ使用可能です。以下のオプションは、VTAM バッファー・トレースに関連しています。

SOURCE=GTF
このオプションは、入力データ・セットに GTF フォーマットのレコードがあることを ACFTAP に通知します。 通常、これは、z/OS® システムで定義されている入力のみです。
INPUT=BUFFER
このオプションは、入力データ・セット内のバッファー・レコードのみを使用するように ACFTAP に指示します。 入力データ・セットには、VTAM 内部トレース・レコード、Db2® パフォーマンス・トレース・レコード、および多種多様な z/OS レコードなど、さまざまな種類のレコード・タイプが入っている場合があります。
NODE=<name>
このオプションは、指定されたノードのすべてのレコードをフォーマットするように ACFTAP に要求します。 このオプションを省略すると、ACFTAP はネットワーク PIU (セッションのセットアップまたは停止、リソースのアクティブ化または非アクティブ化などを行うために流れている PIU) のみをフォーマットします。 トレースが取得された時間によっては、ジョブからの出力がない場合があります。
PRINT=YES
このオプションは、各 PIU の項目 (TH および RH の解釈など) を提供します。 45 バイトの RU のみが表示されます。

図 2 は、PRINT=YES を使用した場合の ACFTAP フォーマットの例を示しています。 この PIU は、図 1 の PIU と同じです。

このトレース項目は、LUDBD2 から LUDBD1 に流れている (この VTAM からの) アウトバウンド PIU を示しています。

TH の解釈は、LU のアドレスとカウント・フィールドを示しています。 カウント・フィールドでは、TH 内の長さフィールドが X'350' から 10 進数の 848 に変換されています。 起点サブエリア・フィールド (OSAF) および起点エレメント・フィールド (OEF) は、LUDBD2 のアドレス '0000000F 006E' を示しています。 同様に、宛先アドレスは '0000000E 006B' です。このアドレスは、LUDBD1 を表しています。

図 1. ACFTAP オプション SSPRT=YES を使用してフォーマットされたバッファー・トレース
                                                    ADVANCED COMMUNICATIONS FUNCTION
                                                         TRACE ANALYSIS PROGRAM
            DATE: 09:19:89                        SYSTEMS NETWORK ARCHITECTURE SUMMARY                        PAGE: 00001
              *******SDLC******  **********TRANSMISSION HEADER*********  ************************REQUEST HEADER*********************
              ..-SDLC ADDRESS    .-FORMAT IDENTIFIER (FID)               .-REQUEST(Q) OR RESPONSES  .-PACING INDICATOR
              || .-CMND/RESP     | .-F/M/L/( =ENTIRE)SEGMENT  **FID3**   | .-SC/DFC/NC/( =FMDATA)RU   | .-BEGIN BRACKET INDICATOR
  DIRECTION-. || | .-POLL/FINAL  | | .-EXPEDITED                         | | .-FORMATTED              | | .-END BRACKET INDICATOR
            | || | | .-RECEIVE   | | |                        LSID---.   | | |  .-F/M/L( =ONLY)CHAIN  | | | .-CHANGE DIRECTION IND
    TYPE--. | || | | | .-SEND    | | |    SAF-EF     FROM/TO SSCP--. |   | | |  |                     | | | | .-ALT CODE
  ------- | | || | | | | .-TYPE  | | |      OR       FROM/TO PU--. | |   | | |  |                     | | | | |    *********RU******
  MESSAGE | | || | | | | | CMND  | | |   OAF  DAF    SEQNO COUNT | | |   | | |  |  REQUEST/RESPONSES  | | | | |     COMMAND   SENSE
  NUMBER  V V VV V V V V V ____  V V V _____________ _____ _____ V V V   V V V  V  _________________  V V V V V    _________  ______
  0000001 B O                    4     0000000F 006E 0007  00848        Q   F     DR1     EXCEPTION    B   S      UNKNOWN
                                       0000000E 006B
  0000002 B I                    4     0000000E 006B 0006  00781        Q         DR1     EXCEPTION        S
                                       0000000F 006E
RH 内のビットも解釈されています。以下の機能がリストされます。
  • FMT は、RU に FMH があることを示します。この例では、これは FMH5 です。
  • BB は、これがブラケットの先頭であることを示します。
  • CD は変更の方向で、LUDBD1 が一部のデータを送り返すことを許可します。
  • REQ は、これが要求 PIU であることを示します。
  • DR1 および EXC は、エラーがある場合にのみこの PIU に応答を送信するように LUDBD1 に指示します。
  • FM は、RU データ・タイプです。

このフォーマットは、RU が FMH5 を保持することを示しますが、それ以外には特にありません。

次の図は、インバウンド PIU です。これは、VTAM バッファー・トレース で VTAM 項目にフォーマットされた PIU と同じです。

このトレース項目は、LUDBD1 から LUDBD2 へのインバウンド・バッファーを示します。 この PIU でも同様の TH および RH の解釈が発生しています。 実際には、この PIU は、LUDBD2 に送り返されている選択からの出力の最初の行です。 すべてのデータが VTAM バッファー・トレースで使用できるわけではありません。Db2 パフォーマンス・トレースで見られる場合もあります。

SDPRT=YES
このオプションは、VTAM バッファー・トレースの SNA 詳細レポートを要求します。PRINT=YES でフォーマットされる 2 つの項目は、比較のために SDPRT=YES を使用してフォーマットされています。

SNA の詳細は、オンにあるかどうかに関係なく、TH の各セクションおよび RH の各ビットの解釈を提供します。 前述の PRINT=YES は、オンのビットの解釈のみを提供します。 SNA の詳細には、トレースされたすべての PIU (TH、RH、および最大 256 バイトの RU) も含まれます。 'USER DATA' では、RU は EBCDIC から英数字に変換されており、データの解釈が容易になっています。

SSPRT=YES
このオプションは、前の図に示されている SNA 要約レポートを要求します。 このレポートだけでは、問題の診断にはほとんど役に立ちません。 しかし、バッファー・トレースが長く、発生した特定のイベントを探す場合には便利です。 コマンドあるいは出力のセンス列を使用することで、特定のイベントを検索できる場合があります。 イベントが見つかったら、その行のメッセージ番号を使用して、SNA の詳細と相互参照したり、レポートを表示したりします。 すべての特定の PIU は、各レポートで同じメッセージ番号を持ちます。
図 2. ACFTAP を使用して表示される VTAM 入出力トレース
   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

SNA 要約レポートには、5 つの主要な列セクションが含まれます。

  1. セクション 1 には、メッセージ番号、タイプ (この例では、バッファーを意味する「B」が示されています)、および方向 (アウトバウンドの場合は「O」、インバウンドの場合は「I」) が示されます。
  2. セクション 2 は「SDLC」です。これは、NCP 回線トレースに使用され、バッファー・トレースには使用されません。
  3. セクション 3 は、伝送ヘッダーの要約です。重要なのはアドレスです。 最初のメッセージの 1 行目に起点アドレス '0000000F 006E'、2 行目に宛先アドレス '0000000E 006B' が示されています。 これらは、他のフォーマットと同じアドレスですが、LU の名前は含まれていません。 カウントは再度 10 進数に変換された長さ値です。 ここには、PIU のシーケンス番号 (SEQNO) も含まれています。シーケンス番号は、受信側でデータの順序が狂うことを回避するため、およびペーシングのために、セッションで各方向に流れる PIU 上に保持されます。
  4. セクション 4 は、要求ヘッダー (RH) 内のビットの要約です。 これには、他のフォーマット・オプションで説明されているものと同じ情報が含まれます。
  5. セクション 5 は、RU について示されています。ここには、コマンドとセンスのみが含まれます。 メッセージ番号 '0000001' では、コマンドは不明です。これは、フォーマッターが FMH5 を認識できないことが原因です。 RU の最初のバイトがコマンド・コードである PIU の場合、これは、解釈されたコードを示します。 例えば、RU が BIND である場合、RU の最初のバイトは X'31' になります。 ACFTAP は、これを解釈して、その PIU のコマンド列に 'BIND' を入れます。 RU 内にセンスがある場合 (RH にはセンス・データが含まれていることを示すビットがあります)、ACFTAP は SENSE 列にセンス・データを入れます。