Technical data

3.5.5 Stopping Tracing

To stop the collection of trace records from particular tracepoints, enter the

following command:

CTF> STOP [tracepoint-name[,...]]

For example:

CTF> STOP "ROUTING CIRCUIT UNA-0"

stops the collection of trace records from the speciﬁed tracepoint.

If you specify no tracepoint names, all current tracing is stopped.

If you speciﬁed a trace server process name other than the default,

username$CTF, when you started detached tracing (see Section 3.5.2), you

must specify this process name in the /PROCESS_NAME qualiﬁer in the STOP

command. For example, if you started detached tracing with the command:

CTF> START/PROCESS_NAME=DDCMPTRACE "DDCMP LINK LNK-02"

you would stop this trace with the command:

CTF> STOP/PROCESS_NAME=DDCMPTRACE "DDCMP LINK LNK-02"

If you stop all detached tracing, the trace server process will exit. If you stop all

local tracing, the process CTF$DCP will also exit.

3.6 Displaying Trace Records

This section describes the facilities provided by CTF for displaying trace output.

3.6.1 Controlling Output During Live Tracing

When you start live tracing, trace records are formatted and displayed on your

terminal as they are collected. You can interrupt the display at any time by

pressing any key on the keyboard; you can then use the ANALYZE command to

alter the format and contents of the display.

You can use the /DISPLAY qualiﬁer to specify what parts of the trace record

(other than the protocol data itself) are to be included in the display. For

example:

CTF> ANALYZE/DISPLAY=(CONTEXT,EVENT,NAME)

displays the context-speciﬁc information, event code, and tracepoint name for

each trace record.

You can use the /DATA qualiﬁer to specify whether or not the user data part of

the protocol data is displayed, and in what format. For example:

CTF> ANALYZE/DATA=ASCII

causes user data to be displayed in ASCII (the default is to display user data in

hexadecimal). Note that not all trace records include user data; in such cases the

/DATA qualiﬁer has no effect.

Normally, all trace records collected from the tracepoints you are tracing will

be displayed. There are a number of ways in which you can restrict what trace

records are displayed:

• You can use the /FILTER qualiﬁer to specify that only trace records with

speciﬁed event codes are displayed; for example:

CTF> ANALYZE/FILTER=(RX)

3–8 Using CTF