Open Client/Server runtime configuration file syntax

The Open Client/Server runtime configuration file is a text file. The file is separated into sections, each of which begins with a section name enclosed in square brackets ([]) and ends with the next section name or the end of the file, whichever appears first.

Each section contains one or more settings, as illustrated below:

[section name]
 keyword = value ; comment
 keyword = value
; more comments
[next section name]
... and so forth ...

In general, all supported keywords in the file match the names of the symbolic constants that would identify the property, option, or capability in a Client-Library/C program. However, not all properties can be set in the configuration file. If a keyword is not supported, the setting is ignored.

Legal values adhere to the following rules:

If a keyword occurs twice in a section, only the first definition is used.

A section can include the keywords in another section using this syntax:

[section name]
 include = previous section name
... more settings ...

All settings defined under an included section name are defined in a section that includes that section. An included setting is always replaced by an explicit setting in the including section. For example, the Finance section, below, defines CS_TIMEOUT as 30. The included setting from the DEFAULT section is replaced by an explicit setting:

[DEFAULT]
 CS_TIMEOUT = 45
 
 [Finance]
 include = DEFAULT
 CS_TIMEOUT = 30