Environment variables in alphabetical order

• ON

  Access JCL files on the local machine on which the browser is running.

• OFF

  Access JCL files from the machine running the enterprise server.

• The number of retries made to obtain a record lock.
• Default: 20

Allows the specification, in tenths of seconds, of the maximum time out period that will be used with any LSC style application, such as Drag and Drop, SourceConnect, or the Monitor. The default is 2 minutes (1200), and the maximum value that can be used is 2,147,483,647.

SET CCITIMEOUT=2400 

• The name or the IP address of the machine hosting the CCITCP2 registration program.

• The port on which the CCITCP2 registration program operates.

Filename for and trace output and the trace options. The trace options are as follows:

• /F or -F

  Logs the details of CCI API calls to the trace file. The default condition for this option is OFF, unless a filename or any other trace option are specified, in which case it is always ON.

• /P or -P

  logs the details of protocol level calls to the trace file. If this flag is not ON, then only the details of the CCI user level API will be traced. If this flag is ON, the level of function tracing may be greatly increased. The default condition for this option is OFF.

• /D or -D

  Logs the contents of all buffers passed to and from the CCI functions. The default condition for this option is OFF. Data tracing may not be allowed if the application has been coded to prohibit data tracing for security reasons.

• The name of the SIT that the region uses.

• The path where the .aif files are located.

• The base animator session filename.

• An Animator directive, or a list of directives. Must not be a filename.

• The progid identifier that is used to identify the program to which Animator will attach.

Specifies non-standard behavior for HIGHLIGHT and LOWLIGHT clauses used with ACCEPT and DISPLAY statements. It provides compatibility with earlier COBOL products. You should avoid using it wherever possible as support might be discontinued at some future date.

A value in the range 0 through 7. It can be one of the following values, or a cumulative value; for example, specifying a value of 6 would result in the behavior described for values 4 and 2.

• 0

  Provides standard, default behavior.

  When a COBOL program displays text subject to a HIGHLIGHT or LOWLIGHT clause, the run-time system uses respectively the bold or dim mode specified in the terminfo entry for the terminal. If the bold or dim mode is not specified, then the HIGHLIGHT or LOWLIGHT clause respectively has no effect.

• 1

  When a COBOL program displays text subject to a HIGHLIGHT clause, the run-time system uses the bold mode. The run-time system uses the default mode for normal text. Specifying dim mode in the terminfo entry for the terminal has no affect. The LOWLIGHT clause has no effect.

• 2

  High and low intensity space characters are not assumed to be the same as normal mode space characters.

• 3

  As for 1 and 2 above

• 4

  Provides compatibility with default behavior of products before COBOL version 3.2.

  When a COBOL program displays text subject to a HIGHLIGHT clause, the effect depends on whether the dim mode is specified in the terminfo entry for the terminal. If dim mode is specified, then the run-time system uses the default mode for highlighted text and the dim mode for normal text. If the dim mode is not specified, then the run-time system uses the bold mode for highlighted text and default mode for normal text. The LOWLIGHT clause has no effect, giving the same appearance as normal text.

• The location of a COBOL runtime configuration file.

• The location of a properties file.

• A list of search directories, each item separated by a semicolon.

• A list of search directories, each item separated by a semicolon.

• A list of search directories, each item separated by a semicolon.

Specifies the maximum elapsed time, in tenths of a second, for the connected terminal to transmit any valid escape sequence to the run-time system.

• Terminal timeout time in tenths of a second.

• A COBOL language environment (LE) value.

• A valid logical printer channel.

• A number in the range 1 through nnn that represents the size of the main stack in bytes.

• 32

  The system starts in 32-bit mode

• 64

  The system starts in 64-bit mode

