UNIX Environment Variables

Lists environment variables related to configuring Enterprise Server for a UNIX environment.
Note: If you want to do any database access from within Enterprise Server you need to add the necessary libraries to the PATH environment variable and to the LD_LIBRARY_PATH or LIBPATH (AIX only) environment variables, depending on your UNIX system. For full information about setting the environment up for database access see the documentation supplied by your database vendor.

CCITCP2

Sets the TCP address of the machine running the MFDS (formerly CCITCP2) registration daemon.
Syntax
CCITCP2=host-name
Parameter
host-name
The TCP host name, IPv4 address, or IPv6 address of the machine running the MFDS daemon you want to contact from the session.
Default
Not set. The local system is used.
Comments
Use this environment variable to set the TCP address of the machine running the MFDS registration daemon, which holds the registration of the service you are contacting, or will hold the registration of the service you are starting.

CCITRACE

Specifies the type of information to record using CCI tracing.
Syntax
CCITRACE={/|-}{F|P|D}[...]
Parameters
/
Turns on the specified option.
-
Turns off the specified option.
F
Logs the details of CCI API calls to CTF. This option is implied when either P or D is specified. You can override this using -F.
P
When turned on, logs the details of protocol-level calls to CTF, which could greatly increase function tracing. When not set, only the details of the CCI user-level API are traced.
D
Logs the contents of all buffers passed to and from the CCI functions.
Warning: Setting this option might not produce the desired results if the application has been coded to prohibit data tracing.
Default
Not set. CCI tracing is controlled via the ctf.cfg and CCI.INI trace options.
Comments
The ctf.cfg and the CCI.INI file ([ccitrace_base] section) can also be used to control trace options, but any values specified by the CCITRACE environment variable take precedence. For details, see Tracing Options for CTF.CFG and CCI.INI - The CCI Configuration File.
Example
CCITRACE=/F/D

CASRDO44_NEWSUB

Enables access to JCL files held on the local machine on which the browser is running, and prevents submitting local JCL through ESCWA or ESMAC.
Syntax
CASRDO44_NEWSUB={ON|OFF}
Parameters
ON
Access JCL files on the local machine on which the browser is running.
OFF
Access JCL files from the machine running the enterprise server.
Default
CASRDO44_NEWSUB=ON
Comments
Micro Focus recommends that you use the Advanced Region Properties page in the Enterprise Server Common Web Administration (ESCWA) interface to configure this environment variable. See Advanced Region Properties for more information.

COB_LIVE_RECORD

Specifies the path and/or filename prefix for the live recording (.mfr) file created by the Live Recorder feature.
Syntax
COB_LIVE_RECORD=[path-name/]file-prefix
Parameters
path-name
The full path to the location of the .mfr file.
file-prefix
The name of the file prefix, consisting of all characters before the dot (.) and file extension.
Default
The default path is the output directory defined in your COBOL properties. No default file prefix is provided.
Comments
The live recording file must be replayed on the same operating system as it was created.

Animator can update the information file to record information held between sessions.

COB_LIVE_RECORD_SIZE

Specifies the amount of memory that can be used to store events written to the live recording file.
Syntax
COB_LIVE_RECORD_SIZE=mem-size
Parameter
mem-size
The amount of memory in megabytes (MB) to allocate for events written to the recording file. The range of valid values starts at 67, and extends to a value dependant on your available memory, bitism, etc.
Note: This is not the actual size of the live recording file that is stored on disk, as the event log is compressed when writing to the file.
Default
COB_LIVE_RECORD_SIZE=268
Comments
Setting COB_LIVE_RECORD_SIZE could improve performance during recording.

When the limit is reached, the buffer is cycled so that the oldest events are removed to make space for the most recent events.

An adequate range for 32-bit systems is between 500 and 1000.

You might need to experiment to determine the most optimal setting

Example
COB_LIVE_RECORD_SIZE=756

COBAIF

Specifies the directory path that Animator is to search for the session (.aif) file for the program being animated, if it is not found in the same directory as the information (.idy) file.
Syntax
COBAIF=path-name[:path-name[...]]
Parameter
path-name
The name of a path in which to search for .aif files.
Default
Not set. Enterprise Server searches for the .aif file in the directory or directories specified by the COBIDY environment variable, if set, and if COBIDY is not set or the .aif file is not found, searches the current directory. If still not found, Enterprise Server creates the .aif file in the first directory specified by the COBIDY environment variable, when set. If COBIDY is not set, then Enterprise Server creates the .aif file in the current directory.
Comments
When COBAIF is set, the search sequence is first - the directory or directories specified by COBAIF; second - the directory or directories specified by COBIDY; and third - the current directory. Enterprise Server uses the first .aif found. If not found, Enterprise Server creates an .aif file in the first directory specified by COBAIF.

