gtpo1m7pOperations

ZINIP-Manage an Individual IP Trace

Use this command to do the following:

Requirements and Restrictions

Format




DEFine
creates an entry in the individual IP trace table.

NAME-tracename
specifies an individual trace, where tracename is a 1- to 8-character alphanumeric trace name.

RIP-ripaddr
specifies a remote IP address, where ripaddr is the numeric IP address. Do not enter the following reserved IP addresses for this parameter:
Note:
Either the RIP or PORT parameter, or both parameters, must be specified.

PORT-port
specifies the server port, where port is a decimal number from 1 to 65535.
Note:
Either the RIP or PORT parameter, or both parameters, must be specified.

SIZE-size
changes the amount of data to trace in each packet, where size is the amount of data to trace. The value can be from 8 to 3840 bytes.

WRAP
specifies that the individual IP trace table will wrap when it reaches the end.

NOWRAP
specifies that the individual trace table will not wrap when it reaches the end.

DELETE
deletes one or all entries from the individual IP trace table.

ALL
specifies all the entries in the individual IP trace table or all the packets in an individual IP trace.

DISplay
displays the packets in an individual IP trace.

NUMber-nn
specifies the number of packets to display in an individual IP trace, where nn is a decimal number from 1 to 999.

FORMAT
provides a formatted display of the packets in the individual IP trace table.

MODIFY
modifies an entry from the individual IP trace table.

PAUSE
pauses the tracing on a specified individual IP trace.

RESUME
resumes the tracing on a specified individual IP trace.

RESET
clears the packets in an individual IP trace.

SUMmary
summarizes the entries in the individual IP trace table.

Additional Information

Examples

The following example displays the last five entries in the IP trace table, where:

 RW 
is the read/write operation code.

 IN 
is the IP channel command word (IPCCW) area index. X'FF'indicates that you are using local sockets.

 SOURCE IP 
is the source IP address.

 DEST IP 
is the destination IP address.

 SPORT 
is the source port. This field has meaning only for packets using Transmission Control Protocol (TCP) or User Datagram Protocol (UDP).

 DPORT 
is the destination port. This field has meaning only for packets using TCP or UDP.

 PR 
is the protocol; for example:

01
specifies Internet Control Message Protocol (ICMP).

06
specifies TCP.

11
specifies UDP.

 FG 
is the TCP flag byte. This field has meaning only for packets using TCP.

 DATA 
is the user data in the IP packet. Only the first 7 bytes of user data are displayed.
+--------------------------------------------------------------------------------+
|User:   ZINIP DISPLAY NAME-MARDI NUMBER-5                                       |
|                                                                                |
|System: INIP0006I 12.41.57 INDIVIDUAL IP TRACE MARDI DISPLAY                    |
|        RW IN    SOURCE IP        DEST IP     SPORT DPORT PR FG DATA            |
|        31 02   9.117.249.058   9.117.249.056  9999  1025 06 18 4040F1F0        |
|        32 02   9.117.249.056   9.117.249.058  1025  9999 06 18 4040F1F0F08181  |
|        51 02   9.117.249.058   9.117.249.056  9999  1025 06 18 4040F1F0        |
|        52 02   9.117.249.056   9.117.249.058  1025  9999 06 18 4040F1F0F08181  |
|        31 02   9.117.249.058   9.117.249.056  9999  1025 06 18 4040F1F0        |
|        639 ENTRIES IN IP TRACE TABLE                                           |
+--------------------------------------------------------------------------------+

The following example shows a formatted display of the IP trace table. The information shown in the display depends on the protocol of the IP packet, as follows:

 RWI 
is the read/write operation code.

 IPCCW 
is the IP channel command word (IPCCW) area index. X'FF'indicates that you are using local sockets.

 SOURCE IP 
is the source IP address.

 DEST IP 
is the destination IP address.

 LEN 
is the length of the IP packet.

 TOD 
is the time stamp.

 PROTOCOL 
is the protocol of the IP packet, where:

01
specifies ICMP

06
specifies TCP

11
specifies UDP.

 SOURCE PORT 
is the source port. This field is only displayed for packets using TCP or UDP.

 DEST PORT 
is the destination port. This field is only displayed for packets using TCP or UDP.

 SEQ 
is the sequence number in the TCP header. This field is only displayed for packets using TCP.

 ACK 
is the acknowledgment number in the TCP header. This field is only displayed for packets using TCP that have the ACK flag set in the TCP flag byte.

 WINDOW 
is the window size in the TCP header. This field is only displayed for packets using TCP.

 URGENT OFFSET 
is the urgent offset field in the TCP header. If this value is not 0, the packet contains out-of-band (OOB) data. This field is only displayed for packets using TCP.

 TCP FLAG BYTE 
is the flag byte in the TCP header. The numeric value is displayed with the name of each bit that is set in the flag byte. This field is only displayed for packets using TCP.

 REASON CODE 
is the reason code provided if an exception condition is associated with a packet.

 IP HEADER 
is the entire IP header of the packet.

 TCP HEADER 
is the entire TCP header of the packet. This field is only displayed for packets using TCP.

 UDP HEADER 
is the entire UDP header of the packet. This field is only displayed for packets using UDP.

 DATA 
