Welcome
Administering
In addition to administering the database server, you can tune performance, replicate data, and archive data.
System administration
These topics contain concepts, procedures, and reference information for database and database server administrators to use for managing and tuning HCL Informix® database servers.
High-Performance Loader User's Guide
The describes how to use the HCL Informix® to load and unload large quantities of data efficiently to or from Informix databases.
The onpladm utility
This section describes how to use the onpladm utility.
Define onpladm utility jobs
You can create, modify, describe, list, run, and delete jobs with the onpladm utility.
Create onpladm jobs
Create conversion jobs
Create conversion jobs by using detailed specification files
You can also specify job details in specification files that you reference from the command line. When you create a job by using a specification file, you must create all associated objects; the onpladm utility does not create these objects for you.
Create a conversion-load job

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.
- System administration
  These topics contain concepts, procedures, and reference information for database and database server administrators to use for managing and tuning HCL Informix® database servers.
  - List of utilities
    HCL Informix® includes utilities and applications that you can use to perform administrative tasks and capture information about configuration and performance.
  - Administrator's Guide
    The HCL® Informix® Administrator's Guide provides the information required to administer HCL Informix.
  - Administrator's Reference
    The HCL® Informix® Administrator's Reference includes comprehensive descriptions of HCL Informix configuration parameters, the system-monitoring interface (SMI) tables in the sysmaster database, the syntax of database server utilities such as onmode and onstat, logical-log records, disk structures, event alarms, and unnumbered error messages.
  - DB-Access User's Guide
    The HCL® Informix® DB-Access User's Guide describes how to use the utility to access, modify, and retrieve information from HCL Informix database servers.
  - High-Performance Loader User's Guide
    The describes how to use the HCL Informix® to load and unload large quantities of data efficiently to or from Informix databases.
    - High-Performance Loader overview
    - Examples of loading and unloading jobs using the ipload utility
      This section shows how the components of the fit together. The section includes a step-by-step tutorial with two examples (for a load and an unload job) that use the ipload graphical user interface (GUI).
    - The ipload utility windows
      This section contains information about using the ipload utility.
    - Define HPL projects
      This section explains how to create a project and how projects are related. The individual components that you store in projects are described in later sections.
    - Configure the High-Performance Loader
      This section describes the process of configure the .
    - Define device arrays
      This section describes how to define and use device arrays with the .
    - Define formats
      This section describes the formats that the provides and shows how to prepare and edit the format component.
    - Define queries
      This section describe how to define queries including how to create, edit, and export and import queries.
    - Define maps
      This section describes how to define maps with the . It also describes the options that are available for defining maps.
    - Define filters
      This section describes how to create, edit, and delete filters.
    - Unload data from a database
      This section describes the Unload Job window.
    - Load data to a database table
      This section describes the load process.
    - The Generate options of the ipload utility
      This section describes the Generate options for the ipload utility.
    - The HPL browsing options
      This section describes the browsing options that are available for the .
    - Manage the High-Performance Loader
    - The onpload utility
      This section describes how to use the onpload utility.
    - The onpladm utility
      This section describes how to use the onpladm utility.
      - Overview of the onpladm utility
        The onpladm command-line interface is equivalent to the ipload utility. You can use the onpladm utility from the command line to create, modify, and delete objects. The HPL objects include projects, jobs, maps, formats, queries, filters, device arrays, and machines.
      - Define onpladm utility jobs
        You can create, modify, describe, list, run, and delete jobs with the onpladm utility.
        Create onpladm jobs
        Create conversion jobs
        Create conversion jobs by using a quick command
        When you create a conversion job by using a quick command, the onpladm utility creates all objects associated with the job. The HPL objects that it creates have the same name as the job.
        Create conversion jobs by using detailed specification files
        You can also specify job details in specification files that you reference from the command line. When you create a job by using a specification file, you must create all associated objects; the onpladm utility does not create these objects for you.
        Create a conversion-load job
        Create a conversion unload job
        Create no-conversion jobs
        A no-conversion job is faster than a conversion job because onpload uses the internal format of the target database and does not create maps or formats. No-conversion jobs are always run in express mode.
        Modify a job by using a detailed specification file
        Describe a job
        List all jobs in a project
        Run a job
        Delete a job
      - Define device arrays
        You can create, modify, describe, list, and delete device arrays with the onpladm utility.
      - Define maps
        You can create, modify, describe, list, and delete maps with the onpladm utility.
      - Define formats
        You can create, modify, describe, list, and delete formats with the onpladm utility.
      - Define queries
        You can create, modify, describe, list, and delete queries with the onpladm utility.
      - Define filters
        You can create, modify, describe, list, and delete filters with the onpladm utility.
      - Define projects
        You can create a project, run all jobs in a project, list all projects, and delete a project with the onpladm utility.
      - Define machine types
        You can create, modify, describe, list, and delete machine types with the onpladm utility.
      - Define database operations
    - Appendixes
      This section contains additional reference information.
  - Performance Guide
    The HCL® Informix® Performance Guide describes how to configure and operate your HCL Informix database server to improve overall system throughput and to improve the performance of SQL queries.
  - SNMP Subagent Guide
    The describes the Simple Network Management Protocol (SNMP) and the software that you need to use SNMP to monitor and manage HCL Informix® database servers and databases.
- Backup and Restore Guide
  The HCL® Informix® Backup and Restore Guide describes how to use the HCL Informix and ontape utilities to back up and restore database server data. These utilities enable you to recover your databases after data is lost or becomes corrupted due to hardware or software failure or accident.
- Enterprise Replication
  The describes the concepts of data replication using HCL Informix® Enterprise Replication, including how to design your replication system, as well as administer and manage data replication throughout your enterprise.
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.
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.

Create a conversion-load job

Use the syntax shown in Specification-file conventions to create a conversion-load job from a specification file.

Use the following syntax to create a specification file for a conversion-load job:

BEGIN OBJECT LOADJOB jobname 
# Compulsory Attributes 
PROJECT projectname 
DEVICE device_array_name 
MAP mapname 

FILTER filtername 
SERVER targetservername 
DATABASE targetdatabasename 
FLTFILE filtered_records_filename 
REJECTFILE rejected_records_filename 
LOGFILE job_progress_logfilename 
RUNMODE runmode_type 
GENERATEVIORECS violation_records_option 
TAPES sourcetape_num 
NUMRECORDS records_num 
STARTRECORD start_record 
MAXERRORS max_error_num 

END OBJECT

The following table lists the attributes and their attribute values.


Attribute	Attribute value
device_array_name	Device-array name You must create the device array; onpladm does not create it for you.
filtername	Filter name
jobname	Job name
job_progress_logfilename	Path to the job-progress log file
mapname	Map name You must create the map before you use this option; onpladm does not create the map for you.
max_error_num	Maximum number of errors; if exceeded, load ends
projectname	Name of an existing project
records_num	Number of records to be processed in the data file
rejected_records_filename	Rejected-records file name (rejected by database server)
filtered_records_filename	Filtered-records file name (rejected by filter)
runmode_type	Type of run mode: E Express® mode D Deluxe mode without replication DR Deluxe mode with replication
sourcetape_num	Number of tapes that contain source data
start_record	Number of the first record to begin a load
targetdatabasename	Name of the database that the records will be loaded or unloaded to; if set, this value overrides the database value in the load or unload map
targetservername	Name of the target database server
violation_records_option	Specify: Y to generate violations records or N not to generate violations records