Preparing the ONCONFIG Configuration File

The onconfig.std template file in the etc subdirectory of INFORMIXDIR contains initial values for many of the configuration parameters. Copy this template and tailor it to your specific configuration.

The template files contain initial values for many of the configuration parameters. You can use a text editor or ISA to change the configuration parameters in your ONCONFIG file.

Do not modify or delete the template files. The database server provides these files as templates and not as functional configuration files.

If you omit parameters in your copy of the ONCONFIG file, the database server uses values in the onconfig.std file for the missing parameters when the server starts.

Creating an ONCONFIG File on UNIX

A new instance of the database server is created and initialized when you install the IBM Informix software for the first time. The installation script automatically creates the onconfig.demo file for you.

To prepare the ONCONFIG file using a text editor

Copy and rename the $INFORMIXDIR/etc/onconfig.std file and store it in the etc subdirectory. (Skip this step if you are using ISA.)
Use a text editor or ISA to edit the ONCONFIG configuration file.
Set the ONCONFIG environment variable to the name of your new ONCONFIG file.
Initialize the database server if it is a new instance.
Otherwise, shut down and restart the database server.

Creating an ONCONFIG File on Windows

On Windows, a new instance of the database server is created and initialized when you install the IBM Informix software for the first time. You can also use the Instance Manager (instmgr.exe) to create a new database server instance. The Instance Manager automatically creates an ONCONFIG file.

To prepare the ONCONFIG file using the Instance Manager

Use the Instance Manager to create a new database server instance.
For details, see Using the Instance Manager to Create a New Database Server Instance (Windows).
Use a text editor or ISA to edit the ONCONFIG configuration file.
Set your ONCONFIG environment variable to the name of your new ONCONFIG file.
Shut down and restart the database server for the configuration changes to take effect.
1. From the Service control application window, select the Dynamic Server service and click the Stop button.
2. Click the Start button.

To use dbservername.cmd to change the ONCONFIG environment variable

Change the ONCONFIG environment variable for your session in the %INFORMIXDIR%\dbservername.cmd file.
Execute dbservername.cmd for the changes to take effect.