General Enterprise Server Environment Variables

ES_CAS_API=ON

ON

The utility is invoked by a call, and messages are not sent to the console or command line.

ES_CONSOLE_LOG={I|W|E|S}[...]

I

Send informational messages to the Windows Event Log.

W

Send warning messages to the Windows Event Log.

E

Send error messages to the Windows Event Log.

S

Send severe messages to the Windows Event Log.

ES_ESM_DISABLE_DFLTUSER_ESMAC=Y

Y

Disables the default ESMAC user, disables the DEFAULT button on the logon screen, and forces users to always enter a valid user ID and password.

ES_ESMAC_DISP_MAX_OVERRIDE=value

value

An integer denoting the number of lines to display to a maximum of 99999.

ES_ESMAC_DISP_MAX_OVERRIDE=1000

ES_MAX_CATALOG_LINES=number

number

The number of lines to display up to a maximum of 99999.

ES_MAX_CATALOG_LINES=5000

ES_MAX_HTTP_OUT=value

value

A number representing the maximum size of the HTTP response in bytes.

ES_MAX_HTTP_OUT=

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.

ES_SEP_DORMANT_TIME=wait-time

wait-time

The number of seconds that the Transient SEP is inactive.

ES_SEP_DORMANT_TIME=2

ES_SERVER=server-name

server-name

The server name.

32-bit

ES_SERVER=ESDEMO

64-bit

ES_SERVER=ESDEMO64

ES_SYSOUT_HOLD={msg-class}[msg-class[...]]

msg-class

A message class to send to the Complete queue with an Out Hold status.

ES_SYSOUT_HOLD=AB

ES_USR_DFLT_ESMAC=userid

userid

The default user name.

ES_USR_DFLT_ESMAC=MFUSER

ES_WS_RUNAWAY_TIMEOUT=wait-time

wait-time

Time in seconds that the client waits for a response from the Web service. Valid range is 0 through 65535.

JAVA_HOME=path-name

path-name

The full path to the location of the JAVA_HOME location.

Windows:
LANG=win-language[_territory[.code-page]]

UNIX:
LANG=unix-language[_territory[.code-page]]

win-language (Windows)

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. win-language can take any of the following values:

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

unix-language (UNIX)

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.

Windows:
LANG=7

UNIX:
LANG=fr_FR

LD_LIBRARY_PATH={$COBDIR/lib|path-name}[:path-name[...]]

path-name

The full path to a directory to search.

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[...]]

path-name

The full path to a directory to search.

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

line-depth

The depth of the terminal screen or window, in lines.

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}

ON

The server uses version 5 of the Open SCA.

OFF

The server uses the default version of Open SCA.

MF_USESCA5=ON

MFACCCGI_CHARSET=iana-string

iana-string

An IANA-defined charset string. For a list of valid strings, see the Comments section in the CBL_CCSID_FROM_IANA topic.

Windows:
MFACCCGI_CHARSET=windows-1252

UNIX:
MFACCCGI_CHARSET=iso-8859-1

Windows:
MFCSCFG=[path-name\]file-name

UNIX:
MFCSCFG=[path-name/]file-name

path-name

The full path to the location of the configuration file.

file-name

The name of the configuration file.

MFCSCFG=mfclisrv.cfg

Windows:
MFCSCFG=d:\mydir\mfclisrv.cfg

UNIX:
MFCSCFG=/home/mydir/mfclisrv.cfg

MFJSDCBOUTFIL={ON|OFF}

ON

The LRECL specified in the DCB properties is used during an OUTFIL statement.

OFF

Emulates the ICE222A/ICE217A mainframe restriction.

MFJSDCBOUTFIL=OFF

MFJSDCBOUTFIL=ON

Windows:
MFLECONFIG=path-name\file-name

UNIX:
MFLECONFIG=path-name/file-name

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.

MFLOGDIR=path-name

path-name

The full path to the location of log files.

Windows:
MFLOGDIR=d:\mydir\logs

UNIX:
MFLOGDIR=/home/mydir/logs

MFRU_NOINHERIT={Y|TRUE}

Y|TRUE

Do not register processes in shared memory during initialization of the run-time system.

When set, various run-time settings such as switches, shared memory, console window settings, and so on, are no longer inherited by any child processes.

MFSUB={SUBI|ASUBI}

Windows:
PATH=path-name[;[path-name][...]]

UNIX:
PATH=path-name[;[path-name][...]]

path-name

The full or relative path to a directory to search for executables.

Windows:
PATH=c:\myprojects\proj\loadlib;%USERNAME%\srclib

UNIX:
PATH=u:/home/mydir/srclib:otherlib

TERM=term-type-name

term-type-name

The name of a terminal type listed in the terminfo database.

TERM=at386

TERMINFO=path-name

path-name

The full path to the directory that contains the UNIX system terminfo database.

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

path-name

The full path to an alternative directory in which to store temporary work files.

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