Cisco Cisco Computer Telephony Integration Option 9.0 Developer's Guide

Page of 490
   
B-3
CTI OS Developer’s Guide for Cisco Unified Contact Center Enterprise
Release 8.5(3)
Appendix B      CTI OS Logging
Java CIL Logging Utilities
Java CIL Logging Utilities
The Java CIL provides a different logging facility than the C++ CIL. This gives the customer application 
more flexibility in how trace messages are handled. It also limits the number of special privileges the 
browser would need to give the applet using the CIL; the Java CIL will only need to access the network 
and not the file system. For that reason, the Java CIL does its tracing through the firing of special events 
called “LogEvents” that the custom application can trap and handle in however way it sees fit. 
The Java CIL provides the following objects for logging as part of the utilities package:
ILogEvents
This interface must be implemented by a class interested in receiving Java CIL LogEvents. It has only 
one method.
void processLogEvent(LogEvent event)
LogEvent
A custom application that is interested in receiving LogEvents receives an object of this type whenever 
a log message is generated. This class extends the Java “EventObject”, and has one public method:
String getDescription()
Parameter
Description
Recommended Value
FlushIntervalSeconds
Maximum number of 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. 
7
MaxFiles
Maximum number of log files that can 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.
2048
TraceMask
Bit mask that determines the categories of events 
that are traced.
0x40000307
Table B-2
LogEvent Method Description
Method
Description
getDescription
Returns the text description to write somewhere.