HP-UX TN3270 Administration Guide

Using TN3270 Tracing Facilities
Controlling Tracing
Chapter 5 59
Controlling Tracing
This section describes how you can start and stop tracing, how you
specify the names of trace files, and how you can control the size of trace
files.
Controlling Tracing of the TN3270 Program
The SNAMSG environment variable controls tracing the TN3270 program.
The syntax for SNAMSG is:
file1 [ : file2 ]
Specify the following parameters in the SNAMSG 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.
SNAMSG tracing is always active if the environment variable is set.
Tracing cannot be turned on and off while the program is running.
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.
Controlling Tracing of HLLAPI Applications
The SNATRC environment variable and the HLLAPI Set Session
Parameters function control HLLAPI application tracing. To use the Set
Session Parameters function, always set the SNATRC environment
variable before starting the application program.