Animator can update the session file to record information held between sessions.

The .aif file contains details of breakpoints and monitors.

COBAIFNAME

Specifies the base name of the Animator session file (.aif) for the program being animated.
Syntax
COBAIFNAME=base-name
Parameter
base-name
The base name of the .aif files.
Default
Not set.
Comments
You need to specify this environment variable if you are starting Animator using COBSW=+A and you want to save breakpoints for subsequent animation sessions. You can also specify it if you are starting Animator using the command anim; in this case the base name you specify overrides the application name as the basename of the .aif file.

The .aif file contains details of breakpoints and monitors.

COBANIMOPT

Specifies additional directives to be used by Character Animator.
Syntax
COBANIMOPT=directive-name[:directive-name[...]]
Parameter
directive-name
A directive to use with Character Animator. Must not be a file name.
Default
Not set. Character Animator runs with directives specified on the command line only.
Comments
When you invoke Character Animator, it first reads the directives you have specified in COBANIMOPT and then uses any directives you specify on the command line, with the possibility that command-line directives override directives specified by COBANIMOPT.
Example
COBANIMOPT=MIXEDLANGDEBUG:MULTITHREAD

COBANIMSRV

Attaches Character Animator to a running COBOL program.
Syntax
COBANIMSRV=prog-id
Parameter
prog-id
An identifier used to identify the program to which Character Animator attaches.
Default
Not set.
Comments
This environment variable is particularly useful for starting cross-session debugging.
Example
In one console session:
export COBANIMSRV=myid

myid is now a unique identifier that you can use to match Character Animator to a program. Type the command to start Character Animator:

cobanimsrv

The Character Animator waits for a COBOL program to start that has a matching identifier. In another console session:

export COBANIMSRV=myid
cobrun prog1.int

When prog1.int starts, the unique identifier myid matches that of Character Animator; therefore, Character Animator attaches to this process. In console session 1, the Character Animator main screen is displayed and the cursor placed on the first line of prog1.int.

COBATTR

Specifies non-standard behavior for HIGHLIGHT and LOWLIGHT clauses used with ACCEPT and DISPLAY statements, providing compatibility with earlier COBOL products.
CAUTION:
Avoid using COBATTR when possible as support is likely to be discontinued at some future date.
Syntax
COBATTR={0|1|2|3|4|5|6|7}
Parameters
0
Provides standard, default behavior.
1
When a COBOL program displays text subject to a HIGHLIGHT clause, the run-time system uses the bold mode. The run-time system uses the default mode for normal text. Specifying dim mode in the terminfo entry for the terminal has no affect. The LOWLIGHT clause has no effect.
2
High and low intensity space characters are not assumed to be the same as normal mode space characters.
3
Behavior is a combination of parameters 1 and 2.
4
Provides compatibility with default behavior of products before COBOL version 3.2.
5
Behavior is a combination of parameters 4 and 1.
6
Behavior is a combination of parameters 4 and 2.
7
Behavior is a combination of parameters 1, 2, and 4.
Default
COBATTR=0
Comments
When a COBOL program displays text subject to a HIGHLIGHT clause, the effect depends on whether the dim mode is specified in the terminfo entry for the terminal. If dim mode is specified, then the run-time system uses the default mode for highlighted text and the dim mode for normal text. If the dim mode is not specified, then the run-time system uses the bold mode for highlighted text and default mode for normal text. The LOWLIGHT clause has no effect, giving the same appearance as normal text.
Example
COBATTR=1

COBCONFIG

Specifies a run-time configuration file that tailors run-time configurable options in some way.
Syntax
COBCONFIG=path-name
Parameter
path-name
The directory that contains the COBOL configuration file, which tailors the run-time system.
Default
Not set. Enterprise Server searches for the file in $COBDIR/etc/cobconfig.
Example
COBCONFIG=/home/mydir/cobconfig

COBCPY

Specifies the directory or directories that the Compiler and Animator should search for copybook files.
Syntax
COBCPY=path-name[[:path-name][...]]
Parameter
path-name
The full path to a directory that the Compiler and Animator are to search when looking for copybook files. When more than one path-name is present, a null path-name represents the current working directory.
Default
COBCPY=%COBCPY%;C:\Program Files (x86)\Micro Focus\Enterprise Developer\cpylib;
   C:\Program Files (x86)\Micro Focus\Enterprise Developer\cpylib\basecl;
   C:\Program Files (x86)\Micro Focus\Enterprise Developer\cpylibguicl;
   C:\Program Files (x86)\Micro Focus\Enterprise Developer\cpylibolecl
Example

