iSeries Access for Linux Toolkit

/***********************************************************************/ /* LICENSE AND DISCLAIMER */ /* */ /* This material contains IBM copyrighted sample programming source */ /* code. IBM grants you a nonexclusive license to use, execute, */ /* display, reproduce, distribute and prepare derivative works of this */ /* sample code. The sample code has not been thoroughly tested under */ /* all conditions. IBM, therefore, does not warrant or guarantee its */ /* reliability, serviceablity, or function. All sample code contained */ /* herein is provided to you "AS IS." ALL IMPLIED WARRANTIES, */ /* INCLUDING BUT NOT LIMITED TO THE IMPLIED WARRANTIES OF */ /* MERCHANTABILLITY AND FITNESS FOR A PARTICULAR PURPOSE, ARE */ /* EXPRESSLY DISCLAIMED. */ /* */ /***********************************************************************/

Version 5 Release 4 Modification Level 0
(c) Copyright IBM Corporation 1996, 2007. All rights reserved.

This toolkit provides information on the C/C++ APIs available in the iSeries Access for Linux product.

For samples and more API information, see the iSeries Access Toolkit and the iSeries Information Center web sites.

Header Information

The toolkit provides the following foundation header files that all components could use:

Client Information

iSeries Access for Linux provides a C programming interface for retrieving information about the iSeries Access for Linux code installed on the PC.

Interface definition: cwbad.h

Shared Library: libcwbcore.so

Communications and Security

These interfaces provide the ability to:

Interface definitions: cwbcosys.h cwbco.h cwbsy.h

Shared Library: libcwbcore.so

Program Call

iSeries Access for Linux provides a C programming interface for calling server programs or system APIs. For conversion of parameter data, the C interfaces for data manipulation can be used.

Interface definition: cwbrc.h

Shared Library: libcwbrc.so

Remote Command

iSeries Access for Linux provides a C programming interface for running OS/400 commands.

Interface definition: cwbrc.h

Shared Library: libcwbrc.so

Database - ODBC

The iSeries Access for Linux ODBC driver provides SQL access to iSeries database files, using standard ODBC interfaces.

There are multiple ways in which to access the ODBC driver:

For more information on developing ODBC applications, see the Linux driver manager web site.

Database - EDRS

The iSeries Access for Linux Extended Dynamic Remote SQL driver provides access to iSeries database files. For more information on developing ERDS applications, see the EDRS web site.

Interface definition: qxdaedrsnt.h

Shared Library: libcwbxda.so

Database - Distributed Transaction Processing - XA Interface

The iSeries Access for Linux provides the XA interface. This allows an application program to define transaction boundaries as well as manage outstanding transactions. For more information on developing XA applications, see the Distributed Transaction Processing: The XA Specification web site.

Interface definition: xa.h (available on iSeries in /QIBM/include) and cwbxa.h

Shared Library: libcwbcore.so

Error Handling

Many of the iSeries Access for Linux APIs support an error handle parameter. This error handle supports returning both PC and server messages associated with a failure. iSeries Access for Linux also provides a C programming interface for logging trace points and diagnostic messages.

Interface definition: cwbsv.h

Shared Library: libcwbcore.so

Data Manipulation

iSeries Access for Linux provides a C programming interface for data conversions.

Interface definition: cwbnl.h

Shared Library: libcwbcore.so