This section explains how applications call API functions.
Applications call C API functions defined in C language header files, and a dynamic link library (DLL). Each function call returns an integer result code, defined in the ctgstdat.h header file. A function that completes normally returns the code CTG_STAT_OK. A function that needs to report a problem returns a negative code, detailed in the ctgstdat.h header file.
The statistics C API does not provide logging messages. Runtime operation of the C API functions can be monitored using trace facilities. Statistics C API tracing can be enabled programatically with data written to stderr, or a specified file. C API errors are reported to the calling application using an integer result code.