Cisco Cisco Computer Telephony Integration Option 8.5 Developer's Guide

Page of 508
   
B-3
CTI OS Developer’s Guide for Cisco Unified ICM/Contact Center Enterprise & Hosted
Release 8.0(1)
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 only has 
one method.
void processLogEvent(LogEvent event)
LogEvent
A custom application that is interested in receiving LogEvents will receive an object of this type 
whenever a log message is generated. This class extends the Java “EventObject”, and has one public 
method:
String getDescription()
MaxFiles
Maximum number of log 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.
2048
TraceMask
Bit mask that determines the 
categories of events that are traced.
0x40000307
Parameter
Description
Recommended Value
Table B-2
LogEvent Method Description
Method
Description
getDescription
Returns the text description to write somewhere.