is the user data in the packet that was traced.
+---------------------------------------------------------------------------------------------+
|User:   ZINIP DISPLAY NAME-TEST NUMBER-6 FORMAT                                              |
|                                                                                             |
|System: INIP0007I 11.23.52 INDIVIDUAL IP FORMATTED TRACE TEST DISPLAY                        |
|        RWI-32  IPCCW-01  SOURCE IP-9.117.241.25  DEST IP-9.117.249.50  LEN-148              |
|          TOD-B6E1240A49A93625  PROTOCOL-01 (ICMP)                                           |
|          REASON CODE - DISCARDED BY FIREWALL _                                              |
|          IP HEADER   45000094 15020000 39016F31 0975F119 0975F932                           |
|          DATA    0   0    0800EDFB 0A60002B 3C18D608 000AA4E0  .....-.. ..O...u.            |
|                 16  10    292A2B2C                             ....                         |
|        RWI-52  IPCCW-01  SOURCE IP-9.117.241.25  DEST IP-9.117.249.50  LEN-48 _             |
|          TOD-B6E12411EB6096AE  PROTOCOL-06 (TCP)  SOURCE PORT-1034  DEST PORT-9999          |
|          SEQ-1092329965  WINDOW--1  URGENT OFFSET-0                                         |
|          TCP FLAG BYTE-02 (SYN)                                                             |
|          IP HEADER   45000030 15040000 39066F8E 0975F119 0975F932                           |
|          TCP HEADER  040A270F 411BA1ED 00000000 7002FFFF 78A30000 020405D4 01030304 _       |
|        RWI-51  IPCCW-01  SOURCE IP-9.117.249.50  DEST IP-9.117.241.25  LEN-48               |
|          TOD-B6E12411EBDE212E  PROTOCOL-06 (TCP)  SOURCE PORT-9999  DEST PORT-1034          |
|          SEQ-1092531721  ACK-1092329966  WINDOW-8192  URGENT OFFSET-0                       |
|          TCP FLAG BYTE-12 (ACK, SYN)                                                        |
|          IP HEADER   45000030 1A970000 3C0666FB 0975F932 0975F119 _                         |
|          TCP HEADER  270F040A 411EB609 411BA1EE 70122000 616A0000 020405D4 01030304         |
|        RWI-32  IPCCW-01  SOURCE IP-9.117.241.25  DEST IP-9.117.249.50  LEN-40 _             |
|          TOD-B6E124121F4B0645  PROTOCOL-06 (TCP)  SOURCE PORT-1034  DEST PORT-9999          |
|          SEQ-1092329966  ACK-1092531722  WINDOW-8192  URGENT OFFSET-0                       |
|          TCP FLAG BYTE-10 (ACK)                                                             |
|          IP HEADER   45000028 15050000 39066F95 0975F119 0975F932                           |
|          TCP HEADER  040A270F 411BA1EE 411EB60A 50102000 8D520000 _                         |
|        RWI-32  IPCCW-01  SOURCE IP-9.117.241.25  DEST IP-9.117.249.50  LEN-57               |
|          TOD-B6E124121F4B0645  PROTOCOL-06 (TCP)  SOURCE PORT-1034  DEST PORT-9999          |
|          SEQ-1092329966  ACK-1092531722  WINDOW-8192  URGENT OFFSET-0                       |
|          TCP FLAG BYTE-18 (ACK, PSH)                                                        |
|          IP HEADER   45000039 15060000 39066F83 0975F119 0975F932 _                         |
|          TCP HEADER  040A270F 411BA1EE 411EB60A 50182000 7BF90000                           |
|          DATA    0   0    D7C9D5C7 60D7D6D5 C7000000 01000000  PING-PON G.......            |
|                 16  10    64                                   .                            |
|        RWI-32  IPCCW-01  SOURCE IP-9.117.241.25  DEST IP-9.117.249.50  LEN-140 _            |
|          TOD-B6E124121F4B0645  PROTOCOL-06 (TCP)  SOURCE PORT-1034  DEST PORT-9999          |
|          SEQ-1092329983  ACK-1092531722  WINDOW-8192  URGENT OFFSET-0                       |
|          TCP FLAG BYTE-18 (ACK, PSH)                                                        |
|          IP HEADER   4500008C 15070000 39066F2F 0975F119 0975F932 _                         |
|          TCP HEADER  040A270F 411BA1FF 411EB60A 50182000 A3DC0000                           |
|          DATA    0   0    4040F1F0 F0818181 81818181 81818181    100aaa aaaaaaaa            |
|                 16  10    81818181                             aaaa                         |
|         106 ENTRIES IN IP TRACE TABLE                                                       |
+---------------------------------------------------------------------------------------------+

The following example displays a summary of the individual traces defined, where:

 NAME 
is the name of the individual trace.

 REMOTE IP 
is the remote IP address (if any) being traced.

 PORT 
is the server port (if any) being traced.

 WRAP 
specifies whether the trace is allowed to wrap.

 PAUSED 
specifies whether the trace is currently paused.

 STATUS 
specifies the status of the trace, where:

 EMPTY 
specifies that there are no trace entries for this individual trace.

 FULL 
specifies that the individual trace is currently full and no trace entries can be added because the NOWRAP parameter is set for this trace.
Note:
If this field is left blank, the trace is not empty and more trace entries can be added.
+--------------------------------------------------------------------------------+
|User:   ZINIP SUMMARY                                                           |
|                                                                                |
|System: INIP0005I 15.18.29 INDIVIDUAL IP TRACE SUMMARY                          |
|        NAME     REMOTE IP       PORT  SIZE WRAP PAUSED STATUS                  |
|        -------- --------------  ----- ----  ---- ----- -----                   |
|        MQSERV                   1414  3840 YES  YES                            |
|        MARDI      9.117.249.058        120 YES  NO     EMPTY                   |
|        HTTP       9.117.107.167   80  3840 NO   NO     FULL                    |
|        END OF DISPLAY                                                          |
|                                                                                |
+--------------------------------------------------------------------------------+

Related Information

See TPF Transmission Control Protocol/Internet Protocol for more information about the IP trace tables and TCP/IP native stack support.