Novell Documentation: Novell Internet Access Server 4.1

Using the DTRACE Utility

DTRACE is a menu-driven trace utility used with U.S. Robotics ISDN Allegra adapters with FXPRI.LAN and FXBRI.LAN ISDN drivers.

To load DTRACE, enter the following command at the server prompt:

load dtrace

The DTRACE main menu is displayed. Table 9 describes the fields of the DTRACE main menu. To select a menu item, use the cursor control keys (arrow keys) to move the cursor to the field you want to select.

Table 9. DTRACE Main Menu

Menu Field	Description
Board Selection	Name of board to trace
Buffer Size	Size of the file to store the trace data, default is 4 KB
Start Background Trace	Press Enter to begin trace of selected board
Display Current Trace	Displays the Display Current Trace menu
Save Current Trace Data	Saves current trace data in a file you designate

After the trace has started, DTRACE will record all transfers between the adapter and the ISDN switch. If the file exceeds the buffer size, entries will wrap to the beginning of the file. Press Esc to stop the trace.

To display the current trace, select Display Current Trace from the DTRACE Main Menu. The Display Current Trace window is displayed. Table 10 describes the fields of the Display Current Trace window.

Table 10. Display Current Trace Window

Field	Description
Display Current Trace	Displays the current trace
Select Layer or Layers to Trace	Displays the selected layers
Layer 1	Select Yes to filter, No to include
Layer 2	Select Yes to filter, No to include
Layer 3	Select Yes to filter, No to include
Save Current Trace Data	Saves current trace data in a file you designate

After selecting a trace to display, DTRACE decodes the recorded data and displays it in ASCII packets. The output of the trace shows all incoming and outbound data between the ISDN driver and the ISDN switch.

If you choose to filter a layer's data, that layer's transfers will not be included in the trace data. This can be helpful when you are trying to diagnose problems in a specific layer. For example, filter layers 1 and 2 to diagnose a connection problem occurring only in layer 3.