The following causes the Compiler to search for a copybook in /home/group/sharedcopy, then in the current directory, and finally in ./mydir/mycpy until either the copybook is found or it can be considered not found.

COBCPY=/home/group/sharedcopy:.:mydir/mycpy

COBDATA

Specifies the directory or directories that the run-time system is to search for data files.
Syntax
COBDATA=path-name[[:path-name][...]]
Parameter
path-name
The full path to a directory for the run-time system to search for application data files. When more than one path-name is present, a null path-name represents the current working directory.
Default
Not set. The run-time searches the current working directory.
Comments
This environment variable is set in the system registry. You can change the values using the SET command, but values you set are only added to the values already set in the registry.

COBDATA provides you with the facility to map data files globally, thus enabling you to put working data files in a directory whose name is not known until run time.

COBDATA affects the compiler and other utilities. During compilation, for example, program source is regarded as a data file by the compiler. If you intend to use any COBOL development system utilities, we recommend that the COBDATA value starts with a colon (:).

COBDATA is considered set if there is an environment variable of this name in your environment space, and its value is non-empty.

The full mapping order for files is:

  1. Any dd_ environment mappings
  2. Any ASSIGN TO EXTERNAL mappings
  3. Any COBDATA environment variable mappings

For multiple directory paths specified either in the COBDATA environment variable or a dd_ environment variable, the system searches the first directory specified followed by a slash (/) as a prefix to the user name.

If the filename is not found, or is not readable, the search continues with the next directory until the final directory has been searched. If no file is found, the first directory is used if a file is to be created.

Any dd_ and COBDATA mappings are ignored for any filename that starts with a hyphen () or a slash (/). In addition, it is illegal to have a hyphen in an environment variable name.

When using this facility, you should not use a filename that starts with "COB... "(these are reserved for the COBOL system).

You can use the COBDATA environment variable for files open in any mode (including OUTPUT) and for fixed or variable length files. If you are using indexed files, both the data and index files must be in the same directory.

The COBDATA environment variable affects file deletes, using the rules given here, as well as file opens.

If you intend to use COBOL development system programs, we recommend that you first unset COBDATA, as many of these programs open data files and are thus affected by the value of COBDATA. If you have to set COBDATA, you should include the paths :$COBDIR/dynload/helptbox.lbr and :$COBDIR/dynload/check.lbr at the beginning of the COBDATA value. If you want to see the Animator Help pages, also include COBDIR/dynload/advanim.lbr.

Example

The following causes COBDATA to be set to instruct the run-time system to search for data files in the current directory, then in the directory ./demo, then in the directory /home/data and finally in ./progs.

COBDATA=:demo:/home/data:progs

COBDIR

Specifies the directory where Enterprise Server is installed. Many system components and utilities require and use this information.
Syntax
COBDIR=path-name
Parameter
path-name
The directory that contains the required Micro Focus COBOL system software.
Default
Not set. The default path is /opt/microfocus/EnterpriseDeveloper .
Example

This example causes the compiler to search the directory /home/products/cobse20 for the Micro Focus COBOL system software.

COBDIR=/home/products/cobse20

COBIDY

Specifies the directory that Animator is to search for the information (.idy) file for the program being animated if it is not found in the same directory as the intermediate code (.int) file.
Syntax
COBIDY=path-name[:path-name[...]]
Parameter
path-name
A directory where .idy files can be found by the Animator.
Default
Not set. Animator searches the current working directory.
Comments
Animator can update the information file to record information held between sessions.

COBKEYTIMEOUT

Specifies the maximum elapsed time, in tenths of a second, for the connected terminal to transmit any valid escape sequence to the run-time system.
Syntax
COBKEYTIMEOUT=trans-time
Parameter
trans-time
A number in the range 1 through 126 that represents the maximum elapsed time required for a terminal to transmit any valid escape sequence to the run-time system over the line or network connection.
Default
Not set.
Comments
On encountering a lone Escape character, the run-time system waits n tenths of a second before assuming that the character does not introduce an escape sequence.

The run-time system calculates an appropriate default value for n from the baud rate of the terminal.

When a terminal key is depressed, the terminal might send in response a single character or a group of characters to the run-time system. Typically, such a group of characters starts with an escape character and the group of characters is known as an escape sequence. A terminal might send an escape sequence for one depression of a function key. It might also send the same sequence of characters for a depression of the Escape key followed by the depression of one or more alphabetic or numeric data keys. The only difference apparent to the run-time system is the interval between the arrival of each character; the user cannot type as fast as the escape sequence is generated by the terminal.

If a terminal is connected over a network that sends the characters to the run-time system in discrete packets, then the network can alter the intervals between each character arriving at the run-time system. COBKEYTIMEOUT is available to help compensate for typical network delays so the run-time system identifies escape sequences correctly.

