DataBlade client applications

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

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

You must specify the location of the Informix GLS 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 DataBlade 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 DataBlade client application called sample.c that uses Informix GLS:

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

All Informix GLS 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	DataBlade API 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 DataBlade client application. The esql preprocessor automatically links most of the libraries that the client application requires (including the Informix GLS 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