Cisco Cisco Computer Telephony Integration OS 8.5 Developer's Guide
B-2
CTI OS Developer’s Guide for Cisco ICM/IPCC Enterprise & Hosted Editions
Cisco CTI OS Release 7.2(1)
Appendix B CTI OS Logging
Setting Trace Levels (COM and C++)
Setting Trace Levels (COM and C++)
You must set the tracel level in the registry by creating a TraceMask registry value within the
HKEY_LOCAL_MACHINE\Software\Cisco Systems\Ctios\Logging key and setting its value to
0x40000307.
HKEY_LOCAL_MACHINE\Software\Cisco Systems\Ctios\Logging key and setting its value to
0x40000307.
Trace levels for client processes, such as the Agent Desktop phone are stored under the following registry
key:
key:
HKEY_LOCAL_MACHINE\Software\Cisco Systems\CTI Desktop\Ctios\Logging
Warning
If the TraceMask not set or if it is set incorrectly, the application's performance may be negatively
affected. The preferred setting for normal operation is 0x40000307.
affected. The preferred setting for normal operation is 0x40000307.
Configuring Tracing (COM and C++)
You can set C++ and COM client trace configuration parameters in the Windows registry at the following
key. See
key. See
, for instructions on configuring tracing for the Java CIL.
See
, for instructions on configuring tracing for the .NET CIL.
HKEY_LOCAL_MACHINE\SOFTWARE\Cisco Systems\CTI Desktop\Ctios\Logging
These settings are defined as follows:
Parameter
Description
Recommended Value
FlushIntervalSeconds
Maximum number of
seconds before the trace
mechanism transfers data
to the log file.
seconds before the trace
mechanism transfers data
to the log file.
30
MaxDaysBeforeExpire
Maximum number of days
before a log file is rolled
over into a new log file
regardless of the size of the
file.
before a log file is rolled
over into a new log file
regardless of the size of the
file.
7
MaxFiles
Maximum number of log
files that may exist in the
log file directory before
the logging mechanism
starts overwriting old files.
files that may exist in the
log file directory before
the logging mechanism
starts overwriting old files.
5
MaxFileSizeKb
Maximum size of a log file
in kilobytes. When a log
file reaches the maximum
size, a new log file is
created.
in kilobytes. When a log
file reaches the maximum
size, a new log file is
created.
2048
TraceMask
Bit mask that determines
the categories of events
that are traced.
the categories of events
that are traced.
0x40000307