Operation [ COBOL/HP-UX Operating Guide for the Series 700 and 800 ] MPE/iX 5.0 Documentation
COBOL/HP-UX Operating Guide for the Series 700 and 800
Operation
When your RTS or statically linked executable starts up, as part of its
initialization of the COBOL run-time environment it will attempt to read
your run-time configuration sidefile. It is shared by all users of the
Micro Focus COBOL system.
Run-Time Configuration File
The run-time configuration file is a text file, which you can edit with
your standard text editor. It is an optional file (no error will be
issued if it does not exist) called $COBDIR/cobconfig. Each run-time
configurable appears on a new line. Blank lines are ignored. A comment
line is one starting with a # (although because this file is processed at
run time, we advise that you limit your comments, in order to keep to a
minimum the time it takes to process it). The maximum number of
characters permitted in a comment line is 80, including any new-line or
carriage return characters that may be placed at the end of the line by
some editors.
You can perform two types of configuration in the configuration file:
* setting environment variables, such as dd_file-name mappings, or
other environment variables significant to Micro Focus COBOL
* setting run-time tuneables. These control the behavior of certain
aspects of the COBOL run-time.
Setting Environment Variables
The keyword "setenv" must begin the line, followed by:
1. one or more tabs and/or spaces, followed by:
2. the name of the environment variable, followed by:
3. one or more tabs and/or spaces, followed by:
4. the value to assign to the environment variable (the value must be
a single word, or multiple words within quotation marks).
Environment variables set in this way override values already set
in the environment.
For example:
setenv dd_MYFILE /usr/lib/mydir/myfile
setenv SOMESHORTNAMES "JOE FRED JACK MARY"
Setting Run-Time Tuneables
The keyword "set" must begin the line, followed by:
1. one or more tabs and/or spaces, followed by:
2. the name of the run-time tuneable, followed by:
3. "=", followed by:
4. the value to which to set the run-time tuneable. This is
validated according to the type and values allowed for that
run-time tuneable and the value of cobconfig_error_report. The
following section details the names of the run-time tuneables and
the values to which you can set them.
MPE/iX 5.0 Documentation