User manual

Device Service Logging and Debug Capabilities
User Manual 17
Device Service Logging and Debug Capabilities
The Datalogic Device Services provide the ability to turn on logging of cer-
tain events and to control the level of detail asso
ciated with the log. Events
are logged to a file named dlstrace.log, which is created in the directory
from which the user’s JavaPOS application is launched. To ensure that data
is retained for a reasonable period of time, up to 5 logs can be maintained,
with the size and verbosity of the log configured by settings in a control file.
The control file is a text editable file named Datalogic.properties, which
exists in the same directory. Configurable settings are:
•log name (defaults to jpostrace.log)
•
log size (defaults to 10 MB)
• number of logs to keep (defaults to 5)
• logging trace level (defaults to High)
Device Service Logging
Logging control – how to control logging
The user can control the Device Service logging by editing the dls.proper-
ties file. User controllable properties are:
Table 2
Property Description
Source file:
TraceSourceName = True Puts the name of the source .java file in the trace
log
Source path:
TrimSourceName = True Trims path name for log
When to log:
NumberOfWritesBeforeFlush
= <1>
Default is 1, this controls how much log data is
buffered by Windows before a write is done to
the log. In production, a higher number (e.g. 50)
may improve system performance.
Name:
LogFile = <filename> Default to DatalogicTrace.log
Size:
MaxFileSizeInMegabytes =
<1 to 10>
Defaults to 10 megabytes
Log Levels:
TraceLevel = <0 to 4, see
below>
Defaults to 4
. Device Service logging
Logging levels
• 0 = OFF – no logging (not recommended)
• 1 = Errors – errors and exceptions logged
• 2 = Errors and Some Diagnostics – errors plus additional diag
nostic
data
• 3 = Errors, Diagnostics, and Trace – above plus developer trace mes-
sages
• 4 = Errors, Diagnostics, Trace, and Method entry/exit – most detailed
for d
ebug