Version 5.1. e-bizco.com GmbH. Includes Information for usage with the SAP R/3 System

Transcription

1 PLUS Version 5.1 Includes Information for usage with the SAP R/3 System Version October 1, 2013 SAP, ABAP and SAPscript are registered trademarks of the SAP AG, Walldorf, Germany Windows is a registered trademark of Microsoft Corporation, Redmond, Washington, USA Laserjet and are registered trademarks of Hewlett-Packard Corporation USA Other product or company names mentioned may be trademarks of their respective owners.

2

3 Table of Contents 1 Smart Barcoding Installation Quick Guide Windows Quick Guide with SAP Linux Quick Guide with SAP Overview Installation Windows version System Requirements Licensed Version Demo Version Upgrade from demo to a licensed Version Upgrade from "1D Classic" to "2D Plus" Installing a newer version of covered by your license Running the Running as service Running as user program Logfile Installation ( Linux version ) System Requirements Licensed Version Demo Version Installing a license Installing a newer version of covered by your license Linux Print Command Running the (Linux) Running as service Starting from inetd Running as user program Logfile Installation ( AIX version ) System Requirements Licensed Version Demo Version Installing a license Installing a newer version of covered by your license AIX Print Command Running the (AIX)...13

4 Running as service Starting from inetd Running as user program Logfile Installation ( SunOS / Solaris version, HPUX ) System Requirements Licensed Version Demo Version Installing a license Installing a newer version of covered by your license Solaris /HPUX Print Command Running the ( SunOS /Solaris, HPUX ) Running as service Starting from inetd Running as user program Logfile Installation (SAP) Device type Setup your printer with transaction SPAD Printing barcodes from the SAP system format General Commands for all s T Select barcode P Annotation B Bar Width S Gap Width V Bar Height Horizontal and vertical Position EAN 128 / Code 128 Parameters QR Code Parameters PDF 417 Parameters termination Rotation Embedded control characters Defining s in SAPscript and SmartForms Create your own device type Create System Create Printer Create a simple Test with SmartForms Used...32

5 6.2.2 Used Style Create your form Version History More Information / Contact Appendix Hex Table Specifications QR Code data capacity ISO 3166 Codes (Country Codes)...49

6

7 Page 3 Page 3 for SAP R/3 1 Smart Barcoding Our Software dramatically reduces your costs to print barcodes. You do not need any hardware extension for your printer. You can replace broken printers with another printer and don t have to worry how to replace it with the same model or how to get a compatible barcode module. You do not need to buy any barcode hardware for each printer. Our is supported by SAP R/3: Easy plug-and-play using the device types HPLJ4 HPLJ5 HPLJ5SI HPLJ1100 HPLJ4000 HPLJ8000 HPLJIIID LEXUTF8 You can use our to print almost any widely used barcode type including: Code 128 / EAN 128 Code 39 Code 93 QR Code PDF 417 Data Matrix 2 of 5 family For a complete list of barcodes and required license, please refer to section Almost any barcode allows you to specify parameters and options. Our allows you to define The size of the printed barcode. Rotation of barcodes. Rows and columns for 2D s Error correction mode, redundancy. Structured data for Data Matrix. For a complete list, please refer to section This combination of support by SAP R/3 and customizing makes our really unique. Our online and always up to date trouble shooting section on our web site will help you in case of problems: You are also welcome to contact us at techsupport2@ for free support.

8 Page 4 Page 4 for SAP R/3 2 Installation Quick Guide To install our, only a few steps are necessary for the experienced user. If you are not absolutely familiar with your operating system and SAP, please read the detailed information in the following chapters. 2.1 Windows Quick Guide with SAP Download the most recent version of the from Install the software: run pcl_barcode_win32-xxx.exe to unpack. Save licence.key file (if you have one) to the unpack directory Run setup.exe Answer yes when asked to install as service. Start the service using the computer management tool. Create a new SAP printer using transaction SPAD: The device type depends on your printer model. HPLJ4 is usually a good starting point. The access method must be U. The remote hostname is the name of your test machine. The remote printer name needs to be defined at your test machine. (lpr P yourprinter needs to work well on the test machine). The remote port (click on the Icon) shall be Linux Quick Guide with SAP Download the most recent version of the from Install the software: cd /; tar zxvf pcl_barcode_linux-xxx.tgz will install the software. Save a license file as /etc/barcode.lic Run /usr/local/bin/pcl_barcode_server to start the service manually for a quick test with SAP Create a new SAP printer using transaction SPAD: The device type depends on your printer model. HPLJ4 is usually a good starting point. The access method must be U. The remote hostname is the name of your test machine. The remote printer name needs to be defined at your test machine. ( lpr P yourprinter needs to work well on the test machine). The remote port ( click on the Icon ) shall be 1515.

