Tracing Options for CCI.INI

Part of the process to enable CCI tracing is to specify the degree of information that will be traced, which can be done by configuring the [ccitrace-base] section of the CCI configuration file, CCI.INI. The options are:

force_trace_on=yes|no

If yes is specified then details of CCI API calls are logged to the trace file.

The default value is no. Tracing will not be generated, even if the other options are set to yes.

protocol_trace=yes|no

If yes is specified then details of protocol-level calls are logged to the trace file and the level of function tracing can be greatly increased. The default value is no.

data_trace=yes|no

If yes is specified then the contents of all buffers passed to and from the CCI functions are logged. The default value is no.

Warning: This type of tracing might not produce the desired results if the application has been coded to prohibit data tracing.

For example, to enable CCI API tracing and data tracing, but not protocol-level tracing, add the following:

[ccitrace-base]
force_trace_on=yes
protocol_trace=no
data_trace=yes

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