The client libraries
The client libraries can be found in the following locations of your Apama installation:
In the
lib directory:
libapclient.so (
-lapclient) on Solaris or Linux, or
apclient.lib on Windows, both for C and C++.
In the
lib directory:
ap-client.jar for Java.
In the
bin directory:
apclientdotnet.dll (and its dependency
apclient.dll) for .NET.
Using the C and C++ client libraries
To program against the C and C++ SDKs, you must use the definitions from the following files, which are located in the include directory of your Apama installation:
engine_client_c.h header file for C.
engine_client_cpp.hpp header file for C++.
C++ compilers vary extensively in their support for the ISO C++ standard and in how they support linking. For this reason, Apama supports only specific C/C++ compilers and development environments. For a list of the supported C++ compilers, see Software AG's Knowledge Center in Empower at
https://empower.softwareag.com/.
On the other hand, C has been standardized for several years, and for this reason, the C development kit should work with the majority of modern C/C++ compilers on all platforms. However, note that when using a C compiler and linker, you still need to link against the standard C++ library since Apama's underlying libraries contain C++ code.
To configure the build for an Apama C/C++ client:
On Linux, copying and customizing an Apama
makefile from a sample application is the easiest method.
On Windows, you might find it easiest to copy an Apama sample project. If you prefer to use a project you already have, be sure to add
$(APAMA_HOME)\include as an include directory. To do this in Visual Studio, select your project and then select
Project Properties > C/C++ > General > Additional Include Directories.
Also, link against apclient.lib. To do this in Visual Studio, select your project and then select Project Properties > Linker > Input > Additional Dependencies and add apclient.lib.
Finally, select Project Properties > Linker > General > Additional Library Directories and add $(APAMA_HOME)\lib.
Using the Java client library
Add the ap-client.jar library to your classpath when compiling and running.
Using the .NET client library
To make use of the .NET wrapper, add the apclientdonet.dll library as a reference of your assembly.
To run an application using the wrapper:
1. Copy the following libraries from the bin directory of your Apama installation into the directory that contains your compiled .NET assembly:
apclient.dll apclientdonet.dll log4net.dll 2. Ensure that the bin directory of your Apama installation is in the PATH environment variable.