To initialize the QAnywhere C++ API

1. Include the QAnywhere header file.

   #include <qa.hpp>

   qa.hpp defines the QAnywhere classes.

2. Initialize QAnywhere.

   To do this, initialize a factory for creating QAManager objects.

   QAManagerFactory * factory; factory = QAnywhereFactory_init(); if( factory == NULL ) { // Fatal error. }

   For more information about QAManagerFactory, see QAManagerFactory class.

3. Create a QAManager instance.

   You can create a default QAManager object as follows:

   QAManager * mgr; // Create a manager mgr = factory->createQAManager( NULL ); if( mgr == NULL ) { // fatal error }

   See QAManager class.

   Tip

   For maximum concurrency benefits, multi-threaded applications should create a QAManager for each thread. See Multi-threading considerations.

   You can customize a QAManager object programmatically or using a properties file.

   • To customize QAManager programmatically, use setProperty().

     See Setting QAnywhere manager configuration properties programmatically.

   • To use a properties file, specify the properties file in createQAManager():

     mgr = factory->createQAManager( "qa_mgr.props" );

     where qa_mgr.props is the name of the properties file on the remote device.

     See Setting QAnywhere manager configuration properties in a file.

4. Initialize the QAManager object.

   qa_bool rc; rc=mgr->open( AcknowledgementMode::IMPLICIT_ACKNOWLEDGEMENT );

   The argument to the open method is an acknowledgement mode, which indicates how messages are to be acknowledged. It must be one of IMPLICIT_ACKNOWLEDGEMENT or EXPLICIT_ACKNOWLEDGEMENT. With implicit acknowledgement, messages are acknowledged as soon as they are received by the client. With explicit acknowledgement, you must call one of the acknowledge methods on the QAManager to acknowledge the message.

   For more information about acknowledgement modes, see AcknowledgementMode class.