COBLPFORM

Used to define and print to printer channels C01-C12.
Syntax
COBLPFORM line-number[[:line-number][...]]
Parameter
line-number
A single line number of a channel. Null entries are ignored. Those channels that have line number zero, function-names S01-S052, CSP, or are undefined, are set to line 1.
Default
Not set.
Comments
Any WRITE BEFORE/AFTER PAGE statements cause positioning to be at line 1. Each line advance increases the line number by one. A request to skip to a line number less than or equal to the current line causes a new page to begin. The appropriate number of line feeds are then generated.
Examples

In the following example, C01 equals 1, C02 equals 3, and so on:

COBLPFORM 1:3:5:7:9:11:13:15:17:19:21:23

In this next example, C01 equals 3, C02 equals 5, C03 equals 1, and C04 equals 9. C03 equals 1 because its value is a space and therefore undefined, and channels C05 - C12 are also undefined:

COBLPFORM :3::5: :9
Note: If a print statement specifies channel C05 - C12, the line is printed at line 1.

COBMAINSTACK

Specifies the size of the main stack.
Note: This variable applies to native COBOL applications on UNIX, and Enterprise Server on both Windows and UNIX.
Syntax
COBMAINSTACK=stack-size
Parameters
stack-size
The size of the main stack in bytes.
Default
Not set.
Comments
The main stack size defaults to three times the size of a threaded stack. The size of a threaded stack is either specified when the stack is created (using CBL_THREAD_CREATE), or it defaults to 160KB for a 32-bit application or 320KB for a 64-bit application.

You might need to set COBMAINSTACK in any of the following circumstances:

  • If you are deploying native OO COBOL Enterprise JavaBeans (EJBs) to WebSphere on the AIX platform.
  • If you are using the multi-threaded run-time system.
  • If you have IF STATEMENTS with a very large number of ELSE clauses.
  • If you have a large amount of local-storage data.

COBMODE

Describes whether to start the server in 32-bit or 64-bit mode.
Syntax
COBMODE={32|64};
Parameters
32|64
Specify the bitness you want to use when starting the server.
Default
None
Example
COBMODE=32;

COBOPT

Sets cob command options that either supplement or override those defined in $COBOPT/etc/cobopt, or specifies the path and file name of a file that contains such options.
Syntax
COBOPT="[set environment-variable=parameter]
[option[...]]
[[cobextn: .ext [.ext]][...]]"

or

COBOPT=[path-name/]file-name
Parameters
environment-variable
Any one environment variable supported by Enterprise Server.
parameter
A parameter used by the specified environment variable.
option
A cob command-line directive. See Compiler Directives for details.
ext
A filename extension that, in addition to the standard ones of .cob, .CBL, or .cbl, denotes a file that the compiler should treat as a COBOL source file. If more than one is specified on one line then they must be separated by a space or tab character.
Default
Not set. Uses options defined in $COBOPT/etc/cobopt.
Comments
The options can extend over more than one line and each line must have the same format as described for the file $COBDIR/etc/cobopt in cobopt File.

If a line does not begin with one of the identifiers set or cobextn: then it is taken as an options line.

Examples
These examples assume you are setting COBOPT at a command prompt.

This example enables ANSI 85 standard COBOL syntax and sets COBCPY to the specified list of paths.

COBOPT="CANS85
set COBCPY=$COBDIR/srclib/:$HOME/mylib:"
export COBOPT

This next example specifies that cob options are contained in the file options in the temp directory:

export COBOPT=temp/options

COBPATH

Specifies the directory or directories that the run-time system searches for dynamically loadable .int and .gnt files, or callable shared objects.
Syntax
COBPATH=path-name[:path[...]]
Parameter
path-name
The full or relative path to a directory for the run-time system to search for a dynamically loadable program (.int, .gnt or callable shared object) file.
Default
None. Dynamically set based on enterprise server region configuration.
Comments
This environment variable is set in the system registry. You can change the values using the SET command, but values you set are only added to the values already set in the registry.

When more than one path-name is specified, a null path name represents the current working directory.

Example
COBPATH=/home/mydir/srclib:otherlib

COBPRINTER

Specifies the name of a print spooler that is to receive, via its standard input stream (stdin), output from any DISPLAY UPON PRINTER statement.
Syntax
COBPRINTER="command-line"
Parameter
command-line
A command line supported by your system and that can be executed by the system shell. Typically, it is simply the name of a print spooler or other executable, but if the shell is escaped when setting the value then any command-line arguments can be used.
Default
Not set.
Comments
Each DISPLAY UPON PRINTER statement executed by your COBOL program causes a new invocation of command-line. Each invocation receives the data referenced in the DISPLAY statement, and is followed by a system end-of-file condition.
Example
COBPRINTER="myspooler -a $TMPDIR/spoolfile"

