Input, Output, and Display Environment Variables

COBCONFIG=path-name

path-name

The directory that contains the COBOL configuration file, which tailors the run-time system.

COBCONFIG=C:\mydir\cobconfig

COBCONFIG.BLOCK=path

path

The full path to the location of the application configuration file.

COBDIR=path-name

path-name

The directory that contains the required Micro Focus COBOL system software.

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.

This example causes the compiler to search the directory C:\products\cobse20 for the Micro Focus COBOL system software:

COBDIR=C:\products\cobse20

COBKEYTIMEOUT=trans-time

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.

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

LE-option

A COBOL language environment (LE) option.

COBLPFORM line-number[[:line-number][...]]

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.

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

stack-size

The size of the main stack in bytes.

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.

COBPATH=path-name[;path[...]]

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.

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

COBPATH=C:\mydir\srclib;;\otherlib

COBPRFDIR=path-name[[;path-name][...]]

path-name

The full path of a directory to search.

COBSW={+|-}switch[...]

+

Sets the switch.

-

Unsets the switch.

switch

A run-time switch. See Run-time Switches for details.

COBSW=-A

COBSW=+0+D

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_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_JES_SPOOL_ORDER=1

1

Displays the list in descending order by JOBID.

ES_LEGACY_ECI=Y

Y

Micro Focus ECI is used.

ES_MAX_CATALOG_LINES=number

number

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

ES_MAX_CATALOG_LINES=5000

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_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.

JAVA_HOME=path-name

path-name

The full path to the location of the JAVA_HOME location.

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

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

MFCSCFG=d:\mydir\mfclisrv.cfg

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.

MFLOGDIR=d:\mydir\logs

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.

MFSUB={SUBI|ASUBI}