• environment-variable Any one of the environment variables supported by the COBOL system and listed in this appendix.
• value The value to which you want to set the specified environment variable.
• options One or more cob command line options. See the chapter COBOL System Interface (cob) for details on the format of cob options.
• .ext A filename extension that, in addition to the standard ones of .cob, .CBL, or .cbl, denotes a file that Cob should treat as a COBOL source file. The extension must begin with a period, and if more than one is specified on one line then they must be separated by a space or tab character. You can use more than one cobextn line.
• pathname The directory that the COBOL system is to search for an options file.
• filename The name of a file containing cob options.

• A list of search directories, each item separated by a semicolon.

Specifies the name of a print spooler that is to receive, via its standard input stream (stdin), output from any DISPLAY UPON PRINTER statement.

• A command line supported by your system and that can be executed by the system shell. Typically, it is simply the name of a print spooler or other executable, but if the shell is escaped when setting the value then any command-line arguments can be used.

• A list of search directories, each item separated by a semicolon.

COBSES={option[filename]}..., where option can be one or more of the following:

• -a Include keystrokes made to and screen output from the Animator
• -f filename Play back recording in fast forward mode
• -p filename Play back recording in filename at normal speed
• -r filename Record keystrokes
• -s filename Record screen output
• -t terminal number Indicate terminal number for multi-user screen recordings

A list of the runtime switches to set or unset.

• + sets a switch.
• - un-sets a switch.

• A list of search directories, each item separated by a semicolon.

• An integer number of columns.

• The location and name of the default database.

• The path location of the IMS ACB files.

• Y/N.

• File path and name of the dataset rules file.

• pathname

• Setting this variable to any value causes CESN to produce an invalid credential message instead of a specific invalid user or invalid password message.

• Y A user can only log on once.
• Not set: A user can log on multiple times. This is the default.

• Yes
• No
• The overriding class. The default is: ACICSPCT

• Yes
• No
• The overriding class. The default is: CCICSCMD

• Yes
• No
• The overriding class. The default is: DCICSDCT

• Yes
• No
• The overriding class. The default is: FCICSFCT

• Yes
• No
• The overriding class. The default is: JCICSJCT

• Yes
• No
• The overriding class. The default is: MCICSPPT

• Yes
• No
• The overriding class. The default is: PCICSPSB

• Yes
• No
• The overriding class.

• Yes
• No
• The overriding class. The default is: SCICSTST

• Yes
• No
• The overriding class. The default is: TCICSTRN

• Any value sets the variable.

• Any value sets the variable.

• Yes Console messages are sent to the Windows Event Log

• Yes CSKL messages are not written to the console log.

• Y or y Having logged on to ES administration via your MFDS internal security account, you no longer receive the auto logon as "mfuser" when accessing ESMAC.

• ASIS

  CICS honors the CMDSEC option defined in a transaction's resource definition. CICS calls its command security checking routine only when CMDSEC(YES) is specified in a transaction resource definition.

• ALWAYS

  CICS overrides the CMDSEC option, and always calls its command security checking routine to issue the appropriate call to the SAF interface.

• U - Always uppercase.
• L - Always lowercase.
• M - Mixed case and case sensitive

Example: ES_ESM_IDPW_CASE=UM - a single authentication is tried with the user ID folded to uppercase, and the password used as-is.

• NONE

  You do not want any security checking on PLT initialization programs.

• CMDSEC

  You want CICS to perform command security checking only.

• RESSEC

  You want CICS to perform resource security checking only.

• ALL

  You want CICS to perform both command and resource security checking.

• The userid that CICS is to use for security checking for PLT programs that run during CICS initialization.

• A Includes options T, C, and S.
• C Specifies that RACF is to be used for ETO terminal command authorization.
• N Specifies that no sign-on, transaction, or command authorization is to be performed by RACF.
• S Specifies that RACF is to be used for static and ETO terminal command authorization. Includes option C.
• T Specifies that RACF is to be used for sign-on and transaction authorization.
• Y Includes options T and C.

• ASIS

  The RLS security setting of a transaction will be honored. That is, resource level security checking is performed only when the RLS security checkbox is marked in the PCT definition.

