SYNTAX

        Barcoder  /Metro  /Com=#  {/Init}  {/IRQ=x}  {/Debug}  {/?}

            *              /Metro – Specifies MetroLogic bar code reader
            *              /Com=# – Specifies Com port to use
            *              /Init – Initializes the video.  For use when not run from TouchPro
            *              /IRQ=x – Specifies IRQ for Com port.  Only required if port has nonstandard interrupt
            *              /? – Displays help info

SUPPORTED HARDWARE

      1. MetroLogic Orbit 7100

INSTALLATION

    There is only one file, the executable.  It should be saved in the TOOLS folder.

STYLING USING BARCODER MODULE

    A styling module currently exists for use with the Epson TM-T88II.  It adds a barcode of the check number to the bottom of the guestcheck.  When the recall button is touched, and the employee is logged in as a cashier(Job Code 2), the application will shell out to read the barcoder.  On detection of touch, or a successful read by the shell terminates.  If a check cannot be recalled from the barcoder number, the application then displays the standard retrieve check screen.  This screen also comes up if the logged on employee is not a cashier, allowing the station to be used as a precheck by other servers as well.  To style in the module, perform the following:

      1. Copy the files into the application directory:
          RECALL.CHN
          BARCODE.SHL
          BARCODER.TMP
      2. Touch Menu’s standard application templates already use the name Recall for the retrieve check chain.  If the application being styled is nonstandard, then a Chain to Recall command must replace the existing one on the Retrieve Check button.
      3. Wherever a Do Template Guestchk command exists, add a Do Template Barcode immediately after it.  Use the scanner utility to help you locate these commands.
      4. Alter the Guestchk template by removing the Paper Cut command and making it advance only two lines at the end.
      5. Touch Menu’s standard application templates already contain all other components used by the Recall chain.  Other applications may require some modification to properly integrate the chain.  An easy way to see if additional styling is needed would be to run the scanner utility and see if the Recall chain has any dead ends.
      6. The shell expects the barcoder to be installed on Com2.  If it is on a different port, edit the shell, putting in the correct port number.
      7. Barcoder expects the interrupts for the com ports to be 4,3,4,3 respectively for Com ports 1 – 4.  If the IRQ for the port specified in step 6 is different, add /IRQ=x to the command line switches in the shell, where x is the IRQ.

STYLING FROM SCRATCH

    BarCoder monitors the device/port and returns the data in Z:Variable.TXT through the variable Number 1 (#38).

    Make a shell like this:

[img:3mnbr4ef]http://www.possupport.net/dealer/kbase/images/barcoder_shell.jpg[/img:3mnbr4ef]

    Then do the appropriate styling to call the shell.

    When BarCoder is running you’ll see this on the screen:

[img:3mnbr4ef]http://www.possupport.net/dealer/kbase/images/barcoder_screen.jpg[/img:3mnbr4ef]

    Scan the check or touch the screen to exit.  Either way, BarCoder then writes the value of Number 1 to Z:Variable.TXT.  If you aborted, the value will be 0.

    Also returned is the index variable containing the termination status.  This can be used to determine which program branch to follow or whether to provide an error window for the user.  Valid values are:

        *          0 – Normal Termination.  Number1 holds check number.
        *          2 – Screen touched or keyboard key pressed.
        *          8 – Barcoder terminated without waiting for a scan.  This could be because the reader is not on-line or because the command line switches weren’t valid.
        *          9 – Shell failed to run.  Barcoder does not return this value, but it is reserved for this error.  If you set Index=9 prior to the shell, the only way it can have this value is if the shell failed to run.

IMPLEMENTATION

    Recall Checks with BarCoder:

      1. Print a bar code. 
      2. Recall the check using BarCoder.

Revisions

11/12/98  Version 0.10

  1. Initial Beta release.

12/04/98  Version 1.00

  1. Added HASP copy protection.
  2. Public release.

12/24/98 Document revision

  1. Added instructions for styling in Barcoder module.

5/3/99  Version 1.01 rw

    1. Added /IRQ= command line switch.

7/21/99  Version 1.02 rw

    1.  When Barcoder terminates, it will now return a termination status value in the index variable.