COBSES

Specifies the UNIX Session Recorder functions to perform.
Syntax
COBSES={option}[[:option][...]]
Parameters
option
One or more of the following, all of which are case sensitive:
-a Include keystrokes made to and screen output from the Animator
-f file-name Play back recording in file-name in fast forward mode
-p file-name Play back recording in file-name at normal speed
-r file-name1 Record keystrokes in file-name
-s file-name Record screen output in file-name
-t terminal-number Terminal number for multi-user screen recordings
1 Do not combine with either -f or -p.
file-name
The name of the recording file.
terminal-number
The terminal number for multi-user screen recordings.
Default
Not set.
Comments
You must unset COBSES when you have finished using the UNIX Session Recorder, or it interferes with the running of your COBOL programs. To do this, set COBSES to spaces, then export this setting to the shell.

COBTERMINFO

Specifies the directory or directories to be searched by the run-time system for a terminfo database of terminal information tailored to the needs of COBOL applications.
Syntax
COBTERMINFO=path-name[[:path-name][...]]
Parameter
path-name
A search directory that identifies a terminfo database containing terminal settings tailored for COBOL applications.
Default
COBTERMINFO=$COBDIR/terminfo
Comments
When set, COBTERMINFO enables COBOL applications to use different terminfo settings to those used by non-COBOL applications, such as vi, when using the same terminal.

The COBOL system takes the value of the standard UNIX environment variable TERM as the name of the terminal in use. It uses this to search for the appropriate terminal information in a terminfo database. The run-time system first searches the databases identified in COBTERMINFO and then, if the terminal information is not found it searches the database identified in the standard UNIX environment variable TERMINFO.

Micro Focus recommends that the first directory listed in COBTERMINFO is $COBDIR/terminfo so that the terminfo database supplied with this COBOL system is found first. For commonly used terminals, this terminfo contains settings that are fuller and more appropriate to COBOL than those normally available in the UNIX system terminfo database.

When debugging using Animator, COBTERMINFO must be set to $COBDIR/terminfo.

COBTERMINFO can also be used to identify a terminfo database that is portable between UNIX systems. Such a database conforms to the standard UNIX database format but does not include any supplementary, UNIX implementation-dependent terminal information. Many UNIX system terminfo databases are not portable because they include such supplementary information. The COBOL system ignores any such nonportable details.

Example
COBTERMINFO=$COBDIR/terminfo:/home/mydir/terms

COBSW

Specifies the run-time system switch settings for the run-time system to observe when running an application.
Syntax
COBSW={+|-}switch[...]
Parameters
+
Sets the switch.
-
Unsets the switch.
switch
A run-time switch. See Run-time Switches for details.
Default
COBSW=-A
Example
This example enables run-time switch 0 and the ANSI COBOL debug switch:
COBSW=+0+D

COLUMNS

Specifies the column width of the terminal screen or window, overriding the specified terminal default.
Syntax
COLUMNS=number-of-columns
Parameter
number-of-columns
Specifies the width of the terminal screen or window as represented by the number of columns that display.
Default
Not set. Uses the cols value defined in the specified terminal's terminfo entry, or the current width of the terminal window if you are using an X terminal. See System Terminfo for additional details.
Comments
The terminal type is specified using the standard UNIX environment variable, TERM.

On non-windowing environments, where the terminal screen area cannot be resized, the COLUMNS values does not need to be set. Terminals that can switch into a wide mode (usually from 80 through 132 columns) have a terminal name ending in "w" and these are automatically supported, without the need to set COLUMNS.

In windowing environments, where the size of windows can be changed, the initial size of the window is used in preference to the cols value in terminfo. When the window is resized, the new size is reread. If the new size is greater than the initial size then the extra columns might not be used.

If you want to use the full width of the window you might need to set COLUMNS to the current column width of the window on some platforms.

Using COLUMNS values that do not correspond to the actual width of the window produces unexpected results.

Example
COLUMNS=100

ENTRYNAMEMAP

Specifies the locations of entry-name map files to use.
Important: You must set the entry_point_mapper tunable to enable entry-point mapper support. See entry_point_mapper for details.
Syntax
ENTRYNAMEMAP={file-name|directory}[:...]
Parameters
file-name
The name of the entry-name map file.
directory
A directory containing an entry-name map file. The name of the entry-name map file must be mfentmap.dat.
Default
Not set. The run-time system searches for an entry-name map file called mfentmap.dat in each directory specified by the COBDIR environment variable.
Comments
If the run-time system finds more than one entry-name map file, and the same entry point is defined differently in different files, precedence is given to the definition in the entry-name map file that was found first. To change the order in which the run-time system finds entry name map files you need to change the order in which the files appear in the COBDIR or ENTRYNAMEMAP environment variable paths.