9 Page 5 Page 5 for SAP R/3 3 Overview The use of usage of bar codes on mass products is widely known. They can be found on nearly all articles in the local supermarket. They are used for automatic product recognition. Therefore it is not necessary to recognize any individual items. So all identical products share the same barcode. But bar codes can also be used to distinguish individual articles or documents. This requires the production of individual bar codes on demand as part of the printing process. As many documents are printed from within windows it is a requirement for many users to print barcodes from their windows application. Windows printing is always done through a device driver that is supplied from the printer vendor. This driver has uniform interface to the windows side. The principle advantage of this interface causes problems, as barcodes are not part of the interface. Neither the interface definition nor windows do take care about barcodes. So even if the printer could print barcodes by itself, the windows interface does not allow requesting them. You can buy programs, which produce barcodes by printing graphics. But they do not allow you to integrate these barcodes automatically into your document. You have to do some (electronic or mechanical) clipping for each document. You can also buy barcode fonts. But they are limited to simple barcodes and you have to compute the checksum in your application, which is often not possible at all. Without checksums barcodes are rather risky to use. You can also not adapt the printing process to your physical output device. This is often required to produce optimal barcodes as every printing system has is own characteristics. What is the solution? Our is the perfect solution for applications, which are aware of barcodes. The application has just to insert the barcode print command with the data and the will integrate the barcode into the current document. The does also generate checksum and caption automatically on demand. You can specify the size of the barcode and even the individual relationship of bars and gaps. SAP System R/3 supports our since version 3.0. It allows you to print barcodes on all printers which are supported by the SAP device types HPLJ4 and HP5MI. The is available on Linux, HPUX, AIX and Windows 95/98/2000/NT. The configuration of the is done from within the SAP system. supplies two : The 1D Classic version supports all one-dimensional barcodes like code 39 and 2 of 5 interleaved. The 2D Plus version also supports two-dimensional barcodes like Data Matrix, PDF 417 or Code16K. If you want to print barcodes on any windows printer: We also offer the DLL for SAP that prints bar codes on any windows printer.

10 Page 6 Page 6 for SAP R/3 4 Installation 4.1 Windows version System Requirements SAP Release 2.x, 3.x, 4.x and newer versions using Unix, Windows, OS/400 Operating System: Windows 2003, 2008, 2008 R2 / Vista / Windows 7 / Windows 2000 / XP This section describes the installation of our and also outlines the changes in your SAP R/3 system Licensed Version If you download the for Windows from the Internet at you will get a single executable pcl_barcode_win32-xxx.exe that contains the compressed installation set. Please download to an empty directory. Just execute this program from your explorer to unpack the installation set. Executing pcl_barcode_win32-xxx.exe will result in the files SETUP.EXE, _BARCODE_SERVER.EX_ and other auxiliary files. If you received a CD from, these files can be found on the disk. The required license key will be sent to you as , by fax or on CD. Please save the as LICENCE.KEY in the same directory where you have the unpacked installation files or place it on a floppy disk as A:\LICENCE.KEY. The Setup program can also create a temporary trial license on demand. To install the on your system, please run the supplied program SETUP.EXE from the installation set. Windows 2008 / Vista or newer: Please use right-click Run as Administrator even if your account has Administrator privileges. To install a licensed version, the license disk should be inserted to your diskette drive or the file LICENCE.KEY has to be just beside of the installation set. If this file is found at the start of SETUP.EXE, the license string is read form this file. If you have received the license key by fax, you may enter this string manually into the field license key Demo Version If you download the from the Internet, you will get a single executable pcl_barcode_win32-xxx.exe that contains the compressed installation set. Simply execute this program from your explorer to unpack the installation set. Executing pcl_barcode_win32- xxx.exe will result in the files SETUP.EXE, _BARCODE_SERVER.EX_ and other auxiliary files. To install the on your system, please run the supplied program SETUP.EXE from the installation set. If possible, Setup will offer to create a temporary license which is valid for 30 days. Windows 2008 / Vista or newer: Please use right-click Run as Administrator even if your account has Administrator privileges.

11 Page 7 Page 7 for SAP R/ Upgrade from demo to a licensed Version To upgrade from a demo version to a licensed version, you must obtain a license key from e- bizco.com. You may download the most recent version the from the Internet at It is the same executable as for the demo version, so if you already have downloaded the actual demo version, you can go ahead with this one. You will get a single executable pcl_barcode_win32-xxx.exe that contains the compressed installation set. Simply execute this program from your explorer to unpack the installation set. Executing pcl_barcode_win32-xxx.exe will result in the files SETUP.EXE, _BARCODE_SERVER.EX_ and other auxiliary files. If you received a CD from e- bizco.com, these files can be found on the disk. The required license key will be sent to you as , by fax or on floppy disk. Please save the as LICENCE.KEY in the same directory where you have the unpacked installation files or place it on floppy disk as A:\LICENCE.KEY. To update the to your system, please run the supplied program SETUP.EXE from the installation set. Windows 2008 / Vista or newer: Please use right-click Run as Administrator even if your account has Administrator privileges. To install a licensed version, the license disk should be inserted to your diskette drive or the file LICENCE.KEY has to be just beside of the installation set. If this file is found at the start of SETUP.EXE, the license string is read form this file. If you have received the license key by fax, you may enter this string manually into the field license key Upgrade from "1D Classic" to "2D Plus" To upgrade from a licensed 1D Classic version to a licensed 2D Plus, you must obtain a license key for the "2D Plus" version from e- bizco.com. You may download the most recent version the from the Internet at It is the same executable as for the demo or classic barcode version, so if you already have downloaded the actual demo version, you can go ahead with this one. You will get a single executable pcl_barcode_win32-xxx.exe that contains the compressed installation set. Simply execute this program from your explorer to unpack the installation set. Executing pcl_barcode_win32-xxx.exe will result in the files SETUP.EXE, _BARCODE_SERVER.EX_ and auxiliary files. If you received a CD from, these files can be found on the disk. The required license key will be sent to you as , by fax or on floppy disk. Please save the as LICENCE.KEY in the same directory where you have the unpacked installation files or place it on floppy disk as A:\LICENCE.KEY. To update the to your system, please run the supplied program SETUP.EXE from the installation set. Windows 2008 / Vista or newer: Please use right-click Run as Administrator even if your account has Administrator privileges. To install a licensed version, the license disk should be inserted to your diskette drive or the file LICENCE.KEY has to be just beside of the installation set. If this file is found at the start of SETUP.EXE, the license string is read form this file. If you have received the license key by fax, you may enter this string manually into the field license key.

