SmartTrace Menu Mode

Using SmartTrace in menu mode is slightly less simple than Line Command mode; but offers more comprehensive and powerful trace management. Although the PT line command provide the quickest way to start a packet trace, it is limited in its ability to select packets to be included in the trace. You can end up with too many packets. This is important because the SMARTTRACE parameter group limits the number of packets in a PT trace (1000 packets maximum). When the limit is exceeded, the oldest packet is removed and replaced by a new packet.

In menu mode, you create your own custom trace definitions. The definitions provides the following features:

All menu mode functions are accessed from the Packet Tracing Menu.

Access Packet Tracing Menu

The Packet Tracing Menu enables you to manage and perform advanced packet tracing functions.

To access the Packet Tracing Menu

  1. Enter /SMART (or /IPPKT) from the prompt.

    The Packet Tracing Menu appears.

    Note: For information about the menu, press F1 (Help).

Definition Types

The following definition types are available for you to create SmartTrace definitions:

Trace definition samples are provided as templates for you to define traces. These definitions describe common network conditions and events that are worth tracing.

Selection Criteria

Packet tracing often results in many packet entries, most of which are not relevant. SmartTrace provides the following types of selection criteria to help limit the trace output:

Example: Trace New Connections Between Specific Hosts

The following example selects only newly-initiated TCP connections with a local host of 172.31.255.255, local port of 1123, and a foreign host of 172.16.0.0.

PROD-------- SmartTrace : Multiple TCP Connection Trace Details --------------
Command ===> Page 1 of 4

Name ...............
Description ........

Trace Each Connection With:
TCP/IP Stack .......+
Local Host .......... 172.31.255.255
Local Ports ......... 1123
Foreign Host ........ 172.16.0.0
Foreign Ports........

Example: Capture Packets with Specific Flags and Data

The following example selects only the TCP packets in the previous example that have a TCP flag of SYN, ACK, or PSH, and contains the string USER between positions 1 and 20 of the TCP data.

PROD--------- SmartTrace : Multiple TCP Connection Trace Details --------------
Command ===> Page 2 of 4

After the Initial Packets, Trace Packets with:
TCP Flags .......+ SYN or ACK or PSH
(SYN,ACK,PSH,RST,URG,FIN or an expression e.g. SYN and not ACK)

. Packet Data (Following TCP Header) ----------------------------------------.
| Start |
| Oper Data Format Pos. Length |
| 1 LIKE USER ASCII 1 20 |

Example: Stop Tracing on the TCP RST Flag

The following example stops the trace when a captured packet has a TCP flag of RST.

PROD--------- SmartTrace : Multiple TCP Connection Trace Details --------------
Command ===> Page 3 of 4

Stop After Tracing a Packet with:
TCP Flags .......+ RST
(SYN,ACK,PSH,RST,URG,FIN or an expression e.g. SYN and not ACK)
TCP Window Size ...........+

Example: Stop Tracing After a Specified Number of Packets

The following example stops the trace when 2000 packets are captured.

PROD--------- SmartTrace : Multiple TCP Connection Trace Details --------------
Command ===> Page 4 of 4

Trace Options:
Trace Limit ............... 2000 (Number of packets)
Stop At Limit? ............ YES (Yes or No)


Copyright © 2010 CA. All rights reserved.