Pcl Barcode Manual

59
PCL Barcode Server PCL Barcode Server PLUS Version 4.2.5 e-bizco.com GmbH Includes Information for usage with the SAP R/3 System Version November 03, 2011 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 PCL are registered trademarks of Hewlett-Packard Corporation USA Other product or company names mentioned may be trademarks of their respective owners.

Transcript of Pcl Barcode Manual

Page 1: Pcl Barcode Manual

PCL Barcode Server PCL Barcode Server PLUS

Version 4.2.5

e-bizco.com GmbH

Includes Information for usage

with the SAP R/3 System

Version November 03, 2011

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 PCL are registered trademarks of Hewlett-Packard Corporation USA Other product or company names mentioned may be trademarks of their respective owners.

Page 2: Pcl Barcode Manual
Page 3: Pcl Barcode Manual

Table of Contents

1 Smart Barcoding ..............................................................................................................3

2 Installation Quick Guide .................................................................................................4

2.1 Windows Quick Guide with SAP........................................................................................4

2.2 Linux Quick Guide with SAP ..............................................................................................4

3 Barcode Overview ...........................................................................................................5

4 Installation ........................................................................................................................6

4.1 Windows version ...............................................................................................................6

4.1.1 System Requirements .......................................................................................................6

4.1.2 PCL Barcode Server ..........................................................................................................6

4.1.2.1 Licensed Version .............................................................................................................. 6

4.1.2.2 Demo Version ................................................................................................................... 6

4.1.2.3 Upgrade from demo to a licensed Version ....................................................................... 7

4.1.2.4 Upgrade from "1D Classic" to "2D Plus" ........................................................................... 7

4.1.2.5 Installing a newer version of PCL Barcode Server covered by your license .................... 8

4.1.3 Running the PCL Barcode Server .....................................................................................8

4.1.3.1 Running as service ........................................................................................................... 8

4.1.3.2 Running as user program ................................................................................................. 8

4.1.3.3 Logfile ............................................................................................................................... 8

4.2 Installation ( Linux version ) ...............................................................................................9

4.2.1 System Requirements .......................................................................................................9

4.2.2 PCL Barcode Server ..........................................................................................................9

4.2.2.1 Licensed Version .............................................................................................................. 9

4.2.2.2 Demo Version ................................................................................................................... 9

4.2.2.3 Installing a license ............................................................................................................ 9

4.2.2.4 Installing a newer version of PCL Barcode Server covered by your license .................... 9

4.2.2.5 Linux Print Command ..................................................................................................... 10

4.2.3 Running the PCL Barcode Server (Linux) .......................................................................10

4.2.3.1 Running as service ......................................................................................................... 10

4.2.3.2 Starting from inetd .......................................................................................................... 10

4.2.3.3 Running as user program ............................................................................................... 10

4.2.3.4 Logfile ............................................................................................................................. 11

4.3 Installation ( AIX version ) ................................................................................................12

4.3.1 System Requirements .....................................................................................................12

4.3.2 PCL Barcode Server ........................................................................................................12

4.3.2.1 Licensed Version ............................................................................................................ 12

4.3.2.2 Demo Version ................................................................................................................. 12

4.3.2.3 Installing a license .......................................................................................................... 12

4.3.2.4 Installing a newer version of PCL Barcode Server covered by your license .................. 12

4.3.2.5 AIX Print Command ........................................................................................................ 13

4.3.3 Running the PCL Barcode Server (AIX) ..........................................................................13

Page 4: Pcl Barcode Manual

4.3.3.1 Running as service ......................................................................................................... 13

4.3.3.2 Starting from inetd .......................................................................................................... 13

4.3.3.3 Running as user program ............................................................................................... 14

4.3.3.4 Logfile ............................................................................................................................. 14

4.4 Installation ( SunOS / Solaris version, HPUX ) ................................................................15

4.4.1 System Requirements .....................................................................................................15

4.4.2 PCL Barcode Server ........................................................................................................15

4.4.2.1 Licensed Version ............................................................................................................ 15

4.4.2.2 Demo Version ................................................................................................................. 15

4.4.2.3 Installing a license .......................................................................................................... 15

4.4.2.4 Installing a newer version of PCL Barcode Server covered by your license .................. 16

4.4.2.5 Solaris /HPUX Print Command....................................................................................... 16

4.4.3 Running the PCL Barcode Server ( SunOS /Solaris, HPUX ) .........................................16

4.4.3.1 Running as service ......................................................................................................... 16

4.4.3.2 Starting from inetd .......................................................................................................... 16

4.4.3.3 Running as user program ............................................................................................... 17

4.4.3.4 Logfile ............................................................................................................................. 17

4.5 Installation (SAP) .............................................................................................................18

4.5.1 Device type ......................................................................................................................18

4.5.2 Setup your printer with transaction SPAD .......................................................................19

5 Printing barcodes from the SAP system .....................................................................20

5.1 PCL Barcode format ........................................................................................................20

5.1.1 General Commands for all Barcodes ..............................................................................21

5.1.2 “T” Select barcode ...........................................................................................................21

5.1.3 “P” Annotation ..................................................................................................................22

5.1.4 “B” Bar Width ...................................................................................................................23

5.1.5 “S” Gap Width ..................................................................................................................23

5.1.6 “V” Bar Height ..................................................................................................................23

5.1.7 Horizontal and vertical Position .......................................................................................23

5.1.8 EAN 128 / Code 128 Parameters ....................................................................................23

5.1.9 QR Code Parameters ......................................................................................................24

5.1.10 PDF 417 Parameters .......................................................................................................25

5.1.11 Barcode termination ........................................................................................................25

5.1.12 Rotation ...........................................................................................................................25

5.1.13 Embedded control characters..........................................................................................26

6 Defining Barcodes in SAPscript and SmartForms .....................................................27

6.1 Create your own device type ...........................................................................................27

6.1.1 Create System Barcode ..................................................................................................27

6.1.2 Create Printer Barcode ....................................................................................................28

