NET/MASTER Management Services (MS) Command Reference Manual

LBANNER
TRACE START
NonStop NET/MASTER MS Commands
2–570 115412 Tandem Computers Incorporated
TRACE START The TRACE START command starts tracing the specified trace parameter settings—
either messages or internal trace points (as described in the TRACE trace-spec
command). This command starts a trace collector process (the process name is
returned when the process is started), which opens a trace file to collect trace records
and controls the writing of trace records to the trace file. You must specify the
parameter settings you want to trace by using the TRACE trace-spec command before
starting a trace; otherwise, the trace collector is not started, and the trace file is not
opened.
Note To start a trace collector process using the TRACE START command, the program SCPTCOL must exist
in $SYSTEM.SYSTEM or $SYSTEM.SYSnn.
One TRACE START command starts one trace collector process. A single trace
collector process controls one running trace and the writing of records to one trace file.
A single user can execute multiple TRACE START commands to run multiple traces
(except that only one internal trace can be started at a time in a NonStop
NET/MASTER MS system).
All current values in the trace parameter list (TPL) are used when starting a trace.
When the TRACE START command is executed, the values of the parameter settings
in the TPL are sent to the trace collector. After the trace is started, the trace parameter
settings in the TPL are reset to their default values. Therefore, if you subsequently
want to supplement the trace parameter settings of a running trace (using the TRACE
ALTER command), you must reenter the original settings in addition to the new
settings.
When started, the trace is allocated a trace ID from 1 through 65535, which you can use
in subsequent TRACE ALTER or TRACE STOP commands. Entering the TRACE
START command with no operands causes the default values to be used when the
trace is started. You can use the SHOW TRACE=ALL command to display
information about a running trace, including its trace ID.
TRACE START[ = file-name ]
[ COUNT= record-limit ]
[ PAGES= pages ]
[ WRAP={ YES | NO } ]
file-name
specifies the file name to which trace records are written by the trace collector.
The file name is created on the system on which NonStop NET/MASTER MS is
running.
You can specify a file name in the form:
$ volume . subvolume . file-name