tm_trace

The OpenAccess SDK SQL engine supports the logging method tm_trace to allow method calls, arguments, and other messages to be traced based on a flag provided at runtime. The tm_trace method provides a flexible way to trace events because you can set different levels of tracing with total control over enabling or disabling at runtime.

Insert as many traces as possible, specifically for each error or important event occurring, as well as for each assumption or minor event occurring. Function calls should be traced by placing a trace as the first instruction of each function (using the flag UL_TM_F_TRACE to trace the program flow). Additionally, IP identification and version information should be displayed by the IP initialization routines (using the flag UL_TM_INFO) to facilitate future maintenance. For information about how to control tracing, refer to the OpenAccess SDK Troubleshooting Guide. The ServiceIPLogOption service attribute controls the tracing level. Log files for each connection are stored in the install_dir/logging directory.

void tm_trace(
    long   handle,
    int    flag,
    String msg)

Parameters for tm_trace

The flag is a mask defined by the combination of using one or more of the masks listed in Table Trace Flag Masks for use in tm_trace().

Trace Flag Masks for use in tm_trace()

1 The selected logging level and all levels above it are enabled. For example, selecting Enable Major Events will turn on all trace messages that use the flag UL_TM_FATAL, UM_TM_ERRORS, or UL_TM_MAJOR_EV.