CAS_SRV_CANCEL={P|L|N|D}
CAS_SRV_CANCEL=P
CAS_SRV_CANCEL=L
Specifies a run-time configuration file that tailors the run-time configurable options in some way.
Syntax
SET COBCONFIG=pathname
Parameters
Comments
If $COBCONFIG is not set then the file $COBDIR/etc/cobconfig is searched for instead.
Example
SET COBCONFIG=/home/mydir/cobconfig
Values
Specifies the directory or directories that the Compiler and Animator should search for copyfiles.
Syntax
SET COBCPY=pathname[:pathname]...
Parameters
A directory that the Compiler and Animator are to search when looking for copyfiles. When more than one pathname is present, a null pathname represents the current working directory.
Example
SET COBCPY=/home/group/sharedcopy::mydir/mycpy
causes the Compiler to search for a copyfile in /home/group/sharedcopy, then in the current directory and finally in ./mydir/mycpy until either the copyfile is found or it can be considered not found.
Specifies the directory or directories that the run-time system is to search for data files. Provides you with the facility to map data files globally, thus enabling you to put working data files in a directory whose name is not known until run time.
Syntax
COBDATA=pathname[:pathname]...
Comments
COBDATA affects the compiler and other utilities. During compilation, for example, program source is regarded as a data file by the compiler. If you intend to use any COBOL development system utilities, we recommend that the COBDATA value starts with a colon (:).
COBDATA is considered set if there is an environment variable of this name in your environment space, and its value is non-empty.
The full mapping order for files is:
For multiple directory paths specified either in the COBDATA environment variable or a dd_ environment variable, the system searches the first directory specified followed by a slash (/) as a prefix to the user name.
If the filename is not found, or is not readable, the search continues with the next directory until the final directory has been searched. If no file is found, the first directory is used if a file is to be created.
Any dd_ and COBDATA mappings are ignored for any filename that starts with a hyphen () or a slash (/). In addition, it is illegal to have a hyphen in an environment variable name.
When using this facility, you should not use a filename that starts with "COB... "(these are reserved for the COBOL system).
You can use the COBDATA environment variable for files open in any mode (including OUTPUT) and for fixed or variable length files. If you are using indexed files, both the data and index files must be in the same directory.
The COBDATA environment variable affects file deletes, using the rules given here, as well as file opens.
If you intend to use COBOL development system programs, we recommend that you first unset COBDATA, as many of these programs open data files and are thus affected by the value of COBDATA. If you have to set COBDATA, you should include the paths :$COBDIR/dynload/helptbox.lbr and :$COBDIR/dynload/check.lbr at the beginning of the COBDATA value. If you want to see the Animator Help pages, also include COBDIR/dynload/advanim.lbr.
Example
SET COBDATA=:demo:/home/data:progs
causes COBDATA to be set to instruct the run-time system to search for data files in the current directory, then in the directory ./demo, then in the directory /home/data and finally in ./progs.
COBDIR=path-name
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
Specifies which Java Virtual Machine (JVM) to load.
SET COBJVM=platform_nnn
Parameters
platform_nnn where
Comments
You might need to set COBJVM if you are developing distributed applications with both COBOL and Java components.
Example
SET COBJVM=ibm_122
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.
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.
Syntax
SET COBKEYTIMEOUT=n
Parameters
n 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. On encountering a lone Escape character, the run-time system waits n tenths of a second before assuming that the character does not introduce an escape sequence. The run-time system calculates an appropriate default value for n from the baud rate of the terminal.
Example 1:
COBLPFORM 1:3:5:7:9:11:13:15:17:19:21:23
In this example C01 equals 1, C02 equals 3, and so on.
Example 2:
COBLPFORM :3::5: :9
In this example, C01 equals 3, C02 equals 5, C03 equals 1, and C04 equals 9. You can specify only a single line number for each channel.
In example 2 above, channels C05 - C12 are undefined. If a print statement specifies channel C05 - C12, the line is printed at line 1. In addition, in the example shown, C03 equals 1 because its value is a space and therefore undefined.
Any WRITE BEFORE/AFTER PAGE statements cause positioning to be at line 1. Each line advance increases the line number by one. A request to skip to a line number less than or equal to the current line causes a new page to begin. The appropriate number of line feeds are then generated.
This variable is used to specify the size of the main stack.
Syntax
SET COBMAINSTACK=n
Parameters
n - The size, in bytes, of the stack.
The main stack size defaults to three times the size of a threaded stack. The size of a threaded stack is either specified when the stack is created (using CBL_THREAD_CREATE), or it defaults to 160KB for a 32-bit application or 320KB for a 64-bit application.
You might need to set COBMAINSTACK in any of the following circumstances:
Specifies the directory or directories that the run-time system is to search for dynamically loadable .int and .gnt files, or callable shared objects.
Syntax
SET COBPATH=pathname[:pathname]...
Parameters
pathname A list of search directories, each item separated by a semicolon, that the run-time system is to search for a dynamically loadable program (.int, .gnt or callable shared object) file. When more than one pathname is specified, a null pathname represents the current working directory.
Example
SET COBPATH=u:/home/mydir/srclib:otherlib
Syntax
SET COBSW=[+/-}s...
A list of the run-time switches to set or unset.
Example
SET COBSW=+0+D
This enables run-time switch 0 and the ANSI COBOL debug switch.
Values
DT_ENABLE_MFDBFH=true|false
Syntax
SET ENTRYNAMEMAP={filename|directory}; ...
Parameters
filename An entry map file.
directory A directory containing an entry name map file. The name of the entry name map file must be mfentmap.dat.
Comments
You must set the entry_name_mapper tunable to enable entry point mapper support.
If ENTRYNAMEMAP is not set, the run-time system searches for an entry name map file called mfentmap.dat in each folder specified by the COBDIR environment variable.
If the run-time system finds more than one entry name map file and same entry point is defined differently in different files, precedence is given to the definition in the entry name map file that was found first. To change the order in which the run-time system finds entry name map files you need to change the order in which the files appear in the COBDIR or ENTRYNAMEMAP environment variable paths.
SET ES_CERT_REG=pathname
pathname Pathname of the directory where registrations are stored.
By default no directory is specified. In this case it must be specified on the cascertreg command.
ES_CLASS_XPCT={YES|NO|class-name
ES_CLASS_XPCT=YES
ES_CONSOLE_LOG=port export ES_CONSOLE_LOG
Can be any combination of the following:
Enables or disables database file handler support. This is required if your data files are stored in a datastore, or your enterprise server region stores some of its resources in a database; see Micro Focus Native Database File Handling and Enterprise Server Region Database Management for more information.
Syntax
SET ES_DB_FH=value
Values
Default
Database file handler support is disabled.
Specify the name of the database server to be used for region database operations.
There also needs to be a corresponding <server> entry for the database server within the configuration file specified by the MFDBFH_CONFIG environment variable. <dsn> entries for the region, cross-region and master databases must also be specified in the configuration file to enable use of region database operations.
Syntax
SET ES_DB_SERVER=server-instance
Values
server-instance is the name of a valid database server instance. For example, set ES_DB_SERVER=MYSERVER.
Default
Not set.
Using the example above, you would be required to have something similar to that below in your database configuration file:
<?xml version="1.0" encoding="utf-8"?>
<datastores usevault="false">
<server name="MYSERVER" type="sqlserver" access="odbc">
<dsn name="SS.MYMASTER" type="database" dbname="master"/>
<dsn name="SS.CAS.ESDEMO" type="region.cas" region="ESDEMO" feature="all"/>
<dsn name="SS.CAS.CROSSREGION" type="crossregion.cas"/>
</server>
</datastores>
If you use a hyphen, the values you specify are the start and the end of the port range, and the second port number must be greater than the first.
If you specify a comma, the values you specify are the start of the port range and the number of ports available from the start of the range.
ES_DDBG_PORT_RANGE=value
or
Examples
The following definition specifies that ports 8001 through 8040 are to be used:
ES_DDBG_PORT_RANGE=8001-8040
The following definition specifies the same ports but using a different format:
ES_DDBG_PORT_RANGE=8001,40
Syntax
ES_ESM_DISABLE_DFLTUSER_ESMAC=value
Values
Default
Default ESMAC user is not disabled.
ES_DISABLE_DFLTUSR_SIGNON=value
ES_ESMAC_DISP_MAX_OVERRIDE=value
Syntax
SET ES_HSF_CFG=cfg-options
Parameters
field_name=value;[field_name=value;]...using the following values:
| Field name | Range | Default |
|---|---|---|
| CUSTOM | 0-5 | 0 |
| CICSF | 0-20 | 5 |
| TSQ | 0-20 | 5 |
| TDQ | 0-20 | 5 |
For example: ES_HSF_CFG=CUSTOM=2;CICSF=10;TSQ=32 generates 2 custom fields, 10 CICS file fields, 5 TSQ fields and 5 TDQ fields.
Custom fields are written to using the ES_WRITE_CUSTOM_HSF library routine.
ES_IMS_LINKAGE_NULL={Y|N}
ES_IMS_LINKAGE_NULL=N
Specifies the region database that is to process resource locking (step- and system-scoped ENQs) for an enterprise server within a cluster, where resources (such as spool queues and catalogs) are deployed to a database.
Syntax
SET ES_LOCKDB=region-db
Parameters
ES_MAX_CATALOG_LINES=number
ES_MAX_HTTP_OUT=value
ES_MAX_HTTP_OUT=
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.
SET ES_OLD_SEC_TSTD=value
ES_PROG_PATH={Y|N}
| Default: | None |
Syntax
SET ES_RLS_FILE_SUPPORT=value
Values
Default
RLS file support is off.
Syntax
ES_SEP_DORMANT_TIME=seconds
Values
Default
Transient SEPs are terminated after 2 seconds of inactivity.
Syntax
ES_SERVER=name
Values
Default
ESDEMO/ESDEMO64
ES_SNATRC_DIR=path-name
This directory is then used to set up the SNA environment variables SNAMSG and SNATRC to appropriate values.
ES_SYSOUT_HOLD={Y|N}
| Default: | None |
Syntax
SET ES_USR_DFLT_ESMAC=user
Values
Default
mfuser
ES_WS_RUNAWAY_TIMEOUT=wait-time
Syntax
ES_XA_LOG_SUPPRESS=value
Values
Default
By default no value is specified and XA logging is not suppressed.
Syntax
SET EXTFH=filename.cfg
Parameters
filename.cfg The name of the configuration file.
Example
SET EXTFH=/home/mydir/myconfig.cfg
Syntax
SET FHREDIR=filename.cfg
Parameters
filename.cfg The name of the configuration file.
Example
SET FHREDIR=/home/mydir/myconfig.cfg
Specifies a configuration file to be used by the Fileshare Server.
Syntax
SET FS=filename.cfg
Parameters
filename.cfg The name of the configuration file.
Example
SET FS=myconfig.cfg
Syntax
SET FSCOMMS="\$local"
Parameters
"\$local" Run the Fileshare System in single user mode.
JCLTEMP_DIR=path
MF_LE_CBLOPTS={Y|N}
MF_LE_CBLOPTS=N
[run-time-options] [/program-options];
Otherwise, the syntax is of the form:
[program-options] [/run-time-options]
MFACCCGI_CHARSET=iana-string
MFACCCGI_CHARSET=windows-1252
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.
Specifies the location and the name of the configuration file that defines the database server instances and associated databases.
Syntax
SET MFDBFH_CONFIG=value
Values
value represents the full path and filename of your database configuration file.
Default
Not set.
Grants execute privileges to specific users or roles, for types and procedures that are created when configuring an Oracle database for MFDBFH access.
Syntax
MFDBFH_GRANT_USER_PERMISSIONS=value
Values
value is a space-separated list of users and/or roles that will be granted to execute privileges to the types and procedures created by MFDBFH.
Default
Not set.
Notes
If the variable is not specified, the Oracle default permissions are applied, which are to grant execute permissions to the schema owner of that type/procedure only.
This variable has no effect on permissions for any other database provider used with MFDBFH.
Specifies the type of record locking that it is to be used when the database file handler is in effect.
Syntax
SET MFDBFH_RECORD_LOCKING=table|database
Parameters
Default
Specifies the location of the scripts and stored procedures required when the database file handler is in effect.
Syntax
SET MFDBFH_SCRIPT_DIR=value
Values
value represents a path to the directory containing the required resources.
Default
value defaults to the \etc\mfdbfh\scripts sub directory of your product installation directory.
For more information on secrets vaults, see Vault Facility.
Syntax
SET MFDBFH_VAULT=value
Values
value represents the name of a vault.
Default
Not set.
SET MFCROW_DISABLE={Y|N}
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.
Syntax
SET MFLOGDIR=dirname
Parameters
dirname The name of the directory for log files.
Example
SET MFLOGDIR=/home/mydir/logs
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.
Syntax
SET SORTCOMPRESS=n
Parameters
n - An integer that indicates if compression is enabled or not. 0 (zero, the default) indicates not enabled; any positive integer indicates enabled. When enabled, it allows for run-length encoding of sort records, resulting in much better performance when records contain multiple repeated characters.
Comments
This variable is recommended if the sort records contain many single repeated characters, for example, multiple spaces, as it can be very effective in improving memory usage and therefore sort performance.
Example
SET SORTCOMPRESS=5
SORTEXITREENTRY={ON|OFF}
SORTEXITREENTRY=OFF
Syntax
SET SORTSCHEME=1
Syntax
SET SORTSPACE=n[K|k|M|m|G|g]
Parameters
n[K|k|M|m|G|g The amount of memory to be allocated to internal workspace for SORT operations. K or k indicates kilobytes, M or m indicates megabytes and G or g indicates gigabytes. No letter indicates bytes. Defaults to 1 megabyte.
Comments
A larger value for SORTSPACE will generally result in a faster sort. However, if you specify a value that exceeds the capacity of main memory in your computer, such that the operating system has to page memory in and out, performance will be degraded.
Example
SET SORTSPACE=1024K
Syntax
SET SORTTEMPSPACE=n[K|k|M|m|G|g]
Parameters
n[K|k|M|m|G|g] The amount of memory to be allocated to temporary workspace for SORT operations. K or k indicates kilobytes, M or m indicates megabytes and G or g indicates gigabytes. No letter indicates bytes. 32 megabytes is the lowest amount of memory that can be allocated.
Comments
The memory allocation strategy used by SORT can be adjusted through use of SORTTEMPSPACE, which generally improves performance in systems suffering from memory fragmentation.
Example
SET SORTTEMPSPACE=250MB
Syntax
SET SORTTYPE=2
Syntax:
SET XFHLOG=DEFAULT
Parameters:
DEFAULT - generates the log file in the current directory.
Comments:
If the XFHLOG variable is not set, the log file is created in C:\ProgramData\Micro Focus\File Handler\[version-number].
where [version-number] represents the version of your Micro Focus product.
The effect of this variable can be overridden by the LOGFILENAME configuration option.