On UNIX systems, the runtime configuration file is typically named cblconfig and is located in /etc by default.
On Windows and DOS systems, the runtime configuration file is typically named cblconfi and is located in \etc by default.
If the file is renamed, or located in another directory, the full path and name of the file must be specified with the "-c" option when you start the ACUCOBOL-GT application. See the Acucobol Runtime Manual for a complete description of the runtime configuration file and all options to runcbl.
Several runtime configuration variables can affect the behavior of AcuServer. Seven (USE-LOCAL-SERVER, DEFAULT-TIMEOUT, TEXT, FILE-PREFIX, CODE-PREFIX, APPLY-CODE-PATH, and APPLY-FILE-PATH) appear only in the runtime configuration file. USE-LOCAL-SERVER, DEFAULT-TIMEOUT, and TEXT are discussed in this section. FILE-PREFIX, CODE-PREFIX, APPLY-CODE-PATH, and APPLY-FILE-PATH are discussed in Chapter 9, Section 9.1.2 Using FILE-PREFIX and CODE-PREFIX.
Several other runtime configuration variables, including ACUSERVER-PORT, can be used in both the runtime and server configuration files, and some specialized variables appear only in the server configuration file. These are discussed in the Server configuration variables section that follows.
Set USE-LOCAL-SERVER when you want to run AcuServer client applications on the same machine as the AcuServer file server. USE-LOCAL-SERVER allows you to specify whether to use or bypass AcuServer when accessing local files that have remote name notation.
Set USE-LOCAL-SERVER to "0" (the default setting) to prevent the use of AcuServer to access local files that have remote name notation (the remote name is stripped off and the file I/O operation is handled by the runtime). Set USE-LOCAL-SERVER to "1" to use AcuServer to access local files that have remote name notation.
The variable DEFAULT-TIMEOUT defines the length of time, in seconds, that the runtime will wait for a response from acuserve before timing out. The default value is 25 seconds. Some networks have long connect times and, depending on network loading, the default value may not be long enough to allow the application to connect.
The TEXT configuration variable is used to control the text of selected runtime messages. Three runtime messages have been added to support AcuServer password handling. These messages are numbered 15, 16, and 17. The default text for each message is:
15 "A password is required to connect to host %s."
16 "Please enter a password: "
17 "Invalid password."
Note that in message 15, the name of the AcuServer host will be substituted for the "%s" characters.
To change the text associated with a given message, place the word "TEXT" at the beginning of a line in the runtime configuration file, followed by a space, the message number, an "=" character, and the text to be used when that message number is displayed. For example:
TEXT 16=Enter your password now:
(Note that the use of AcuServer password protection is optional. If password protection is not used, these messages will not be displayed.)