Using the individual IP trace function

In addition to a systemwide IP trace table displayed by the ZIPTR command or processed offline using the IPTPRT facility, there is an individual IP trace function that allows you to trace all the packets to and from specific remote terminals in the network. The individual IP trace function is an online trace facility that allows you to define the following individual IP traces:
  • All packets to and from a specific remote node
  • All packets to and from a local server application
  • All packets to and from a remote server application.
However, Individual IP trace support does not affect the function of the systemwide trace table.
You can define an individual IP trace by entering the ZINIP command with the DEFINE parameter specified. Assign the individual IP trace a trace name, which is used for accessing the trace for other functions (displaying the trace table, for example). The following example defines an individual IP trace: 
ZINIP DEFINE NAME-MARDI RIP-9.117.249.58

You can specify the maximum number of individual IP traces you can define by using the keypoint 2 (CTK2) parameter, IPTRCNUM. You can specify the size of each individual IP trace that is defined by using the CTK2 parameter, IPTRCSIZ.

Individual IP trace support has the following capabilities:
  • The individual IP trace table wraps so only the most recent packets are in main storage. Many times when tracing specific remote terminals, you want to see the initial data flows in the trace table. You can do this by entering the ZINIP command with the NOWRAP parameter specified, which allows you to stop tracing once the trace table becomes full.
    To continue tracing after the trace table is full, do one of the following:
    • Enter the ZINIP command with the RESET parameter specified to clear the table and to continue tracing.
    • Enter the ZINIP command with the MODIFY and WRAP parameters specified to continue the tracing.
  • The individual IP trace function allows you to pause an individual IP trace so you can examine what has been traced to a certain point. You can resume the trace by entering the ZINIP command with the RESUME parameter specified.
  • Entering the ZINIP command with the SIZE parameter specified controls the amount of data in the packet that is added to the trace table.
  • Entering the ZINIP command with the SUMMARY parameter specified allows you to see what individual IP traces are currently defined and their status, as shown in the following example.
User:   ZINIP SUMMARY

System: INIP0005I 11.43.04 INDIVIDUAL IP TRACE SUMMARY
	     NAME     REMOTE IP       PORT  SIZE WRAP PAUSED STATUS
	     -------- --------------- ----- ---- ---- ------ ------
	     MARDI      9.117.249.058       3840 NO   NO     EMPTY
	     MQSERV                    1414 3840 YES  NO     EMPTY
	     END OF DISPLAY
See z/TPF Operations for more information about the ZINIP command.