HP-UX TN3270 Administration Guide

Using TN3270 Tracing Facilities
Controlling Tracing
Chapter 560
Specifying Trace Files for a HLLAPI Application
The SNATRC environment variable specifies one or two files to hold trace
data and indicates whether to activate tracing when the application
starts. The syntax for the SNATRC environment variable is:
file1 [ : [ file2 ] [ : ] ]
Specify the following parameters in the SNATRC environment variable:
file1
Name of the trace file.
file2
Optionally included name of a second trace file. Use a
colon to separate the two file names. If you specify two
trace files, when one file has reached the maximum size
(as specified by the SNATRACESIZE environment
variable), trace data is written to the second file. When
the second file has reached the maximum size, trace
data is written again to the first file.
Final colon (:)
The final colon indicates that tracing is active as soon
as the application is started. If tracing is not active
when the application is started, it can be activated
fromwithintheapplicationusingtheHLLAPIfunction
Set Session Parameters. (For more information, see
“Controlling Tracing from Within a HLLAPI
Application”.) If you specify only one file name, use two
colons to make tracing active as soon as the application
is started.
If you specify only one file name, the size of the trace file has no limit. If
you specify two file names, the maximum size of each trace file is
specified by the SNATRACESIZE environment variable. For more
information, see “Controlling the Amount of Trace Data”. Using two files
extends the trace period and limits the disk space usage to twice the
value specified in SNATRACESIZE.
Trace data must always be written to text files. Do not specify the name
of a device (such as /dev/tty) or a print spooler as a trace filename. If
you do not specify a full path for the trace file or files, TN3270 uses the
directory from which you start the application.