What algorithm does isCOBOL use to load framework properties (runtime config variables)?
Estimated Reading Time: 1 Minutes
In isCOBOL, the runtime configuration file is a Java properties file and is referred to in the documentation as the isCOBOL framework properties file.
The Java virtual machine allows you to specify properties with the -D command line option. The isCOBOL runtime properties file can be specified with the value of the iscobol.conf property.
For example:
or simply:
With the wrapper:
or
isCOBOL uses the following algorithm for loading properties from the environment and/or the isCOBOL properties file. Properties read in each step override those read in previous steps:
The Java virtual machine allows you to specify properties with the -D command line option. The isCOBOL runtime properties file can be specified with the value of the iscobol.conf property.
For example:
java -Discobol.conf=myapp.cfg com.iscobol.invoke.Isrun MYAPP
or simply:
java -Discobol.conf=myapp.cfg MYAPP
With the wrapper:
iscrun -c myapp.cfg MYAPP
or
iscrun -J-Discobol.conf=myapp.cfg MYAPP
isCOBOL uses the following algorithm for loading properties from the environment and/or the isCOBOL properties file. Properties read in each step override those read in previous steps:
- Read system environment variables such as those set with SET VAR=VAL. In this case the prefix "iscobol." is stripped from the name before it is looked up for the environment.
- Read properties from /etc/iscobol.properties if it exists
- Read properties from %HOMEPATH%/iscobol.properties if it exists
- Read the first iscobol.properties found in CLASSPATH
- Read the file specified in the command line as the value of the iscobol.conf property if it exists. iscobol.conf cannot be set in the environment (i.e. isCOBOL does not read the CONF environment variable).
- Read iscobol.properties file found in $ISCOBOL directory, if it exists.
- Read properties specified directly with -Discobol.* on the java command line