Many aspects of the runtime system can be controlled through configuration variables. Configuration variables can be modified by each runcbl site as well as directly by an ACUCOBOL-GT program. This allows a great deal of flexibility in adapting runcbl to a particular system.
Configuration variables are maintained in a configuration file. This is a standard text file that can be modified by the host system's text editor. runcbl uses the following rules to decide what the configuration file is called:
a) If the "-c" runtime option is used, then the configuration file is the one named by that option; otherwise,
b) If the operating system environment variable "A_CONFIG" is defined, then its value is the name of the configuration file; otherwise,
c) The configuration file is named according to the host operating system. This depends on the operating system used by the machine, as outlined in the following table.
| System
| Configuration File
|
| MS/DOS
| \etc\cblconfi
|
| Windows
| \etc\cblconfi
|
| OS/2
| \etc\cblconfi
|
| UNIX
| /etc/cblconfig
|
| MPE/iX
| /etc/cblconfig
|
| VMS
| SYS$LIBRARY:A_CONFIG.DAT |
Each entry in the configuration file consists of a single line. All entries start with a keyword, followed by one or more spaces, tabs, or an equals sign, and then a value. The value consists of the rest of the line less any trailing spaces. The limit for each configuration value entry is 4095 characters.
For the following configuration variables, a colon may be used instead of an equals sign in the value portion of the entry:
| COLOR-TABLE
| COLOR-MAP
|
| FILE-CONDITION
| KEYBOARD
|
| KEYSTROKE
| SCREEN
|
| MENU-ITEM
| MOUSE
|
| HOT-KEY
|
In all configuration file entries: 0, OFF, NO, FALSE are interchangeable; 1, ON, YES, TRUE are interchangeable. You can insert comments by placing a "#" in column one. The following sections contain examples of configuration file entries.
In the keyword, all lower-case characters are treated as upper-case and all hyphens are treated as underscores. Keywords longer than 60 characters are truncated to 60 characters.
All of the configuration variables may also be given initial assignments in the host computer's environment. When a particular variable appears in both the host's environment and the configuration file, then the value in the host's environment is used. Note that when placed in the host's environment, a configuration variable must be upper-case and must use underscores instead of hyphens.
The following sections describe some of the most frequently used configuration variables. A complete list of configuration variables along with a description of their use can be found in Appendix H in Book 4, "Appendices."
More:
2.7.2 Code and Data File Search Paths