6.2 Create a simple Barcode Test with SmartForms.............................................................32

6.2.1 Used Barcode ..................................................................................................................32

Page 5: Pcl Barcode Manual

6.2.2 Used Style .......................................................................................................................32

6.3 Create your form ..............................................................................................................35

7 Version History ..............................................................................................................37

8 More Information / Contact ...........................................................................................37

9 Appendix Hex Table ......................................................................................................38

10 Barcode Specifications .................................................................................................39

11 QR Code data capacity .................................................................................................44

12 ISO 3166 Codes (Country Codes) ................................................................................49

Page 6: Pcl Barcode Manual
Page 7: Pcl Barcode Manual

© e-bizco.com GmbH PCL Barcode Server Page 3 Copyright 2002-2011

© e-bizco.com GmbH PCL Barcode Server Page 3 Copyright 2002-2011 for SAP R/3

1 Smart Barcoding

Our Software PCL Barcode Server dramatically reduces your costs to print barcodes. You do not need any hardware extension for your printer. You can replace broken printers with another PCL 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 PCL Barcode Server 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 PCL Barcode Server 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 5.1.2 Almost any barcode allows you to specify parameters and options. Our PCL Barcode Server allows you to define

The size of the printed barcode.

Rotation of barcodes.

Rows and columns for 2D Barcodes

Error correction mode, redundancy.

Structured data for Data Matrix. For a complete list, please refer to section 5.1.1 This combination of support by SAP R/3 and customizing makes our PCL Barcode Server really unique. Our online and always up to date trouble shooting section on our web site will help you in case of problems: http://www.e-bizco.com/english/support.phtml . You are also welcome to contact us at [email protected] for free support.

Page 8: Pcl Barcode Manual

© e-bizco.com GmbH PCL Barcode Server Page 4 Copyright 2002-2011

© e-bizco.com GmbH PCL Barcode Server Page 4 Copyright 2002-2011 for SAP R/3

2 Installation Quick Guide

To install our PCL Barcode Server, 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 PCL Barcode Server from http://www.e-bizco.com

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 1515.

2.2 Linux Quick Guide with SAP

Download the most recent version of the PCL Barcode Server from http://www.e-bizco.com

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.

Page 9: Pcl Barcode Manual

© e-bizco.com GmbH PCL Barcode Server Page 5 Copyright 2002-2011

© e-bizco.com GmbH PCL Barcode Server Page 5 Copyright 2002-2011 for SAP R/3

3 Barcode 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 PCL Barcode Server 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 PCL Barcode Server will integrate the barcode into the current document. The PCL Barcode Server 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 PCL Barcode Server 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 PCL Barcode Server is available on Linux, HPUX, AIX and Windows 95/98/2000/NT. The configuration of the PCL Barcode Server is done from within the SAP system. e-bizco.com GmbH supplies two PCL Barcode Server: 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 “Barcode DLL for SAP” that prints bar codes on any windows printer.

Page 10: Pcl Barcode Manual

© e-bizco.com GmbH PCL Barcode Server Page 6 Copyright 2002-2011

© e-bizco.com GmbH PCL Barcode Server Page 6 Copyright 2002-2011 for SAP R/3

4 Installation

4.1 Windows version

4.1.1 System Requirements

SAP Release 2.x, 3.x, 4.x and newer versions using Unix, Windows, OS/400 Operating System: Windows Server 2003, 2008, 2008 R2 / Vista / Windows 7 / Windows 2000 / XP

4.1.2 PCL Barcode Server

This section describes the installation of our PCL Barcode Server and also outlines the changes in your SAP R/3 system.

4.1.2.1 Licensed Version

If you download the PCL Barcode Server for Windows from the Internet at http://www.e-bizco.com/, 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, PCL_BARCODE_SERVER.EX_ and other auxiliary files. If you received a CD from e-bizco.com GmbH, these files can be found on the disk. The required license key will be sent to you as email, by fax or on CD. Please save the email 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 PCL Barcode Server on your system, please run the supplied program

SETUP.EXE from the installation set. Windows Server 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.

4.1.2.2 Demo Version

If you download the PCL Barcode Server 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, PCL_BARCODE_SERVER.EX_ and other auxiliary files. To install the PCL Barcode Server 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 Server 2008 / Vista or newer: Please use right-click

“Run as Administrator” even if your account has Administrator privileges.

Page 11: Pcl Barcode Manual

© e-bizco.com GmbH PCL Barcode Server Page 7 Copyright 2002-2011

© e-bizco.com GmbH PCL Barcode Server Page 7 Copyright 2002-2011 for SAP R/3

4.1.2.3 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 GmbH. You may download the most recent version the PCL Barcode Server from the Internet at http://www.e-bizco.com. 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, PCL_BARCODE_SERVER.EX_ and other auxiliary files. If you received a CD from e-bizco.com GmbH, these files can be found on the disk. The required license key will be sent to you as email, by fax or on floppy disk. Please save the email 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 PCL Barcode Server to your system, please run the supplied program

SETUP.EXE from the installation set. Windows Server 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.

4.1.2.4 Upgrade from "1D Classic" to "2D Plus"

To upgrade from a licensed “1D Classic” PCL Barcode Server version to a licensed PCL Barcode Server “2D Plus”, you must obtain a license key for the "2D Plus" version from e-bizco.com GmbH. You may download the most recent version the PCL Barcode Server from the Internet at http://www.e-bizco.com. 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, PCL_BARCODE_SERVER.EX_ and auxiliary files. If you received a CD from e-bizco.com GmbH, these files can be found on the disk. The required license key will be sent to you as email, by fax or on floppy disk. Please save the email 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 PCL Barcode Server to your system, please run the supplied program

SETUP.EXE from the installation set. Windows Server 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.

Page 12: Pcl Barcode Manual

© e-bizco.com GmbH PCL Barcode Server Page 8 Copyright 2002-2011

© e-bizco.com GmbH PCL Barcode Server Page 8 Copyright 2002-2011 for SAP R/3

4.1.2.5 Installing a newer version of PCL Barcode Server covered by your

