SNAX/HLS Configuration and Control Manual

Command Dictionary
Using the HLSCOM Utility
6–62 104705 Tandem Computers Incorporated
START
directs the SNAX/HLS server to open the trace file and begin collecting trace
records.
STOP
directs the SNAX/HLS server to close the trace file.
Considerations
The status of trace activity for each SNAX/HLS session is kept in a special header
of the trace file called the entity trace table (ETT). The trace file must be open and
trace must be active before elements can be added to the ETT.
You must follow the proper sequence of events to acquire correct traces. The
proper sequence can be found below in the example section.
The trace file must reside on the same system as the currently open copy of the
SNAX/HLS server.
The size of the trace file specified with the SIZE parameter has a direct impact on
the amount of disk space required to support the file, and on the amount of trace
data that can be retained. These two effects are somewhat contradictory; to retain
more trace data requires more disk space, and disk space might be at a premium.
In earlier versions of SNAX/HLS, this value was fixed at 64 pages (one page is
equal to 2,048 bytes). Based upon this historical fact, you should be wary of
allocating a trace file whose size is very different.
Examples
This command directs the SNAX/HLS server to open the trace file named ELPASO.
The file name ELPASO is qualified with CMDVOL.
@ TRACE FILE ELPASO
This command directs the SNAX/HLS server to open a small trace file that contains 32
pages (65,536 bytes).
@ TRACE FILE TINY, SIZE 32
This command turns on tracing in SNAX/HLS and allows you to trace specific
sessions.
@ TRACE START
This command adds the SNAX/HLS session $SNA1.#LU1 to the ETT. The trace type
defaults to A (ALL).
@ TRACE ENABLE $SNA1.#LU1