Run-time Configuration Tunables - Overview

When you run the application, the IDE creates a .gcf file which includes the run-time IDE settings.

When your run-time system or linked executable starts up, it attempts to read the run-time configuration file. The run-time configuration file specifies values for the run-time tunables and environment variables. Environment variables set in this way override values already set in the environment.

If you use the Interface Mapping Toolkit to generate COBOL services for execution in Enterprise Server, you can specify settings for some tunables for the application container, a version of the run-time system used in Enterprise Server. If a setting specified by the Interface Mapping Toolkit conflicts with a setting in the configuration file, the setting specified in the Interface Mapping Toolkit always takes precedence.

The run-time configuration file is shared by all users of the run-time system.

For native COBOL, you create or edit a text-based run-time configuration file with a text editor, and then specify the location and name of the run-time configuration file using the COBCONFIG environment variable, or if you are developing a COBOL JVM project and need to specify Java property files, the COBCONFIGJVM environment variable. The format of the text file is described in the sections Format of a Configuration File for Native COBOL and List of Run-time Tunables.

Examples

For example, if you want to use a configuration file called myconf , you set COBCONFIG as follows.

COBCONFIG=$HOME/myconf
export COBCONFIG

If you want to use a Java property file called myconf.properties for a JVM project, you set COBCONFIGJVM as follows.

COBCONFIGJVM=$HOME/myconf.properties
export COBCONFIGJVM

The use of a configuration file is optional - no error is issued if it does not exist.