Welcome
Client APIs and tools
You can use the HCL Informix® implementation of client APIs to develop applications for Informix database servers.
Informix® ODBC Driver Guide
The Informix® ODBC Driver Programmer's Manual serves as a user guide and reference for HCL Informix ODBC Driver, which is the Informix implementation of the Microsoft™ Open Database Connectivity (ODBC) interface, Version 3.0.
Error messages
These topics describe the HCL Informix® ODBC Driver error messages.
Map Informix® error messages to SQLSTATE values
The rest of this section describes diagnostic SQLSTATE values for HCL Informix® ODBC Driver functions.
SQLBrowseConnect (level two only)
SQLBrowseConnect supports an iterative method of discovering and enumerating the attributes and attribute values required to connect to a data source.

HCL Informix® V15.0.0 documentation
Welcome to the documentation for HCL Informix® 15.0.0 and related client tools and products.
Product overview
HCL Informix® is a fast and scalable database server that manages traditional relational, object-relational, and dimensional databases. Its small footprint and self-managing capabilities are suited to embedded data-management solutions.
Installing
These topics describe how to install HCL Informix® database servers, client products, and modules.
Administering
In addition to administering the database server, you can tune performance, replicate data, and archive data.
Migrating and upgrading
You can upgrade to the 15.0.0 release of HCL Informix® or migrate from other database servers to Informix. Upgrading is an in-place migration method that uses your existing hardware and operating system software. Some changes to the Informix database server can affect upgrading from a previous release.
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 HCL® Informix® Change Data Capture API Programmer's Guide describes how to program applications to process changed data from HCL Informix databases using the HCL Informix Change Data Capture API.
- Embedded SQLJ for HCL Informix®
  The HCL® Informix® Embedded SQLJ User's Guide contains information about using HCL Informix Embedded SQLJ.
- ESQL/C Guide
  The HCL® Informix® Enterprise Replication Guide explains how to use , the Informix implementation of Embedded Structured Query Language (SQL) for C (ESQL/C), to create client applications with database-management capabilities.
- GLS User's Guide
  The HCL® Informix® GLS User's Guide describes the Global Language Support (GLS) feature available in HCL Informix products.
