Integration Guide

Customizing the PSS System Software
______________________________________________________________________________
WaveWorks PSS, Integration Guide, 1.10 Page 106
© 2000, Symbol Technologies, Inc. February 1, 2000
PSS base code is linked with Microsoft's Multithreaded DLL runtime library, so integrators must
link a custom user exit DLL using that same library. Otherwise runtime errors will occur with
the CpssMsgLog and CSymStatementPool classes that are used in the stub User Exits.
9.4.2 Return and Message Codes
The following return codes are used by the standard PSS software to determine how to proceed
after the User Exit routine has returned to the calling routine. The name and numeric value must
also be defined in database table PSS_TEXT if this name is to be used as the msgcode field for
writing a message to the PSS System Log.
UE_CONTINUE Indicates PSS should continue with normal processing
UE_DONE Indicates the User Exit has performed all necessary processing and PSS should skip its
normal processing.
Note: A UE_DONE returned by a "PreProcess" function will cause PSS to skip the call
for the "PostProcess")
UE_ERROR Indicates the User Exit was unable to process sucessfully PSS processing will write a
message to the log and continue processing in the same manner as if a UE_CONTINUE
was returned unless documented otherwise for the individual User Exit.
9.4.3 Using the CPssMsgLog Class
All of the PSS software uses a C++ class named CPssMsgLog for writing operational status and
error messages to the PSS System Log. Customized User Exits should make use of this class to
keep system logging consistent for troubleshooting purposes. Each line in the PSS System Log
displays the following:
• Date/time the message was written.
• Facility Namea 64-character name which should identify the COM object, NT
Service, or other high-level entity such as "ShoppingTripEndOfTrip" to identify a
transaction type.
• Action Namea 64-character name which represents the specific function which is
logging the message. This should either be the UserExit name or the name of a
specific subfunction used by the UserExit routine.
• Message texta 256-character string that contains the information being reported.
The text of these messages is maintained in the PSS_Text database table. The text
in that table can contain tags that represent values which the software supplies to
replace the tag. For instance, the POS file processing replaces a string tag with the
filename of the file being processed and the Unit Management system replaces a
string tag with the MAC address of a terminal that doesn't respond.