_acu.utl Utility - Application Configuration
Syntax
call "_acu.utl"{,project_code$}
Description
The _acu.utl utility initializes the PRO/5 environment used by other EUS Toolkit programs. It sets global string variables based on lines in a configuration text file, much like config.bbx.
|
Parameter |
Description |
|
project_code$ |
Identifies the configuration file for the current project. May be set to anything, but defaults to "TPM" if it is not specified. In the examples above, "EUS" is used for this value. |
Assuming project_code$ is "EUS", _acu.utl searches for the configuration file based on the following three rules:
-
It searches for a PRO/5 global string named (TPM) and opens the file named in that string. For example:
X$=STBL("TPM");OPEN(channel)X$
-
If a global string is not located, _acu.utl searches the operating system environment. This environment variable must be set before loading PRO/5. For example:
Operating System
Environment Variable
UNIX (Bourne or Korn shell)
$ TPM=/usr/pro5/ext/config.EUS; export TPM
UNIX (C shell)
% setenv TPM /usr/pro5/ext/config.EUS
In MS-DOS (COMMAND.COM or equivalent)
C:\> set TPM=c:\usr\pro5\ext\config.EUS
-
Finally, _acu.utl attempts to open a file called config.EUS in either the current directory or in the PREFIX list. If _acu.utl cannot locate the configuration file using any of the above rules, it exits with an error message.
Examples
The following illustrates how to find a configuration file by default:
call "_acu.utl"
The following illustrates how to find a configuration file in the current directory with an .EUS extension:
call "_acu.utl","EUS"
The following illustrates how to find a configuration file in the current directory with a variable extension, using this variable, _acu.utl searches for a file with a .TPM extension:
LET EUS$="TPM"
call "_acu.utl",EUS$