Technical data

COLLECT
COLLECT
The COLLECT command takes a snapshot of current tracing activity.
Format
COLLECT [/qualifier]
Parameters
None
Qualifiers
/PROCESS_NAME
Specifies the name of the trace server process that is to collect the data. This
must be the same process that you specify in the /PROCESS_NAME qualifier in
the START/NOCOLLECT command that you issued to start snapshot tracing.
If you do not specify a process name, then CTF will use the process named
username$CTF.
You cannot specify a process name if you issue the COLLECT command while
performing live tracing.
Description
If you start tracing with a START/NOCOLLECT command, the collected trace
records are copied to an internal CTF buffer, but are neither written to a trace
file (if you are performing detached tracing) nor displayed on your terminal (if you
are performing live tracing). When the buffer is full, new trace records overwrite
the oldest trace records in the buffer. The buffer is therefore a circular buffer
whose contents provide a snapshot of the most recent history of tracing.
When you issue a COLLECT command, the current contents of the buffer are:
• Written to the default trace file, CTF$TRACE.DAT, if you are performing
detached tracing. You can then issue an ANALYZE command to display these
trace records.
• Displayed on your terminal, if you are performing live tracing.
Examples
CTF> COLLECT
if you are performing detached tracing, writes trace records collected by the
default trace server process username$CTF and writes them to CTF$TRACE.DAT.
If you are performing live tracing, the trace records are displayed on your
terminal.
CTF> COLLECT /PROC=SMITH$CTF_Z
writes trace records collected by the process SMITH$CTF_Z to the file
CTF$TRACE.DAT. You must have previously issued a START/NOCOLLECT
command naming SMITH$CTF_Z in the /PROCESS_NAME qualifier.
CTF Commands 4–9