Use this command to do the following:
- Add an entry to the individual Internet Protocol (IP) trace table
- Delete one or all entries from the individual IP trace table
- Display the packets in the individual IP trace
- Modify an entry in the individual IP trace table
- Reset an individual IP trace
- Summarize the entries in the individual IP trace table.
Requirements and Restrictions
- You can enter this command only in 1052 state or higher.
- You can enter this command only from the basic subsystem (BSS).
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:
- 0.0.0.0
- 255.255.255.255
- 127.0.0.0
- 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
- Online help information is available for this command. To display
the help information, enter one of the following:
ZINIP HELP
ZINIP ?
- Definitions can be added or changed in 1052 state or higher. The
new or changed definitions can be used immediately (no IPL is
required).
- If an exception condition is detected for an input packet, generates
an output packet, or both, a reason code is added to the entry in the IP trace
table. When you specify the FORMAT parameter, the reason code is
displayed if there is one associated with the packet. See TPF Transmission Control Protocol/Internet Protocol for
more information about the IP trace facility and the specific reason codes
that can be displayed.
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.