Tracing and Debugging Environment Variables

Lists environment variables related to the tracing and debugging functionality.

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

CODEWATCH_SRCPATH

The location of source files for the debugger to use if none are found in directories specified when invoking CodeWatch.
Syntax
CODEWATCH_SRCPATH=path-name[[;path-name][...]]
Parameter
path-name
The full path of a directory to search.
Default
Not set.

CODEWATCH_STBPATH

The location of STB files for the debugger to use if none are found in directories specified when invoking CodeWatch.
Syntax
CODEWATCH_STBPATH=path-name[[;path-name][...]]
Parameter
path-name
The full path of a directory to search.
Default
Not set.

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.