Cisco Cisco Computer Telephony Integration Option 8.5 Developer's Guide
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.
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.
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:
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.
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.
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.
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.