Cisco Cisco Computer Telephony Integration Option 8.5 Developer's Guide
B-2
CTI OS Developer’s Guide for Cisco Unified ICM/Contact Center Enterprise & Hosted
Release 7.5(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, Inc.\CTIOS Tracing key and setting its value to
0x40000307.
HKEY_LOCAL_MACHINE\Software\Cisco Systems, Inc.\CTIOS Tracing key and setting its value to
0x40000307.
[HKEY_CURRENT_USER\Software\Cisco Systems, Inc.\CTIOS Tracing]
"TraceMask"=dword:40000307
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, Inc.\CTIOS Tracing]
"TraceFileName"="%HOMEPATH%\\CtiOsClientLog"
"TraceMask"=dword:00000000
"MaxDaysBeforeExpire"=dword:00000007
"MaxFiles"=dword:00000005
"MaxFileSizeKb"=dword:00000800
"FlushIntervalSeconds"=dword:0000001e
"TraceServer"="C:\\Program Files\\Cisco Systems\\CTIOS Client\\CTIOS
Toolkit\\Win32
CIL\\Trace\\CTIOSTraceText.exe"
Note
CTI OS Tracing can be configured globally for the entire machine (using the TraceMask setting on
HKLM) and per user (using the TraceMask setting on HKCU).
HKLM) and per user (using the TraceMask setting on HKCU).
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