Apama Documentation : Connecting Apama Applications to External Components : Developing Custom Clients : The Client Software Development Kits : The client libraries
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.
Copyright © 2013-2017 Software AG, Darmstadt, Germany. (Innovation Release)

Product LogoContact Support   |   Community   |   Feedback