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.
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.
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_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.
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_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_USR_DFLT_ESMAC
- Allows you to override the default user when no user is logged on for ESMAC 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.
- 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:
- 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:
- MFCODESET
- Specifies which translation tables to use.
- Values
- On UNIX platforms (requires
):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 translation. 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
Windows and UNIX
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
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
[3]
- 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
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
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.
- 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.