• ALWAYS

  CICS processing always performs resource level security checking irrespective of the RLS security setting on the transaction definition.

• NO

  No prefixes are used

• YES

  Resource names are prefixed with the CICS region user ID.

• <prefix>

  A string to be used as the prefix for resource names. It can be 1 to 8 upper case alphanumeric characters and it must start with an alphabetic character.

• NO

  No surrogate user checking is performed.

• YES

  Perform surrogate user checking wherever such checks are permitted.

• An integer number of the ESMAC catalog view lines to display.

• Any value sets the variable.

• n seconds.

This variable only applies to the region within an Enterprise Server Cluster designated as the GLM.

• The relevant hostname.

• Y The Transaction Manager (TM) works in diagnostic mode only, and no activity key points are written to the message queue. Use this feature only when advised to do so by Micro Focus.

ES_IMS_MESGQ=[ds-file-name];max-blocks;buffer-count;start-control;[cushion-size]

ds-file-name

An alternative data store file to the default, which is IMSMESGQ.dat.

max-blocks

Data store size limit represented as the number of 64K blocks. Default is 4.

buffer-count

The number of 64K buffers to allocate. Default is 2.

start-control

A flag that sets the start behavior as follows:

Y	Cold start the resource definitions. Default.
S	Cold start the statistics and resource state information.
Q	Cold start the data store (system cold start).

cushion-size

The size of the cushion to be reserved for graceful lack-of-space behavior, represented as a number from 0 to 255. The specified number represents 32 times the actual percentage of max-blocks reserved for emergency use. The default is 4 (a raw value of 128).

Determines whether the PL/I program converts the PCB address list from a direct to an indirect addressing technique. Set the variable to one of the following:

D

If the main program is a PL/I program, PCB addresses are converted from a direct to an indirect addressing technique.

Y

Always converts address as long as the PSB language is PL/I.

N

Never converts addresses.

The default is D (which stands for dynamic).

• Y

All job messages will be sent to the Output queue, but will only actually print (either physically or logically) if the MSGCLASS of the job matches one of the sysout classes defined to an active printer.

• N

  No Assembler supported for CICS server regions.

• Y

  Assembler supported for CICS server regions.

• Any value sets the variable.

• Any value

  The user ID that started the ES region is used in the job submission.

• No Value

  The CICS default user CICSUSER, or as specified by ES_USR_DFLT_CICS, is used in the job submission.

[ES-Environment]
ES_TMC_AGGREGATE={[,N|,D]|nnn,Y}

,N

Sets the default behavior, which is to unilaterally flush operating system buffers to your physical disk at each key transactional point. While this does not change the method used by default at startup, it does enable dynamic modification via ESMAC. Once set, you can then test the effect of various non-default settings by altering them dynamically.

,D

Disables the transactional flushing of operating system buffers to disk. This option can significantly enhance message queue performance; however it is at the expense of the transactional integrity of the message queue in the event of a system failure.

Note: To avoid unpredictable results when using this setting, we highly recommend that you also set the static options as follows on the Administration Server > Properties > MSS > IMS > TM > General tab:

• Set Cold start to Everything (queue)
• Check Persist

See Server Instance Properties: MSS IMS TM General for details.

nnn,Y

Enables the aggregated transactional flushing of operating system buffers to disk where nnn represents an interval of time, in milliseconds, during which additional buffers are allowed to accumulate before flushing. Valid values are 0 through 255.

Once a thread reaches a key transactional point and requests a flush, TM waits the specified interval to accumulate subsequent threads that also request a flush. At the end of the interval, one flush is performed for all accumulated requests thus potentially improving performance by reducing the number of flush commands issued to the operating system.

Note:

• Threads requesting a flush wait until the flush is confirmed.
• Generally, when the message queue resides on a higher performance I/O subsystem such as one using SSDs, a smaller value, e.g. 1 or 2, produces the best results. A value of 10 or higher seldom improves performance.

