COBAIF=path-name[:path-name[...]]
Animator can update the session file to record information held between sessions.
The .aif file contains details of breakpoints and monitors.
COBAIFNAME=base-name
The .aif file contains details of breakpoints and monitors.
COBATTR={0|1|2|3|4|5|6|7}
COBATTR=0
COBATTR=1
COBCONFIG=path-name
Windows:
COBCONFIG=C:\mydir\cobconfig
UNIX:
COBCONFIG=/home/mydir/cobconfig
COBCONFIGJVM=path-name
COBCONFIG.BLOCK=path
COBDIR=path-name
On Windows platforms, the Micro Focus COBOL system is normally installed in the default COBOL system directory and so does not require COBDIR to be set. COBDIR only needs to be set when your COBOL system has been installed in a different directory such as when more than one version of the COBOL system is available at the same time.
Windows platforms:
This example causes the compiler to search the directory C:\products\cobse20 for the Micro Focus COBOL system software:
COBDIR=C:\products\cobse20
UNIX platforms:
This example causes the compiler to search the directory /home/products/cobse20 for the Micro Focus COBOL system software.
COBDIR=/home/products/cobse20
COBKEYTIMEOUT=trans-time
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.
COBLANG=LE-option
COBLPFORM line-number[[:line-number][...]]
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
COBMAINSTACK=stack-size
You might need to set COBMAINSTACK in any of the following circumstances:
COBMODE={32|64};
COBMODE=32;
COBOPT="[set environment-variable=parameter] [option[...]] [[cobextn: .ext [.ext]][...]]"
or
COBOPT=[path-name/]file-name
If a line does not begin with one of the identifiers set or cobextn: then it is taken as an options line.
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
Windows:
COBPATH=path-name[;path[...]]
UNIX:
COBPATH=path-name[:path[...]]
When more than one path-name is specified, a null path name represents the current working directory.
Windows:
COBPATH=C:\mydir\srclib;;\otherlib
UNIX:
COBPATH=/home/mydir/srclib:otherlib
Windows:
COBPRFDIR=path-name[[;path-name][...]]
UNIX:
COBPRFDIR=path-name[[:path-name][...]]
COBPRINTER="command-line"
Windows:
COBPRINTER="myspooler -a %TMPDIR%\spoolfile"
UNIX:
COBPRINTER="myspooler -a $TMPDIR/spoolfile"
COBSES={option}[[:option][...]]
| -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. | |
COBSW={+|-}switch[...]
COBSW=-A
COBSW=+0+D
COBTERMINFO=path-name[[:path-name][...]]
COBTERMINFO=$COBDIR/terminfo
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.
COBTERMINFO=$COBDIR/terminfo:/home/mydir/terms
COLUMNS=number-of-columns
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.
COLUMNS=100
ES_CAS_API=ON
ES_CONSOLE_LOG={I|W|E|S}[...]
ES_ESMAC_DISP_MAX_OVERRIDE=value
ES_ESMAC_DISP_MAX_OVERRIDE=1000
ES_JES_SPOOL_ORDER=1
ES_LEGACY_ECI=Y
ES_MAX_CATALOG_LINES=number
ES_MAX_CATALOG_LINES=5000
ES_SEP_DORMANT_TIME=wait-time
ES_SEP_DORMANT_TIME=2
ES_SERVER=server-name
ES_SERVER=ESDEMO
ES_SERVER=ESDEMO64
ES_SYSOUT_HOLD={msg-class}[msg-class[...]]
ES_SYSOUT_HOLD=AB
ES_USR_DFLT_ESMAC=userid
ES_USR_DFLT_ESMAC=MFUSER
ES_ESM_DISABLE_DFLTUSER_ESMAC=Y
JAVA_HOME=path-name
Windows:
LANG=win-language[_territory[.code-page]]
UNIX:
LANG=unix-language[_territory[.code-page]]
| Value | Language |
|---|---|
| 1 | US English |
| 2 | Canadian French |
| 3 | Danish |
| 4 | Dutch |
| 5 | UK English |
| 6 | Finnish |
| 7 | French |
| 8 | German |
| 9 | Italian |
| 10 | Norwegian |
| 11 | Portuguese |
| 12 | Spanish |
| 13 | Swedish |
| 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) |
Windows:
LANG=7
UNIX:
LANG=fr_FR
LD_LIBRARY_PATH={$COBDIR/lib|path-name}[:path-name[...]]
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/VisualCOBOL), you do not need to set this variable.
LD_LIBRARY_PATH=$COBDIR/lib:/home/mydir/myapp:$LD_LIBRARY_PATH
LIBPATH={$COBDIR/lib|path-name}[:path-name[...]]
If you have installed the product in the default directory (/opt/microfocus/VisualCOBOL), you do not need to set this variable.
LIBPATH=$COBDIR/lib:/lib:/usr/lib
LINES=line-depth
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.
LINES=50
MF_USESCA5={ON|OFF}
MF_USESCA5=ON
Windows:
MFCSCFG=[path-name\]file-name
UNIX:
MFCSCFG=[path-name/]file-name
MFCSCFG=mfclisrv.cfgThe default path-name is the current working directory, and if not found, the default settings for the configuration entries are used.
Windows:
MFCSCFG=d:\mydir\mfclisrv.cfg
UNIX:
MFCSCFG=/home/mydir/mfclisrv.cfg
Windows:
MFLECONFIG=path-name\file-name
UNIX:
MFLECONFIG=path-name/file-name
MFLOGDIR=path-name
Windows:
MFLOGDIR=d:\mydir\logs
UNIX:
MFLOGDIR=/home/mydir/logs
Windows:
MFLECONFIG=path-name\file-name
UNIX:
MFLECONFIG=path-name/file-name
MFSUB={SUBI|ASUBI}
Windows:
PATH=path-name[;[path-name][...]]
UNIX:
PATH=path-name[;[path-name][...]]
Windows:
PATH=c:\myprojects\proj\loadlib;%USERNAME%\srclib
UNIX:
PATH=u:/home/mydir/srclib:otherlib
TERM=term-type-name
TERM=at386
TERMINFO=path-name
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=path-name
You might need to use this environment variable if the run-time system needs to page data to disk when creating heaps or sorting.