Welcome
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.
Informix® extensions and modules
These topics describe how to use built-in database extensions and separately installed modules.
Spatial Data User's Guide
The contains information to assist you in using the HCL® Informix® spatial extension. The HCL Informix spatial extension adds custom data types and supporting routines to the server.
Spatial Java™ API
The spatial Java™ API enables Java applications to access geometry features that are stored in databases that contain spatial data. The spatial Java API provides classes to work with spatial objects from Java client-side programs. The client-side objects are called value objects. Spatial value objects can also be created and examined by Java methods that parallel some of the spatial data functions.
Overview of a Spatial Java™ API Application
Most spatial Java™ API applications need to perform the steps described in this section.

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.
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.
- Informix® extensions and modules
  These topics describe how to use built-in database extensions and separately installed modules.
  - Database Extensions User's Guide
    The IBM® Informix® Database Extensions User's Guide explains how to use the database extensions that come with HCL Informix: Large Object Locator, MQ messaging, binary data types, basic text search, node data type, and SQL packages.
  - Performing XML Publishing
    The IBM® Informix® XML User's Guide includes information about using built-in functions for XML publishing with HCL Informix.
  - Spatial Data User's Guide
    The contains information to assist you in using the HCL® Informix® spatial extension. The HCL Informix spatial extension adds custom data types and supporting routines to the server.
    - Getting started with spatial data
      The HCL® Informix® spatial solution embeds a geographic information system (GIS) within the HCL Informix database server. The HCL Informix spatial data types integrate spatial and non-spatial data, providing a seamless point of access using SQL (Structured Query Language).
    - Spatial data types
      HCL® Informix® spatial data types are divided into two categories: the base geometry subclasses and the homogeneous collection subclasses.
    - Data exchange formats
      You can use several different GIS data exchange formats for spatial data.
    - R-tree indexes
      An index organizes access to data so that entries can be found quickly, without searching every row. The R-tree access method enables you to index multidimensional objects.
    - Run parallel queries
      Running queries in parallel distributes the work for one aspect of a query among several processors and can dramatically improve performance.
    - Estimate your spatial data
      The total amount of space you need for spatial data is equal to the size of spatial tables plus the size of the spatial indexes.
    - Spatial functions
      Use specific spatial data type functions to perform operations on spatial data.
    - Spatial Java™ API
      The spatial Java™ API enables Java applications to access geometry features that are stored in databases that contain spatial data. The spatial Java API provides classes to work with spatial objects from Java client-side programs. The client-side objects are called value objects. Spatial value objects can also be created and examined by Java methods that parallel some of the spatial data functions.
      - Compatibility with the ESRI ArcSDE Java™ API
        The spatial Java™ API is compatible with the ESRI ArcSDE Java API. It provides a partial implementation of the same set of OGC (Open GISConsortium) interfaces.
      - Overview of the Java™ API
        The Java™ API library is implemented in a package called com.ibm.spatial.
      - Overview of a Spatial Java™ API Application
        Most spatial Java™ API applications need to perform the steps described in this section.
        Using Logging
        Using the SpatialManager class, you can turn on logging, for example to a file /tmp/spatial.log. You can alternatively send formatted log records to an existing writer object.
        Assigning a Connection to CoordRefManager
        Applications must assign an open database connection to the CoordRef- Manager object. This enables the CoordRefManager object to query the spatial_references table and cache its contents locally. If you forget to do this, a SpatialException with the message Invalid argument: CoordRef=null is usually thrown whenever you try to instantiate a geometry object.
        Querying and Displaying Geometries
        The following code fragment demonstrates how to query geometries and display geometry data.
        Reading Coordinate Data
        Many applications need to read coordinate data from a geometry object. This example uses for loops to read the coordinates of an existing geometry object, to temporarily hold the coordinates in a buffer, and then to pass the coordinates to a drawing function.
      - Preparing to Run a Program
        Before you run a spatial Java™ API program, set your CLASSPATH environment variable and compile the program.
      - Example 1: Retrieving a Point From a Table
        The commented code fragment below shows how to retrieve a Point shape from a database table using a SELECT statement.
      - Examples 2, 3, and 4: How to Use the Java™ API
        These examples are located in the INFORMIXDIR/extend/spatialversion/examples/java directory in the directory where you installed the module. The examples are fully commented to demonstrate how to use the Java™ API.
    - Appendixes
  - TimeSeries Data User's Guide
    The IBM® Informix® TimeSeries Data User's Guide contains information to assist you in using the TimeSeries extension with HCL Informix.
  - Spatiotemporal Search for Moving Objects User's Guide
    The describes how to program applications to search data from moving objects in HCL Informix® databases using the spatiotemporal search extension.
- Creating extensions
  You can create user-defined data types, routines, access methods, and other database objects to suit your needs. You can use application programming interfaces to write user-defined routines and applications that access data in Informix® databases.
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.

Overview of a Spatial Java™ API Application

Most spatial Java™ API applications need to perform the steps described in this section.