IOPC2

The IOPC 2 library can be used in several configurations (the section called “Library architecture”). Depending on the selected configuration, corresponding initialization and termination routines must be called. These routines are listed in the Table A.1, “Library configurations and their initialization/termination routines”. Configurations are ordered by ascending complexity and so by amount of features they provide. First row of the table contains the most basic configuration - the iopccommon library. Libraries/configurations in following rows depend on libraries from previous rows and also implicitly call their initialization/termination routines. So calling the initialization/termination routine only for the selected configuration is sufficient. There exist also header files with the "Headers" suffix in their names (like iopcMetaHeaders.h or iopcDbHeaders.h), which include most commonly used header files for the selected configuration.

Basic library setup for a configuration that uses IOPC 2 as a database access library can then look like this:

// Include all commonly used headers for the
// iopcdb configuration
#include "iopcdb/iopcDbHeaders.h"

// IOPC 2 structures are defined within the iopc napespace
using namespace iopc;

int main(int argc, char *argv[])
{
  try {
    // Initializes the library and also sets the LogWriter masks
    // Throws an exception if not successful
  	IopcDb::init(LogWriter::ERROR, LogWriter::ERROR | 
      LogWriter::WARNING);
  	
  	// ... 
  
    // Library cleanup. Releases allocated resources, 
    // closes open connections.
  	IopcDb::shutdown();
  } catch (IopcException& e) {
    // Error handling
  }
}