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:
| Option | Value | Meaning |
|---|---|---|
| force_trace_on | yes or no | If yes, details of CCI API calls are logged to the trace file. The default is no. Unless this option is specified, no tracing will be generated, even if the other options are set to yes. |
| protocol_trace | yes or no | If yes, details of protocol-level calls are logged to the trace file. If this option is yes, the level of function tracing may be greatly increased. The default is no. |
| data_trace | yes or no | If yes, the contents of all buffers passed to and from the CCI functions are logged. The default is no.
Warning: This type of tracing may 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 CCI.INI.