Welcome
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.
Informix® Warehouse Accelerator
SQL administration routines
You can use the Informix® Warehouse Accelerator functions and procedures from the command line or in an application to automate administration tasks.
genMartDef() function
The genMartDef() function returns a character large object (CLOB) that contains the data mart definition in XML format.

HCL Informix® V15.0 documentation
Welcome to the documentation for HCL Informix® 15.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 DataBlade® 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 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 DataBlade® 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.
- Dimensional databases
  These topics provide information to help you design, implement, and manage dimensional databases, and describes the tools that you can use to create data warehouses and optimize your data warehouse queries.
- Informix® Warehouse Accelerator
  - Overview of Informix® Warehouse Accelerator
    Informix® Warehouse Accelerator is a product that you use to improve the performance of your warehouse queries.
  - Installation
    You can install Informix® Warehouse Accelerator on the same computer as the Informix database server, on a separate computer, or on a cluster (including a high-availability cluster).
  - Configuration
    You must configure the accelerator server to work with the Informix® database server.
  - Create an accelerator
    You create an accelerator by connecting the Informix® database server to the accelerator server.
  - Data marts and AQTs
    For efficient query processing, the accelerator server must have its own copy of the data. The data is stored in logical collections of related data, or data marts. A data mart specifies the collection of tables that are loaded into an accelerator and the relationships, or references, between these tables.
  - Data marts and AQTs
    For efficient query processing, the accelerator server must have its own copy of the data. The data is stored in logical collections of related data, or data marts. A data mart specifies the collection of tables that are loaded into an accelerator and the relationships, or references, between these tables.
  - Turning on query acceleration
    Before queries can be routed to the accelerator server for processing, you must set the use_dwa session environment variable.
  - SQL administration routines
    You can use the Informix® Warehouse Accelerator functions and procedures from the command line or in an application to automate administration tasks.
    - SQL administration routines sorted by task
      SQL administration routines are sorted into logical areas based on the type of task.
    - ifx_createMart() function
      The ifx_createMart() function creates a data mart in an accelerator.
    - ifx_def2Mart() procedure
      The ifx_def2Mart() procedure uses the ifx_getMartdef()getMartdef() function to retrieve the data mart definition from an accelerator. It then uses the ifx_xml2Mart()xml2Mart() procedure to store the data mart definition XML file in the data mart schema tables.
    - ifx_dropMart() function
      The ifx_dropMart() function drops (removes) the data mart from an accelerator.
    - dropPartMart() function
    - ifx_dropPartMart() function
      The ifx_dropPartMart() function removes the data in one partition in a fragmented table or all of the data from a non-fragmented table.
    - genMartDef() function
      The genMartDef() function returns a character large object (CLOB) that contains the data mart definition in XML format.
    - ifx_genMartDef() function
      The ifx_genMartDef() function returns a character large object (CLOB) that contains the data mart definition in XML format.
    - ifx_getdwaMetrics() function
      The ifx_getdwaMetrics() function returns metrics about an accelerator.
    - ifx_getMartdef() function
      The ifx_getMartdef() function retrieves the data mart definition from an accelerator and returns it as a character large object (CLOB) in XML format.
    - ifx_getMartStat() function
      The ifx_getMartStat() function returns the status of a single data mart as an unnamed row.
    - ifx_listMarts() function
      The ifx_listMarts() function returns a set of unnamed rows that contain the status for all the data marts in an accelerator.
    - ifx_loadMart() function
      The ifx_loadMart() function populates an empty data mart in an accelerator with data. The data is copied from the database tables that are referenced in the data mart definition.
    - loadPartMart() function
    - ifx_loadPartMart() function
      The ifx_loadPartMart() function loads the data into one partition in a fragmented table or into a non-fragmented table.
    - probe2Mart() procedure
      The probe2Mart() procedure converts the data that is gathered from probing into a data mart definition.
    - ifx_probe2Mart() procedure
      The ifx_probe2Mart() procedure converts the data that is gathered from probing into a data mart definition.
    - ifx_refreshMart() function
      The ifx_refreshMart() function checks for data changes in individual partitions and refreshes the changed partitions.
    - ifx_removeDWA() function
      The ifx_removeDWA() function removes (drops) an accelerator from the accelerator server. This function removes the connectivity information from the sqlhosts file in the Informix® database server. The data marts that are associated with the accelerator are not removed, but they are not accessible. Drop the data marts before you drop the accelerator.
    - ifx_removeTrickleFeed() function
      The ifx_removeTrickleFeed() function stops trickle feed so that data in the data mart is no longer continuously refreshed.
    - ifx_setMart() function
      The ifx_setMart() function changes the state of a data mart from Active to Disabled or from Disabled to Active.
    - ifx_setupDWA() function
      The ifx_setupDWA() function creates an accelerator in an accelerator server. This function creates the connection between the database server and the accelerator server. You can also use this function to renew the connectivity information for an accelerator.
    - ifx_setupTrickleFeed() function
      The ifx_setupTrickleFeed() function enables the continuous refreshing of data in the fact and dimension tables of the data mart as the data changes in the database.
    - ifx_TSDW_createWindow() function
      The ifx_TSDW_createWindow function creates a time window to limit the amount of time series data in a time series virtual table of a data mart.
    - ifx_TSDW_dropWindow() function
      The ifx_TSDW_dropWindow function removes time windows from a time series virtual table in a data mart.
    - ifx_TSDW_moveWindows() function
      The ifx_TSDW_moveWindows function moves time windows in a time series virtual table within a data mart.
    - ifx_TSDW_updatePartition() function
      The ifx_TSDW_updatePartition function refreshes the time series data within a time series virtual table in a data mart.
    - ifx_TSDW_setCalendar() function
      The ifx_TSDW_setCalendar function assigns a time series calendar to a time series virtual table in a data mart.
    - ifx_xml2Mart() procedure
      The ifx_xml2Mart() procedure converts a data mart definition from XML format into data mart schema tables.
  - Reversion requirements for an Informix® warehouse server and Informix® Warehouse Accelerator
    If you revert the HCL Informix® server to an earlier version, you must drop all of the data marts. If you created data mart definitions by using workload analysis, you must drop all of the tables that were created by the probe2Mart() procedure.
  - Troubleshooting
  - Sample warehouse schema
    The Informix® Warehouse Accelerator examples use this sample warehouse schema.
  - Sysmaster interface (SMI) pseudo tables for query probing data
    The SMI tables provide a way to access probing data in a relational form, which is most convenient for further processing.
  - Supported locales
    Informix® Warehouse Accelerator supports a subset of the locales that HCL Informix supports.
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.

genMartDef() function

The genMartDef() function returns a character large object (CLOB) that contains the data mart definition in XML format.

Syntax

data_mart_name: The name of the data mart.

Usage

You can either issue the genMartDef() function by itself, or incorporate it as a parameter within the LOTOFILE() function. Using the genMartDef() function with the LOTOFILE() function places the CLOB into an operating system file.

Examples

Use the genMartDef() function as a parameter within the LOTOFILE() function:

EXECUTE FUNCTION LOTOFILE(genMartDef('salesmart'), 
   'salesmart.xml!','client'));

The following example generates the data mart definition for salesmart. The resulting CLOB is used as a parameter within the LOTOFILE() function. The LOTOFILE() function stores the resulting CLOB in an operating system file named salesmart.xml on the client computer.

SELECT lotofile(genMartDef('salesmart'),'salesmart.xml!','client') 
   FROM iwa_marts WHERE martname='salesmart';