HP-UX TN3270 Administration Guide

Using TN3270 Tracing Facilities
Controlling Tracing
Chapter 5 61
The following examples illustrate the SNATRACESIZE environment
variable:
file1.trc:file2.trc
Trace to file1 and file2. Tracing is inactive when the HLLAPI
application is started.
filea.trc::
Trace to one file (filea.trc). Tracing starts when the HLLAPI
application is started.
Controlling Tracing from Within a HLLAPI Application
The TRON and TROFF options of the HLLAPI Set Session
Parameters function enable you to trace the specific section of a HLLAPI
program where a problem is being encountered (without having to trace
the whole application). Tracing can be activated at the start of this
section and deactivated at the end of it. Refer to the HP-UX SNAplus2
3270 & TN3270 HLLAPI Programmers Guide for more information.
To use this facility, the SNATRC environment variable must be set before
the application program is started. For more information, see
“Controlling Tracing of HLLAPI Applications”. When setting this
environment variable, set tracing to be active or inactive when the
HLLAPI application is started and then activate it or deactivate it from
within the application as required.
You can disable the TRON and TROFF options by using the SNACTL
environment variable.
Disabling the Application's Control of Tracing
The SNACTL environment variable overrides the TRON and TROFF
options of the HLLAPI Set Session Parameters function so that the
application cannot control its own tracing. You can use SNACTL to force
the tracing of an application program that normally turns tracing off for
some functions, or to prevent tracing for an application program that
normally uses it.
If the SNACTL variable is set before the application program is started,
any TRON and TROFF tracing control requests from within the
application program are ignored, although the return code indicates a
successful completion. If tracing is on, it remains on; if tracing is off, it
remains off.