12 Page 8 Page 8 for SAP R/ Installing a newer version of covered by your license Any license obtained from entitles you to use newer versions of the released up to six month after the issue date of the license. To use this update feature, please download the newer version of barcode demo from and proceed as described under upgrading from demo to licensed version. To be eligible for upgrading, the new MUST be released within six month after the issue date of your license or you will get an error message when installing a version that was released after that date. If you have purchased a license for with maintenance contract, you may install any covered newer version of the Running the Running as service The can be installed as service in Windows. Installing the can be done by running the program _BARCODE_SERVER with the argument i. The will be started every time the operating system is booted. You can control the services from your windows computer control. To de-install the service, run _BARCODE_SERVER u after shutting the service down from the computer control Running as user program The can be run as _BARCODE_SERVER with no arguments. Option r allows you the change the default port of the server from 1515 to the value given Logfile For trouble shooting, the logfile feature can be turned on. Please add these lines to the file C:\Windows\.ini: [LPD] LogEnabled=9 LogFile=C:\bclpd.log You can create this file using notepad if it does not exist. Please make sure that no.txt is added by windows to the file name.

13 Page 9 Page 9 for SAP R/3 4.2 Installation ( Linux version ) System Requirements Operating System: Linux Kernel 2.6.x or newer This section describes the installation of our and also outlines the changes in your SAP R/3 system Licensed Version If you download the from the Internet, you will get a single installation set pcl_barcode_linux-xxx.tgz that contains the compressed installation set. Please use cd / gzcat < pcl_barcode_linux-xxx.tgz tar xf - to install the software. The program files will be installed in the directory usr/local/bin, documentation will go to usr/local/doc. Please make sure that the files contained in the tar file do not interfere with you local installation before you extract the tar file. Please save the license file that you have received from us as /etc/barcode.lic Demo Version If you download the from the Internet, you will get a single installation set pcl_barcode_linux-xxx.tgz that contains the compressed installation set. Please use cd / gzcat < pcl_barcode_linux-xxx.tgz tar xf - to install the software. The program files will be installed in the directory usr/local/bin, documentation will go to usr/local/doc. Please make sure that the files contained in the tar file do not interfere with you local installation before you extract the tar file. The demo version will occasionally print barcode demo near the barcode. We offer a free 30 day trial license for extensive testing. No demo text will be printed using this trial license. Please contact us at techsupport2@ Installing a license To upgrade from a demo version to a licensed version, you must obtain a license key from e- bizco.com. The license file shall be stored as /etc/barcode.lic To upgrade to a new license, backup the existing /etc/barcode.lic and save the new license as /etc/barcode.lic Installing a newer version of covered by your license Any license obtained from entitles you to use newer versions of the released up to six month after the issue date of the license. To use this update feature, please download the newer version of barcode demo from and proceed as described under upgrading from demo to licensed version. To be eligible for upgrading, the new MUST be released within

14 Page 10 Page 10 for SAP R/3 six month after the issue date of your license or you will get an error message when installing a version that was released after that date. If you have purchased a license for with maintenance contract, you may install any covered newer version of the Linux Print Command The communicates with the host spool system via two commands. It uses the lpr command and the lpq command. The default settings are: with lpr -P '%P' -T '%T' -U '%U' -#%N lpq -L -P%P (printer long output format) lpq -P%P (printer short output format) lpq -L -P%P %I (job long output format) lpq -P%P %I (job short output format) %P Destination / Printername %T Title %U Owner %N Number of copies %I Job Id These command can be modified in the /etc/barcode.ini file (Version or newer): [LPD] lpr=lpr -P '%P' -T '%T' -U '%U' -#%N lpstat=lpq P%P lpstat_long=lpq L P%P lpstat_job=lpq P%P %I lpstat_job_long=lpq L P%P %I If your linux distribution has lpr-cups instead of lpr, you can either create a symbolic link for lpr or modify the barcode.ini Running the (Linux) Running as service The can be started at boot time using the usual /etc/rc config scripts. No parameters are required. The r xxxx can be used to change the control port from 1515 to xxxx Starting from inetd The can be run from the inetd daemon. Please insert this line to /etc/inetd.conf : 1515 stream tcp nowait root /usr/sbin/tcpd /usr/local/bin/pcl_barcode_server i To change the control port, change the 1515 to the desired port number. Please remember to restart inetd to activate the change. ( kill HUP ) Running as user program The can be run as pcl_barcode_server with no arguments. Option r allows you the change the default port of the server from 1515 to the value given.

