The client libraries

The client libraries can be found in the following locations of your Apama installation:

For C++, in the lib directory: libapclient.so (-lapclient) on UNIX, or apclient.lib on Windows.

For .NET, in the bin directory: apclientdotnet.dll (and its dependency apclient.dll).

To program against the C++ SDK, you must use the definitions from the engine_client_cpp.hpp header file, which is located in the include directory of your Apama installation.

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++ 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/.

To configure the build for an Apama C++ client:

On UNIX, 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++ > 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.

Add the ap-client.jar library to your classpath when compiling and running.

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:

2. Ensure that the bin directory of your Apama installation is in the PATH environment variable.