HP-UX TN3270 Administration Guide

Using TN3270 Tracing Facilities
Controlling Tracing
Chapter 562
To use SNACTL, set it to any non-blank string. To cancel it, set SNACTL to
a blank character.
Controlling the Amount of Trace Data
The following environment variables control the amount of data stored in
trace files:
SNATRUNC
Specifies the maximum length in bytes of each entry in
a trace file. This variable applies both to HLLAPI trace
files (specified by the SNATRC environment variable)
and to TN3270 emulation program tracing (specified by
the SNAMSG environment variable).
Set this variable to a decimal number. If a message has
more characters than this value, the excess characters
are truncated. For example, setting SNATRUNC to 70
limits tracing to 70 bytes of data per entry. By default,
the length of internal messages is limited to a
maximum of 256 bytes.
SNATRACESIZE
Specifies the maximum size in bytes of each trace file
when using two files. This value applies both to
HLLAPI trace files (specified by the SNATRC
environment variable) and to TN3270 emulation
program tracing (specified by the SNAMSG environment
variable), but only when tracing to two files. If you are
tracing to one file, the size of the trace file has no limit.
Set this environment variable to a decimal number.
When TN3270 is writing a message to one of the trace
files and the maximum file size is reached, TN3270
clears the other trace file and continues tracing to that
file. This ensures that the maximum amount of disk
space taken up by a pair of user-space trace files is
approximately twice the value of SNATRACESIZE.
If you do not set SNATRACESIZE, the default is 1
megabyte. To cancel the SNATRACESIZE setting and
return to the default, set SNATRACESIZE to a blank
character.