Tracing and Debugging Environment Variables

Restriction: This topic applies only when the Enterprise Server feature is enabled.

This topic lists environment variables relate to the tracing and debugging functionality.

CCITRACE
Part of the process to enable CCI tracing is to specify the degree of information that will be traced, which can be done by setting the CCITRACE environment variable as follows:

Syntax

CCITRACE=[options]
Parameters
  • options Any, or all, of the following:
/F or -F Logs the details of CCI API calls to the trace file. The default is OFF, unless any other trace option is specified, in which case it is always ON.
/P or -P Logs the details of protocol-level calls to the trace file. The default is OFF. If this flag is OFF, then only the details of the CCI user-level API will be traced. If this flag is ON, the level of function tracing can be increased.
/D or -D Logs the contents of all buffers passed to and from the CCI functions. The default is OFF. Data tracing might not be allowed if the application has been coded to prohibit data tracing for security reasons.

The CCI.INI file can also be used to control trace options, but any values specified by the CCITRACE environment variable will take precedence.

ES_DDBG_PORT_RANGE
A range of ports to use for dynamic debugging.
You specify a range of port numbers using either a hyphen or a comma.

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.

Syntax
ES_DDBG_PORT_RANGE=value
Values
  • low_port-high_port

    or

  • low_port,number_of_ports
Default
If this is not set, dynamic debugging will use random ports.

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
Note: 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.
LDAP_OPT_DEBUG_LEVEL
Enables you to set the LDAP_OPT_DEBUG_LEVEL value using decimal representation.
Syntax
MF_OPENLDAP_DEBUG=decimal_debug_value
Parameters
Sum the decimal debug values you require:
1
LDAP_DEBUG_TRACE
2
LDAP_DEBUG_PACKETS
4
LDAP_DEBUG_ARGS
8
LDAP_DEBUG_CONNS
16
LDAP_DEBUG_BER
32
LDAP_DEBUG_FILTER
64
LDAP_DEBUG_CONFIG
128
LDAP_DEBUG_ACL
256
LDAP_DEBUG_STATS
512
LDAP_DEBUG_STATS2
1024
LDAP_DEBUG_SHELL
2048
LDAP_DEBUG_PARSE
16384
LDAP_DEBUG_SYNC
32768
LDAP_DEBUG_NONE
-1
LDAP_DEBUG_ANY
Default
Not set.
Comments
For Enterprise Server processes, the ES_KEEP_STDERR environment variable must also be set.
Example
MF_OPENLDAP_DEBUG=16657

Sets LDAP_DEBUG_SYNC, LDAP_DEBUG_STATS, LDAP_DEBUG_BER, and LDAP_DEBUG_TRACE.

MFTRACE_ANNOTATIONS
The location of the trace files.
MFTRACE_CONFIG
The location of the CTF configuration file.
MFTRACE_LOGS
The location of the CTF log files.
MFTSO_DEBUG
Controls the display of debug messages.
TX_MQTRACE
Enables tracing in dfh0mqis for WebSphere MQ calls.