Receipt printer other than Epson does not show in the POS printer application
Set up a Star Micronics or other non-Epson receipt printer so it shows in the POS printer application.
Symptom
- A Star Micronics or other non-Epson receipt printer does not print receipts from WorldShare Circulation
- The POS printer application is running, but the Printer list on its test page is empty
- A test print from the POS printer application returns "Printing failed"
- POSPrinter does not appear as a receipt option in WorldShare Circulation
Applies to
- WorldShare Circulation
- POS printer application
Resolution
The POS printer application prints through JavaPOS, so the receipt printer needs its manufacturer's JavaPOS driver as well as its regular Windows printer driver. The setup steps in POS Printer Preferences assume an Epson printer with the Epson JavaPOS ADK. For Star Micronics and other makes, follow the steps below on each computer that has a receipt printer attached. Your IT staff may need to complete them, since several steps require administrator rights.
- Confirm the computer has 64-bit Java 8 installed and no other versions of Java. If it doesn't, uninstall the other versions and install the Windows Offline (64-bit) Java 8 installer from java.com.
- In OCLC Service Configuration, go to WMS Circulation > Integrations > POS Printer Preferences and click Click Here to Download the POS Printer application. The download is a small file named wms-posprinter-server.jnlp. Double-click it to install and start the application.
- If the application stops at startup with "Unable to create the directory [C:\WINDOWS\system32\tomcat.8080]", click Start, find WMS POS Printer Server Application, right-click it, and choose Open file location. Right-click the shortcut, choose Properties, enter %USERPROFILE% in the Start in field, and click OK. Start the application from that shortcut.
- In a browser on the same computer, go to posprinter.worldcat.org followed by a colon and your server port, for example posprinter.worldcat.org:7557. If the page loads with Echo and Print tabs, the application is running. If the Printer list on the Print tab is empty, continue with the next step.
- Search your printer manufacturer's support site for its JavaPOS driver and the software manual that comes with it. Check the manual's list of supported models for your printer, and download the 64-bit driver. If your manufacturer's driver has an installer, follow the manufacturer's installation steps and then go to step 12.
- For the Star JavaPOS driver, which has no installer, close the POS printer application and unzip the driver package.
- Copy starjavapos.jar, stario.jar, jpos113-controls.jar, and jcl.jar from the driver folder into C:\Program Files\Java\jre1.8.0_xxx\lib\ext, where xxx is your Java version number.
- Do not copy xercesimpl.jar or xml-apis.jar. They conflict with the XML parser built into Java 8 and stop the POS printer application from starting.
- Copy StarIOJ.dll and StarIOPort.dll into C:\Program Files\Java\jre1.8.0_xxx\bin.
- Open jpos.xml in Notepad and find the POSPrinter entry for your printer model. For a USB printer, set portName to usbprn: followed by the printer's name exactly as Windows shows it under Settings > Bluetooth & devices > Printers & scanners, for example value="usbprn:Star SP700". For a parallel or serial printer, use the port name, such as LPT1 or COM1. Save the file.
- Copy the edited jpos.xml into the folder the POS printer application starts in. This is the folder where the application created its tomcat.8080 folder.
- Start the POS printer application from its shortcut and wait a few minutes. Reload the test page from step 4, select your printer from the Printer list on the Print tab, and click Print.
- When the test receipt prints, sign in to WorldShare Circulation and select POSPrinter as the receipt option. If you use Chrome or Edge, start the POS printer application from its shortcut before you open WorldShare Circulation.