- Informix GLS 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 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 HCL Informix ODBC Driver, which is the Informix implementation of the Microsoft™ Open Database Connectivity (ODBC) interface, Version 3.0.
  - Overview of HCL Informix® ODBC Driver
    These topics introduce the HCL Informix® ODBC Driver and describe its advantages and architecture. The topics also describe conformance, isolation and lock levels, libraries, and environment variables.
  - Configure data sources
    These topics explain how to configure a data source (DSN) on UNIX™ and Windows™ for HCL Informix® ODBC Driver.
  - Data types
    These topics contain information about the data types that are supported by HCL Informix® ODBC Driver.
  - Smart large objects
    These topics describe how to store, create, and access a smart large object; how to transfer smart-large-object data; how to retrieve the status of a smart large object; and how to read or write a smart large object to or from a file.
  - Rows and collections
    Rows and collections are composite values that consist of one or more elements.
  - Client functions
    These topics describe the HCL Informix® ODBC Driver client functions. Use these functions to access and manipulate smart large objects and rows and collections.
  - Application tracking in ODBC
    Set the CLIENT_LABEL environment variable in CSDK 4.50.xC4 onwards to assign a character string to ODBC client session and identify that character string on the database server. You can use this variable to distinguish one database session from the other.
  - Improve application performance
    These topics suggest ways to improve performance of HCL Informix® ODBC Driver applications.
  - Error messages
    These topics describe the HCL Informix® ODBC Driver error messages.
    - Diagnostic SQLSTATE values
      Each HCL Informix® ODBC Driver function can return an SQLSTATE value that corresponds to the Informix error code.
    - Map SQLSTATE values to Informix® error messages
      View the SQLSTATE values that HCL Informix® ODBC Driver can return.
    - Map Informix® error messages to SQLSTATE values
      The rest of this section describes diagnostic SQLSTATE values for HCL Informix® ODBC Driver functions.
      - Deprecated and new HCL Informix® ODBC Driver APIs
        In Version 4.10, numerous ODBC APIs have been deprecated and their functionality transferred to new APIs.
      - SQLAllocConnect (core level only)
        This table describes the SQLSTATE and error values for SQLAllocConnect.
      - SQLAllocEnv (core level only)
        SQLAllocEnv allocates memory for an environment handle and initializes the driver call level interface for application use.
      - SQLAllocStmt (core level only)
        SQLAllocStmt allocates memory for a statement handle and associates the statement handle with the connection that hdbc specifies.
      - SQLBindCol (core level only)
        SQLBindCol assigns the storage and HCL Informix® ODBC Driver C data type for a column in a result set.
      - SQLBindParameter (level one only)
        SQLBindParameter binds a buffer to a parameter marker in an SQL statement.
      - SQLBrowseConnect (level two only)
        SQLBrowseConnect supports an iterative method of discovering and enumerating the attributes and attribute values required to connect to a data source.
      - SQLCancel (core level only)
        SQLCancel cancels the processing on an hstmt or a query.
      - SQLColAttributes (core level only)
        SQLColAttributes returns descriptor information for a column in a result set.
      - SQLColumnPrivileges (level two only)
        SQLColumnPrivileges returns a list of columns and associated privileges for the specified table. The driver returns the information as a result set on the specified hstmt.
      - SQLColumns (level one only)
        SQLColumns returns the list of column names in specified tables. The driver returns this information as a result set on the specified hstmt.
      - SQLConnect (core level only)
        SQLConnect loads a driver and establishes a connection to a data source.
      - SQLDataSources (level two only)
        SQLDataSources lists data-source names.
      - SQLDescribeCol (core level only)
        SQLDescribeCol returns the result descriptor (column name, type, precision, scale, and whether it can have a NULL value) for one column in the result set.
      - SQLDisconnect
        SQLDisconnect closes the connection associated with a specific connection handle.
      - SQLDriverConnect (level one only)
        SQLDriverConnect is an alternative to SQLConnect.
      - SQLDrivers (level two only)
        SQLDrivers lists driver descriptions and driver-attribute keywords.
      - SQLError (core level only)
        SQLError returns error or status information.
      - SQLExecDirect (core level only)
        SQLExecDirect executes a preparable statement by using the current values of the parameter-marker variables if any parameters exist in the statement.
      - SQLExecute (core level only)
        SQLExecute executes a prepared statement by using the current values of the parameter-marker variables if any parameter markers exist in the statement.
      - SQLExtendedFetch (level two only)
        SQLExtendedFetch extends the functionality of SQLFetch.
      - SQLFetch (core level only)
        SQLFetch fetches a row of data from a result set.
      - SQLForeignKeys (level two only)
        SQLForeignKeys can return a list of foreign keys.
      - SQLFreeConnect (core level only)
        SQLFreeConnect releases a connection handle and frees all memory associated with the handle.
      - SQLFreeEnv (core level only)
        SQLFreeEnv frees the environment handle and releases all memory associated with the environment handle.
      - SQLFreeStmt (core level only)
        SQLFreeStmt stops the processing that is associated with a specific hstmt, closes any open cursors that are associated with the hstmt, discards pending results, and, optionally, frees all resources associated with the statement handle.
      - SQLGetConnectOption (level one only)
        SQLGetConnectOption returns the current setting of a connection option.
      - SQLGetCursorName (core level only)
        SQLGetCursorName returns the cursor name associated with a specified hstmt.
      - SQLGetData (level one only)
        SQLGetData returns result data for a single unbound column in the current row.
      - SQLGetFunctions (level one only)
        SQLGetFunctions returns information about whether the driver supports a specific function.
      - SQLGetInfo (level one only)
        SQLGetInfo returns general information about the driver and data source associated with an hdbc.
      - SQLGetStmtOption (level one only)
        SQLGetStmtOption returns the current setting of a statement option.
      - SQLGetTypeInfo (level one only)
        SQLGetTypeInfo returns information about data types that the data source supports.
      - SQLMoreResults (level two only)
        SQLMoreResults determines whether more results are available on an hstmt that contains SELECT, UPDATE, INSERT, or DELETE statements and, if so, initializes processing for those results.
      - SQLNativeSql (level two only)
        SQLNativeSql returns the SQL string that the driver translates.
      - SQLNumParams (level two only)
        SQLNumParams returns the number of parameters in an SQL statement.
      - SQLNumResultCols (core level only)
        SQLNumResultCols returns the number of columns in a result set.
      - SQLParamData (level one only)
        SQLParamData is used with SQLPutData to supply parameter data when a statement executes.
    - SQLParamOptions (core and level two only)
      SQLParamOptions allows an application to specify multiple values for the set of parameters assigned by SQLBindParameter.
  - Unicode
    These topics provide a brief overview of the Unicode standard and shows how it is used within ODBC applications.
  - ODBC Smart trigger
