HP-UX SNAplus2 R7 Administration Command Reference

Appendix CEnvironment Variables
C.6 Environment Variables That Affect the Command-Line
Administration Program
C.6.1 COLUMNS
SNAplus2 uses COLUMNS to control the display of information returned on the status_* administration
commands.
The amount of information that can be returned depends on the width of your display; SNAplus2 attempts to
determine this using the COLUMNS environment variable, and uses a default value of 80 if COLUMNS is not set.
The
Description text may be omitted or truncated if there is not enough room to display it.
For more details, see Section 2.198, status_all.
C.7 Environment Variables That Affect Tracing
C.7.1 SNATRC
SNAplus2 uses SNATRC to control API tracing on applications using the SNAplus2 APIs.
For more details, refer to the information about controlling tracing on user-space components in HP-UX SNAplus2
Diagnostics Guide.
C.7.2 SNACTL
The SNAplus2 API libraries use SNACTL to suppress control of tracing from within applications.
If API tracing is active (specified using the SNATRC environment variable), an application can use the CSV
DEFINE_TRACE call or the HLLAPI Set Session Parameters call to turn tracing on and off while the application
is running. You can prevent these calls from taking effect by setting SNACTL to any non-null string. If SNACTL
is not set, or is null, the calls will operate normally.
For more details, refer to the information about controlling tracing on user-space components in HP-UX SNAplus2
Diagnostics Guide.
C.7.3 SNATRACESIZE
The SNAplus2 API libraries use SNATRACESIZE to specify the maximum size of API trace files.
If API tracing is set up to use two files (specified using the SNATRC environment variable), tracing switches between
the two files each time the file size reaches the limit specified by SNATRACESIZE.IfSNATRACESIZE is not set,
SNAplus2 uses a default file size limit of 1,000,000 bytes.
For more details, refer to the information about controlling tracing on user-space components in HP-UX SNAplus2
Diagnostics Guide.
C.7.4 SNATRCRESET
The SNAplus2 API libraries use SNATRCRESET to specify whether an API trace file is reset when an application
first writes to it.
Normally, the file is reset (and its existing contents are discarded) when an application writes its first trace message
to the file. If you are tracing two or more applications to the same file, or if you want to trace two or more runs of
the same application to the same file, you need to prevent the file from being reset. To do this, set SNATRCRESET
to NO.IfSNATRCRESET is not set, or is set to YES, SNAplus2 resets the file when an application first writes to it.
637