General Enterprise Server Environment Variables

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

ES_3270_REMOVE_NULL_COLOR_ATTRIB

Stops the extended color attribute set to low-values from being sent to the 3270 emulator. This fixes an IBM issues related to Personal Communications (PCOM) which is described at http://www-01.ibm.com/support/docview.wss?uid=swg21461404.

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.

Note: 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_ELAPSED_DISPATCH_SECONDS

Enables you to specify how frequently casmgr will check for JOBs in the waiting state, in seconds (s), and then start them. The default value is every 5 seconds.

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

Enables you to modify how Enterprise Server kills a process.

Syntax

ES_HARD_KILL_PROCESS=Y|N

By default, Enterprise Server will initially issue a single soft kill. If the soft kill fails a hard kill will be issued.

Y|N: Specify if a hard kill is attempted after the soft kill, Y for yes, N for no.
The default value is Y.

ES_MAX_CATALOG_LINES

Restricts the number of entries displayed in ESMAC catalog view, and the default is 5000.

ES_MAX_HTTP_OUT

Specifies the maximum size (in bytes) of the HTTP response sent by Enterprise Server.

Note: Previously, this was only controlled by the HTTP Out field on the ESCWA ES Control page.

ES_MEM_STRATEGY

Selects the types of memory processes supported.

ES_MFDS_ADDRESS

Specifies the server address which is used by casstart if the /m parameter is not provided.

ES_OTMA_TIMEOUT

The time that an OTMA client should wait for an answer.

ES_PRODUCTION

When ES_PRODUCTION=Y is set, you are prevented from initiating a debugging session from that region of the IDE.

ES_RDO_MAX_RESOURCES

Specifies the maximum number of records for CICS resource types which will be displayed in Enterprise Server Common Web Administration (ESCWA) or Enterprise Server Monitor and Control (ESMAC).

ES_RTLS_CERT_AUTH_FILEPATH

Absolute file path to the certificate authority file used for a TLS enabled Redis SOR.

ES_RTLS_CERT_FILEPATH

Absolute file path to the certificate file used for a TLS enabled Redis SOR.

ES_RTLS_PRIVATE_KEY_FILEPATH

Absolute file path to the private key file used for a TLS enabled Redis SOR.

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_TN3270_FORCE_ALT

Enables you to use a screen size other than the default when using a TN3270 terminal emulator.

ES_TN3270_MODEL_LOG

Writes the TN3270 emulator's model name to a temporary storage queue named TN32MODL that can be viewed using the CEBR transaction.

ES_USR_DFLT_CICS

Allows you to override the default user when no user is logged on for CICS authentication.

ES_USR_DFLT_ESMAC

Allows you to override the default user when no user is logged on for ESMAC authentication.

ES_USR_DFLT_JES

Allows you to override the default user when no user is logged on for JES authentication.

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.

IMSCPY

The location of copybook files for the DBDGEN, MFSGEN, and PSBGEN utilities.

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

MFACCCGI_CHARSET

Enables you to specify the charset used in the HTTP header returned by ESMAC. Valid values are IANA defined charset strings.

If this variable is unset the charset defaults to:

windows-1252

MFCODESET

Specifies which translation tables to use.

Values

A code between 2000 and 9999 (except 9122) corresponds to a user-defined translation table. User-defined tables are created using the Codecomp utility.

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.

MFJSDCBOUTFIL [11]

Determines whether the DCB's LRECL value is honored during an OUTFIL statement.

MFJSDCBOUTFIL={ON|OFF}

Parameters

ON: The LRECL specified in the DCB properties is used during an OUTFIL statement.
OFF: Emulates the ICE222A/ICE217A mainframe restriction.

Default

MFJSDCBOUTFIL=OFF

Comments

When MFJSDCBOUTFIL=ON is in effect, if the DCB LRECL value differs from that calculated by OUTFIL, records are either truncated or padded with space to match the DCB LRECL value.

Example

MFJSDCBOUTFIL=ON

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) run-time options.

Syntax

SET MFLECONFIG=filename

Parameters

filename The file containing the LE run-time 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.
MQSERVER: The location of an WebSphere MQ Server installation.
MULTMFENTMAP: Specifies whether special characters such as < and & are replaced with the equivalent HTML entities (for example < and &).
OOSW: OO run-time switches.

TX_TN3270_FORCE_ALT: Enables you to use a screen size other than the default when using a TN3270 terminal emulator.
TXMAPP: The location of the BMS load module.
TXRDTP: The location of MSS resource definition (RDO) files.
USER: Default user name.