Trace points

You can record significant custom server events in the AIX trace file in which Blueworx Voice Response records events. This puts your trace points in the context of other system events.

To write a record to the AIX trace, use the CA_Trace_String() and CA_Trace_Data() macros or the CA_Trace_String() and CA_Trace_Data() subroutines.

Note that Blueworx Voice Response will trace each subroutine call made by the custom server. On return from a custom server subroutine call, Blueworx Voice Response will also trace the returned value and the values of CA_errno and errno. You do not need to duplicate this information in your own trace entries.

Trace significant events that will help you debug your custom server. For example, record a trace entry each time your custom server receives input such as a message from another process. The event is best traced using CA_Trace_String(). You can also trace the message itself, by using CA_Trace_Data().

The AIX trace buffer is a limited resource. The more information you write to the trace buffer, the more quickly the trace is likely to wrap. You can use the AIX trace command to be selective about which events you want to trace. For more information about the trace command, see the Commands Reference. For more information about selective tracing, refer to the Blueworx Voice Response for AIX: Problem Determination information.

To trace a custom server, see Tracing custom servers.