Technical data

By default, trace output is displayed continuously as it arrives. You can use the
/NOSCROLL qualifier with ANALYZE to cause output to be displayed a screen
at a time; you can then use the BACK and NEXT commands to move backwards
and forwards through the output one screen at a time.
See the description of the ANALYZE command in Chapter 4 for more information
about the qualifiers that you can use while performing live tracing.
3.6.2 Displaying the Contents of Trace Files
When you start detached tracing, unformatted trace records are collected into a
trace file. To format and display the contents of a trace file, enter the following
command:
CTF> ANALYZE [trace-file]
The ANALYZE command formats the trace records in a trace file into user-
readable form and either displays them on your terminal or writes them to a
file. By default the trace records are displayed on your terminal; you can use the
/OUTPUT qualifier to write them to a file instead. If you do not specify the name
of a trace file, the default trace file CTF$TRACE.DAT (in your default directory)
is assumed.
For example:
CTF> ANALYZE/OUTPUT=ANALYSIS.LIS MYTRACE.DAT
formats the trace records in MYTRACE.DAT and writes the results to
ANALYSIS.LIS.
If you stop and restart detached tracing at a tracepoint, specifying the same
trace file name each time, a new version of the trace file is created each time.
The ANALYZE command starts with the lowest existing version of the trace
file and continues up to and including the highest version. If you want to start
the display with a specific version of a trace file, include the version number in
the file specification. You can use the /VERSION_LIMIT qualifier of the START
command to specify how many versions of the same trace file will be kept.
If trace records have been collected for more than one protocol, the default action
when the trace file is analyzed is that only the protocol implied by the first
tracepoint encountered in the trace file is analyzed. You can use the /TRACE_
LEVEL qualifier to alter this action; for example:
CTF> ANALYZE/TRACE_LEVEL=(DDCMP)
analyzes all DDCMP protocol trace records in the trace file.
You can use the qualifiers of the ANALYZE command described in Section 3.6.1
to alter the format and contents of the display of a trace file.
3.7 Defining Key Sequences for CTF Commands
When you run the TRACE utility, certain keys on your keyboard are defined
to implement frequently used CTF commands. Table 3–2 lists the default
assignments of CTF commands to keys.
You can use the DEFINE/KEY command to alter these definitions or to add
further definitions. For example:
CTF> DEFINE/KEY KP2 "START/LIVE/DISPLAY=OCTAL"
redefines KP2.
3–10 Using CTF