license

Any license obtained from e-bizco.com GmbH entitles you to use newer versions of the PCL Barcode Server 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 http://www.e-bizco.com and proceed as described under “upgrading from demo to licensed version”. To be eligible for upgrading, the new PCL Barcode Server 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 PCL Barcode Server with maintenance contract, you may

install any covered newer version of the PCL Barcode Server.

4.1.3 Running the PCL Barcode Server

4.1.3.1 Running as service

The PCL Barcode Server can be installed as service in Windows. Installing the PCL Barcode Server can be done by running the program PCL_BARCODE_SERVER with the argument –i . The PCL Barcode Server 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 PCL_BARCODE_SERVER –u after shutting the service down from the computer control.

4.1.3.2 Running as user program

The PCL Barcode Server 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.

4.1.3.3 Logfile

For trouble shooting, the logfile feature can be turned on. Please add these lines to the file C:\Windows\Barcode.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.

Page 13: Pcl Barcode Manual

© e-bizco.com GmbH PCL Barcode Server Page 9 Copyright 2002-2011

© e-bizco.com GmbH PCL Barcode Server Page 9 Copyright 2002-2011 for SAP R/3

4.2 Installation ( Linux version )

4.2.1 System Requirements

Operating System: Linux Kernel 2.6.x or newer

4.2.2 PCL Barcode Server

This section describes the installation of our PCL Barcode Server and also outlines the changes in your SAP R/3 system.

4.2.2.1 Licensed Version

If you download the PCL Barcode Server 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

4.2.2.2 Demo Version

If you download the PCL Barcode Server 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 [email protected]

4.2.2.3 Installing a license

To upgrade from a demo version to a licensed version, you must obtain a license key from e-bizco.com GmbH. 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

4.2.2.4 Installing a newer version of PCL Barcode Server covered by your

license

Any license obtained from e-bizco.com GmbH entitles you to use newer versions of the PCL Barcode Server 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 http://www.e-bizco.com and proceed as described under “upgrading from demo to licensed version”. To be eligible for upgrading, the new PCL Barcode Server MUST be released within

Page 14: Pcl Barcode Manual

© e-bizco.com GmbH PCL Barcode Server Page 10 Copyright 2002-2011

© e-bizco.com GmbH PCL Barcode Server Page 10 Copyright 2002-2011 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 PCL Barcode Server with maintenance contract, you may install any covered newer version of the PCL Barcode Server.

4.2.2.5 Linux Print Command

The PCL Barcode Server communicates with the host spool system via two commands. It uses the lpr command and the lpq command. The default settings are:

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)

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 3.6.3 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.

4.2.3 Running the PCL Barcode Server (Linux)

4.2.3.1 Running as service

The PCL Barcode Server 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.

4.2.3.2 Starting from inetd

The PCL Barcode Server 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 )

4.2.3.3 Running as user program

The PCL Barcode Server 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.

Page 15: Pcl Barcode Manual

© e-bizco.com GmbH PCL Barcode Server Page 11 Copyright 2002-2011

© e-bizco.com GmbH PCL Barcode Server Page 11 Copyright 2002-2011 for SAP R/3

4.2.3.4 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

Page 16: Pcl Barcode Manual

© e-bizco.com GmbH PCL Barcode Server Page 12 Copyright 2002-2011

© e-bizco.com GmbH PCL Barcode Server Page 12 Copyright 2002-2011 for SAP R/3

4.3 Installation ( AIX version )

4.3.1 System Requirements

Operating System: AIX Version 4.3 or newer

4.3.2 PCL Barcode Server

This section describes the installation of our PCL Barcode Server and also outlines the changes in your SAP R/3 system.

4.3.2.1 Licensed Version

If you download the PCL Barcode Server 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

4.3.2.2 Demo Version

If you download the PCL Barcode Server 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 [email protected]

4.3.2.3 Installing a license

To upgrade from a demo version to a licensed version, you must obtain a license key from e-bizco.com GmbH. 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

4.3.2.4 Installing a newer version of PCL Barcode Server covered by your

license

Page 17: Pcl Barcode Manual

© e-bizco.com GmbH PCL Barcode Server Page 13 Copyright 2002-2011

© e-bizco.com GmbH PCL Barcode Server Page 13 Copyright 2002-2011 for SAP R/3

Any license obtained from e-bizco.com GmbH entitles you to use newer versions of the PCL Barcode Server 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 http://www.e-bizco.com and proceed as described under “upgrading from demo to licensed version”. To be eligible for upgrading, the new PCL Barcode Server 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 PCL Barcode Server with maintenance contract, you may install any covered newer version of the PCL Barcode Server.

4.3.2.5 AIX Print Command

The PCL Barcode Server 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 (printer long output format)

qchk –P %P (printer short output

format) qchk -L –P %P -# %I (job long output format)

qchk –P %P -# %I (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 3.6.3 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

4.3.3 Running the PCL Barcode Server (AIX)

4.3.3.1 Running as service

The PCL Barcode Server 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.

4.3.3.2 Starting from inetd

The PCL Barcode Server 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.

Page 18: Pcl Barcode Manual

© e-bizco.com GmbH PCL Barcode Server Page 14 Copyright 2002-2011

© e-bizco.com GmbH PCL Barcode Server Page 14 Copyright 2002-2011 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.

4.3.3.3 Running as user program

The PCL Barcode Server 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.

4.3.3.4 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

Page 19: Pcl Barcode Manual

© e-bizco.com GmbH PCL Barcode Server Page 15 Copyright 2002-2011

© e-bizco.com GmbH PCL Barcode Server Page 15 Copyright 2002-2011 for SAP R/3

4.4 Installation ( SunOS / Solaris version, HPUX )

4.4.1 System Requirements

Operating System: SunOS Version 5.8 / Solaris 8 or newer Operating System: HPUX 11 or newer

4.4.2 PCL Barcode Server

This section describes the installation of our PCL Barcode Server and also outlines the changes in your SAP R/3 system.

4.4.2.1 Licensed Version

