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.
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.
Data set names and SMP/E typesOn IBM® z/OS®, the runtime DLL and header file are delivered by SMP/E. The details are provided in the following table.
|Sidedeck||SMP/E generated||hlq.SCTGSID||CTGSTATS||Not applicable|
The DLL load module is link-edited during installation. When the SCTGDLL library is added to the STEPLIB concatenation, user applications can use the statistics C API. If the application uses implicit DLL loading, the sidedeck might be required to complete the link-edit cycle.
File names and locationsThe runtime DLL and header files are included in the SDK. The details of the files are provided in the following table.
|Platform||Deliverable||File name||SDK directory|
|Linux® on Intel||DLL||libctgstats.so||cicstgsdk/statistics/c/LinuxI/lib32|
|Linux on POWER®||DLL||libctgstats.so||cicstgsdk/statistics/c/LinuxP/lib32|
|Linux on IBM z Systems®||DLL||libctgstats.so||cicstgsdk/statistics/c/LinuxZ/lib32|
|UNIX and Linux||Sample Makefile||makefile||cicstgsdk/statistics/c/samples|
- 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 cicstgsdk/statistics/c/samples/include.def file for your chosen platform.