ZapperPollService Installation Instructions

Technical Description (Payment Polling)

It has been noted that in some installations the POS2100.EXE would hang for a few seconds when polling for payments from various payment vendors at guest check startup. This process can unfortunately slow the entire business. To combat this, this service will attempt to poll the Zapper server for payments, relieving the POS2100.EXE from having to poll on every guest check open.

Every 15 or so seconds, this service will issue a HTTPS payments poll request to the Zapper server. The response from the Zapper server will be abbreviated to an array of guest check numbers that have payments available. If there are no payments available, an empty array is formed. This array will be immediately sent to all of the POS2100.EXEs on the network.

When attempting to open or retrieve a guest check, the POS2100.EXE will first check the array of guest check numbers received from this service for a match to it's own guest check number. If there is a match, the POS2100.EXE will send the payments poll request to the Zapper server, and continue on as normal. If there is no match of it's guest check number, the POS2100.EXE will skip sending the poll request to the Zapper server.

Since the bulk of the POS2100.EXE guest checks will not have a Zapper payment waiting, this should significantly speed up the guest check open process.

Installation Instructions
  1. This Comtrex Zapper Poll Service is intended to be installed only by Comtrex installation and support personnel.
  2. POS2100.EXE version 1.0.3.888 or 1.0.4.888 or later is required for Zapper functionality.
  3. POS System Options - Zapper Definitions must be programmed before starting this service.
    This service requires Zapper parameters (ZapperDefinitions) to be set to operate. Note that if Zapper parameters are not populated or the "Active" check box is not checked, this service will not run.
  4. Installation must be on the PC that is hosting the Odyssey databases.
  5. Uninstall any existing "Comtrex Zapper Poll Service" installation first.
  6. Click on the installation link below to run or download (ftp) the installation program.
    • If downloading, download it to any temporary directory on your C: drive.
    • If running directly, ignore the security warning.
  7. If you downloaded the installation program (.msi), execute it to start the installation.
Installation Follow-up
Important: Make sure you complete the following steps right away.
  1. Be sure to open UDP port 31249 on all terminals.
    If no firewall is running on the terminals, or POS2100.EXE is passed through the firewall, there is probably nothing to do. Most machine firewalls will allow an "application" (POS2100.EXE), thus allowing all ports requested by the application.
    This port is used by the ZapperPollService to notify the terminals (POS2100.EXE) of the current guest check numbers that have Zapper payments to apply. This notification is especially important to keep the terminals running in a robust manner.
  2. This service will not be running after the install, so go to Control Panel - Administrative Tools - Services and start the service. It will automatically start on subsequent power-up sequences.
Installation Reference
  1. Registry entries used by ZapperPollService and created by this installation.
    Changing any of these will require a stop/start sequence to reinitialize the service.
    • (32 bit) [HKEY_LOCAL_MACHINE\SOFTWARE\Comtrex Systems\ZapperPollService] OR
      (64 bit) [HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Comtrex Systems\ZapperPollService]
       
      Value NameValue DataNotes
      AccessDatabasePathC:\icom\databaseThis should not be edited normally.
      PaymentsIntervalSeconds1515 to 20 second range.
      UDPNotifyPort31249This should not be changed without direction from engineering.
  2. Files updated or installed by this installation.
    • (32 bit) C:\Program Files\Comtrex Systems\ZapperPollService OR
      (64 bit) C:\Program Files (x86)\Comtrex Systems\ZapperPollService
      • ZapperPollService.exe - Service executable.
      • LogFiles - Folder with daily log files.
      • Misc. install/uninstall support files.



Click here to Download.


Page last updated: June 20, 2023