If you download the PCL Barcode Server 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

4.4.2.2 Demo Version

If you download the PCL Barcode Server 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 [email protected]

4.4.2.3 Installing a license

To upgrade from a demo version to a licensed version, you must obtain a license key from e-bizco.com GmbH. 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

Page 20: Pcl Barcode Manual

© e-bizco.com GmbH PCL Barcode Server Page 16 Copyright 2002-2011

© e-bizco.com GmbH PCL Barcode Server Page 16 Copyright 2002-2011 for SAP R/3

4.4.2.4 Installing a newer version of PCL Barcode Server covered by your

license

Any license obtained from e-bizco.com GmbH entitles you to use newer versions of the PCL Barcode Server 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 http://www.e-bizco.com and proceed as described under “upgrading from demo to licensed version”. To be eligible for upgrading, the new PCL Barcode Server 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 PCL Barcode Server with maintenance contract, you may install any covered newer version of the PCL Barcode Server.

4.4.2.5 Solaris /HPUX Print Command

The PCL Barcode Server 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 (printer long output format)

lpstat -p%P (printer short output format)

lpstat -p%P –o %I (job long output format)

lpstat -p%P –o %I (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 3.6.3 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

4.4.3 Running the PCL Barcode Server ( SunOS /Solaris, HPUX )

4.4.3.1 Running as service

The PCL Barcode Server 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.

4.4.3.2 Starting from inetd

The PCL Barcode Server 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 :

Page 21: Pcl Barcode Manual

© e-bizco.com GmbH PCL Barcode Server Page 17 Copyright 2002-2011

© e-bizco.com GmbH PCL Barcode Server Page 17 Copyright 2002-2011 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.

4.4.3.3 Running as user program

The PCL Barcode Server 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.

4.4.3.4 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

Page 22: Pcl Barcode Manual

© e-bizco.com GmbH PCL Barcode Server Page 18 Copyright 2002-2011

© e-bizco.com GmbH PCL Barcode Server Page 18 Copyright 2002-2011 for SAP R/3

4.5 Installation (SAP)

4.5.1 Device type

The device type describes the capabilities of a printer type and how to interact with it. The PCL Barcode Server is designed to insert barcodes into the data stream of a laserjet compatible page printer. Current SAP versions are aware of our PCL Barcode Server. SAP added PCL Barcodes to the following device types:

HPLJ4

HPLJ5

HPLJ5SI

HPLJ1100

HPLJ4000

HPLJ8000

HPLJIIID

LEXUTF8 You can use these unmodified device types. Please note, that the PCL Barcode Server “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.

Page 23: Pcl Barcode Manual

© e-bizco.com GmbH PCL Barcode Server Page 19 Copyright 2002-2011

© e-bizco.com GmbH PCL Barcode Server Page 19 Copyright 2002-2011 for SAP R/3

4.5.2 Setup your printer with transaction SPAD

The PCL Barcode Server 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 PCL Barcode Server, 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.

Page 24: Pcl Barcode Manual

© e-bizco.com GmbH PCL Barcode Server Page 20 Copyright 2002-2011

© e-bizco.com GmbH PCL Barcode Server Page 20 Copyright 2002-2011 for SAP R/3

5 Printing barcodes from the SAP system

5.1 PCL Barcode format

PCL 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, 24670 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 Result

<ESC>(s1p24670T Select barcode “Code 39” with no annotation, (s is the command group. 1p is the first command, 24670 the second command.

<ESC>(s1p5,10b24670T Select barcode “Code 39” with no annotation. The small bar is 5 pixel wide, the thicker bar is 10 pixel.

Page 25: Pcl Barcode Manual

© e-bizco.com GmbH PCL Barcode Server Page 21 Copyright 2002-2011

© e-bizco.com GmbH PCL Barcode Server Page 21 Copyright 2002-2011 for SAP R/3

5.1.1 General Commands for all Barcodes

5.1.2 “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.

Barcode Number Selected Barcode

24700 Code 128

24701 Code 128, Subset A

24702 Code 128, Subset B

24704 Code 128, Subset C

24650 Code 2 of 5 Industrial

24651 Code 2 of 5 Industrial w. checksum

24660 Code 2 of 5 Matrix

24661 Code 2 of 5 Matrix w. checksum

24640 Code 2 of 5 Interleaved

24641 Code 2 of 5 Interleaved w. checksum

24649 ITF-14 w. checksum

24670 Code 39

24671 Code 39 w. checksum

24680 Code 39 Extended

24681 Code 39 Extended w. checksum

24690 Code 93 w. checksum

24691 Code 93 Extended w. checksum

24815 Code 16K

24816 Code 16K, Subset A

24817 Code 16K, Subset B

24818 Code 16K, Subset C

24819 Code 49

24750 Codabar

24751 Codabar w. checksum

24820 Data Matrix

24720 EAN 128 w. checksum

24630 EAN 13

24631 EAN 13 + 2 Zusatzzeichen

24632 EAN 13 + 5 Zusatzeichen

24620 EAN 8

24621 EAN 8 + 2 Zusatzzeichen

24622 EAN 8 + 5 Zusatzeichen

24800 Maxicode

24761 MSI Plessey w. Mod 10 checksum

Page 26: Pcl Barcode Manual

© e-bizco.com GmbH PCL Barcode Server Page 22 Copyright 2002-2011

© e-bizco.com GmbH PCL Barcode Server Page 22 Copyright 2002-2011 for SAP R/3

Barcode Number Selected Barcode

24762 MSI Plessey w. Mod 10 and Mod10 checksum

24763 MSI Plessey w. Mod 10 and Mod 11 checksum

24850 PDF 417

24851 PDF 417 Truncated

24852 PDF 417 Micro

24642 Post Ident ( German Postal 2/5 Leitcode 13 )

24643 Post Ident ( German Postal 2/5 Identcode 11 )

24861 QR Code

24710 UCC 128

24600 UPCA

24601 UPCA + 2 Zusatzzeichen

24602 UPCA + 5 Zusatzzeichen

24610 UPCE

24611 UPCE + 2 Zusatzzeichen

24612 UPCE + 5 Zusatzzeichen

24770,24771,24772 ZIP Postnet 5, 9 and 11 digits

5.1.3 “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.

Page 27: Pcl Barcode Manual

© e-bizco.com GmbH PCL Barcode Server Page 23 Copyright 2002-2011

© e-bizco.com GmbH PCL Barcode Server Page 23 Copyright 2002-2011 for SAP R/3

5.1.4 “B” Bar Width

Barcodes 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.

5.1.5 “S” Gap Width

Barcodes 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.

5.1.6 “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.

5.1.7 Horizontal and vertical Position

The horizontal and vertical position is set using usual PCL positioning commands, e.g.

<ESC>&a100h200V will position the cursor at 100 deci points horizontal and 200 deci points vertical.

5.1.8 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.

Page 28: Pcl Barcode Manual

© e-bizco.com GmbH PCL Barcode Server Page 24 Copyright 2002-2011

© e-bizco.com GmbH PCL Barcode Server Page 24 Copyright 2002-2011 for SAP R/3

5.1.9 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.

Page 29: Pcl Barcode Manual

© e-bizco.com GmbH PCL Barcode Server Page 25 Copyright 2002-2011

© e-bizco.com GmbH PCL Barcode Server Page 25 Copyright 2002-2011 for SAP R/3

5.1.10 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:

0 2 1 4 2 8 (Default) 3 16 4 32 5 64 6 128 7 256 8 512

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 417

5.1.11 Barcode 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.

5.1.12 Rotation

The barcode can be rotated using the regular PCL rotation command: <ESC>&a#P with # = 0,90,180 and 270.

Page 30: Pcl Barcode Manual

© e-bizco.com GmbH PCL Barcode Server Page 26 Copyright 2002-2011

© e-bizco.com GmbH PCL Barcode Server Page 26 Copyright 2002-2011 for SAP R/3

5.1.13 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

Page 31: Pcl Barcode Manual

© e-bizco.com GmbH PCL Barcode Server Page 27 Copyright 2002-2011

© e-bizco.com GmbH PCL Barcode Server Page 27 Copyright 2002-2011 for SAP R/3

6 Defining Barcodes in SAPscript and SmartForms

6.1 Create your own device type

SAP has included the support for our PCL Barcode Server 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.

6.1.1 Create System Barcode

Start Transaction SE73 Select “System Barcode”, Press “Change”

Press “Create”.

Page 32: Pcl Barcode Manual

© e-bizco.com GmbH PCL Barcode Server Page 28 Copyright 2002-2011

© e-bizco.com GmbH PCL Barcode Server Page 28 Copyright 2002-2011 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 Barcode “ZPDF417”.

Press “Execute”. If you get a popup asking for a Workbench job: Select an appropriate job or cancel for local testing.

6.1.2 Create Printer Barcode

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 ).

Page 33: Pcl Barcode Manual

© e-bizco.com GmbH PCL Barcode Server Page 29 Copyright 2002-2011

© e-bizco.com GmbH PCL Barcode Server Page 29 Copyright 2002-2011 for SAP R/3

Start Transaction SE73. Select “Printer Bar Codes”, press “Change”, double click on your device type.

Page 34: Pcl Barcode Manual

© e-bizco.com GmbH PCL Barcode Server Page 30 Copyright 2002-2011

© e-bizco.com GmbH PCL Barcode Server Page 30 Copyright 2002-2011 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”.

Page 35: Pcl Barcode Manual

© e-bizco.com GmbH PCL Barcode Server Page 31 Copyright 2002-2011

© e-bizco.com GmbH PCL Barcode Server Page 31 Copyright 2002-2011 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”.

Page 36: Pcl Barcode Manual

© e-bizco.com GmbH PCL Barcode Server Page 32 Copyright 2002-2011

© e-bizco.com GmbH PCL Barcode Server Page 32 Copyright 2002-2011 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 Barcode Test with SmartForms

6.2.1 Used Barcode

To include a barcode type into SmartForm, you need to make sure that this is a defined System Barcode ( Transaction SE73 ) and that a correct print control is defined for each target device types.

6.2.2 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.

Page 37: Pcl Barcode Manual

© e-bizco.com GmbH PCL Barcode Server Page 33 Copyright 2002-2011

© e-bizco.com GmbH PCL Barcode Server Page 33 Copyright 2002-2011 for SAP R/3

Page 38: Pcl Barcode Manual

© e-bizco.com GmbH PCL Barcode Server Page 34 Copyright 2002-2011

© e-bizco.com GmbH PCL Barcode Server Page 34 Copyright 2002-2011 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 Barcode 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.

Page 39: Pcl Barcode Manual

© e-bizco.com GmbH PCL Barcode Server Page 35 Copyright 2002-2011

© e-bizco.com GmbH PCL Barcode Server Page 35 Copyright 2002-2011 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!

Page 40: Pcl Barcode Manual

© e-bizco.com GmbH PCL Barcode Server Page 36 Copyright 2002-2011

© e-bizco.com GmbH PCL Barcode Server Page 36 Copyright 2002-2011 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:

Page 41: Pcl Barcode Manual

© e-bizco.com GmbH PCL Barcode Server Page 37 Copyright 2002-2011

© e-bizco.com GmbH PCL Barcode Server Page 37 Copyright 2002-2011 for SAP R/3

7 Version History

4.2.5 Bugfix: PCL macros parsing error

4.2.3 Bugfix: Data Matrix code generation error with encoding C40

4.2 Support for Windows 7 (Windows version).

4.1.4 Include checksum in the annotation if barcode ITF-14.

Additional diagnostic information for trouble shooting (Windows version) Server licensing is based on hostname now (Windows version).

4.1.3 New Barcode: ITF-14, a 2 of 5 interleave variant, id 24649 4.1.2 Bugfix: Datamatrix 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 Barcode DLL

8 More Information / Contact

Please contact us at e-bizco.com GmbH Up'n Hoff 1 D-22927 Großhansdorf Germany Web: http://www.e-bizco.com EMail: [email protected] Phone: ++49 4102 69 190 49 Fax: ++49 4102 69 190 47

Page 42: Pcl Barcode Manual

© e-bizco.com GmbH PCL Barcode Server Page 38 Copyright 2002-2011

© e-bizco.com GmbH PCL Barcode Server Page 38 Copyright 2002-2011 for SAP R/3

9 Appendix Hex Table

Hexcode Character Hexcode Character Hexcode Character Hexcode Character

0 NUL 20 space 40 @ 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 30 0 50 P 70 p

11 CS1 31 1 51 Q 71 q

12 DC2 32 2 52 R 72 r

13 DC3 33 3 53 S 73 s

14 DC4 34 4 54 T 74 t

15 NAK 35 5 55 U 75 u

16 SYN 36 6 56 V 76 v

17 ETB 37 7 57 W 77 w

18 CAN 38 8 58 X 78 x

19 EM 39 9 59 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

Page 43: Pcl Barcode Manual

© e-bizco.com GmbH PCL Barcode Server Page 39 Copyright 2002-2011

© e-bizco.com GmbH PCL Barcode Server Page 39 Copyright 2002-2011 for SAP R/3

10 Barcode Specifications

Data Matrix Character set: Complete ASCII or

numeric information Checksum: Intergrated high

quality error correction

ID: C=DM Required licence: Barcode 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: Complete ASCII or

numeric information Checksum: Intergrated high

quality error correction

ID: C=PDF417 Required licence: Barcode 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.

Page 44: Pcl Barcode Manual

© e-bizco.com GmbH PCL Barcode Server Page 40 Copyright 2002-2011

© e-bizco.com GmbH PCL Barcode Server Page 40 Copyright 2002-2011 for SAP R/3

Maxicode Character set: 0-9A-Z Checksum: Yes ID: C=MAXI Required licence: Maxicode

Remarks: UPS packet labeling

Code 16K Character set: Complete ASCII or

numeric information Checksum: Yes ID: C=C16K Required licence: Barcode Plus

Remarks: Stacked 2-D barcode, encodes up to 77 ASCII characters or 154 digits.

Code 49 Character set: Complete ASCII or

numeric information Checksum: Yes ID: C=C49 Required licence: Barcode Plus

Remarks: Stacked 2-D barcode

Page 45: Pcl Barcode Manual

© e-bizco.com GmbH PCL Barcode Server Page 41 Copyright 2002-2011

© e-bizco.com GmbH PCL Barcode Server Page 41 Copyright 2002-2011 for SAP R/3

Code 128 Character set: 7 Bit ASCII Checksum: Yes ID: C=128 Required licence: Barcode Classic or

Barcode Plus

Remarks: Complete 7 Bit ASCII character set, high density, low error resistance.

Code 39 Character set: A-Z 0-9 - . $ / + %

and space Checksum: Optional ID: C=39 Required licence: Barcode Classic or

Barcode Plus

Remarks: Robust code, low density for upper case letters and digits.

Code 39 extended Character set: Full 7 Bit ASCII Checksum: Optional ID: C=39X Required licence: Barcode Classic or

Barcode Plus

Remarks: Very low density code, most characters are encodes by two code 39 characters.

Page 46: Pcl Barcode Manual

© e-bizco.com GmbH PCL Barcode Server Page 42 Copyright 2002-2011

© e-bizco.com GmbH PCL Barcode Server Page 42 Copyright 2002-2011 for SAP R/3

Code 93 Character set: A-Z 0-9 - . * $ / + %

and space Checksum: Optional ID: C=93 Required licence: Barcode Classic or

Barcode Plus

Remarks: Robust code, low density for upper case letters and digits.

Code 93 extended Character set: Full 7 Bit ASCII Checksum: Optional ID: C=93X Required licence: Barcode Classic or

Barcode Plus

Remarks: Robust, low density.

Code 2 of 5 Industrial Character set: Digits only Checksum: Optional ID: C=25I Required licence: Barcode Classic or

Barcode Plus

Remarks: Robust, low density code for digits ONLY.

Page 47: Pcl Barcode Manual

© e-bizco.com GmbH PCL Barcode Server Page 43 Copyright 2002-2011

© e-bizco.com GmbH PCL Barcode Server Page 43 Copyright 2002-2011 for SAP R/3

Code 2 of 5 Interleaved Character set: Digits only Checksum: Optional ID: C=25L Required licence: Barcode Classic or

Barcode 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: Digits only Checksum: Optional ID: C=25M Required licence: Barcode Classic or

Barcode Plus

Remarks: Robust code for digits ONLY. Higher density than 2 of 5 Industrial.

Page 48: Pcl Barcode Manual

© e-bizco.com GmbH PCL Barcode Server Page 44 Copyright 2002-2011

© e-bizco.com GmbH PCL Barcode Server Page 44 Copyright 2002-2011 for SAP R/3

11 QR Code data capacity

Format Error

Correction

Level

Data capacity format 1 - 8

Numeric Alphanumeric 8-bit Byte Kanji

1

L 41 25 17 10

M 34 20 14 8

Q 27 16 11 7

H 17 10 7 4

2

L 77 47 32 20

M 63 38 26 16

Q 48 29 20 12

H 34 20 14 8

3

L 127 77 53 32

M 101 61 42 26

Q 77 47 32 20

H 58 35 24 15

4

L 187 114 78 48

M 149 90 62 38

Q 111 67 46 28

H 82 50 34 21

5

L 255 154 106 65

M 202 122 84 52

Q 144 87 60 37

H 106 64 44 27

6

L 322 195 134 82

M 255 154 106 65

Q 178 108 74 45

H 139 84 58 36

L 370 224 154 95

Page 49: Pcl Barcode Manual

© e-bizco.com GmbH PCL Barcode Server Page 45 Copyright 2002-2011

© e-bizco.com GmbH PCL Barcode Server Page 45 Copyright 2002-2011 for SAP R/3

7

M 293 178 122 75

Q 207 125 86 53

H 154 93 64 39

8

L 461 279 192 118

M 365 221 152 93

Q 259 157 108 66

H 202 122 84 52

9

L 552 335 230 141

M 432 262 180 111

Q 312 189 130 80

H 235 143 98 60

10

L 652 395 271 167

M 513 311 213 131

Q 364 221 151 93

H 288 174 119 74

11

L 772 468 321 198

M 604 366 251 155

Q 427 259 177 109

H 331 200 137 85

12

L 883 535 367 226

M 691 419 287 177

Q 489 296 203 125

H 374 227 155 96

13

L 1022 619 425 262

M 796 483 331 204

Q 580 352 241 149

H 427 259 177 109

14

L 1101 667 458 282

M 871 528 362 223

Q 621 376 258 159

Page 50: Pcl Barcode Manual

© e-bizco.com GmbH PCL Barcode Server Page 46 Copyright 2002-2011

© e-bizco.com GmbH PCL Barcode Server Page 46 Copyright 2002-2011 for SAP R/3

H 468 283 194 120

15

L 1250 758 520 320

M 991 600 412 254

Q 703 426 292 180

H 530 321 220 136

16

L 1408 854 586 361

M 1082 656 450 277

Q 775 470 322 198

H 602 365 250 154

17

L 1548 938 644 397

M 1212 734 504 310

Q 876 531 364 224

H 674 408 280 173

18

L 1725 1046 718 442

M 1346 816 560 345

Q 948 574 394 243

H 746 452 310 191

19

L 1903 1153 792 488

M 1500 909 624 384

Q 1063 644 442 272

H 813 493 338 208

20 L 2061 1249 858 528

M 1600 970 666 410

Q 1159 702 482 297

H 919 557 382 235

21

L 2232 1352 929 572

M 1708 1035 711 438

Q 1224 742 509 314

H 969 587 403 248

22 L 2409 1460 1003 618

Page 51: Pcl Barcode Manual

© e-bizco.com GmbH PCL Barcode Server Page 47 Copyright 2002-2011

© e-bizco.com GmbH PCL Barcode Server Page 47 Copyright 2002-2011 for SAP R/3

M 1872 1134 779 480

Q 1358 823 565 348

H 1056 640 439 270

23 L 2620 1588 1091 672

M 2059 1248 857 528

Q 1468 890 611 376

H 1108 672 461 284

24 L 2812 1704 1171 721

M 2188 1326 911 561

Q 1588 963 661 407

H 1228 744 511 315

25

L 3057 1853 1273 784

M 2395 1451 997 614

Q 1718 1041 715 440

H 1286 779 535 330

26

L 3283 1990 1367 842

M 2544 1542 1059 652

Q 1804 1094 751 462

H 1425 864 593 365

27 L 3517 2132 1465 902

M 2701 1637 1125 692

Q 1933 1172 805 496

H 1501 910 625 385

28

L 3669 2223 1528 940

M 2857 1732 1190 732

Q 2085 1263 868 534

H 1581 958 658 405

29

L 3909 2369 1628 1002

M 3035 1839 1264 778

Q 2181 1322 908 559

Page 52: Pcl Barcode Manual

© e-bizco.com GmbH PCL Barcode Server Page 48 Copyright 2002-2011

© e-bizco.com GmbH PCL Barcode Server Page 48 Copyright 2002-2011 for SAP R/3

H 1677 1016 698 430

30 L 4158 2520 1732 1066

M 3289 1994 1370 843

Q 2358 1429 982 604

H 1782 1080 742 457

31

L 4417 2677 1840 1132

M 3486 2113 1452 894

Q 2473 1499 1030 634

H 1897 1150 790 486

32 L 4686 2840 1952 1201

M 3693 2238 1538 947

Q 2670 1618 1112 684

H 2022 1226 842 518

33 L 4965 3009 2068 1273

M 3909 2369 1628 1002

Q 2805 1700 1168 719

H 2157 1307 898 553

34 L 5253 3183 2188 1347

M 4134 2506 1722 1060

Q 2949 1787 1228 756

H 2301 1394 958 590

35 L 5529 3351 2303 1417

M 4343 2632 1809 1113

Q 3081 1867 1283 790

H 2361 1431 983 605

36

L 5836 3537 2431 1496

M 4588 2780 1911 1176

Q 3244 1966 1351 832

H 2524 1530 1051 647

37 L 6153 3729 2563 1577

Page 53: Pcl Barcode Manual

© e-bizco.com GmbH PCL Barcode Server Page 49 Copyright 2002-2011

© e-bizco.com GmbH PCL Barcode Server Page 49 Copyright 2002-2011 for SAP R/3

M 4775 2894 1989 1224

Q 3417 2071 1423 876

H 2625 1591 1093 673

38

L 6479 3927 2699 1661

M 5039 3054 2099 1292

Q 3599 2181 1499 923

H 2735 1658 1139 701

39 L 6743 4087 2809 1729

M 5313 3220 2213 1362

Q 3791 2298 1579 972

H 2927 1774 1219 750

40 L 7089 4296 2953 1817

M 5596 3391 2331 1435

Q 3993 2420 1663 1024

H 3057 1852 1273 784

12 ISO 3166 Codes (Country Codes)

These country codes are used with Maxicode to specify the destination.

Country Number

Afghanistan 004

Albania 008

Algeria 012

American Samoa 016

Andorra 020

Angola 024

Anguilla 660

Antarctica 010

Antigua And Barbuda 028

Argentina 032

Armenia 051

Aruba 533

Australia 036

Austria 040

Page 54: Pcl Barcode Manual

© e-bizco.com GmbH PCL Barcode Server Page 50 Copyright 2002-2011

© e-bizco.com GmbH PCL Barcode Server Page 50 Copyright 2002-2011 for SAP R/3

Country Number

Azerbaijan 031

Bahamas 044

Bahrain 048

Bangladesh 050

Barbados 052

Belarus 112

Belgium 056

Belize 084

Benin 204

Bermuda 060

Bhutan 064

Bolivia 068

Bosnia And Herzegowina 070

Botswana 072

Bouvet Island 074

Brazil 076

British Indian Ocean Territory 086

Brunei Darussalam 096

Bulgaria 100

Burkina Faso 854

Burundi 108

Cambodia 116

Cameroon 120

Canada 124

Cape Verde 132

Cayman Islands 136

Central African Republic 140

Chad 148

Chile 152

China 156

Christmas Island 162

Cocos (Keeling) Islands 166

Colombia 170

Comoros 174

Congo 178

Cook Islands 184

Costa Rica 188

Cote D'ivoire 384

Croatia 191

Cuba 192

Cyprus 196

Czech Republic 203

Page 55: Pcl Barcode Manual

© e-bizco.com GmbH PCL Barcode Server Page 51 Copyright 2002-2011

© e-bizco.com GmbH PCL Barcode Server Page 51 Copyright 2002-2011 for SAP R/3

Country Number

Denmark 208

Djibouti 262

Dominica 212

Dominican Republic 214

East Timor 626

Ecuador 218

Egypt 818

El Salvador 222

Equatorial Guinea 226

Eritrea 232

Estonia 233

Ethiopia 231

Falkland Islands (Malvinas) 238

Faroe Islands 234

Fiji 242

Finland 246

France 250

France, Metropolitan 249

French Guiana 254

French Polynesia 258

French Southern Territories 260

Gabon 266

Gambia 270

Georgia 268

Germany 276

Ghana 288

Gibraltar 292

Greece 300

Greenland 304

Grenada 308

Guadeloupe 312

Guam 316

Guatemala 320

Guinea 324

Guinea-Bissau 624

Guyana 328

Haiti 332

Heard And Mc Donald Islands 334

Honduras 340

Hong Kong 344

Hungary 348

Iceland 352

Page 56: Pcl Barcode Manual

© e-bizco.com GmbH PCL Barcode Server Page 52 Copyright 2002-2011

© e-bizco.com GmbH PCL Barcode Server Page 52 Copyright 2002-2011 for SAP R/3

Country Number

India 356

Indonesia 360

Iran 364

Iraq 368

Ireland 372

Israel 376

Italy 380

Jamaica 388

Japan 392

Jordan 400

Kazakhstan 398

Kenya 404

Kiribati 296

Korea, Democratic People's Republic Of 408

Korea, Republic Of 410

Kuwait 414

Kyrgyzstan 417

Lao People's Democratic Republic 418

Latvia 428

Lebanon 422

Lesotho 426

Liberia 430

Libyan Arab Jamahiriya 434

Liechtenstein 438

Lithuania 440

Luxembourg 442

Macau 446

Macedonia 807

Madagascar 450

Malawi 454

Malaysia 458

Maldives 462

Mali 466

Malta 470

Marshall Islands 584

Martinique 474

Mauritania 478

Mauritius 480

Mayotte 175

Mexico 484

Micronesia, Federated States Of 583

Moldova, Republic Of 498

Page 57: Pcl Barcode Manual

© e-bizco.com GmbH PCL Barcode Server Page 53 Copyright 2002-2011

© e-bizco.com GmbH PCL Barcode Server Page 53 Copyright 2002-2011 for SAP R/3

Country Number

Monaco 492

Mongolia 496

Montserrat 500

Morocco 504

Mozambique 508

Myanmar 104

Namibia 516

Nauru 520

Nepal 524

Netherlands 528

Netherlands Antilles 530

New Caledonia 540

New Zealand 554

Nicaragua 558

Niger 562

Nigeria 566

Niue 570

Norfolk Island 574

Northern Mariana Islands 580

Norway 578

Oman 512

Pakistan 586

Palau 585

Panama 591

Papua New Guinea 598

Paraguay 600

Peru 604

Philippines 608

Pitcairn 612

Poland 616

Portugal 620

Puerto Rico 630

Qatar 634

Reunion 638

Romania 642

Russian Federation 643

Rwanda 646

Saint Kitts And Nevis 659

Saint Lucia 662

Saint Vincent And The Grenadines 670

Samoa 882

San Marino 674

Page 58: Pcl Barcode Manual

© e-bizco.com GmbH PCL Barcode Server Page 54 Copyright 2002-2011

© e-bizco.com GmbH PCL Barcode Server Page 54 Copyright 2002-2011 for SAP R/3

Country Number

Sao Tome And Principe 678

Saudi Arabia 682

Senegal 686

Seychelles 690

Sierra Leone 694

Singapore 702

Slovakia 703

Slovenia 705

Solomon Islands 090

Somalia 706

South Africa 710

South Georgia And The South Sandwich Islands 239

Spain 724

Sri Lanka 144

St. Helena 654

St. Pierre And Miquelon 666

Sudan 736

Suriname 740

Svalbard And Jan Mayen Islands 744

Swaziland 748

Sweden 752

Switzerland 756

Syrian Arab Republic 760

Taiwan 158

Tajikistan 762

Tanzania, United Republic Of 834

Thailand 764

Togo 768

Tokelau 772

Tonga 776

Trinidad And Tobago 780

Tunisia 788

Turkey 792

Turkmenistan 795

Turks And Caicos Islands 796

Tuvalu 798

Uganda 800

Ukraine 804

United Arab Emirates 784

United Kingdom 826

United States 840

United States Minor Outlying Islands 581

Page 59: Pcl Barcode Manual

© e-bizco.com GmbH PCL Barcode Server Page 55 Copyright 2002-2011

© e-bizco.com GmbH PCL Barcode Server Page 55 Copyright 2002-2011 for SAP R/3

Country Number

Uruguay 858

Uzbekistan 860

Vanuatu 548

Vatican City State 336

Venezuela 862

Viet Nam 704

Virgin Islands (British) 092

Virgin Islands (U.S.) 850

Wallis And Futuna Islands 876

Western Sahara 732

Yemen 887

Yugoslavia 891

Zaire 180

Zambia 894

Zimbabwe 716