DISPLAY TCPIP,,TRACE
real-time application-controlled TCP/IP trace ネットワーク管理インターフェース (NMI) を使用して TCP/IP スタックからリアルタイム・ネットワーク管理データを取得する、ネットワーク管理アプリケーションに関する情報を表示するために、DISPLAY TCPIP,,TRACE コマンドを使用します。詳しくは、「z/OS Communications Server: IP Programmer's Guide and Reference」の『Real-time application-controlled TCP/IP trace NMI (EZBRCIFR)』を参照してください。
このコマンドは、現在 NMI を使用している各アプリケーション、およびリアルタイム・データを提供するために TCP/IP スタックが使用するストレージに関する情報を表示します。NAME パラメーターと TYPE パラメーターのいずれも指定されていない場合、このコマンドは、NMI を現在使用しているすべてのアプリケーションに適用される統計セクションを表示します。 各アプリケーションによって指定されている、すべてのトレース・フィルターを表示するには、このコマンドで DETAIL パラメーターを指定します。
フォーマット
>>-Display --TCPIP--,--+----------+--,--------------------------> '-procname-' .-----------------------. V | .-,MAX=200---. >----TRACE----+-------------------+-+--+------------+---------->< +-,--DETAIL---------+ +-,MAX=*-----+ +-,--NAME=-jobname--+ '-,MAX=lines-' '-,--TYPE=--+-DAT-+-' '-PKT-'
規則: パラメーターは構文図で示される順序で指定する必要があります。
パラメーター
- DETAIL
- このパラメーターを指定すると、各トレース・タイプのすべてのフィルター・セットが表示されます。このパラメーターが指定されていない場合、フィルター・セット情報は表示されません。
- NAME=jobname
- このパラメーターを指定すると、指定されたジョブ名の情報のみが表示されます。jobname 値は、次の MVS™ ジョブ名のいずれかになります。
- real-time application-controlled TCP/IP trace NMI を使用しているアプリケーションのジョブ名。
- NMI を使用しているアプリケーションを作成した元のアプリケーションのジョブ名。例えば、JOB1 が JOB2 を fork しており、JOB2 が NMI を使用している場合、JOB1 または JOB2 のいずれかをジョブ名として指定できます。fork または spawn のサービスを使用していない場合、JOB1 と JOB2 のジョブ名は同じになります。
ガイドライン: NAME パラメーターを指定した場合、NMI を使用しているアプリケーションに関する情報のみが表示されます。 NMI 統計セクションは表示されません。 - TYPE=DAT|PKT
- このパラメーターを指定すると、指定されたトレース・タイプで NMI を使用するジョブに関する情報のみが表示されます。DETAIL パラメーターと TYPE パラメーターの両方を指定した場合、指定されたトレース・タイプのすべてのフィルター・セットが表示されます。現在サポートされている有効な TYPE 値は、以下のとおりです。
- DAT
- NMI データ・トレース機能を使用するジョブに関する情報のみが表示されるように指定します。
- PKT
- NMI パケット・トレース機能を使用するジョブに関する情報のみが表示されるように指定します。
ガイドライン: TYPE パラメーターを指定した場合、NMI を使用しているアプリケーションに関する情報のみが表示されます。 NMI 統計セクションは表示されません。 - MAX=*|lines
- コンソールに表示される最大行数です。
有効な値の範囲は、2 から 65533 です。アスタリスク (*) を指定すると、最大 65533 行まで表示されます。
- MAX=*
- MAX=* を指定して、複数行 WTO の最大値を超えたためにレポートが切り捨てられた場合は、以下のメッセージが表示されます。
Report truncated due to greater than 65533 lines of output
- MAX=lines
- 表示されている行の総数と表示可能であった行の総数は、以下の出力行に示されます。
ここで、n は表示されている行の数、m は表示できたはずの行の総数です。n of m lines displayed
例
1. real-time application-controlled TCP/IP trace NMI を使用しているすべてのアプリケーションの統計セクションおよび要約情報を表示します。
D TCPIP,TCPCS,TRACE
EZD2016I DISPLAY TRACE for TCPCS
Real-time application-controlled TCP/IP trace NMI statistics
TotStage: 0000000030M
Collection buffer statistics
TotalSize: 0000000064M InUse: 0000000000K
HiWater: 0000000318K Lost: 00000000000000000000
Name: NMAPP2 OrigName: NMAPPL ASID: 001A UserID: JONES
Description: Network Management Collector Active: Yes
Mode: Locate Ecb: Yes
Staging buffer statistics
TotalSize: 0000000020M InUse: 0000000080K
HiWater: 0000000014M Lost: 00000000000000000000
PutRecs: 00000000000000001287 GetRecs: 00000000000000001263
Data trace: Yes FiltNum: 01 ATTLSClr: Yes
Packet trace: Yes FiltNum: 01 IPSecClr: No
Name: PKTMON OrigName: PKTMON ASID: 002A UserID: SMITH
Description: Packet Monitor Active: No
Mode: Move Ecb: No
Staging buffer statistics
TotalSize: 0000000010M InUse: 0000000005M
HiWater: 0000000009M Lost: 00000000000000000254
PutRecs: 00000000000000002513 GetRecs: 00000000000000001965
Data trace: No FiltNum: 00 ATTLSClr: No
Packet trace: Yes FiltNum: 01 IPSecClr: Yes
25 of 25 lines displayed
EZZ0053I COMMAND DISPLAY TCPIP,,TRACE COMPLETED SUCCESSFULLY
2. real-time application-controlled TCP/IP trace NMI を使用して、パケット・トレース情報を取得している、すべてのアプリケーションに関する詳細情報を表示します。
D TCPIP,TCPCS,TRACE,TYPE=PKT,DETAIL
EZD2016I DISPLAY TRACE for TCPCS
Name: NMAPP2 OrigName: NMAPPL ASID: 001A UserID: JONES
Description: Network Management Collector Active: Yes
Mode: Locate Ecb: Yes
Staging buffer statistics
TotalSize: 0000000020M InUse: 0000000080K
HiWater: 0000000014M Lost: 00000000000000000000
PutRecs: 00000000000000001287 GetRecs: 00000000000000001263
Data trace: Yes FiltNum: 01 ATTLSClr: No
Packet trace: Yes FiltNum: 02 IPSecClr: Yes
Packet trace filter set # 1
Protocol: TCP Payload: 0000200
Discard: None PortNum: Any
IPSec: None
IntfName: OSAINTF1
IpAddr: Any PfxLen: None
Packet trace filter set # 2
Protocol: Any Payload: 0065535
Discard: None PortNum: Any
IPSec: Clear
IntfName: Any
IpAddr: 10.143.7.65 PfxLen: None
Name: PKTMON OrigName: PKTMON ASID: 002A UserID: SMITH
Description: Packet Monitor Active: No
Mode: Move Ecb: No
Staging buffer statistics
TotalSize: 0000000010M InUse: 0000000005M
HiWater: 0000000009M Lost: 00000000000000000254
PutRecs: 00000000000000002513 GetRecs: 00000000000000001965
Data trace: No FiltNum: 00 ATTLSClr: No
Packet trace: Yes FiltNum: 02 IPSecClr: No
Packet trace filter set # 1
Protocol: Any Payload: 0065535
Discard: None PortNum: Any
IPSec: Secure
IntfName: Any
IpAddr: 10.2.104.126 PfxLen: None
Packet trace filter set # 2
Protocol: Any Payload: 0065535
Discard: None PortNum: Any
IPSec: Secure
IntfName: Any
IpAddr: 2001:0DB8:0:1:10:2:105:254 PfxLen: None
44 of 44 lines displayed
EZZ0053I COMMAND DISPLAY TCPIP,,TRACE COMPLETED SUCCESSFULLY
3. real-time application-controlled TCP/IP trace NMI を使用して、データ・トレース情報を取得している、すべてのアプリケーションに関する詳細情報を表示します。
D TCPIP,TCPCS,TRACE,TYPE=DAT,DETAIL
EZD2016I DISPLAY TRACE for TCPCS
Name: NMAPP2 OrigName: NMAPPL ASID: 001A UserID: JONES
Description: Network Management Collector Active: Yes
Mode: Locate Ecb: Yes
Staging buffer statistics
TotalSize: 0000000020M InUse: 0000000080K
HiWater: 0000000014M Lost: 00000000000000000000
PutRecs: 00000000000000001287 GetRecs: 00000000000000001263
Data trace: Yes FiltNum: 02 ATTLSClr: Yes
Data trace filter set # 1
JobName: TSTAPPL Payload: 0065535
ATTLS: None PortNum: Any
IpAddr: 2001:0DB8:0:1:10:2:105:254 PfxLen: None
Data trace filter set # 2
JobName: DBAPPL Payload: 1000000
ATTLS: Clear PortNum: 00163
IpAddr: 10.5.126.0 PfxLen: 0024
Packet trace: Yes FiltNum: 01 IPSecClr: No
19 of 19 lines displayed
EZZ0053I COMMAND DISPLAY TCPIP,,TRACE COMPLETED SUCCESSFULLY
4. 特定のアプリケーションの要約情報を表示します。
D TCPIP,TCPCS,TRACE,NAME=NMAPP2
EZD2016I DISPLAY TRACE for TCPCS
Name: NMAPP2 OrigName: NMAPPL ASID: 001A UserID: JONES
Description: Network Management Collector Active: Yes
Mode: Locate Ecb: Yes
Staging buffer statistics
TotalSize: 0000000020M InUse: 0000000080K
HiWater: 0000000014M Lost: 00000000000000000000
PutRecs: 00000000000000001287 GetRecs: 00000000000000001263
Data trace: Yes FiltNum: 01 ATTLSClr: No
Packet trace: Yes FiltNum: 02 IPSecClr: Yes
11 of 11 lines displayed
EZZ0053I COMMAND DISPLAY TCPIP,,TRACE COMPLETED SUCCESSFULLY
5. 特定のアプリケーションの詳細情報を表示します。
D TCPIP,TCPCS,TRACE,NAME=NMAPP2,DETAIL
EZD2016I DISPLAY TRACE for TCPCS
Name: NMAPP2 OrigName: NMAPPL ASID: 001A UserID: JONES
Description: Network Management Collector Active: Yes
Mode: Locate Ecb: Yes
Staging buffer statistics
TotalSize: 0000000020M InUse: 0000000080K
HiWater: 0000000014M Lost: 00000000000000000000
PutRecs: 00000000000000001287 GetRecs: 00000000000000001263
Data trace: Yes FiltNum: 02 ATTLSClr: Yes
Data trace filter set # 1
JobName: TSTAPPL Payload: 0065535
ATTLS: None PortNum: Any
IpAddr: 2001:0DB8:0:1:10:2:105:254 PfxLen: None
Data trace filter set # 2
JobName: DBAPPL Payload: 1000000
ATTLS: Clear PortNum: 00163
IpAddr: 10.5.126.0 PfxLen: 0024
Packet trace: Yes FiltNum: 02 IPSecClr: Yes
Packet trace filter set # 1
Protocol: TCP Payload: 0000200
Discard: None PortNum: Any
IPSec: None
IntfName: OSAINTF1
IpAddr: Any PfxLen: None
Packet trace filter set # 2
Protocol: Any Payload: 0065535
Discard: None PortNum: Any
IPSec: Clear
IntfName: Any
IpAddr: 10.143.7.65 PfxLen: None
31 of 31 lines displayed
EZZ0053I COMMAND DISPLAY TCPIP,,TRACE COMPLETED SUCCESSFULLY
6. リアルタイムのアプリケーション制御 TCP/IP トレース NMI がアクティブであるものの、どのアプリケーションによってもまだ使用されていない場合に、この情報が表示されます。
D TCPIP,TCPCS,TRACE
EZD2016I DISPLAY TRACE for TCPCS
Real-time application-controlled TCP/IP trace NMI available for use
3 of 3 lines displayed
EZZ0053I COMMAND DISPLAY TCPIP,,TRACE COMPLETED SUCCESSFULLY
7. リアルタイムのアプリケーション制御 TCP/IP トレース NMI が使用不可の場合に、この情報が表示されます。
D TCPIP,TCPCS,TRACE
EZD2016I DISPLAY TRACE for TCPCS
Real-time application-controlled TCP/IP trace NMI disabled
3 of 3 lines displayed
EZZ0053I COMMAND DISPLAY TCPIP,,TRACE COMPLETED SUCCESSFULLY
レポート・フィールドの説明
- NMI グローバル情報
- TotStage
- 現在割り振られている、トレース・インスタンスのステージング・バッファー・ストレージの合計量。各トレース・インスタンスは、RCCOpen 要求で割り振られるストレージの量を指定します。
- コレクション・バッファー統計セクション
-
- TotalSize
- コレクション・バッファーのサイズ (メガバイト単位)。
- InUse
- コレクション・バッファーで現在使用中のキロバイト数またはメガバイト数。
- HiWater
- アプリケーションがトレース・インスタンスをオープンしてから、コレクション・バッファーで使用された最大キロバイト数または最大メガバイト数。
- Lost
- ストレージ・スペースが不足しているためにコレクション・バッファーに書き込むことができなかったトレース・レコードの合計数。
- アプリケーション情報セクション
- Name
- NMI トレース・インスタンスをオープンしたアプリケーションのジョブ名。 アプリケーションは、RCCOpen NMI 要求を起動して、トレース・インスタンスをオープンします。 アプリケーションが複数のトレース・インスタンスをオープンする場合、すべてのトレース・インスタンスについて同じジョブ名が表示されます。
- OrigName
- アプリケーションの開始元のジョブ名。例えば、JOB1 が JOB2 を fork し、JOB2 が NMI を使用している場合、ジョブ名 JOB1 がこのフィールドに表示されます。fork または spawn のサービスを使用していない場合、このフィールドの値は「Name」フィールドの値と同じです。
- ASID
- NMI トレース・インスタンスをオープンしたアプリケーションの 16 進アドレス・スペース ID。
- UserID
- NMI トレース・インスタンスをオープンしたアプリケーションに関連付けられたユーザー ID。
- Description
- NMI トレース・インスタンスをオープンしたときに、RCCOpen NMI 要求でアプリケーションによって提供された説明。
- Active
- アプリケーション・トレース・インスタンスが現在アクティブかどうかを示します。トレース・インスタンスがアクティブである場合、アプリケーションが取得できるように、トレース・レコードがステージング・バッファー内に作成中です。
- Yes
- アプリケーション・トレース・インスタンスが現在アクティブであることを示します。
- No
- アプリケーション・トレース・インスタンスが現在アクティブでないことを示します。
- Mode
- アプリケーション・トレース・インスタンスがトレース・レコードにアクセスするために使用するモードを示します。
- Locate
- アプリケーションは位置指定モードを使用します。 このオプションは RCCOpen NMI 要求に指定されます。
- Move
- アプリケーションは移動モードを使用します。 これは、位置指定モードが RCCOpen NMI 要求に指定されていない場合のデフォルト・モードです。
- Ecb
- トレース・レコードがステージング・バッファーに書き込まれるときに、アプリケーション・トレース・インスタンスが、アプリケーションが所有している送信用の ECB を使用するかどうかを示します。
- Yes
- アプリケーションは、アプリケーションが所有する ECB を使用します。 このオプションは RCCOpen NMI 要求に指定されます。
- No
- アプリケーションは、アプリケーションが所有する ECB を使用しません。 これは、ECB アドレスが RCCOpen NMI 要求に指定されていない場合のデフォルト・オプションです。
- ステージング・バッファー統計セクション
-
- TotalSize
- ステージング・バッファーのサイズ (メガバイト単位)。
- InUse
- ステージング・バッファーで現在使用中のキロバイト数またはメガバイト数。 この値は、トレース・インスタンスに対して RCCStart 要求が処理されるたびにゼロにリセットされます。
- HiWater
- トレース・インスタンスに対する最後の RCCStart 要求が処理されてから、ステージング・バッファーで使用された最大キロバイト数または最大メガバイト数。
- Lost
- ストレージ・スペース不足のために、ステージング・バッファーに書き込むことができなかった、トレース・レコードおよびコレクション・バッファー逸失レコードの合計数。 この値は、トレース・インスタンスに対して RCCStart 要求が処理されるたびにゼロにリセットされます。
- PutRecs
- トレース・インスタンスに対する最後の RCCStart 要求が処理されてから、ステージング・バッファーに保管された合計トレース・レコード数。
- GetRecs
- トレース・インスタンスの最後の RCCStart 要求が処理されてから、アプリケーションがステージング・バッファーから取得したトレース・レコードの合計数。
- データ・トレース・フィルター制御ブロック・セクション
- Data trace
- アプリケーション・トレース・インスタンスが、データ・トレースに対してフィルターをセットアップしているかどうかを示します。
- Yes
- アプリケーション・トレース・インスタンスが、データ・トレースに対してフィルターをセットアップしていることを示します。DETAIL パラメーターがコマンドで指定されている場合、フィルター・セットがこのフィールドの下に表示されます。
- No
- アプリケーション・トレース・インスタンスが、データ・トレースに対してフィルターをセットアップしていないことを示します。
- FiltNum num
- トレース・タイプに対して定義されているフィルターの合計数を示します。
- ATTLSClr
- AT-TLS 平文データがいずれかのデータ・トレース・フィルターで要求されているかどうかを示します。
- Yes
- AT-TLS 平文データが少なくとも 1 つのフィルターで要求されているかどうかを示します。
- No
- AT-TLS 平文データがどのフィルターでも要求されていないことを示します。
- Data trace filter set #num
- フィルター・セット番号 num がこのフィールドの下に表示されていることを示します。 フィルター・セット情報は、トレース・タイプにフィルターが設定され、DETAIL パラメーターがコマンドで指定された場合にのみ、表示されます。
- Payload
- RCCDat フィルター制御ブロック内の RCDAPayload フィールドの、指定のまたはデフォルトのペイロード値。
- Portnum
- RCCDat フィルター制御ブロック内の RCDAPortNum フィールドのポート番号。ポート番号は、送信元ポートまたは宛先ポートに適用されます。次のいずれかの値が表示されます。
- Any
- ポート番号が、このフィルター・セットに指定されていないことを示します。
- portnum
- ポート番号。
- ATTLS
- RCCDat フィルター制御ブロック内の RCDAFiltFlags フィールドからの要求された AT-TLS フィルター・サポート。
次の 1 つ以上の値が表示されます。
- None
- AT-TLS フィルター・サポートが要求されていないことを示します。
- Clear
- AT-TLS 平文データ・サポートが要求されていることを示します。 データがカプセル化または暗号化される前に、トレース・レコードが AT-TLS に対して作成されます。
制約事項: データは、それに対して作成されるトレース・レコードの他のフィルター基準に一致しなければなりません。 - JobName
- RCCDat フィルター制御ブロック内の RCDAJobName フィールドからのジョブ名。
次のいずれかの値が表示されます。
- Any
- ジョブ名が、このフィルター・セットに指定されていないことを示します。
- jobname
- ジョブ名。
- IpAddr
- RCCDat フィルター制御ブロック内の RCDAJobName フィールドからのジョブ名。
次のいずれかの値が表示されます。
- Any
- ジョブ名が、このフィルター・セットに指定されていないことを示します。
- jobname
- ジョブ名。
- PfxLen
- RCCDat フィルター制御ブロック内の RCDAPrefix フィールドのプレフィックスの長さ。この値は、IP アドレス値と一緒に、IP アドレスをパケット内のソースまたは宛先 IP アドレスと比較する際に用いられる IP アドレス・マスクを作成するために使用されます。
次のいずれかの値が表示されます。
- None
- プレフィックスの長さが、このフィルター・セットに指定されていないことを示します。
- pfxlen
- プレフィックスの長さ (ビット数単位)。
- パケット・トレース・フィルター制御ブロック・セクション
-
- Packet trace
- アプリケーション・トレース・インスタンスが、パケット・トレースに対してフィルターをセットアップしているかどうかを示します。
- Yes
- アプリケーション・トレース・インスタンスが、パケット・トレースに対してフィルターをセットアップしていることを示します。 DETAIL パラメーターがコマンドで指定されている場合、フィルター・セットがこのフィールドの下に表示されます。
- No
- アプリケーション・トレース・インスタンスが、パケット・トレースに対してフィルターをセットアップしていないことを示します。
- FiltNum num
- トレース・タイプに対して定義されているフィルターの合計数を示します。
- IPSecClr
- IPSec 平文データがいずれかのデータ・トレース・フィルターで要求されているかどうかを示します。
- Yes
- IPSec 平文データが少なくとも 1 つのフィルターで要求されているかどうかを示します。
- No
- IPSec 平文データがどのフィルターでも要求されていないことを示します。
- Packet trace filter set #num
- フィルター・セット番号 num がこのフィールドの下に表示されていることを示します。フィルター・セット情報は、トレース・タイプにフィルターが設定され、DETAIL パラメーターがコマンドで指定された場合にのみ、表示されます。
- Protocol
- RCCPkt フィルター制御ブロック内の RCPKProto フィールドのプロトコル番号。以下のいずれかの値が表示されます。
- Any
- プロトコルが、このフィルター・セットに指定されていないことを示します。
- プロトコル | TCP | UDP | ICMP | ICMPv6
- 示された既知のプロトコルのプロトコル番号またはプロトコル名。
- Payload
- RCCPkt フィルター制御ブロック内の RCPKPayload フィールドの指定のまたはデフォルトのペイロード値。
- 廃棄プロトコル
- RCCPkt フィルター制御ブロック内の RCPKDiscard フィールドの廃棄パケット値。以下のいずれかの値が表示されます。
- None
- トレース・レコードが、廃棄パケットについて作成されないことを示します。
- Both
- トレース・レコードが、廃棄パケット、および送信された提供済みパケットの両方について作成されることを示します。
- Only
- トレース・レコードが、廃棄パケットについてのみ作成されることを示します。
- reason_code
- トレース・レコードが、指定した廃棄理由コードのあるパケットについてのみ作成されることを示します。
- Portnum
- RCCPkt フィルター制御ブロック内の RCPKPortNum フィールドのポート番号。ポート番号は、送信元ポートまたは宛先ポートに適用されます。以下のいずれかの値が表示されます。
- Any
- ポート番号が、このフィルター・セットに指定されていないことを示します。
- portnum
- ポート番号。
- IPSec
- RCCPkt フィルター制御ブロック内の RCPKFiltFlags フィールドからの要求された IPSec フィルター・サポート。
次の 1 つ以上の値が表示されます。
- None
- IPSec フィルター・サポートが要求されていないことを示します。
- Clear
- IPSec 平文データ・サポートが要求されていることを示します。 パケットがカプセル化される前またはカプセル化解除された後に、トレース・レコードが IPSec パケットに対して作成されます。
- Secure
- IPSec セキュア・データ・サポートが要求されていることを示します。 トレース・レコードは、カプセル化された IPSec パケットに対して作成されます。
制約事項: パケットは、それに対して作成されるトレース・レコードの他のフィルター基準に一致しなければなりません。 - IntfName
- RCCPkt フィルター制御ブロック内の RCPKIntfName フィールドのインターフェース名。以下のいずれかの値が表示されます。
- Any
- インターフェース名が、このフィルター・セットに指定されていないことを示します。
- intfname
- インターフェース名。
- IpAddr
- RCCPkt フィルター制御ブロック内の RCPKIpAddr フィールドの IPv4 または IPv6 アドレス。IP アドレスは、送信元アドレスまたは宛先アドレスに適用されます。パケットに GRE ヘッダーが含まれている場合、IP アドレスは GRE ヘッダー内の送信元アドレスまたは宛先アドレスにも適用されます。以下のいずれかの値が表示されます。
- Any
- IP アドレスが、このフィルター・セットに指定されていないことを示します。
- ipaddr
- IP アドレス。
- PfxLen
- RCCPkt フィルター制御ブロック内の RCPKPrefix フィールドのプレフィックスの長さ。NMI は、このプレフィックスの長さと IP アドレス値を使用して、IP アドレス・マスクを作成します。IP アドレス・マスクは、IP アドレスをパケット内の送信元 IP アドレスまたは宛先 IP アドレスと比較するために使用されます。以下のいずれかの値が表示されます。
- None
- プレフィックスの長さが、このフィルター・セットに指定されていないことを示します。
- pfxlen
- プレフィックスの長さ (ビット数単位)。
- Matches
- このフィルター・セットの値に一致したトレース・レコードの数。この値には、通常のトレース・レコードおよび廃棄されたトレース・レコードが含まれます。