Cisco Cisco Computer Telephony Integration Option 8.5 Developer's Guide
B-2
CTI OS Developer’s Guide for Cisco Unified Contact Center Enterprise
Release 8.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:
Table B-1
Configuring Tracing Settings
Parameter
Description
Recommended Value
FlushIntervalSeconds
Maximum number of seconds
before the trace mechanism
transfers data to the log file.
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.
log file is rolled over into a new log
file regardless of the size of the file.
7