ES_CAS_API

Indicates whether casout or cassub is executed by a call and not from the command line.
Syntax
ES_CAS_API=ON
Parameter
ON
The utility is invoked by a call, and messages are not sent to the console or command line.
Default
Not set. Utilities are executed from the command line, and messages are logged.

ES_JES_ENFORCE_EXPIRE_DATE

Determines whether or not to check the expiration date when deleting a catalogued dataset, and if expired, delete the dataset.

Syntax
ES_JES_ENFORCE_EXPIRE_DATE={Y|N}
Parameters
Y
Check the expiry date and delete expired datasets.
N
Do not check the expiration date.
Default
ES_JES_ENFORCE_EXPIRE_DATE=Y
Comments
Use the PURGE keyword to delete non-expired datasets.

ES_JES_LEVEL

Sets the default JCL type on the JES Control page.
Syntax
ES_JES_LEVEL={VSE|JES2|JES3}
Parameters
VSE
Default JCL type of VSE.
JES2
Default JCL type of JES2.
JES3
Default JCL type of JES3.
Default
ES_JES_LEVEL=JES2

EXTFH

Specifies a configuration file for the Callable File Handler.
Syntax
EXTFH=file-name.cfg
Parameter
file-name
The prefix name of the configuration (.cfg) file.
Default
Not set. The default configuration file name prefix is extfh.
Example
EXTFH=/home/mydir/myconfig.cfg

FHREDIR

Specifies a configuration file to be used by the Fileshare Client.
Syntax
FHREDIR=[path-name/]prefix.cfg}
Parameters
path-name
The full path to the location of the Fileshare Client configuration file.
prefix
The prefix name of the configuration (.cfg) file.
Default
Not set. Uses the fhredir.cfg file in the current working directory.
Example
FHREDIR=/home/mydir/myconfig.cfg

FS

Specifies a configuration file to be used by the Fileshare Server.
Syntax
FS=file-name.cfg
Parameter
file-name
The prefix name of the configuration (.cfg) file.
Default
FS=fs.cfg
Example
FS=myfsconf.cfg

FSCOMMS

Specifies that the Fileshare system is to run in single user mode.
Syntax
FSCOMMS="\$local"
Parameter
$local
Run the Fileshare System in single user mode.
Default
Not set. Fileshare system runs in multi-user mode.

HCOBND (deprecated)

Specifies a directory to be used for bind files generated by the DB2 External Compiler Module (ECM).
Attention: HCOBND is deprecated and provided for backward compatibility only. We recommend that you use either the BIND or the BINDDIR compiler directive option instead.
Syntax
HCOBND=path-name
Parameter
path-name
The directory that the DB2 ECM is to use to store bind files.
Default
Not set. Looks only in the current working directory for bind files generated by the DB2 ECM.
Comments
The DB2 ECM uses the specified directory until the variable is unset or reset to a different directory. The DB2 Compiler directive option BIND overrides this environment variable.
Example
HCOBND=/mydir/binds

ES_JES_LISTCAT_YMD

Determines the date format used in the HISTORY report generated when the IDCAMS LISTCAT command specifies the ALL parameter.
Syntax
ES_JES_LISTCAT_YMD={Y|N}
Parameters
Y
Show the CREATED, CHANGED and EXPIRE date in YYYYMMDD format.
N
Show the CREATED, CHANGED and EXPIRE date in YYYY.ddd format.
Default
ES_JES_LISTCAT_YMD=N

LANG

Specifies the locale.
Syntax
LANG=unix-language[_territory[.code-page]]
Parameters
unix-language
The spoken/written language in which your program is to run. This determines which message catalog is open so that if an error occurs, the error message is output in the selected language. unix-language can take any of the following values:
Value Language
en_US US English
en_GB UK English
jp_JP Japanese (EUC encoding)
jp_JP.sjis Japanese (Shift-JIS encoding)
jp_JP.utf8 Japanese (UTF8 encoding)
territory
The country in which your program is to run.
code-page
The character set code to use for your program.
Default
Not set.
Example
LANG=fr_FR

LD_LIBRARY_PATH

Specifies the directory or directories for the UNIX system, cob command, and the run-time system to search for shared libraries and callable shared objects.
Syntax
LD_LIBRARY_PATH={$COBDIR/lib|path-name}[:path-name[...]]
Parameter
path-name
The full path to a directory to search.
Default
Not set. Looks in the current working directory only.
Comments
This environment variable is a system environment variable; see your UNIX documentation for more information.

