Component Profile and Setup

This document provides information about the contents of this Tamino component and the installation.


Component Profile

Here you will find general information about the API and how to use it.

The Tamino API for C is automatically with the Tamino XML Server installation.

Tamino Component Profile for the Tamino API for C

Supported Platforms

All platforms supported by Tamino XML Server.

Location of Installed Component

<TaminoInstallDir>/SDK/TaminoAPI4C (henceforth called <TaminoAPI4CDir>).

Structure of the Tamino API for C

The Tamino API for C consists of two layers.

The first layer provides roughly the same functionality as can be achieved by issuing X-Machine commands directly. For more details, see Requests using X-Machine Commands. This layer operates on byte buffers and is distributed as a shared library.

The second layer provides convenience functions. The convenience functions mostly deal with file I/O. They are described in detail in the section File Handling Reference. This layer can be easily adapted to the programmer's specific needs since it is also distributed in source code.

Working with the Tamino API for C

You need a running Tamino database server to work with the Tamino API for C. If you want to access an existing Tamino database, you need to specify the database name only, e.g. "mydb", since the Tamino database is accessed via the Software AG product eXtended Transport Services (XTS).

In order to run an existing application that uses the Tamino API for C:

  • Make sure that the module for webserverless access to Tamino has been installed on the computer on which the application runs. This includes a local installation of XTS. Please note that no license file is required.

  • Make sure that your PATH variable (Windows) or LD_LIBRARY_PATH variable (UNIX) includes the directory containing the provided library file.

    The PATH variable must include the directory $INODIR/$INOVERS/sagcom64/.

  • If you want to recompile your application, see Using the API.