ACSE/Presentation and ROSE Interface Programmer's Guide

Chapter 5 77
Troubleshooting Your Application
Using ROSE API Tracing
Table 5-2 ROSE Tracing Types
Enable ROSE API Tracing
To enable ROSE tracing in your program, add the following statements
to your program:
1. Include the appropriate definitions by adding these lines:
#include <stdio.h>
#include <api_trace.h>
extern int rose_trace;
extern int rose_trace_max_udata;
extern FILE *rose_trace_fp;
API_TR_ENTRY_EXIT Traces procedure entry and exit. No
parameter information is displayed. This is
useful if you are only interested in seeing
what ROSE calls your program is making.
Note that this trace is automatically
generated if you use API_TR_INPUT,
API_TR_OUTPUT, or
API_TR_INT_ENTRY_EXIT.
API_TR_INPUT Provides traces of ROSE function call input
parameters. This is useful if you want to
verify that ROSE is actually receiving the
values you expect.
API_TR_OUTPUT Provides traces of ROSE function call
output parameters. This is useful if you
want to verify what values ROSE is passing
back to your program.
API_TR_INT_ENTRY_EXIT Enables internal tracing. Use if directed to
do so by your HP support representative.
API_TR_INT_ERROR Enables external and internal error tracing.
Recommended that users turn this tracing
on at all times. Includes filename and line
number information useful for HP factory
support.