15 Page 11 Page 11 for SAP R/ Logfile For trouble shooting, the logfile feature can be turned on. Please add these lines to the file /etc/barcode.ini: [LPD] LogEnabled=9 LogFile=/tmp/bcserver.log

16 Page 12 Page 12 for SAP R/3 4.3 Installation ( AIX version ) System Requirements Operating System: AIX Version 4.3 or newer This section describes the installation of our and also outlines the changes in your SAP R/3 system Licensed Version If you download the from the Internet, you will get a single installation set pcl_barcode_aix4_3-xxx.tar.compressed that contains the compressed installation set. Please use cd / uncompress < set pcl_barcode_aix4_3-xxx.tar.compressed tar xf - to install the software. (xxx is the current version and release number.) The program files will be installed in the directory usr/local/bin, documentation will go to usr/local/doc. Please make sure that the files contained in the tar file do not interfere with you local installation before you extract the tar file. Please save the license file, that you have received from us, as /etc/barcode.lic Demo Version If you download the from the Internet, you will get a single installation set pcl_barcode_aix4_3-xxx.tar.compressed that contains the compressed installation set. Please use cd / uncompress < pcl_barcode_aix4_3-xxx.tar.compressed tar xf - to install the software. (xxx is the current version and release number.) The program files will be installed in the directory usr/local/bin, documentation will go to usr/local/doc. Please make sure that the files contained in the tar file do not interfere with you local installation before you extract the tar file. The demo version will occasionally print barcode demo near the barcode. We offer a free 30 day trial license for extensive testing. No demo text will be printed using this trial license. Please contact us at techsupport2@ Installing a license To upgrade from a demo version to a licensed version, you must obtain a license key from e- bizco.com. The license file shall be stored as /etc/barcode.lic To upgrade to a new license, backup the existing /etc/barcode.lic and save the new license as /etc/barcode.lic Installing a newer version of covered by your license

17 Page 13 Page 13 for SAP R/3 Any license obtained from entitles you to use newer versions of the released up to six month after the issue date of the license. To use this update feature, please download the newer version of barcode demo from and proceed as described under upgrading from demo to licensed version. To be eligible for upgrading, the new MUST be released within six month after the issue date of your license or you will get an error message when installing a version that was released after that date. If you have purchased a license for with maintenance contract, you may install any covered newer version of the AIX Print Command The communicates with the host spool system via two commands. It uses the lpr command and the qchk command. The default settings are: lpr -P '%P' -T '%T' -U '%U' -#%N qchk -L P %P qchk P %P format) qchk -L P %P -# %I qchk P %P -# %I (printer long output format) (printer short output (job long output format) (job short output format) with %P Destination / Printername %T Title %U Owner %N Number of copies %I Job Id These command can be modified in the /etc/barcode.ini file (Version or newer): [LPD] lpr= lpr -P'%P' -T'%T' -#%N -h lpstat=qchk P %P lpstat_long=qchk -L P %P lpstat_job=qchk P %P -# %I lpstat_job_long=qchk -L P %P -# %I Running the (AIX) Running as service The can be started at boot time using the usual /etc/rc config scripts. No parameters are required. The r xxxx can be used to change the control port from 1515 to xxxx Starting from inetd The can be run from the inetd daemon. Add the required service name to your /etc/services: pclbarcode 1515/tcp Please insert this line to /etc/inetd.conf : pclbarcode stream tcp nowait root /usr/local/bin/pcl_barcode_server pcl_barcode_server i To change the control port, change the 1515 to the desired port number.

18 Page 14 Page 14 for SAP R/3 If you change the /etc/inetd.conf file, run the refresh -s inetd or kill - 1 InetdPID command to inform the inetd daemon of the changes to its configuration file Running as user program The can be run as pcl_barcode_server with no arguments. Option r allows you the change the default port of the server from 1515 to the value given Logfile For trouble shooting, the logfile feature can be turned on. Please add these lines to the file /etc/barcode.ini: [LPD] LogEnabled=9 LogFile=/tmp/bcserver.log

19 Page 15 Page 15 for SAP R/3 4.4 Installation ( SunOS / Solaris version, HPUX ) System Requirements Operating System: SunOS Version 5.8 / Solaris 8 or newer Operating System: HPUX 11 or newer This section describes the installation of our and also outlines the changes in your SAP R/3 system Licensed Version If you download the from the Internet, you will get a single installation set pcl_barcode_sun-xxx.tgz resp. pcl_barcode_hpux11-xxx.tgz that contains the compressed installation set. Please use cd / gzcat < pcl_barcode_sun-xxx.tgz tar xf - to install the software. (xxx is the current version and release number.) The program files will be installed in the directory usr/local/bin, documentation will go to usr/local/doc. Please make sure that the files contained in the tar file do not interfere with you local installation before you extract the tar file. Please save the license file, that you have received from us, as /etc/barcode.lic Demo Version If you download the from the Internet, you will get a single installation set pcl_barcode_sun-xxx.tgz resp. pcl_barcode_hpux11-xxx.tgz that contains the compressed installation set. Please use cd / gzcat < pcl_barcode_sun-xxx.tgz tar xf - to install the software. (xxx is the current version and release number.) The program files will be installed in the directory usr/local/bin, documentation will go to usr/local/doc. Please make sure that the files contained in the tar file do not interfere with you local installation before you extract the tar file. The demo version will occasionally print barcode demo near the barcode. We offer a free 30 day trial license for extensive testing. No demo text will be printed using this trial license. Please contact us at techsupport2@ Installing a license To upgrade from a demo version to a licensed version, you must obtain a license key from e- bizco.com. The license file shall be stored as /etc/barcode.lic To upgrade to a new license, backup the existing /etc/barcode.lic and save the new license as /etc/barcode.lic

