User manual

Device Service Control
16
Datalogic™ JavaPOS Device Services
then appended to the LD_LIBRARY_PATH variable, as in the following
example lines:
DLS_LD_LIBRARY_PATH=/opt/dls/JavaPOS/SupportJars
LD_LIBRARY_PATH=$LD_LIBRARY_PATH:$DLS_LD_LIBRARY_PATH
export LD_LIBRARY_PATH
Any JavaPOS app must use the java command line option:
-Djava.library.path=/opt/dls/JavaPOS/SupportJars
to ensure proper libraries are used
PATH WINDOWS ONLY
During the installation process a new system environment variable by the
name of DLS_PATH is created that contains the following string:
c:\Program Files\Datalogic\JavaPOS;c:\Program
Files\Datal
ogic\JavaPOS\SupportJars.
This environment variable is then appended to end of the system environ-
ment variable
PATH
. This is required so the runtime libraries of
Win32Hid.dll and Win64Hid.dll will be found.
Device Service Control
The Datalogic Device Controls use a properties file to control certain
optional operations, and to control trace logging. This file is named
dls.properties. Upon initial service startup, if the service does not find
the dls.properties file, it extracts a default version from the JAR file and
places it in the same folder as the Java application started from. The user
can now change the default settings, but the file must remain in the appli-
cation directory.
dls.properties file
Several of the entries are related to trace logging — see next section for
details. The two remaining entries are described here:
com.Datalogic.jpos.service.ScaleService.ThrowExceptionOn-
ScaleMotion
Defaults to False
. If set True, the service will throw an exception when a
weight request times out due to Scale In Motion (112) or Scale At Zero
(114). If set False, the service reports a timeout.
com.Datalogic.jpos.interpretation.autoLoadConfig
Default is True
. When True, the service will attempt to configure the scan-
ner/scale as per settings in the jpos.xml file upon
startup. If False, the
service will not send configuration data to the scanner/scale upon startup.
This must be set
True
if
jpos.xml
settings are changed by the user.