Calling the C API

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.


Concept Concept

Feedback


Timestamp icon Last updated: Tuesday, 19 November 2013


https://ut-ilnx-r4.hursley.ibm.com/tgzos_latest/help/topic/com.ibm.cics.tg.zos.doc//progdezos/callingtheapi.html