Integration Guide

Customizing the PSS System Software
______________________________________________________________________________
WaveWorks PSS, Integration Guide, 1.10 Page 107
© 2000, Symbol Technologies, Inc. February 1, 2000
• Severityrepresents the severity of the condition being logged. A System setting
value, subname "Trace_Level", is maintained for the Facilities that log messages.
If the message severity value is less than the severity value specified in the
LogMessage call, the message is not written to the log. For instance, if the
Trace_Level is set to 2 (Warning), then messages with a severity value 1
(Informational) are not written to the log, but messages logged with the severity 3
(Error) are written to the log. The value 2 is the default Trace_Level value set for
most facilities by the PSS installation scripts. The Trace_Level values can be
modified using the System Settings Page on the PSS Administration terminal.
The allowable values for severity which can be specified in a LogMessage call are:
• PML_DEBUGlevel 0, used to log messages helpful in debugging code during
development. Examples are logging the values of parameters used or calculated by
software. The default Trace_Level settings suppress these messages.
• PML_INFOlevel 1, informational messages that typically log the operational status of
software. Examples are positive status about the completion of an operation (Function
XYX completed successfully). These are messages that would not normally be enabled in
the System Log because there would be many such messages cluttering the log and they
would obscure more severe messages. If there were a perceived system problem, then
troubleshooting procedures might suggest setting the Trace_Level to 1 so these messages
would be written to the log and could be reviewed to see if software functions were being
performed as expected.
• PML_WARNINGlevel 2, Error conditions which the PSS software is readily able to
recover from. The default Trace_Level settings write these messages to the log. These
messages may or may not indicate a system malfunction.
• PML_ERRORlevel 3, Error conditions that indicate a system malfunction that is causing
operational errors. The default Trace_Level settings write these messages to the log.
Some corrective action will normally need to be taken to reinstate proper system operation.
• PML_FATALlevel 4, Critical Error conditions that stop the operation of PSS system
components. These messages typically accompany other indications such as turning the
PSS Administration terminal's Main Menu traffic light red and the disabling of the ability
of PSS to perform shopping activities.
• PML_ALWAYSlevel 10, Status messages that do not indicate error conditions, but
which should always be written to the System Log. Examples are startup and shutdown
messages logged by PSS services or activation messages logged by scheduled tasks.
See the PssMsgLog.h header file for more programming details.