Chapter 5 71
Troubleshooting Your Application
Using A/P API Tracing
Enable A/P API Tracing Using Global
Variables
To enable A/P 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 ap_trace;
extern int ap_trace_max_udata;
extern FILE *ap_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 A/P 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 A/P function call input
parameters. This is useful if you want to
verify that A/P is actually receiving the
values you expect.
API_TR_OUTPUT Provides traces of A/P function call output
parameters. This is useful if you want to
verify what values A/P 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.