client applications

You can compile and link a client application with the HCL® Informix® GLS libraries.

For information about how to write and compile client applications, see the HCL® Informix® DataBlade® API Programmer's Guide.

You must specify the location of the header file, ifxgls.h. This header file is located in %INFORMIXDIR%\incl\public for Windows™ and in $INFORMIXDIR/incl/public for UNIX™.

This directory also contains many of the other files that a client application uses. Therefore, it is an important directory to include when you compile the application.

The following command uses the Microsoft™ compiler, cl, to compile a client application called sample.c that uses :

cl -MD -Id:\msdev\include -Id:\informix\incl\public -Id:\informix\incl\esql \
-Id:\informix\incl -c sample.c

All functions are exported through the libthdmi.lib library. For linking, you must specify the following two libraries.


At link time (in lib subdirectory of INFORMIXDIR)	At run time (in bin subdirectory of INFORMIXDIR)	Purpose
libthdmi.lib	idmit09a.dll	functions
isqlt09a.lib	isqlt09a.dll	ESQL/C functions

Make sure to include the $INFORMIXDIR/incl/public directory with the -I compiler option, as follows:

cc -I$INFORMIXDIR/incl/public -I$INFORMIXDIR/esql -I$INFORMIXDIR/incl -c sample.c

The preceding command checks to see whether the API client libraries have been installed in the directory that the INFORMIXDIR environment variable indicates.

On UNIX™ platforms, you must explicitly specify the location and name of the library, as follows:

For the library location, use the following -L compiler option: -L$INFORMIXDIR/lib/esql
For the library name, include the -lifgls command-line option.

The following command links the sample.o object file to create an executable file called sample:

cc -o sample sample.o \
-L$INFORMIXDIR/lib/esql -L$INFORMIXDIR/lib/dmi -L$INFORMIXDIR/lib \
-lifdmi -lifsql -lifasf -lifcss -lifos -lifgen -lifgls -lifglx \
-lnsl -lsocket -laio -lm -ldl -lelf -lw \
$INFORMIXDIR/lib/esql/checkapi.o

Alternatively, you can use the ESQL/C preprocessor, esql, to compile and link the client application. The esql preprocessor automatically links most of the libraries that the client application requires (including the library). However, you must explicitly specify the libdmi library. The following esql command compiles and links the sample.o object file:

esql -o sample sample.o -L$INFORMIXDIR/lib/dmi -ldmi