Enable A/P Api Tracing Using Global Variables - HP A4500A - VMEbus Single Board Computer 744 Motherboard Programmer's Manual

API_TR_ENTRY_EXIT
API_TR_INPUT
API_TR_OUTPUT
API_TR_INT_ENTRY_EXIT
API_TR_INT_ERROR
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;
Chapter 5
Troubleshooting Your Application
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.
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.
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.
Enables internal tracing. Use if directed to
do so by your HP support representative.
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.
Using A/P API Tracing
71