Statistics C API components
The statistics C API is made available to user applications by two C language header files and a dynamic link library (DLL).
C language header files
Two platform-independent C language header files are provided for developing user applications.
ctgstats.h defines the C API function calls and data types required to use the C API functions.
ctgstdat.h defines the set of query return codes that might be seen by a statistical user application. The set of query return codes can vary according to the statistics protocol version provided by the CICS® Transaction Gateway daemon.
Runtime DLL
The statistics C API runtime DLL is provided for each of the supported CICS Transaction Gateway hardware platforms. It is supplied as a platform-specific DLL or shared library. It must be available during the run time of the statistical user application.
File names and locations
The runtime DLL and header files are installed by the installer. The details of the files are provided in the following table.| Platform | Deliverable | File name | Installation directory |
|---|---|---|---|
| All | C Header | ctgstats.h | include |
| All | C Header | ctgstdat.h | include |
| All | C Sample | ctgstat1.c | samples/c/stats |
| IBM® AIX® | DLL | libctgstats.a | lib |
| Linux® on Intel | DLL | libctgstats.so | lib |
| Linux on POWER® | DLL | libctgstats.so | lib |
| Linux on IBM z Systems® | DLL | libctgstats.so | lib |
| UNIX and Linux | Sample Makefile | samp.mak | samples/c/stats |
| Windows | DLL | ctgstats.dll | lib |
| Windows | Export symbols | ctgstats.lib | lib |
| Windows | Sample Makefile | ctgstat1mak.cmd | samples/c/stats |
- Windows platform
- At compile time, applications that use the statistics C API need access to the C API DLL external symbols provided in the ctgstats.lib file.
- Unix and Linux platforms
- If you change the sample makefile, you might also have to update the samples/c/env_c.def file.