If you have installed the product to a directory other than the default, you must set this variable, and include $COBDIR/lib on all platforms except AIX (which uses LIBPATH). It should also include any directories that contain callable shared objects used by your application.

If you have installed the product in the default directory (/opt/microfocus/EnterpriseDeveloper), you do not need to set this variable.

Example
LD_LIBRARY_PATH=$COBDIR/lib:/home/mydir/myapp:$LD_LIBRARY_PATH

LIBPATH

On AIX platforms only, specifies the directory or directories for the UNIX system, cob command, and the run-time system to search for shared libraries and callable shared objects.
Syntax
LIBPATH={$COBDIR/lib|path-name}[:path-name[...]]
Parameter
path-name
The full path to a directory to search.
Default
Not set. Looks in the current working directory only.
Comments
If you have installed the product on an AIX platform and to a directory other than the default, you must set this variable, and include $COBDIR/lib. It should also include any directories that contain callable shared objects used by your application.

If you have installed the product in the default directory (/opt/microfocus/EnterpriseDeveloper), you do not need to set this variable.

Example
LIBPATH=$COBDIR/lib:/lib:/usr/lib

LINES

Specifies the depth of the terminal screen or window, overriding the specified terminal default.
Syntax
LINES=line-depth
Parameter
line-depth
The depth of the terminal screen or window, in lines.
Default
Uses the lines value as defined in the specified terminal's terminfo entry, or the current depth of the terminal window if you are using X windows.
Note: The terminal type is specified via the standard UNIX environment variable, TERM.
Comments
On non-windowing environments, where the terminal screen area cannot be resized, the LINES values does not need to be set.

In windowing environments, where the size of windows can be changed, the initial size of the window is used in preference to the lines value in terminfo. When the window is resized, the new size is reread. If the new size is greater than the initial size then the extra lines might not be used.

If you want to use the full depth of the window you might need to set LINES to the current depth of the window on some platforms.

Using LINES values that do not correspond to the actual depth of the window produces unexpected results.

Example
LINES=50

MAINFRAME_FLOATING_POINT

Specifies the format to use for floating point data items. Possible formats are IBM hexadecimal and IEEE.
Syntax
MAINFRAME_FLOATING_POINT={true|false}
Parameters
true
Use IBM hexadecimal-format floating-point data items.
false
Use IEEE-format floating-point data items.
Default
MAINFRAME_FLOATING_POINT=false
Comments
The setting of this environment variable can be overridden by the NATIVE-FLOATING-POINT directive.

MFCODESET

Specifies which translation tables to use.
Syntax
MFCODESET=country-code
Parameter
country-code
The country code required for translation. See Supported Country Codes for a list of countries and codes.
Default
Not set. Uses the country code returned from the CBL_GET_OS_INFO routine.

MFCSCFG

Specifies a configuration file to be used by the Client/Server Binding client program.
Syntax
MFCSCFG=[path-name/]file-name
Parameters
path-name
The full path to the location of the configuration file.
file-name
The name of the configuration file.
Default
MFCSCFG=mfclisrv.cfg
The default path-name is the current working directory, and if not found, the default settings for the configuration entries are used.
Comments
The value of MFCSCFG is overridden by any value defined in the command line.
Example
MFCSCFG=/home/mydir/mfclisrv.cfg

MFJSERET

Allows an unsuccessful operation to abend, but prevents this from terminating the program with an unrecoverable error.
Syntax
MFJSERET=ABEND
Parameter
ABEND
The operation will abend and its program will continue instead of terminating with an unrecoverable error (return code 16)
Default
Not set. An unsuccessful operation and its program terminate with an unrecoverable error (return code 16). See also MFJSABCODE.

MFJSTATS

For a COBOL sort not running under mainframe emulation, determines whether statistics are included in reports produced for the COBOL SORT operation.
Syntax
MFJSTATS={ON|OFF|switch}
Parameters
ON
Creates a report containing statistics for the SORT that is displayed to SYSOUT. If a report file already exists for a previous SORT, the new statistics are appended to the end of the previous one.
OFF
No statistics are included in the report.
switch
Switches the inclusion of statistics in the report to ON when set to OFF, and to OFF when set to ON.
Default
MFJSTATS=OFF
Comments
If you are performing a COBOL sort using mainframe emulation, you can create a statistics report by modifying the JCL statement.

MFLECONFIG

Specifies a configuration file for Language Environment (LE) run-time options.
Syntax
MFLECONFIG=path-name/file-name
Parameters
path-name
The full path to the location of the ile containing the LE run-time options you want to use.
file-name
The name of the file containing the LE run-time options you want to use.
Default
Not set. No LE run-time options are used.

