HP 3000 Manuals

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