Introduction to the QAnywhere interfaces

QAnywhere client applications manage the receiving and sending of QAnywhere messages. The applications can be written using one of several QAnywhere APIs:

QAnywhere .NET API
QAnywhere C++ API
QAnywhere Java API
QAnywhere SQL API

You can use a combination of client types in your QAnywhere system. For example, messages that are generated using QAnywhere SQL can also be received by a client created using the APIs for .NET, C++, or Java. If you have configured a JMS connector on your server, the messages can also be received by JMS clients. Similarly, QAnywhere SQL can be used to receive messages that were generated by QAnywhere .NET, C++, Java, or JMS clients.

QAnywhere .NET API

The QAnywhere .NET API is a programming interface for deployment to Windows computers using the Microsoft .NET Framework and to handheld devices running the Microsoft .NET Compact Framework. The QAnywhere .NET API is provided as the iAnywhere.QAnywhere.Client namespace.

QAnywhere supports Microsoft Visual Studio.

Note

In this document, code samples for the .NET API use the C# programming language, but the API can be accessed using any programming language that Microsoft .NET supports.

Versions of the TestMessage sample application are written in Java, C#, and Visual Basic .NET. There is also a .NET compact framework sample.

For more information about the .NET version of the TestMessage sample application, see Lesson 4: Explore the TestMessage client source code.

See QAnywhere .NET API reference for clients.

QAnywhere C++ API

The QAnywhere C++ API supports Microsoft Visual Studio.

The QAnywhere C++ API consists of the following files:

A set of header files (the main one being qa.hpp), located in install-dir\sdk\include.
An import library (qany12.lib), located in install-dir\sdk\lib\x86, and install-dir\sdk\lib\ce\arm.50.
A run-time DLL (qany12.dll) located in install-dir\bin32, and install-dir\ce\arm.50.

To access the API, your source code file must include the header file. The import library is used to link your application to the run-time DLL. The run-time DLL must be deployed with your application.

A version of the TestMessage sample application written in C++ is supplied in samples-dir\QAnywhere\Desktop\MFC.

See QAnywhere C++ API reference for clients.

QAnywhere Java API

The QAnywhere Java API supports JRE 1.4.2 and up. The Mobile web services wsdl compiler generates Java classes compatible with JDK 1.5.0 and up.

The QAnywhere Java API consists of the following files:

API reference material, available in this book or in Javadoc format in the documentation\en\javadocs\QAnywhere subdirectory of your SQL Anywhere 12 installation.
Runtime DLL (qadbiuljni12.dll) for UltraLite message stores, located in the bin32 subdirectory of your SQL Anywhere 12 installation.
An archive of the class files (qaclient.jar), located in the java subdirectory of your SQL Anywhere 12 installation.

The class file archive must be included in your path when you compile your application. The runtime DLL must be deployed with your application.

A version of the TestMessage sample application written in Java is supplied in samples-dir\QAnywhere\Java\. (For information about samples-dir, see Samples directory.)

See QAnywhere Java API reference for clients.