Cisco Cisco Computer Telephony Integration Option 9.0 Guide Du Développeur
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.
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.
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:
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.
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.
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.
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.
file reaches the maximum size, a new log file is
created.
2048
TraceMask
Bit mask that determines the categories of events
that are traced.
that are traced.
0x40000307
Table B-2
LogEvent Method Description
Method
Description
getDescription
Returns the text description to write somewhere.