MFLOGDIR

Specifies a directory to be used by Client/Server Binding for log files.
Syntax
MFLOGDIR=path-name
Parameter
path-name
The full path to the location of log files.
Default
Not set.
Example
MFLOGDIR=/home/mydir/logs

PATH

Specifies the directories to be searched by all UNIX programs, including the run-time system, when finding executables to be run.
Syntax
PATH=path-name[;[path-name][...]]
Parameter
path-name
The full or relative path to a directory to search for executables.
Default
None. Set at the system level.
Example
PATH=u:/home/mydir/srclib:otherlib

SORTCOMPRESS

Tells the system whether or not to execute a compression routine on each record to be sorted.
Syntax
SORTCOMPRESS={0|1}
Parameters
0
Disables compression.
1
Enables compression.
Default
SORTCOMPRESS=0
Comments
When compression is enabled, run-length encoding of sort records is enabled, resulting in much better performance when records contain multiple repeated characters.

Use this variable to improve memory usage and therefore sort performance when the sort records contain many single, repeated characters; for example, multiple spaces.

The behavior when set to any positive integer is equivalent to SORTCOMPRESS=1.

SORTSCHEME

Enables the SORTSPACE environment variable, which specifies an alternative memory allocation size for sort operations.
Syntax
SORTSCHEME=1
Parameter
1
Enables the SORTSPACE environment variable.
Default
Not set. The memory allocated for sort functions is 1 megabyte.

SORTSPACE

The amount of memory to be allocated to internal workspace for SORT operations, and the format for the allocated memory.
Important: To set SORTSPACE to a value other than the default, you must first enable it using the SORTSCHEME environment variable.
Syntax
SORTSPACE=memory-spec[K|M|G]
Parameter
memory-spec
A number that represents the amount of memory to allocate. When used without an optional parameter, this number represents memory in bytes; otherwise, it represents the units specified by an optional parameter.
K
memory-spec specifies memory allocation in kilobytes.
M
memory-spec specifies memory allocation in megabytes.
G
memory-spec specifies memory allocation in gigabytes.
Default
SORTSPACE=1M
Comments
A larger value for SORTSPACE generally results in a faster sort. However, if you specify a value that exceeds the capacity of main memory in your computer such that the operating system has to page memory in and out, performance is degraded.

Parameter values are not case sensitive.

Example
SORTSPACE=1024K

SORTTEMPSPACE

The amount of memory to be allocated to temporary workspace for SORT operations.
Syntax
SORTTEMPSPACE=memory-spec[K|M|G]
Parameters
Important: The value specified must be equivalent to 32M or greater, irrespective of the scheme used to specify the amount of memory.
memory-spec
A number that represents the amount of memory to allocate. When used without an optional parameter, this number represents memory in bytes; otherwise, it represents the units specified by an optional parameter.
K
memory-spec specifies memory allocation in kilobytes.
M
memory-spec specifies memory allocation in megabytes.
G
memory-spec specifies memory allocation in gigabytes.
Default
SORTTEMPSPACE=32M
Comments
Use this variable to adjust the memory allocation strategy used by SORT. This can generally improve performance in systems suffering from memory fragmentation.

Parameter values are not case sensitive.

Example
SORTTEMPSPACE=250M

TERM

Defines the type of terminal to use.
Syntax
TERM=term-type-name
Parameter
term-type-name
The name of a terminal type listed in the terminfo database.
Example
TERM=at386

TERMINFO

Specifies the directory to be searched by all UNIX programs, including the run-time system, for the UNIX system terminfo database.
Syntax
TERMINFO=path-name
Parameter
path-name
The full path to the directory that contains the UNIX system terminfo database.
Comments
The UNIX system terminfo database is used by all UNIX applications that need to use a terminal. However, COBOL applications tend to make much fuller and sophisticated use of the terminal and require a fuller terminfo description than is required by typical UNIX applications such as vi.

Some terminal capabilities, such as those set during the initialization of the terminal to control the use of function keys, commonly conflict with the needs of typical COBOL applications. In such cases, the terminal information required by COBOL can be stored in a separate terminfo database and referenced using COBTERMINFO.

TMPDIR

Specifies a directory in which to store temporary files instead of the UNIX system default.
Syntax
TMPDIR=path-name
Parameter
path-name
The full path to an alternative directory in which to store temporary work files.
Default
Not set. Temporary files are stored in the UNIX system default temporary directory.
Comments
Temporary work files can be created by COBOL utilities such as Cob or by the run-time system when it executes statements such as SORT.

You might need to use this environment variable if the run-time system needs to page data to disk when creating heaps or sorting.

USER

Specifies the default user name.