General Enterprise Server Environment Variables

The following environment variables are applicable to all components of Enterprise Server.

ES_CAS_API: Indicates whether casout or cassub has been executed by a call and not from the command line.
ES_CONSOLE_LOG: Sends console messages to the Windows Event Log.
ES_CSKL_NO_MSG_CONSOLE: Stops CSKL writing messages to console.log.
ES_ESMAC_DISP_MAX_OVERRIDE: The number of items displayed in the ESMAC catalog view or lines displayed in a SYSOUT file from the job list view.
ES_LEGACY_ECI: Indicates that Enterprise Server must use Micro Focus ECI instead of IBM CTG.
ES_MAX_CATALOG_LINES: Restricts the number of entries displayed in ESMAC catalog view, and the default is 5000.
ES_MEM_STRATEGY: Selects the types of memory processes supported.
ES_OTMA_TIMEOUT: The time that an OTMA client should wait for an answer.
ES_SEP_DORMANT_TIME: Allows override of Transient SEP dormant time.
ES_SERVER: Server name (used if no -r switch is specified on casstart or casstop).
ES_SYSOUT_HOLD: The status of the SYSOUT files are set to Out Hold.
ES_USR_DFLT_ESMAC: Allows you to override the default user when no user is logged on for ESMAC authentication.
ES_ESM_DISABLE_DFLTUSER_ESMAC: Allows you to disable the default ESMAC user in order to increase the security of your server. Disables the DEFAULT button on the logon screen and forces users to always enter a valid userid and password.
ES_WS_RUNAWAY_TIMEOUT: Time in seconds that the client will wait for a response from the web service. Valid values are 0 to 65535 seconds.
ISPPROF: The location of ISPF dialog profiles.
JAVA_HOME: Specifies the location of the JDK.

MAINFRAME_FLOATING_POINT

Specifies the format to use for floating point data items. Possible formats are IBM hexadecimal and IEEE.

Syntax

SET MAINFRAME_FLOATING_POINT=fpstatus

Parameters

fpstatus Which format to use for floating point data items. This must be one of:

true Specifies that IBM hexadecimal format floating point data items are to be used.
false Specifies that IEEE format floating point data items are to be used.

Setting MAINFRAME_FLOATING_POINT to anything other than true has the same effect as setting it to false.

The setting of this environment variable can be overridden by the NATIVE-FLOATING-POINT directive.

MF_AMODE31ONLY

Indicates that all programs are AMODE(31).

MF_CHARSET

Specifies the system character set (ASCII or EBCDIC).

MF_USESCA5

Specifies that the server should use version 5 of the Open Service Component Architecture.

Values:

ON (Default)
OFF

MFCODESET

Specifies which translation tables to use.

Values

A pre-defined country code:

Important: To specify a Euro codeset, meaning that it includes the Euro symbol (€), prefix an "E" to the appropriate country code listed below. A country code with no "E" prefix indicates a non-Euro code.

Country Code (MFCODESET)	EBCDIC CCSIDs	Language
AUTOMATIC AUTO		Operating system default - sets country code based on CBL_GET_OS_INFO
DEFAULT		Set to 0437 (US English) on Windows, or 0081 (Japanese Katakana Extended) on Japanese Windows.
0031	37, 1140	Dutch
0033	297, 1147	French
0034	284, 1145	Spanish
0039	280, 1144	Italian
0043	273, 1141	German (Austrian)
0044	285, 1146	UK English
0045	277, 1142	Danish
0046	278, 1143	Swedish
0047	277, 1142	Norwegian
0049	273, 1141	German
0066	838	Thai Extended
0081†	930 (290, 300)	* Japanese Katakana Extended
0082	933 (833, 834)	*Korean
0086	13676 (836, 837)	*Simplified Chinese
0351	37, 1140	Portuguese
0358	278, 1143	Finnish
0420	420	Arabic See Arabic support considerations below
0437	37, 1140	US English
0500	500, 1148	International (Latin 1)
0886	937 (37, 835)	*Traditional Chinese
0930 †	930 (290, 300)	*Japanese Katakana Extended
0939 †	939 (1027, 300)	*Japanese Latin Extended
9122 †	9122 (290, 300)	*Japanese Katakana

Character sets marked with an asterisk (*) are capable of mixed single-byte and double-byte character conversion. EBCDIC CCSIDs in these rows indicate the mixed-byte CCSID first, followed by the single-byte, then double-byte Code Page Global Identifiers (CPGIDs) in parenthesis.

Other EBCDIC CCSIDs in parentheses reflect a 'non-Euro, Euro' pair for appropriate country codes.

For database applications using a DBMS server on Windows, use the table above.

For database applications accessing a UNIX database created with single-byte character sets 819 or 923, use the following table:

Country Code (MFCODESET)	EBCDIC CCSIDs	Languages
1140	37,1140	Dutch US English Portuguese
1141	273,1141	German (Austrian) German
1142	277,1142	Danish Norwegian
1143	278,1143	Swedish Finnish
1144	280,1144	Italian
1145	284,1145	Spanish
1146	285,1146	UK English
1147	297,1147	French
1148	500,1148	International (Latin 1)

If you are not using UK or US language settings, you must also set the codepage in your PC environment settings:

Right click My Computer.
Select Properties.
Click Advanced system settings.
Click Environment Variables.
Under System Variables click New.
Enter MFCODESET as Variable name and XXXX as Variable value, where XXXX is your chosen codepage.

MFCSCFG

Specifies a configuration file to be used by the Client/Server Binding client program.

Syntax

SET MFCSCFG=filename

Parameters

filename The name of the configuration file.

Example

SET MFCSCFG=/home/mydir/mfclisrv.cfg

Comments

The value of MFCSCFG is overridden by any value defined in the command line. If neither of the above yields a filename, the default filename mfclisrv.cfg is assumed, and is searched for in the current directory. If that in turn is not found, the default settings for the configuration entries are used.

MFEXTMAP

Location of a mapper file.

MFLOGDIR

Specifies a directory to be used by Client/Server Binding for log files.

Syntax

SET MFLOGDIR=dirname

Parameters

dirname The name of the directory for log files.

Example

SET MFLOGDIR=/home/mydir/logs

MFLECONFIG

Specifies a configuration file for Language Environment (LE) runtime options.

Syntax

SET MFLECONFIG=filename

Parameters

filename The file containing the LE runtime options you want to use.

MFPRELOAD_USE

Calls MFPRELOAD to improve perfomance.

MFRU_NOINHERIT

Determines if processes are registered in shared memory during initialisation of the run-time system. COBRT105 errors can occur during initialisation if a very large number of COBOL processes are running and there are no available slots in the shared memory segment - setting this variable to Y or TRUE skips the registration process. However, when set to Y, various run-time settings (switches, shared memory, console window settings, etc...) are no longer inherited by any child processes.

When the variable is not set (which is the default), the registration process is not skipped.

Syntax

SET MFRU_NOINHERIT=Y|TRUE

The default is that the variable is not set.

MFSUB: Specifies whether to use SUBI or ASUBI.
MFSYSCATDIR: The location of the system catalog directory.
MFUSER: Default user ID.
MFUSERCAT_LOC: The fully-qualified name of the SMS dataset.
MULTMFENTMAP: Specifies whether special characters such as < and & are replaced with the equivalent HTML entities (for example < and &).
OOSW: OO run-time switches.

USER: Default user name.