Integration Guide
Table Of Contents
- I
- Introduction
- Architecture Overview
- Hardware Requirements
- PSS Software Installation
- Install NT 4.0 Server
- Install the NT 4 Service Pack
- Install Internet Explorer 4.01 Service Pack 2
- NT Option Pack Install
- Install the Video Driver
- Create and Format the Database partition
- Desktop Cleanup (optional)
- Install Microsoft SQL Server 7
- Create and Configure the PSS Database
- Install Microsoft Access
- Internet Explorer 5.0 with Task Scheduler install
- Install WaveWorks
- Install PSS Runtime System
- Install Waveworks Development Studio
- Install PSS Development System
- TFTP Configuration
- DHCP Configuration
- Create an ODBC Data Source
- Load Initial Data
- MS IIS Configuration
- Obtaining Access to PSS System Administration Screens
- Configure Task Scheduler
- Configure Unit Management
- Configure Licensing
- Configure the NBQMAIN Service (IBM 4690 POS Only)
- Setup NT System Log
- Configuration of the PSS System
- Validation of System Operation
- Directory Listing of PSS Folders/Files
- Software Description
- _
- Hardware Overview
- Software Components
- Database Access
- Start of Shopping Trip Processing
- Shopping Trip Processing
- End of Shopping Trip Processing
- Shopping Trip Message Log Entries
- Fatal Messages:
- PSSTransactionFile Processing
- POS Transaction File Processing
- Item Record File Processing
- Customer Update File Processing
- PSS Services
- _
- Customizing the PSS System Software
- Custom DisplayServer Scripts
- Custom Services
- Custom Business Objects
- User Exit DLL
- Available User Exit Functions
- UE_PreProcessItemFile
- UE_PreProcessItemRecord
- UE_PostProcessItemRecord
- UE_PostProcessItemFile
- UE_PreProcessTaxFile
- UE_PostProcessTaxFile
- UE_PreProcessPOSTransFile
- UE_PreProcessPOSTransRecord
- UE_PostProcessPOSTransRecord
- UE_ProcessEODRecord
- UE_PostProcessPOSTransFile
- UE_PreProcessPSSTransFile
- UE_PreProcessPSSTransRecord
- UE_PostProcessPSSTransFile
- UE_CalculateItemPrice_Method10to20
- UE_RescanLevelCalculation
- UE_Pre-RescanDetermination
- UE_PostRescanDetermination
- UE_PreProcessMarketingMessage
- UE_LoginAuthorization
- System Administration Interface
- Specific Features
Software Description
______________________________________________________________________________
WaveWorks PSS, Integration Guide, 1.10 Page 100
© 2000, Symbol Technologies, Inc. February 1, 2000
In order to enable this feature, the following system settings must be configured as shown.
Name/Subname Value
PSSTransFile/TransferEnabled Y (Tells PssFileMonitor to process this filetype - default is N)
PSSTransFile/TransferTX P2P299 (the PosEmulation transaction -default is P2P199)
PSSTransFile/AddCustCheckDigit N (should match value for POSTransFile/RemoveCustChkdigit)
PSSTransFile/AddCustItemDigit Y (should match value for POSTransFile/RemoveItemChkdigit)
After changing these settings, stop both the PosService and PssFileMonitor services. Set the
WaveWorks database ADM_DAEMON table so that PosService is NOT restarted automatically
(just prefix the name so the service isn't found). This will prevent the PosService process from
trying to process PssTransaction(ScanIn) files.
Start up the PssFileMonitor service. By setting the values above, PssFileMonitor will be enabled
to monitor PSSTransaction(ScanIn) files and trigger event P2P299, which creates a
corresponding POSTransaction(ScanOut) file. Normal POSTransaction file processing will then
be triggered by the appearance of a file and cause the shopping trip to be completed.
The POSTransaction file that is created has the same RESCAN flag value and the same items as
are in the PSSTransaction file. Future support for record level and file level user exits to be
called by transaction P2P299 is planned. Thus the created POSTransaction file could be altered
by integrators to add to, remove, or alter records. This support is not available in the initial
release.
8.8.5 POS Transaction File Processing
8.8.5.1 File-Based Interface
The transfer directory is polled by the PssFileMonitor service. Once a POSTransactionFile
arrives in the transfer directory, file processing is activated. The shopping trip information is
moved into the Shopping History database tables. In addition, the shopper's rescan probability is
recalculated. If the file contains an End of Day record, the End of Day Event is stored in the
database (PSS_EOD table) and the End of Day user exit routine is activated.
8.8.5.2 4690 Interface
Upon completion of a transaction at the store check-out lane, a 4690 user exit running in the
check out support application updates a ScanOut file on the POS with information about the
completed transaction. The PssPosService polls the file on the POS, retrieves new information
in the scan-out file, and creates a PosTransactionFile in the Transfer Area for each POS
transaction completed since the last scan. Upon detection of a POS transaction file by the
PssFileMonitor service, processing continues as described in the file-based interface. The
frequency of the poll interval is specified by system setting POSTransactionFile/MonitorInterval.