Home
Client APIs and tools
You can use the HCL Informix® implementation of client APIs to develop applications for Informix database servers.
ESQL/C Guide
The Informix® ESQL/C Programmer's Manual explains how to use Informix ESQL/C, the Informix implementation of Embedded Structured Query Language (SQL) for C (ESQL/C), to create client applications with database-management capabilities.
Database server communication
Exception handling
Exception handling with the sqlca structure
An alternative way to obtain diagnostic information is through the SQL Communications Area. When an SQL statement executes, the database server automatically returns information about the success or failure of the statement in a C structure that is called sqlca.
Check for exceptions with sqlca
Success in sqlca

Client APIs and tools
You can use the HCL Informix® implementation of client APIs to develop applications for Informix database servers.
- Change Data Capture API Programmer's Guide
  The Informix® Change Data Capture API Programmer's Guide describes how to program applications to process changed data from HCL Informix databases using the Informix Change Data Capture API.
- Embedded SQLJ for HCL Informix®
  The Informix® Embedded SQLJ User's Guide contains information about using Informix Embedded SQLJ.
- ESQL/C Guide
  The Informix® ESQL/C Programmer's Manual explains how to use Informix ESQL/C, the Informix implementation of Embedded Structured Query Language (SQL) for C (ESQL/C), to create client applications with database-management capabilities.
  - What is Informix® ESQL/C?
  - Database server communication
    - Exception handling
      - Obtain diagnostic information after an SQL statement
      - Exception handling with SQLSTATE
      - Exception handling with the sqlca structure
        An alternative way to obtain diagnostic information is through the SQL Communications Area. When an SQL statement executes, the database server automatically returns information about the success or failure of the statement in a C structure that is called sqlca.
        Fields of the sqlca structure
        The SQLCODE variable
        The SQLCODE variable is an int4 that indicates whether the SQL statement succeeded or failed.
        Check for exceptions with sqlca
        Success in sqlca
        NOT FOUND in SQLCODE
        Warnings in sqlca.sqlwarn
        Runtime errors in SQLCODE
        When an SQL statement results in a runtime error, the database server sets SQLCODE (and sqlca.sqlcode) to a negative value. The actual number identifies the particular error. The error message documentation lists the error codes specific to HCL Informix® and their corrective actions.
        Display error text (Windows™)
        Your Informix® ESQL/C application can use the HCL Informix ERRMESS.HLP file to display text that describes an error and its corrective action.
      - Choose an exception-handling strategy
      - Library functions for retrieving error messages
      - A program that uses exception handling
    - Working with the database server
      These topics explain how the Informix® ESQL/C program can interact with a database server.
    - Informix® libraries
      These topics describe how to link the static, shared, and thread-safe HCL Informix® general libraries with your Informix ESQL/C application.
  - Dynamic SQL
  - Appendixes
    This section contains additional reference information.
- GLS User's Guide
  The Informix® GLS User's Guide describes the Global Language Support (GLS) feature available in Informix products.
- API
  The Informix® GLS API Programmer's Guide describes the global language support (GLS) application programming interface (API) available in Informix ESQL/C and HCL Informix DataBlade® modules.
- Informix® Object Interface for C++ Guide
  The Informix® Object Interface for C++ Programmer's Guide describes how to develop HCL Informix client applications by using the object-oriented C++ programming language.
- Informix® ODBC Driver Guide
  The Informix® ODBC Driver Programmer's Manual serves as a user guide and reference for Informix ODBC Driver, which is the Informix implementation of the Microsoft™ Open Database Connectivity (ODBC) interface, Version 3.0.
- .NET provider options
  The Data Server Provider for .NET DB2® provider option is the preferred Informix® provider for developing new applications.
- Informix® JDBC Driver Guide
  The Informix® JDBC Driver Programmer's Guide describes how to install, load, and use Informix JDBC Driver to connect to the Informix database from within a Java™ application or applet.
- Informix International Language Supplement (ILS) User Guide
  These topics include information about the translated user interface files for Informix® UNIX™ products, locales, and code set conversion tables
- Informix® OLE DB Provider Guide
  The Informix® OLE DB Provider Programmer's Guide describes the software requirements for using Informix OLE DB Provider, show how to install and configure the provider for your use, and explain how to use Informix OLE DB Provider to enable client applications, such as ActiveX Data Object (ADO) applications and web pages, to access data on the Informix server.

Success in sqlca

When the database server executes an SQL statement successfully, it sets SQLCODE (sqlca.sqlcode) to 0. The database server might also set one or more of the following informational fields in sqlca after a successful SQL statement:

After a PREPARE for a SELECT, DELETE, INSERT, or UPDATE:
- sqlca.sqlerrd[0] indicates an estimated number of rows affected.
- sqlca.sqlerrd[3] contains the estimated weighted sum of disk accesses and total rows processed.
After an INSERT, sqlca.sqlerrd[1] contains the value that the database server has generated for a SERIAL column.
After a SELECT, INSERT, DELETE, or UPDATE:
- sqlca.sqlerrd[2] contains the number of rows that the database server processed.
- sqlca.sqlerrd[5] contains the rowid (physical address) of the last row that was processed. Whether this rowid value corresponds to a row that the database server returns to the user depends on how the database server processes a query, particularly for SELECT statements.
After a CONNECT, SET CONNECTION, DATABASE, CREATE DATABASE, or START DATABASE, the sqlca.sqlwarn.sqlwarn0 field is set to W and other fields of sqlca.sqlwarn provide information about the database and connection.