CAS_SRV_CANCEL={P|L|N|D}
CAS_SRV_CANCEL=P
CAS_SRV_CANCEL=L
CCITCPT_serice-name=[unused], MFNODE:node-name, MFPORT:port-number
CCITCPT_MYSERVICE=,MFNODE:localhst.MFPORT:3000
COB_LIVE_RECORD=[path-name/]file-prefix
Animator can update the information file to record information held between sessions.
COB_LIVE_RECORD_SIZE=mem-size
COB_LIVE_RECORD_SIZE=268
When the limit is reached, the buffer is cycled so that the oldest events are removed to make space for the most recent events.
An adequate range for 32-bit systems is between 500 and 1000.
You might need to experiment to determine the most optimal setting
COB_LIVE_RECORD_SIZE=756
COBAIF=path-name[:path-name[...]]
Animator can update the session file to record information held between sessions.
The .aif file contains details of breakpoints and monitors.
COBAIFNAME=base-name
The .aif file contains details of breakpoints and monitors.
COBANIMOPT=directive-name[:directive-name[...]]
COBANIMOPT=MIXEDLANGDEBUG:MULTITHREAD
COBANIMSRV=prog-id
export COBANIMSRV=myid
myid is now a unique identifier that you can use to match Character Animator to a program. Type the command to start Character Animator:
cobanimsrv
The Character Animator waits for a COBOL program to start that has a matching identifier. In another console session:
export COBANIMSRV=myid cobrun prog1.int
When prog1.int starts, the unique identifier myid matches that of Character Animator; therefore, Character Animator attaches to this process. In console session 1, the Character Animator main screen is displayed and the cursor placed on the first line of prog1.int.
COB_LIVE_RECORD_SIZE=mem-size
COB_LIVE_RECORD_SIZE=268
When the limit is reached, the buffer is cycled so that the oldest events are removed to make space for the most recent events.
An adequate range for 32-bit systems is between 500 and 1000.
You might need to experiment to determine the most optimal setting
COB_LIVE_RECORD_SIZE=756
COBAIFNAME=base-name
The .aif file contains details of breakpoints and monitors.
COBANIMOPT=directive-name[:directive-name[...]]
COBANIMOPT=MIXEDLANGDEBUG:MULTITHREAD
COBAIF=path-name[:path-name[...]]
Animator can update the session file to record information held between sessions.
The .aif file contains details of breakpoints and monitors.
COBANIMSRV=prog-id
export COBANIMSRV=myid
myid is now a unique identifier that you can use to match Character Animator to a program. Type the command to start Character Animator:
cobanimsrv
The Character Animator waits for a COBOL program to start that has a matching identifier. In another console session:
export COBANIMSRV=myid cobrun prog1.int
When prog1.int starts, the unique identifier myid matches that of Character Animator; therefore, Character Animator attaches to this process. In console session 1, the Character Animator main screen is displayed and the cursor placed on the first line of prog1.int.
COBATTR={0|1|2|3|4|5|6|7}
COBATTR=0
COBATTR=1
COBCCSIDDIR=base-dir
COBCONFIG=path-name
COBCONFIG=/home/mydir/cobconfig
COBCONFIGJVM=path-name
COBCONFIG.BLOCK=path
COBCPY=path-name[[:path-name][...]]
COBCPY=%COBCPY%;C:\Program Files (x86)\Micro Focus\Enterprise Developer\cpylib; C:\Program Files (x86)\Micro Focus\Enterprise Developer\cpylib\basecl; C:\Program Files (x86)\Micro Focus\Enterprise Developer\cpylibguicl; C:\Program Files (x86)\Micro Focus\Enterprise Developer\cpylibolecl
The following causes the Compiler to search for a copybook in /home/group/sharedcopy, then in the current directory, and finally in ./mydir/mycpy until either the copybook is found or it can be considered not found.
COBCPY=/home/group/sharedcopy:.:mydir/mycpy
COBDATA=path-name[[:path-name][...]]
COBDATA 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.
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.
The following 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.
COBDATA=:demo:/home/data:progs
COBDIR=path-name
This example causes the compiler to search the directory /home/products/cobse20 for the Micro Focus COBOL system software.
COBDIR=/home/products/cobse20
COBIDY=path-name[:path-name[...]]
COBJVM=platform_nnn
| Code | Description |
|---|---|
| ibm | IBM AIX |
| unx | SCO UnixWare |
| sun | Oracle SPARC |
COBJVM=ibm_122
COBKEYTIMEOUT=trans-time
The run-time system calculates an appropriate default value for n from the baud rate of the terminal.
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.
COBLANG=LE-option
COBLPFORM line-number[[:line-number][...]]
In the following example, C01 equals 1, C02 equals 3, and so on:
COBLPFORM 1:3:5:7:9:11:13:15:17:19:21:23
In this next example, C01 equals 3, C02 equals 5, C03 equals 1, and C04 equals 9. C03 equals 1 because its value is a space and therefore undefined, and channels C05 - C12 are also undefined:
COBLPFORM :3::5: :9
COBMAINSTACK=stack-size
You might need to set COBMAINSTACK in any of the following circumstances:
COBMODE={32|64};
COBMODE=32;
COBOPT="[set environment-variable=parameter] [option[...]] [[cobextn: .ext [.ext]][...]]"
or
COBOPT=[path-name/]file-name
If a line does not begin with one of the identifiers set or cobextn: then it is taken as an options line.
This example enables ANSI 85 standard COBOL syntax and sets COBCPY to the specified list of paths.
COBOPT="CANS85 set COBCPY=$COBDIR/srclib/:$HOME/mylib:" export COBOPT
This next example specifies that cob options are contained in the file options in the temp directory:
export COBOPT=temp/options
COBPATH=path-name[:path[...]]
When more than one path-name is specified, a null path name represents the current working directory.
COBPATH=/home/mydir/srclib:otherlib
COBPRFDIR=path-name[[:path-name][...]]
COBPRINTER="command-line"
COBPRINTER="myspooler -a $TMPDIR/spoolfile"
COBSES={option}[[:option][...]]
| -a | Include keystrokes made to and screen output from the Animator |
| -f file-name | Play back recording in file-name in fast forward mode |
| -p file-name | Play back recording in file-name at normal speed |
| -r file-name1 | Record keystrokes in file-name |
| -s file-name | Record screen output in file-name |
| -t terminal-number | Terminal number for multi-user screen recordings |
| 1 Do not combine with either -f or -p. | |
COBSW={+|-}switch[...]
COBSW=-A
COBSW=+0+D
COBTERMINFO=path-name[[:path-name][...]]
COBTERMINFO=$COBDIR/terminfo
The COBOL system takes the value of the standard UNIX environment variable TERM as the name of the terminal in use. It uses this to search for the appropriate terminal information in a terminfo database. The run-time system first searches the databases identified in COBTERMINFO and then, if the terminal information is not found it searches the database identified in the standard UNIX environment variable TERMINFO.
Micro Focus recommends that the first directory listed in COBTERMINFO is $COBDIR/terminfo so that the terminfo database supplied with this COBOL system is found first. For commonly used terminals, this terminfo contains settings that are fuller and more appropriate to COBOL than those normally available in the UNIX system terminfo database.
When debugging using Animator, COBTERMINFO must be set to $COBDIR/terminfo.
COBTERMINFO can also be used to identify a terminfo database that is portable between UNIX systems. Such a database conforms to the standard UNIX database format but does not include any supplementary, UNIX implementation-dependent terminal information. Many UNIX system terminfo databases are not portable because they include such supplementary information. The COBOL system ignores any such nonportable details.
COBTERMINFO=$COBDIR/terminfo:/home/mydir/terms
COLUMNS=number-of-columns
On non-windowing environments, where the terminal screen area cannot be resized, the COLUMNS values does not need to be set. Terminals that can switch into a wide mode (usually from 80 through 132 columns) have a terminal name ending in "w" and these are automatically supported, without the need to set COLUMNS.
In windowing environments, where the size of windows can be changed, the initial size of the window is used in preference to the cols value in terminfo. When the window is resized, the new size is reread. If the new size is greater than the initial size then the extra columns might not be used.
If you want to use the full width of the window you might need to set COLUMNS to the current column width of the window on some platforms.
Using COLUMNS values that do not correspond to the actual width of the window produces unexpected results.
COLUMNS=100
DB2DBDFT=path-name/database-name
ENTRYNAMEMAP={file-name|directory}[:...]
ES_CAS_API=ON
ES_CERT_REG=path-name
ES_DB_FH={[Y|true]|[N|false]}
ES_DB_FH=N
ES_DB_SERVER=server-instance
ES_DB_SERVER=MYSERVER
In this example, your database configuration file would need to contain something similar to the following:
<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>
ES_DDBG_PORT_RANGE={starting-port-number-ending-port-number |
starting-port-number,number-of-ports
ES_DDBG_PORT_RANGE=8001-8040
The following specifies using the next 40 available ports with a port number higher than the starting port number:
ES_DDBG_PORT_RANGE=8001,40
ES_DISABLE_DFLTUSR_SIGNON=Y
ES_ESM_DISABLE_DFLTUSER_ESMAC=Y
ES_ESMAC_DISP_MAX_OVERRIDE=value
ES_ESMAC_DISP_MAX_OVERRIDE=1000
ES_HSF_CFG=cfg-option=value[:[cfg-option=value][...]]
| cfg-option | value range |
|---|---|
| CUSTOM | 0-5 |
| CICSF | 0-20 |
| TSQ | 0-20 |
| TDQ | 0-20 |
ES_HSF_CFG=CUSTOM=0;CICSF=5;TSQ=5;TDQ=5
The ES_WRITE_CUSTOM_HSF library routine writes to the custom fields.
ES_HSF_CFG=CUSTOM=2:CICSF=10:TSQ=5:TDQ=5
ES_KEEP_STDERR=any-value
ES_LOCKDB=region-db
ES_MAX_CATALOG_LINES=number
ES_MAX_CATALOG_LINES=5000
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.
ES_MQ_1PC={[Y|y|Yes|T|True]|[N|n|No|F|False}
ES_MQ_1PC=F
ES_MQ_LIB=path-name/library-name
ES_MQ_LIB="/usr/mqm/lib64/libmqmxa64.a(libmqm64.o)"
ES_MQ_LIB_T=path-name/library-name
ES_MQ_LIB_XA=path-name/library-name
ES_MQ_LIB_XA="/usr/mqm/lib64/libmqmxa64.a(libmqm64.o)"
ES_MQ_LIB_XA_T=path-name/library-name
ES_MQ_LISTENER={queue-manager-name,queue-name,listener-name}
[[,queue-manager-name,queue-name,listener-name][...]]
ES_MQ_XA={D|S}
ES_MQ_XA=D
ES_OLD_SEC_TSTD=ON
ES_PROG_PATH={Y|N}
ES_RLS_FILE_SUPPORT=Y
Parameter values are not case sensitive.
ES_SEP_DORMANT_TIME=wait-time
ES_SEP_DORMANT_TIME=2
ES_SERVER=server-name
ES_SERVER=ESDEMO
ES_SERVER=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={msg-class}[msg-class[...]]
ES_SYSOUT_HOLD=AB
ES_USR_DFLT_ESMAC=userid
ES_USR_DFLT_ESMAC=MFUSER
ES_WS_RUNAWAY_TIMEOUT=wait-time
ES_XA_LOG_SUPPRESS=Y
Parameter value is not case sensitive.
EXTFH=file-name.cfg
EXTFH=/home/mydir/myconfig.cfg
FHREDIR=[path-name/]prefix.cfg}
FHREDIR=/home/mydir/myconfig.cfg
FS=file-name.cfg
FS=fs.cfg
FS=myfsconf.cfg
FSCOMMS="\$local"
JAVA_HOME=path-name
LANG=unix-language[_territory[.code-page]]
| Value | Language |
|---|---|
| en_US | US English |
| en_GB | UK English |
| jp_JP | Japanese (EUC encoding) |
| jp_JP.sjis | Japanese (Shift-JIS encoding) |
| jp_JP.utf8 | Japanese (UTF8 encoding) |
LANG=fr_FR
LD_LIBRARY_PATH={$COBDIR/lib|path-name}[:path-name[...]]
If you have installed the product to a directory other than the default, you must set this variable, and 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.
If you have installed the product in the default directory (/opt/microfocus/VisualCOBOL), you do not need to set this variable.
LD_LIBRARY_PATH=$COBDIR/lib:/home/mydir/myapp:$LD_LIBRARY_PATH
LIB=path-name
LIBPATH={$COBDIR/lib|path-name}[:path-name[...]]
If you have installed the product in the default directory (/opt/microfocus/VisualCOBOL), you do not need to set this variable.
LIBPATH=$COBDIR/lib:/lib:/usr/lib
LINES=line-depth
In windowing environments, where the size of windows can be changed, the initial size of the window is used in preference to the lines value in terminfo. When the window is resized, the new size is reread. If the new size is greater than the initial size then the extra lines might not be used.
If you want to use the full depth of the window you might need to set LINES to the current depth of the window on some platforms.
Using LINES values that do not correspond to the actual depth of the window produces unexpected results.
LINES=50
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]
MF_OPENLDAP_DEBUG=decimal_debug_value
MF_OPENLDAP_DEBUG=16657
Sets LDAP_DEBUG_SYNC, LDAP_DEBUG_STATS, LDAP_DEBUG_BER, and LDAP_DEBUG_TRACE.
MF_USESCA5={ON|OFF}
MF_USESCA5=ON
MFACCCGI_CHARSET=iana-string
MFACCCGI_CHARSET=iso-8859-1
MFBSI_DIR=path-name
MFCROW_DISABLE={Y|N}
MFCROW_DISABLE=N
MFCSCFG=[path-name/]file-name
MFCSCFG=mfclisrv.cfgThe default path-name is the current working directory, and if not found, the default settings for the configuration entries are used.
MFCSCFG=/home/mydir/mfclisrv.cfg
MFDBFH_CONFIG=path-name/file-name
MFDBFH_GRANT_USER_PERMISSIONS={user|role}[{user|role}[...]]
Specifies the type of record locking that it is to be used when the database file handler is in effect.
MFDBFH_RECORD_LOCKING={table|database}
MFDBFH_RECORD_LOCKING=table
MFDBFH_SCRIPT_DIR=path-name
MFDBFH_SCRIPT_DIR=$COBDIR/etc/mfdbfh/scripts
MFDBFH_VAULT=vault-name
MFJSDCBOUTFIL={ON|OFF}
MFJSDCBOUTFIL=OFF
MFJSDCBOUTFIL=ON
MFLECONFIG=path-name/file-name
MFLOGDIR=path-name
MFLOGDIR=/home/mydir/logs
MFSUB={SUBI|ASUBI}
MFTRACE_CONFIG=path-name/ctf.cfg
MFTRACE_LOGS=path-name
MQSERVER=channel-name/transport-type/{machine-name|ip-address(port-number)}
[,{machine-name|ip-address}(port-number)][...]]
This environment variable is IBM-defined, and more information may be found in the relevant IBM publication.
MQSERVER=CHANNEL3/TCP/QServer(1414)
MQSERVER=CHANNEL1/TCP/10.120.99.999(1414),10.120.98.888(1414)
PATH=path-name[;[path-name][...]]
PATH=u:/home/mydir/srclib:otherlib
SORTCOMPRESS={0|1}
SORTCOMPRESS=0
Use this variable to improve memory usage and therefore sort performance when the sort records contain many single, repeated characters; for example, multiple spaces.
The behavior when set to any positive integer is equivalent to SORTCOMPRESS=1.
SORTEXITREENTRY={ON|OFF}
SORTEXITREENTRY=OFF
SORTSCHEME=1
SORTSPACE=memory-spec[K|M|G]
SORTSPACE=1M
Parameter values are not case sensitive.
SORTSPACE=1024K
SORTTEMPSPACE=memory-spec[K|M|G]
SORTTEMPSPACE=32M
Parameter values are not case sensitive.
SORTTEMPSPACE=250M
SORTTYPE=2
TERM=term-type-name
TERM=at386
TERMINFO=path-name
Some terminal capabilities, such as those set during the initialization of the terminal to control the use of function keys, commonly conflict with the needs of typical COBOL applications. In such cases, the terminal information required by COBOL can be stored in a separate terminfo database and referenced using COBTERMINFO.
TMPDIR=path-name
You might need to use this environment variable if the run-time system needs to page data to disk when creating heaps or sorting.
TX_MQ_CONVERT=codeset[,Force]
TX_MQ_CONVERT=037
To force the convert option for MQ even if the application does not set the option on the call, specify the code set followed by Force:
TX_MQ_CONVERT=037,Force
TXFILEP={path-name|datastore-location}