20 Page 16 Page 16 for SAP R/ Installing a newer version of covered by your license Any license obtained from entitles you to use newer versions of the released up to six month after the issue date of the license. To use this update feature, please download the newer version of barcode demo from and proceed as described under upgrading from demo to licensed version. To be eligible for upgrading, the new MUST be released within six month after the issue date of your license or you will get an error message when installing a version that was released after that date. If you have purchased a license for with maintenance contract, you may install any covered newer version of the Solaris /HPUX Print Command The communicates with the host spool system via two commands. It uses the lp command and the lpstat command. The default settings are: lpr -P '%P' -T '%T' -U '%U' -#%N lpstat -p%p lpstat -p%p lpstat -p%p o %I lpstat -p%p o %I (printer long output format) (printer short output format) (job long output format) (job short output format) with %P Destination / Printername %T Title %U Owner %N Number of copies %I Job Id These command can be modified in the /etc/barcode.ini file (Version or newer): [LPD] lpr= lpr -P'%P' -T'%T' -#%N -h lpstat= lpstat -p%p lpstat_long= lpstat -p%p lpstat_job= lpstat -p%p -o %I lpstat_job_long= lpstat -p%p -o %I Running the ( SunOS /Solaris, HPUX ) Running as service The can be started at boot time using the usual /etc/rc config scripts. No parameters are required. The r xxxx can be used to change the control port from 1515 to xxxx Starting from inetd The can be run from the inetd daemon. Add the required service name to your /etc/services: pclbarcode 1515/tcp Please insert this line to /etc/inetd.conf :

21 Page 17 Page 17 for SAP R/3 pclbarcode stream tcp nowait root /usr/local/bin/pcl_barcode_server pcl_barcode_server i To change the control port, change the 1515 to the desired port number. If you change the /etc/inetd.conf file, run the refresh -s inetd or kill -1 InetdPID command to inform the inetd daemon of the changes to its configuration file Running as user program The can be run as pcl_barcode_server with no arguments. Option r allows you the change the default port of the server from 1515 to the value given Logfile For trouble shooting, the logfile feature can be turned on. Please add these lines to the file /etc/barcode.ini: [LPD] LogEnabled=9 LogFile=/tmp/bcserver.log

22 Page 18 Page 18 for SAP R/3 4.5 Installation (SAP) Device type The device type describes the capabilities of a printer type and how to interact with it. The is designed to insert barcodes into the data stream of a laserjet compatible page printer. Current SAP versions are aware of our. SAP added s to the following device types: HPLJ4 HPLJ5 HPLJ5SI HPLJ1100 HPLJ4000 HPLJ8000 HPLJIIID LEXUTF8 You can use these unmodified device types. Please note, that the 2D PLUS does support a lot more barcodes than the predefined SAP bar codes. If you do modify the barcode related print controls or add new barcodes, please copy the device type before doing any modifications. Use a name like ZHPLJ4 for your version.

23 Page 19 Page 19 for SAP R/ Setup your printer with transaction SPAD The is running on a Windows PC, Linux x86, AIX, HPUX or Solaris. It can be installed a service or run in user mode. It translates barcode calls from SAP into printer compatible data. To use the, please define your printer inside SAP using transaction SPAD. Use one of the supported device types ( see section 4.5 ) and use access method U. The host printer is the local or remote printer name as this windows pc expects it, e.g. //host/printer. The remote printer port is 1515 unless changed at the pcl_barcode_server start.

