Using Rose Api Tracing; Environment Variable Names - HP A4500A - VMEbus Single Board Computer 744 Motherboard Programmer's Manual

Using ROSE API Tracing

Tracing is enabled in your application program and the tracing output is
printed to a trace file. Different levels of tracing are provided with the
trace facility. For example, you can trace procedure entry and exits, error
conditions, or both. ROSE tracing has been implemented to be consistent
with ACSE/Presentation tracing.

Environment Variable Names

The names of the ROSE environment variables available are as follows:
ROSE_TRACE
ROSE_TRACE_FILE
ROSE_TRACE_MAX_UDATA
The effect of these environment variables below.
AP_TRACE:
These values indicates the trace level to be used for each API call. It is
actually a set of flags, defined in the file //opt/ots/lib/api_trace.h.
Default = 0 (trace_off).
You may set this value in one of two ways:
1. It may be treated as an integer value and may be set using either
decimal or hexadecimal notation, for example:
AP_TRACE=0xff
2. It may be treated as a set of ASCII flags. The following standard flags
are defined.
i = input parameters
o = output parameters
x = external procedure entry exit
e = error tracing
n = internal tracing
Chapter 5
Troubleshooting Your Application
Using ROSE API Tracing
75