HP UX Internet and Networking Software manual Environment Variables That Affect Tracing, Columns

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. If SNATRACESIZE 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. If SNATRCRESET is not set, or is set to YES, SNAplus2 resets the file when an application first writes to it.

637