24 Page 20 Page 20 for SAP R/3 5 Printing barcodes from the SAP system 5.1 format is a printer language, used on HP laserjets and other printers. It is widely adopted across the industry. All barcode printer command sequences begin with an escape character ( hex value 1B, visualized as <ESC> ) and two command characters, which select the command group. One or more parameters and a command character follow these. Examples: Command Result <ESC>(s24670T Select barcode Code 39. (s is the command group, is the parameter to the command T <ESC>(s1P Select No annotation. (s is the command group, 1 is the parameter to command P. <ESC>(s5,10B Defines the bar width to be 5 and 10 pixels. Parameters are numeric, commands are represented by a letter. Uppercase letters terminate a printer command sequence, lowercase letters indicates another parameter and command will follow: Command <ESC>(s1p24670T <ESC>(s1p5,10b24670T Result Select barcode Code 39 with no annotation, (s is the command group. 1p is the first command, the second command. Select barcode Code 39 with no annotation. The small bar is 5 pixel wide, the thicker bar is 10 pixel.

25 Page 21 Page 21 for SAP R/ General Commands for all s T Select barcode After sending a T command in the command group (s, subsequent data will be encoded as barcode data. The barcode data will be terminated by another T command using one of the printer font ids. Number Selected Code Code 128, Subset A Code 128, Subset B Code 128, Subset C Code 2 of 5 Industrial Code 2 of 5 Industrial w. checksum Code 2 of 5 Matrix Code 2 of 5 Matrix w. checksum Code 2 of 5 Interleaved Code 2 of 5 Interleaved w. checksum ITF-14 w. checksum Code Code 39 w. checksum Code 39 Extended Code 39 Extended w. checksum Code 93 w. checksum Code 93 Extended w. checksum Code 16K Code 16K, Subset A Code 16K, Subset B Code 16K, Subset C Code Codabar Codabar w. checksum Data Matrix EAN 128 w. checksum EAN EAN Zusatzzeichen EAN Zusatzeichen EAN EAN Zusatzzeichen EAN Zusatzeichen Maxicode MSI Plessey w. Mod 10 checksum

26 Page 22 Page 22 for SAP R/3 Number Selected MSI Plessey w. Mod 10 and Mod10 checksum MSI Plessey w. Mod 10 and Mod 11 checksum PDF PDF 417 Truncated PDF 417 Micro Post Ident ( German Postal 2/5 Leitcode 13 ) Post Ident ( German Postal 2/5 Identcode 11 ) QR Code UCC UPCA UPCA + 2 Zusatzzeichen UPCA + 5 Zusatzzeichen UPCE UPCE + 2 Zusatzzeichen UPCE + 5 Zusatzzeichen 24770,24771,24772 ZIP Postnet 5, 9 and 11 digits P Annotation The bar code annotation can be controlled by the P command. Legal values are: Value Command 1 Off 2 Inside the lower edge of the barcode. 3 Partly inside the lower edge of the barcode. 4 Below the barcode. 5 Above the barcode. This code is licensed separately. This code is licensed separately. This code is licensed separately.

27 Page 23 Page 23 for SAP R/ B Bar Width s are composed of bars with different width. You can specify the width of the smallest bar as the first parameter to the B command. The width of the next wider bar can be specified as the second parameter. If the barcode has more than two barcode width, the next values are computed automatically. Example: <ESC>(s6,12B will set the bar width to 6 and 12 pixels S Gap Width s are composed of bars and gaps of different width. You can specify the width of the smallest gap as the first parameter to the S command. The width of the next wider gap can be specified as the second parameter. If the barcode has more than two barcode gap width, the next values are computed automatically. Gap width will normally follow the corresponding bar width. Example: <ESC>(s6,12S will set the gap width to 6 and 12 pixels V Bar Height The height of a regular bar is specified. The height is given in 1/72 inch. Example: <ESC>(s36V will set the bar height to ½ inch Horizontal and vertical Position The horizontal and vertical position is set using usual positioning commands, e.g. <ESC>&a100h200V will position the cursor at 100 deci points horizontal and 200 deci points vertical EAN 128 / Code 128 Parameters EAN 128 and Code 128 allow these special characters to signal functions: FNC1 Decimal 129 (Hex 81) FNC2 Decimal 130 (Hex 82) FNC3 Decimal 131 (Hex 83) FNC4 Decimal 132 (Hex 84) These characters are embedded into the barcode data.

28 Page 24 Page 24 for SAP R/ QR Code Parameters The QR Code will use the P command [ Esc(s#P ] to specify the security level, FNC1 mode and barcode size: Value Security level for error correction: 0 M ( about 15 % redundancy ) 1 L ( about 7% redundancy ) 2 M ( about 15 % redundancy ) 3 Q ( about 25 % redundancy ) 4 H ( about 30 % redundancy ) Value FNC1 mode: 0 No FNC1 implied 10 FNC1 implied before data, use % for addtl FNC1 s Value Security level for error correction: 0 Find optimal size 100 Format 1: 21 x 21 modules 200 Format 2: 25 x 25 modules 300 Format 3: 29 x 29 modules 4000 Format 40: 177 x 177 modules These values can be added to specify more than one QR Code parameter. The S parameter [ Esc(s#S ] is used to change the encoding: Value Encoding: 0 Find optimal encoding 1 Numeric ( digits only, highly compressed ) 2 Alphanumeric only ( 0-9 A-Z + - * / %. : ) 3 Byte values ( 0x00 0xff ), encodes double byte characters without optimization 4 Kanji ( optimized encoding for Japanese double byte characters ) The B Parameter [ Esc(s#B ] specifies the module size ( dot size ) in 1/600 inch.

29 Page 25 Page 25 for SAP R/ PDF 417 Parameters The code PDF417 will use the P command to specify the security: Value Number of bytes added for security and error correction: (Default) Values of 1000 to 1400 indicate a relative security of 0 to 400 % of the data. The exact security level will be computed automatically. The B parameter [ Esc(s#1,#2,#3,#4B ] specifies the maximum number of row and columns for the PDF 417 code. # Usage 1 Row count 2 Column count 3 =0: row and column count are maximum values (default) =1: row and column count are the desired row and column counts. 4 =0: Standard PDF 417 (default ) =1: Truncated PDF termination After a barcode font is selected, printable text is collected until a termination character is found. Termination characters are CR (hex 0D, carriage return), LF ( hex 0A, line feed), FF (hex 0C, form feed) or ESC (hex 1B, Escape). Number only barcodes are terminated by SP (hex 20, space) also. Whenever a barcode is terminated, the collected data is converted into the corresponding barcode and printed on the page. If more printable characters are following after the termination character, a new barcode starts. Empty barcodes with no printable data are suppressed. Example: <ESC>(s4p100h40v10,20b10,20s24700THELLO<ESC>0NWORLD<ESC>(s3T This creates two separate barcodes Rotation The barcode can be rotated using the regular rotation command: <ESC>&a#P with # = 0,90,180 and 270.

30 Page 26 Page 26 for SAP R/ Embedded control characters If you need to include terminating control characters into the barcode, the complete character sequence must be send using transparent data mode. The sequence for transparent data is <Esc>&p#X where # is the number of bytes to print transparently. Example: <ESC>(s4p100h40v10,20b10,20s24700T<ESC>&p11XLine1<CR>Line2<ESC>c(s3T

31 Page 27 Page 27 for SAP R/3 6 Defining s in SAPscript and SmartForms 6.1 Create your own device type SAP has included the support for our into several decive types, e.g. HPLJ5, HPLJ4000. If you do need more barcodes than predefined or if you need a different device type, you can copy a matching device type and add the required print controls. You can do this from within the transaction SPAD. Use the menu entry Utilities/copy device type. We recommend to use the device type HPLJ4000 as template Create System Start Transaction SE73 Select System, Press Change Press Create.

32 Page 28 Page 28 for SAP R/3 Some versions of SAP have two barcode technologies implemented. SAPScript always requires the so called "old" technology. This dialog does not show up on all releases. Fill the Popup with your chosen values. This example creates the new System ZPDF417. Press Execute. If you get a popup asking for a Workbench job: Select an appropriate job or cancel for local testing Create Printer The printer barcodes describes the necessary actions for a given printer type. If you have not created your own device type, it s now time to do it. ( Transaction SPAD, copy HPLJ4000 to ZPLJ4000 ).

33 Page 29 Page 29 for SAP R/3 Start Transaction SE73. Select Printer Bar Codes, press Change, double click on your device type.

34 Page 30 Page 30 for SAP R/3 Choose a free prefix and suffix from the list, e.g. SBP98 and SBS98. For some device types a common suffix SBS01 is used for all SBPxx. That one will usually work for your print control too. Press Create. Select your newly created system barcode (ZPDF417) and fill the prefix and suffix fields. The prefix and suffix will be the names of the used print controls to create the barcode. Press Execute.

35 Page 31 Page 31 for SAP R/3 If you get this warning : Select New Entry and continue. Now we need to fill the new print control: Select your prefix ( e.g. SBP98) and press Maint. Print Control.

36 Page 32 Page 32 for SAP R/3 Turn off the Hex switch ( fill with blank). If you get Variant 1, you need to start the Control Char. Seq with \e(s, Variant 5 starts with (s only. If you don't use the common suffix SBS01, you often can copy the value of SBS01 to your new suffix SBS98: 6.2 Create a simple Test with SmartForms Used To include a barcode type into SmartForm, you need to make sure that this is a defined System ( Transaction SE73 ) and that a correct print control is defined for each target device types Used Style Make sure to have an appropriate style at hand. For testing, you might want to copy the style SYSTEM to a local Z_TEST1 using Transaction SMARTFORMS.

37 Page 33 Page 33 for SAP R/3

38 Page 34 Page 34 for SAP R/3 Right click on Character Formats and choose Create Node. Select a short name for the format, e.g. BA, B1 or DM (this example). Choose the System in the lower section ( ZDATAMTX ) and fill the description field. Save and ACTIVATE. You now have a style where you can use your new barcode.

39 Page 35 Page 35 for SAP R/3 6.3 Create your form Start the form builder, select your new form name, press Create. Double click on Form Attributes, select Output Options : Make sure to use your new style (here Z_TEST1 ). Insert your text into the form. Highlight the test data (or the SAPScript variable), that should be printed as barcode. Please make sure not to highlight anything else! No leading or trailing blanks or line wraps are allowed to be highlighted here!

40 Page 36 Page 36 for SAP R/3 Select your new character format ( DM in this example ). Save and activate. To print the form: Hit F8 three times, then select print:

41 Page 37 Page 37 for SAP R/3 7 Version History 5.1 Bugfix: Data Matrix code generation error for binary data 5.0 Support for Windows 8 / Bugfix: macros parsing error Bugfix: Data Matrix code generation error with encoding C Support for Windows 7 (Windows version) Include checksum in the annotation if barcode ITF-14. Additional diagnostic information for trouble shooting (Windows version) licensing is based on hostname now (Windows version) New : ITF-14, a 2 of 5 interleave variant, id Bugfix: Data Matrix encoding in automode used occasionally the wrong switch sequence between different encoding modes. Bugfix: PDF417 on HPUX and AIX had an encoding error. 4.0 (internal) Codemerge with DLL 8 More Information / Contact Please contact us at Up'n Hoff 1 D Großhansdorf Germany Web: Info2@ Phone: Fax:

42 Page 38 Page 38 for SAP R/3 9 Appendix Hex Table Hexcode Character Hexcode Character Hexcode Character Hexcode Character 0 NUL 20 space 60 ` 1 SOH 21! 41 A 61 a 2 STX 22 " 42 B 62 b 3 ETX 23 # 43 C 63 c 4 EOT 24 $ 44 D 64 d 5 ENQ 25 % 45 E 65 e 6 ACK 26 & 46 F 66 f 7 BEL 27 ' 47 G 67 g 8 BS 28 ( 48 H 68 h 9 HAT 29 ) 49 I 69 i A LF 2A * 4A J 6A j B VT 2B + 4B K 6B k C FF 2C, 4C L 6C l D CR 2D - 4D M 6D m E SO 2E. 4E N 6E n F ST 2F / 4F O 6F o 10 SLE P 70 p 11 CS Q 71 q 12 DC R 72 r 13 DC S 73 s 14 DC T 74 t 15 NAK U 75 u 16 SYN V 76 v 17 ETB W 77 w 18 CAN X 78 x 19 EM Y 79 y 1A STB 3A : 5A Z 7A z 1B ESC 3B ; 5B [ 7B { 1C FS 3C < 5C \ 7C 1D GS 3D = 5D ] 7D } 1E RS 3E > 5E ^ 7E ~ 1F US 3F? 5F _ 7F

43 Page 39 Page 39 for SAP R/3 10 Specifications Data Matrix Character set: Checksum: ID: Required licence: Complete ASCII or numeric information Intergrated high quality error correction C=DM Plus Remarks: High Density (about 15 times higher than linear barcodes). Encodes up to 2334 ASCII characters ( 7bit), 1558 ASCII characters ( 8 bit) or 3116 digits. Requires special optical readers. Can be read from any direction. Implemented ECC200 error correction allows reading of highly damaged codes. PDF 417 Character set: Checksum: ID: Complete ASCII or numeric information Intergrated high quality error correction C=PDF417 Required licence: Plus Remarks: High density barcode, encodes up to 1850 ASCII characters or 2710 digits. Requires special optical readers. Can be read from any direction. The degree of possible error correction can be selected but uses additional space on the print out.

44 Page 40 Page 40 for SAP R/3 Maxicode Character set: Checksum: ID: Required licence: 0-9A-Z Yes C=MAXI Maxicode Remarks: UPS packet labeling Code 16K Character set: Checksum: ID: Required licence: Complete ASCII or numeric information Yes C=C16K Plus Remarks: Stacked 2-D barcode, encodes up to 77 ASCII characters or 154 digits. Code 49 Character set: Checksum: ID: Required licence: Complete ASCII or numeric information Yes C=C49 Plus Remarks: Stacked 2-D barcode

45 Page 41 Page 41 for SAP R/3 Code 128 Character set: Checksum: 7 Bit ASCII Yes ID: C=128 Required licence: Classic or Plus Remarks: Complete 7 Bit ASCII character set, high density, low error resistance. Code 39 Character set: A-Z $ / + % and space Checksum: Optional ID: C=39 Required licence: Classic or Plus Remarks: Robust code, low density for upper case letters and digits. Code 39 extended Character set: Checksum: ID: Required licence: Full 7 Bit ASCII Optional C=39X Classic or Plus Remarks: Very low density code, most characters are encodes by two code 39 characters.

46 Page 42 Page 42 for SAP R/3 Code 93 Character set: A-Z * $ / + % and space Checksum: Optional ID: C=93 Required licence: Classic or Plus Remarks: Robust code, low density for upper case letters and digits. Code 93 extended Character set: Checksum: ID: Required licence: Full 7 Bit ASCII Optional C=93X Classic or Plus Remarks: Robust, low density. Code 2 of 5 Industrial Character set: Checksum: ID: Required licence: Digits only Optional C=25I Classic or Plus Remarks: Robust, low density code for digits ONLY.

47 Page 43 Page 43 for SAP R/3 Code 2 of 5 Interleaved Character set: Checksum: ID: Required licence: Digits only Optional C=25L Classic or Plus Remarks: Robust code for digits ONLY. Requires even number of digits without checksum or odd number of digits plus checksum. A 0 digit will otherwise be placed in front of the data. Higher density than 2 of 5 Industrial and 2 of 5 Matrix. Code 2 of 5 Matrix Character set: Checksum: ID: Required licence: Digits only Optional C=25M Classic or Plus Remarks: Robust code for digits ONLY. Higher density than 2 of 5 Industrial.

48 Page 44 Page 44 for SAP R/3 11 QR Code data capacity Format Error Correction Level Data capacity format 1-8 Numeric Alphanumeric 8-bit Byte Kanji L M Q H L M Q H L M Q H L M Q H L M Q H L M Q H L

49 Page 45 Page 45 for SAP R/3 7 M Q H L M Q H L M Q H L M Q H L M Q H L M Q H L M Q H L M Q

50 Page 46 Page 46 for SAP R/3 H L M Q H L M Q H L M Q H L M Q H L M Q H L M Q H L M Q H L

51 Page 47 Page 47 for SAP R/3 M Q H L M Q H L M Q H L M Q H L M Q H L M Q H L M Q H L M Q

52 Page 48 Page 48 for SAP R/3 H L M Q H L M Q H L M Q H L M Q H L M Q H L M Q H L M Q H L