ES_XA_????_NB_RETRIES= nnnn where:

• ???? is the XA ID defined in MFDS.
• nnnn is the number of subsequent XA call failures allowed before the SEP is recycled and the switch disabled.

• No Value (default)
• Y

If this environment variable is set, when an error occurs on a call to XA, the server recycles the SEP and attempts to reconnect to the Resource Manager. The ES_XA_????_NB_RETRIES variable specifies the number of XA call failures allowed before the SEP is recycled and the switch disabled.

• "\$local" Run the Fileshare System in single user mode.

• language The language in which your program is to run.
• _ (underscore) The delimiter for language and territory, if territory is specified.
• territory The country in which your program is to run.
• . (period) The delimiter for territory and codepage, if codepage is specified.
• codepage The character set to use for your program.

Example: LANG=fr_FR

Specifies the directory or directories for the UNIX system, Cob and the run-time system to search for shared libraries and callable shared objects. It must be set to 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.

• A path or a list of paths, each separated by a colon (:).

• A path or a list of paths, each separated by a colon (:).

• An integer that specifies the number of lines.

• Y (Default)
• N

• y (default)
• n

• DLET - Logs audit information each time an ESMAC/CAS utility deletes a catalog entry
• DLEJ - Logs audit information each time a step in a JCL job deletes a catalog entry
• DLET,DLEJ - Logs audit information each time either an ESMAC/CAS utility or a JCL job step deletes a catalog entry

• ALL - Search for datasets first in the local catalog, and if not found, on the mainframe (default)
• RJSE - Search for datasets in the local catalog only. No mainframe is performed.

• y
• n (Default)

• ON (Default)
• OFF

• ON (Default)
• OFF

• A pre-defined country code:

  Country code	Language
  AUTOMATIC	Operating system default
  AUTO	Operating system default
  DEFAULT	US English
  0031	Dutch
  0033	French
  0034	Spanish
  0039	Italian
  0043	German (Austrian)
  0044	UK English
  0045	Danish
  0046	Swedish
  0047	Norwegian
  0049	German
  0066	Thai Extended
  0081	*Japanese Katakana Extended
  0082	*Korean
  0086	*Simplified Chinese
  0351	Portuguese
  0358	Finnish
  0437	US English
  0500	International (Latin 1)
  0886	*Traditional Chinese
  0939	*Japanese Latin Extended
  9122	*Japanese Katakana

  Character sets marked with an asterisk (*) are capable of mixed single-byte and double-byte character conversion.

• 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 will also have to 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.
• To use the Euro symbol (€), prefix the country code for EURO codesets with "E".

• DFSORT (Default)
• SYNCSORT

Specifies the record length for the REXX EXECIO command when reading or writing a line sequential file that has been cataloged with a record length of zero.

• Record length to use (Default = 255)

• One or more characters for each operator; each character you specify is used in addition to the default operator. Each additional character must be defined within single or double quotes, or in hexadecimal. Separate multiple characters with a space or a comma.

• One or more characters for each operator; each character you specify is used in addition to the default operator. Each additional character must be defined within single or double quotes, or in hexadecimal. Separate multiple characters with a space or a comma.

• SUBI
• ASUBI

• SORTCOMPRESS=5 allows for run-length encoding of sort records, resulting in much better performance when records contain multiple repeated characters.
  Note: 5 is the only valid value for this environment variable.

• SORTSCHEME=1 - this is the only valid value for the environment variable. See SORTSPACE below for more information.

• n[K|k|M|m|G|g No letter indicates bytes. Defaults to 1 megabyte.

• SORTTYPE=2 Forces SORT to use the file handler, so that format modifications are picked up from the extfh.cfg file.
• Not setting this means SORT will try to use CBL_ routines to read and write files to improve performance.

• name The name of the terminal in the terminfo database.