Technical data
START
/FILTER=(event-code,...)
/NOFILTER
Specifies a filter for trace records. A trace record is collected only if its event
code is one of those specified in the filter. See the appendixes to this manual for
a list of the event codes supported by each tracepoint. This value overrides the
current filter, if any. You cannot specify this qualifier with /SELECT. The default
is /NOFILTER, meaning that all trace records are collected.
/LIVE
/NOLIVE
Specifies whether live or detached tracing is performed on the specified
tracepoints. The default is /NOLIVE, indicating that detached tracing is
performed.
/MAXIMUM_BUFFERS=n
Specifies the maximum number of CTF internal trace buffers. The default is 5.
/TIME_OUT=n
Specifies the interval, in seconds, for which CTF support waits before flushing
partially filled buffers to the the trace server process. The default for detached
tracing is 0 (which means no time out is used); the default for live tracing is 5
seconds.
Description
You cannot perform live and detached tracing at the same time from the same
user process. If you are currently performing live tracing and you wish to perform
detached tracing from the same user process, you must first stop all live tracing,
and vice versa.
You cannot perform local and remote tracing at the same time from the same
user process. This means that you cannot specify local and remote tracepoints in
the same START command. If you are currently tracing local tracepoints and you
wish to trace remote tracepoints from the same user process, you must first stop
all local tracing, and vice versa.
A single user process can collect trace records from only one system at a time. If
you are remote tracing, all the remote tracepoints from which the trace session is
collecting must be on the same server.
You can have only one local trace session at any given time.
Examples
CTF> START "ROUTING CIRCUIT UNA-0"
starts detached tracing at the specified local tracepoint. Trace records are written
to CTF$TRACE.DAT in your default directory. The trace server process that
collects trace records is username$CTF.
CTF> START NODEB"netman netmanpw"::"ROUTING CIRCUIT UNA-2"
starts detached tracing at the specified remote tracepoint.
4–22 CTF Commands