Tracing and Debugging Environment Variables

Lists environment variables related to the tracing and debugging functionality.

COBANIMOPT

Specifies additional directives to be used by Character Animator.
Syntax
COBANIMOPT=directive-name[:directive-name[...]]
Parameter
directive-name
A directive to use with Character Animator. Must not be a file name.
Default
Not set. Character Animator runs with directives specified on the command line only.
Comments
When you invoke Character Animator, it first reads the directives you have specified in COBANIMOPT and then uses any directives you specify on the command line, with the possibility that command-line directives override directives specified by COBANIMOPT.
Example
COBANIMOPT=MIXEDLANGDEBUG:MULTITHREAD

COBANIMSRV

Attaches Character Animator to a running COBOL program.
Syntax
COBANIMSRV=prog-id
Parameter
prog-id
An identifier used to identify the program to which Character Animator attaches.
Default
Not set.
Comments
This environment variable is particularly useful for starting cross-session debugging.
Example
In one console session:
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.

COBIDY

Specifies the directory that Animator is to search for the information (.idy) file for the program being animated if it is not found in the same directory as the intermediate code (.int) file.
Syntax
COBIDY=path-name[:path-name[...]]
Parameter
path-name
A directory where .idy files can be found by the Animator.
Default
Not set. Animator searches the current working directory.
Comments
Animator can update the information file to record information held between sessions.

ES_DDBG_PORT_RANGE

A range of ports to use for dynamic debugging.
Syntax
ES_DDBG_PORT_RANGE={starting-port-number-ending-port-number |
   starting-port-number,number-of-ports
Parameters
starting-port-number
A port number that represents the start of the range.
ending-port-number
A port number that represents the end of the range. This number must be greater than the value of starting-port-number. All available ports within the range are used.
number-of-ports
The total number of ports. The ports used include those available, starting with the starting-port-number port and continuing with ports greater than the starting-port-number port, up to the total number specified.
Default
Not set. Dynamic debugging uses random ports.
Comments
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.
Examples
The following specifies that all available ports from 8001 through 8040 are to be used:
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

MFTRACE_ANNOTATIONS

The location of the trace files.

MFTRACE_CONFIG

The location of the CTF configuration file.
Syntax
MFTRACE_CONFIG=path-name/ctf.cfg
Parameter
path-name
The full path to the location of the ctf.cfg file.
Default
Not set.

MFTRACE_LOGS

The location in which to create CTF trace log files.
Syntax
MFTRACE_LOGS=path-name
Parameter
path-name
The full path to the directory used to store CTF trace log files.
Default
Not set. Uses the current working directory.

MFTSO_DEBUG

Controls the display of debug messages.