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