- Informix .NET Core Provider
  Starting with CSDK 4.50.xC4, Informix .NET Core Provider built with .NET Core SDK/Runtime v3.1 is shipped for Windows x64 and Linux x86_64 platforms.
- Informix® .NET EF Core Provider Guide
- HCL Informix 4GL
  This topic provides a link to the Informix 4GL documentation.
- Informix® JDBC Driver Guide
  The HCL® Informix® JDBC Driver Programmer's Guide describes how to install, load, and use HCL 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 HCL Informix OLE DB Provider Programmer's Guide describes the software requirements for using HCL 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.
Embedding Informix®
When you embed HCL Informix®, you can use enterprise-class high-availability and high performance with embeddability features such as easy programmability, a small disk and memory footprint, and silent deployment.
Extending Informix®
Beyond standard relational database objects, HCL Informix® can be extended to handle specialized data types, access methods, routines, and other objects. Informix includes many built-in extensions that are fully integrated in the database server. Informix also provides modules, which are packages of extended database objects for a particular purpose and that are installed separately from the database server. Alternatively, you can create your own user-defined objects for Informix.
Data warehousing
In addition to designing and implementing Informix® dimensional databases, you can use tools to create data warehouse applications and optimize your data warehouse queries.
Designing databases
The first step in creating a relational database is to construct a data model, which is a precise, complete definition of the data you want to store. After you prepare your data model, you must implement it as a database and tables. To implement your data model, you first select a data type for each column and then you create a database and tables and populate the tables with data. You can also implement fragmentation strategies and control access to your data.
JSON compatibility
You can use the popular JSON-oriented query language created by MongoDB to interact with data stored in HCL Informix®.
Security
You can secure your Informix® database server and the data that is stored in your Informix databases. You can encrypt data, secure connections, control user privileges and access, and audit data security.
SQL programming
You can use the HCL Informix® implementation of the SQL language to develop applications for Informix database servers.
Troubleshooting HCL Informix®
Several troubleshooting techniques, tools, and resources are available for resolving problems that you encounter in your HCL Informix® database server environment.

SQLBrowseConnect (level two only)

SQLBrowseConnect supports an iterative method of discovering and enumerating the attributes and attribute values required to connect to a data source.

Each call to SQLBrowseConnect returns successive levels of attributes and attribute values. When all levels are enumerated, a connection to the data source is completed, and a SQLBrowseConnect string is returned with a return code of now connected to the data source.


SQLSTATE	Error value	Error message
01000	-11001	`General warning`
01004	-11003	`Data truncated`
01S00	-11005	`Invalid connection string attribute`
08001	-11015	`Unable to connect to data source`
08002	-11016	`Connection in use`
08S01	-11020	`Communication-link failure`
28000	-11033	`Invalid authorization specification`
IM002	-11041	`Data source not found and no default driver specified`
IM003	-11042	`Specified driver could not be loaded`
IM004	-11043	`Driver's SQLAllocEnv failed`
IM005	-11044	`Driver's SQLAllocConnect failed`
IM006	-11045	`Driver's SQLSetConnectOption failed`
IM009	-11048	`Unable to load translation shared library (DLL)`
IM010	-11049	`Data-source name too long`
IM011	-11050	`Driver name too long`
IM012	-11051	`DRIVER keyword syntax error`
S1000	-11060	`General error`
S1001	-11061	`Memory-allocation failure`
S1090	-11071	`Invalid string or buffer length`
S1T00	-11094	`Time-out expired`
08S01	-11301	`A protocol error has been detected. Current connection is closed.`
S1000	-11303	`Input connection string too large`
S1000	-11317	`Invalid connectdatabase value specified`
S1000	-11318	`Invalid vmbcharlenexact value specified`
S1000	-11320	`Syntax error`
S1000	-11323	`The statement contained an escape clause not supported by this database driver`