Tracing and Debugging Environment Variables

Lists environment variables related to the tracing and debugging functionality.
Parent topic: Environment Variables by Groups

CCITRACE

Specifies the type of information to record using CCI tracing.
Syntax 
CCITRACE={/|-}{F|P|D}[...]
Parameters
/
Turns on the specified option.
-
Turns off the specified option.
F
Logs the details of CCI API calls to CTF. This option is implied when either P or D is specified. You can override this using -F.
P
When turned on, logs the details of protocol-level calls to CTF, which could greatly increase function tracing. When not set, only the details of the CCI user-level API are traced.
D
Logs the contents of all buffers passed to and from the CCI functions.
Warning: Setting this option might not produce the desired results if the application has been coded to prohibit data tracing.
Default
Not set. CCI tracing is controlled via the ctf.cfg and CCI.INI trace options.
Comments
The ctf.cfg and the CCI.INI file ([ccitrace_base] section) can also be used to control trace options, but any values specified by the CCITRACE environment variable take precedence. For details, see Tracing Options for CTF.CFG and CCI.INI - The CCI Configuration File.
Example 
CCITRACE=/F/D

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.

DBG_MVSPSKEL

The skeleton JCL for debugging.

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.

TX_MQTRACE

Enables tracing in dfh0mqis for WebSphere MQ calls.