Installation guide A4 221 vor umbau - AGOSYS

iXBC

intelligent Unix/Windows Barcode Tools

Installation Guide

Versions: iXBCserver 2.2 1D and 2D Edition

iXBCdll 2.1

Copyright 1998-2003 by AGOSYS Dr. Tanczos & Co. KEG. All rights reserved.

Document issue date: 2006-12-28

AGOSYS Dr. Tanczos & Co. KEG. ,Mayrgutstr. 41, A-4451 Garsten [email protected], www.agosys.com

software solutions

Installation Guide

1. Description............................................................................................................................3

2. iXBCserver ...........................................................................................................................4 General Installation ............................................................................................................4 Installation in SAP ..............................................................................................................6

3. iXBCserver for Windows – iXBCwin......................................................................................8 General Installation ............................................................................................................8 Installation in SAP ..............................................................................................................9

4. iXBCdll for SAPlpd..............................................................................................................10 General Installation ..........................................................................................................10

5. Formatting the barcode data...............................................................................................11 Sending non printable characters in barcode ...................................................................11 Sending addendum data for multiple barcodes ................................................................11

6. Print Controls......................................................................................................................12 Print Controls for PCL ......................................................................................................12 Print Controls for PostScript and SAPWIN .......................................................................16 Additional Information ......................................................................................................20

7. Print Control setting in SAP ................................................................................................21

8. Predefined SAP Device Types for iXBC .............................................................................22

9. Print Control Samples for cut and paste + modify ...............................................................23

iXBC – intelligent Unix/Windows barcode tools

3

1. Description The iXBC Intelligent Barcode Tools for SAP are easy-to-use, trouble-free and versatile software solutions to print free scalable, uniform barcodes on any PCL and PostScript printers from SAP-applications:

- iXBCserver for Unix - iXBCwin for Windows server - iXBCdll for SAPlpd

iXBCserver and iXBCwin are revolutionary new, central softwares for direct barcode printing from UNIX or Windows servers, respectively. By a single installation on a central server they enable all laser printers on the network to print a wide variety of the most popular industry standard barcodes. All printers in PCL or Postscript mode, irrespectively of the vendor, are supported. No changes in SAP printprogramms are required. iXBC enables quick and simple barcode printing using SAP’s own standard barcode control. iXBC can also be used with other applications. A variety of operating systems are supported, including AIX, HP-UX, Solaris, Tru64, Linux, OpenVMS and Windows. The program can be installed as a passive filter in printing scripts on the application server or into the print spooler of UNIX or Windows NT/2000/2003.

The supported barcodes are: Code 39, 2 of 5 interleaved, Code 128 A/B/C/ Auto switch, Codabar, EAN128, UCC128, EAN 8/13, UPC A/E, PDF417, DataMatrix, Stamp&Logo “Deutsche Post DV” and OCR-B font. Features: iXBC

makes all network printers barcode enabled by a single server installation, generates precise barcodes with free scalable height and width, can print the barcode horizontal and vertical, into any quadrant from the

actual cursor position, calculates and prints the check digits automatically, provides the compressions specified in the standards, can select the bar density automatically from the desired width and nominal

data length. iXBCdll for SAPlpd is also available for conventional indirect client printing on any Windows supported printers. iXBCdll corresponds to the specification of SAP’s BARCODE.dll for SAPlpd, and it is functionally compatible with iXBCserver and iXBCwin. PCL, Postscript, SAP, SAPlpd, Windows are registered trademarks of their owners respectively.

The goal of the iXBC tools is to provide a uniform barcode printing solution for any SAP environment, also in case of large international distributed IT systems.


4

2. iXBCserver for Unix You can use the iXBCserver in combination with SAP or other business-applications, producing PCL or PostScript printer output. The program works according to the well-known scheme of UNIX filter programs. Availability: AIX, HP-UX, Solaris, Tru64, OpenVMS, Windows32. General Installation Copy the ixbc program (and eventually the test files too) into a local directory, e.g. at UNIX into /usr/local/bin. Use a copy method, that doesn’t change the file, e.g. binary mode of ftp! At Unix set the file attributes of ixbc for execution, e.g. chmod 755. Execute ixbc with –h parameter to display the usage help: ixbc –h The Parameters: ixbc [c-opt…][-r][-N<copies>][-o<output file>] [<input file>] If output and/or input file are not specified, STDOUT and/or STDIN will be used respectively. -o name of the output file (at Windows also /d:printer accepted) -r remove the input file after processing -N print more copies, if input file is specified c-opt… optional customizing options:

-v with this option one or more modifiers can be specified by adding: d printing downward from the cursor baseline (like barcode printing in Prescribe

language) l (small L) low raster: 300 DPI; default: 600 h high raster: 1200 DPI; default: 600

-g"1-char" defines a sutable, in text not occuring special character for FNC1/EAN128 and DataMatrix (not more GLI/PDF417) -e"1-char" defines a sutable, in text not occuring special character for ECI/DataMatrix and GLI/PDF417

-x”1-or-2-char” defines separator(s) to enclose hexadecimal parts in input of Code128, EAN128, DataMatrix and PDF417. Valid hex digits or the standard name of an ASCII control character can be enclosed with this separators, e.g with -x"{}" setting: {0D0A}, {EOT},..., but {_FF} and {_DCn} need an additional underscore.

If the chosen characters are in conflict with your shell, put them in quotes. You can make quick tests using the supplied PCL and Postscript sample files as described later in the section Additional Information. Install the iXBCserver as a filter • in a printing script or • in the print spooler.


5

Installation in a printing script Unix(AIX) example If the original printing script is: #!/bin/ksh # parameters: $1 = name of the printer queue # $2 = name of the file to print qprt -P$1 -Bnn -r -dp -X850 $2

The modified printing script with barcode emulation would be: #!/bin/ksh # parameters: $1 = name of the printer queue # $2 = name of the file to print ixbc -r $2 | qprt -P$1 -Bnn -dp -X850

Windows examples

In a Windows command file: ixbc %2 > %1 or ixbc –o %1 %2 or ixbc /d:%1 %2

where the command file parameters: %1 the output, the possible values are: • a share name of a local or remote printer in

UNC notation, e.g.: \\server1\printer1, • a local port name, that currently referred by the

print manager, e.g. LPT1, or • a file name. %2 input file.

Installation in the print spooler: Unix spooler or output management system: Consult with the manuals of the corresponding system, how to install a standard “cut” style Unix filter program for filtering the outputs. Windows spooler: The installation in the Windows spooler is described in the next capital 3 iXBCserver for Windows – iXBCwin. Processing a test file with iXBCserver

ixbc –o outfile testpcl and send the resulted file to a printer with regular operating system print command, e.g. lp, lpr, qprt, … or combine the both steps in a pipe. In Windows iXBCserver can be used as the Windows print utility:

ixbc /d:\\server1\printer1 testpcl


6

Installation in SAP You can use iXBCserver for connection type L printers. The connection type L in SAP printer settings means, that the printer-ready data stream is written in a local file first, then an operating system command is invoked to print the file. You can install the iXBCserver in the SAP local printer interface, in an external output management system or in the print spooler. Installation in the SAP printer interface: 1. First you should copy the ixbc program into a directory on the SAP

application server with SAP spool process. The ixbc program must be found in the path and must be executable by the system user who is running the SAP. The system user is generally <SID>adm in UNIX and SAPservice<SID> under Windows NT installations (where <SID> is the 3 character length system id of the SAP installation).

2. Prepare and test a script that can perform the printing with the iXBCserver:

Unix(AIX) example: #!/bin/ksh # filename of this script: sap_prt # parameters: $1 = name of the printer queue # $2 = number of copies # $3 = name of the file to print # old print cmd = qprt –dp –P&P –Bnn –N&C –r –R14 –X850 &F # new print cmd = sap_prt &P &C &F ixbc –r $3 | qprt -P$1 -Bnn –N$2 -R14 -dp -X850 Windows example: REM filename of this script: sap_prt.cmd REM parameters: %1 = UNC name of a shared printer REM %2 = number of copies REM %3 = name of the file to print REM old/default print command = print /D:&P &F REM new print command = sap_prt &P &C &F > NULL ixbc -r –N%2 –o%1 %3

3. Set the local print command corresponding with the script parameters, e.g. as commented in the examples above.

4. You can set the print command individually for one or more type L printers: Start the SPAD transaction and select output devices and the desired device, switch to change mode and select the Command set function from the Edit menu. Do double-click to the newly appeared Command set ID input field, define a one character long command set ID and a new printing command, or assign an existing command set ID.

5. You can set the print command also global for SAP instance: Setting the default print command with the “rspo/host_spool/print” SAP profile parameter has effect on all type L printers. Start the transaction RZ10 and


7

select tools->CCMS->Configuration->Profile maintenance. It is applicable only at SAP installations running on UNIX systems1. A restart of the SAP instance is required.

After a proper installation of the iXBCserver in the SAP printer interface, printing by SAP should be performed as before. 1 For SAP Servers running under Windows the default print command for type L printers is fixed to print /D:&P &F, and cannot be changed (SAP Rel. 4.6). Set the print command individually for each type L printer. As escape you can filter globally all type L printers at SAP on Windows by copying ixbc.exe into a directory in the path prior to the location of the standard Windows print.exe utility and renaming it to print.exe


8

3. iXBCserver for Windows – iXBCwin iXBCwin is designed for integrating the iXBCserver into the print spooler of the Windows NT/2000/2003. Only local printers are processed by iXBCwin. To process network printers, iXBCwin has to be installed on the corresponding Windows print server. This configuration is also used for SAP installation on AS400 printing via TCP/IP through the Windows print server. General Installation The installation has to be done with the shipped installation utility install.bat first installation of iXBCwin update.bat upgrade an existing iXBCwin instsallation uninstall.bat uninstall the iXBCwin To perform the installation, double-click on install.bat utility: Checking the Spooler.... C:\WINNT\System32\spool\PRTPROCS\W32X86\iXBCwin.dll copied. iXBCwin Print Processor registered. iXBCwin Print Processor installed successfully. Change the Print Processor of the desired printer to iXBCwin, using RAW as default data type in the Printer properties (at Win2000/2003/XP located in the Advanced folder). The printing should work as before. Now the iXBCwin installation is finished. To verify the installation, send a sample file from the samples directory on the CD to the printer with iXBCwin printprocessor: c:\temp\> copy /B samples\testpcl \\myserver\myprinter The sample barcode will be printed, if the installation is correct. To uninstall iXBCwin, be sure no printer is using iXBCwin as Print Processor, and simply execute the installation utility by double-click on uninst.bat To upgrade the iXBCwin to a newer version, run the installation utility by double-click on update.bat. If you need, you can pass command line options for iXBC in [iXBC] section of iXBCwin.ini file placed in the %windir% directory following form: [iXBC] options=-x”{}” Processing a test file with iXBCwin


9

If iXBCwin is installed on the server server1 and an printer1 the iXBCwin printprocessor is selected:

copy /B testpcl \\server1\printer1 or

set printer1 as Windows standard printer and ixbcsend testpcl

Installation in SAP SAP servers, running on a Windows server system, can communicate with the Windows print manager through direct operating system calls (connections type C). SAP running on any system can forward its print jobs through TCP/IP to a remote machine for:

a standard LPD print server with BSD protocol (type U), SAPLpd (SAP own LPD print server) on any Windows server (type S), or SAPLpd on the requesting SAP client PC (type F).

The Windows print manager knows local and remote printers. Local printers are spooled locally, while the remote printers of the Windows NT/2000/2003 are spooled on the print server. SAP servers running on a non-Windows system (e.g. AS400, UNIX) can also utilize the printing on a Windows NT/2000/2003 machine through connection type S, U or F. You should install iXBCwin on the Windows NT/2000/2003 machine, which spools the print jobs to emulate barcode for all printers using SAP device type with PCL or POST driver. For SAPWIN type devices you should use the iXBCdll. To receive the print jobs on a Windows machine

SAPLpd (for connection type S or F) or TCP/IP Print Server service (for connection type U)

has to be running. In the SAP printer setup, at connection types S and U, enter the TCP/IP name of the desired Windows server as DESTINATION HOST. Enter the local printer name assigned by the Windows print manager or “__DEFAULT” to address the currently default printer as HOST PRINTER. (remark the two underline characters at the beginning!)


10

4. iXBCdll for SAPlpd General Installation The Installation is possible on SAP Clients or on Windows print server or on Windows Terminal Server. System requirements Operating system: all Windows 32 bit systems SAP print server: SAPLPD V2.10 or higher. Installation To install iXBCdll perform the following steps: 1. Copy the “barcode.dll” file from the subdirectory “iXBCdll” into the

subdirectory where SAPLPD.EXE is located. At SAP Clients this program can usually be found in the subdirectory “saplpd” of the “sapgui” directory on the client machine (e.g. “C:\Program Files\ SAPpc\sapgui\saplpd\”)

2. After copying the file you have to restart SAPlpd. To verify a successful installation, search for the following entry in the SAPLD.log file (see Fig. 1):

Fig.1


11

Processing a test file with iXBCdll You can verify the installation by the prtverify test program. Change to the iXBCdll\samples subdirectory and dubbleclick to prtverify.bat. This procedure will call iFORM utility with input1.txt and input2.txt testfiles. You can change the files and execute iFORM similarly. iFORM transfers the barcode commands to iXBCdll.

5. Formatting the barcode data Non printable characters in barcode Some barcode types can encode the full ASCII 0-127 code table (Code128, PDF417) or any byte value 0-255 (DataMatrix). SAP and many print programs cannot output the non printable characters. The non printable part of data should be given as hexadecimal string and enclosed between the free chosen Hex-separator characters, e.g.: 12345{2D41}BCD is equivalent 12345-ABCD Though in this example all characters are printable, it wouldn’t be necessary to use the hexadecimal form. But if you want to send binary data, e.g a fingerprint or only insert some carriage returns or tabulator characters, you have to deliver the data in hexadecimal notation. The chosen hexadecimal separator characters should be declared with command line argument –x of ixbc, e.g. for the example above ixbc -x”{}” … should be defined as hexadecimal separator. Data Length Limit SAP has an internal limit of 70, or at Unicode mode 35 characters for transferring barcode data from layout set to the printer. iXBC can overcome this limit and print also barcodes with more than 70 (or 35) characters. This feature is important for the 2 dimensional barcodes PDF417 and DataMatrix that can contain more than 1000 characters. To print more than 70 (35) characters, the data has to be sent in pieces with a maximal data length of 70 (35) each. There is a dummy barcode type in iXBC (Type 24000 in PCL, and at Postscript and SAPWIN if no C= parameter, only D= occurs), which cause accumulate/collect the data without printing them. The collected data from one or more collection step will be printed together with the subsequent non dummy barcode. See samples for PCL, Postscript and SAPWIN at description of Print Controls.


12

Sending auxiliary data for add-on barcode The barcode “Deutsche Post DV-Freimachung” Stamp&Logo consist of a 2-dimensional DataMatrix barcode and optionally an add-on auxiliary service barcode, e.g identcode of “Registred” letter. If exists, the auxiliary data should be separated by a single “|” character. e.g.: DEA{12100130A55DC70037885A}{000100000101004B00}AGOSY|RR34567890.DE The RR34567890.DE part is the optional identcode of auxiliary service. At auxiliary service barcode of “Deutsche Post DV-Freimachung” Stamp&Logo consists of 2 letters + 8 registration numbers + 1 check digit and 2 characters country code. iXBC will calculate the check digit automatically, if the place of the check digit is empty or non numeric. A special easy data entry modus is provided to avoid the cumbrous hexadecimal coding of the data. All the single fields of the Datamatrix Stamp can be given in its natural form. The delivery datum is given as ANSI YYYYMMDD date and will be converted in DDDYY and subsequently in hexadecimal form XXXX. All of the numerical fields are given in decimal form and will be converted into hexadecimal, where it is prescribed. Only the registration number should be provided, the check digit will be automatically added. The following two data lines are equivalent: |DEA|18|16|5111111111|55|20061215|1|1|1|75|0||AGOSY|RR|34567890|DE DEA{12100130A55DC70037885A}{000100000101004B00}AGOSY|RR34567890.DE

6. Print Controls The Print Controls determine the properties of a barcode (type, size, orientation, position related to the actual print position, etc.) Print Controls for PCL The structure of the Print Control sequence: Print Control prefix | data | suffix

ESC(s{barcode parameters}{user data}ESC…

The ESC stands for the Escape character (Hex 1B). {user data} stands for the barcode data. Some barcode types allow non printable binary bytes (0-127 or 0-255). How to transfer those data content, see the Chapter “Send non printable characters”.


13

{barcode parameters} is a chain of single parameters. A single parameter begins with its numerical value (#) followed by the parameter identification letter. The last parameter identification letter must be upper case T. All other identification letters must be lower case letters. Table 1 Coding of single parameters in PCL Print Controls (# stands for a numerical value with or without decimal point)

#p Code for barcode orientation 1 horizontal, reading from left to right (0°) 2 vertical, reading from top to down (270°) 5 horizontal, reading from right to left (180°) 6 vertical, reading from down to top (90°)

Only in case of PDF417: ECC level is to write just before the code for barcode orientation. Write 1-8 as ECC level or 1001 to 1400 for ECC level in percent (corresponding to 1-400%). If no ECC level is defined, the recommended level is calculated automatically. At PDF417 only 1p and 2p orientation codes are allowed.

#v Height of the barcode in [mm]. A negative value places the barcode on the other side of the cursor2

#b Width of the barcode in [mm] 3. At barcode types with variable length of data, the width refers to the nominal data length given in #h, if it is defined. A negative value places the barcode on the other side of the cursor.

#h Nominal data length: the number of characters (in case of PDF417 and Data Matrix: the number of columns) at the width defined. (not relevant for EAN8/13 and UPC)

#y Vertical offset relative to the current cursor position in [mm]. The value can be + (down) or – (up)


14

#T Barcode type identifier: 24000 the barcode data is only accumulated, not printed 24620 EAN-8 24630 EAN-13 24720 EAN-1284 24670 Code39 (w/n ratio = 2.5) 24671 Code 39 + check digit (w/n ratio = 2.5) 24680 Code39ext 24681 Code39ext + check digit 24640 Interleaved 2 of 5 (w/n ratio = 3) 24646 Interleaved 2 of 5 (w/n ratio = 2) 24641 Interleaved 2 of 5 + check digit (w/n ratio = 3) 24647 Interleaved 2 of 5 + check digit (w/n ratio = 2) 24702 Code128 Code B 24704 Code128 Code C 24700 Code128 autoswitch 24750 CODABAR (w/n ratio = 3) 24751 CODABAR + chk16 (w/n ratio = 3) 24600 UPC-A 24610 UPC E 110 OCR-B font5 24850 PDF417 *) 24851 PDF417 Truncated. *) 24820 DataMatrix *) **) 24821 “Deutsche Post DV-Freimachung” Stamp&Logo *) **)

*) available in iXBC 2D edition **) with Version 2.2 and upwards

The appropriate single parameters have to be selected and joint together to the print control prefix for every required barcode type and size in SAP SE73. Example: Some ready to use Print Control samples are listed for SAP in Chapter 8. If the Device Type in SAP once customized, the SAPscript or SmartForms formatting tool automatically merges the Print Controls and the variable barcode data together, like this: Print Control prefix | data | suffix ESC(s1p15v85b10h24670T12345-ABCDESC(0N Non SAP applications should be able to generate similar sequences. Only in case of PDF417: Default value of the symbol aspect ratio (height / width) = 0.5 and default value of the module aspect ratio (height of elementary row/ width of smallest bar) = 5. The size of the barcode depends on the amount of data.


15

Overcome the Data Length Limit SAP has an internal limit of 70, or at Unicode mode 35 characters for transferring barcode data from layout set to the printer. See the general description in chapter 5, in Data length Limit. In case of PCL the data accumulation is achieved by using the 24000 dummy barcode type as seen in the following example. Data accumulation example for PCL:

ESC(s24000TABCDESC(0N ESC(s24000T123456789-ABCDEFG ESC(0N ESC(s24850TLASTDATAESC(0N

iXBC will print the PDF417 barcode with the following content:

ABCD123456789-ABCDEFGLASTDATA


16

Print Controls for PostScript and SAPWIN Structure of the barcode command in PostScript printer data (Print Control Prefix ) Print Control prefix | | data | | %BARC: C={type}[,H=n[/m]][,B=n[/m]]……,D=({character data}) or D=<{hexadecimal data}> ( ) < > Postscript string separators will be automatically inserted by the SAP Printer driver. The alternative %BARC: … %BEND block format: %BARC: C={type}[,H=n[/m]][,B=n[/m]]……,D= one or more Postscript strings %BEND In Block-Format all valid Postscript strings will be concatenated until %BEND. Other Postscript language commands and values will be ignored. Structure of the barcode command for SAPWIN (iXBCdll): Print Control prefix | data | suffix

ESCbC={type}[,H=n[/m]][,B=n[/m]]……,D={character data}ESC

The ESC stands for the escape character (Hex 1B). The n is a numerical value with or without decimal point, m is an integer value. {type} stands for barcode type identifier, listed in Table 2 at C= Parameter. {character data} stands for barcode data in printable character representation. Some barcode types allow non printable binary bytes (0-127 or 0-255). How to transfer those data content, see the Chapter “Send non printable characters”. {hexadecimal data} stands for barcode data totally represented as hexadecimal string. Only C=, H=, B= and D= parameters are illustrated above. All possible parameters are listed in Table 2.


17

Table 2. Param Value Meaning C=

E8 E13 E128 39 39P 39E 39EP 25L 25L2 25LP 25L2P 128B 128C 128 CODA CODAP UA UCE OCRB PDF PDFT DMX DMXDP

Barcode type identifier EAN-8 EAN-13 EAN-1284 Code39 (w/n ratio = 2.5) Code 39 + check digit (w/n ratio = 2.5) Code39ext (w/n ratio = 2.5) Code 39ext + check digit (w/n ratio = 2.5) Interleaved 2 of 5 (w/n ratio = 3) Interleaved 2 of 5 (w/n ratio = 2) Interleaved 2 of 5 + check digit (w/n ratio = 3) Interleaved 2 of 5 + check digit (w/n ratio = 2) Code128 Code B Code128 Code C Code128 autoswitch CODABAR (w/n ratio = 3) CODABAR + check digit mod 16 (w/n ratio = 3) UPC-A UPC E OCRB-B font6 PDF417 *) PDF417 Truncated *) DataMatrix *) **) “Deutsche Post DV-Freimachung” Stamp&Logo *) **)

*) available in iXBC 2D edition **) with Version 2.2 and upwards H= n

n/m

Height of the barcode in [mm] Only in case of PDF417: Height in [mm] at a given number of rows

B= n n/m

Width of the barcode in [mm]5 Only in case of Code39, Interleaved 2of5, EAN128, Code128 and PDF417: Width in [mm] at given number of coded characters or - in case of PDF417 - at given number of columns

P= 0 1 n n%

Only in case of Code39, Interleaved 2of5, Code128: without checksum with checksum Only in case of PDF417: Error Correction Level: 0 to 8 Error Correction relative to user data: 0 to 400 % If the P= parameter is omitted (or at 0 %), the recommended PDF417 ECC level will be automatically calculated.


18

X= +n -n n

with + (fwd) or – (bwd) sign horizontal offset from the current cursor position absolute horizontal position in [mm]

Y= +n -n n

with + (down) or – (up) sign vertical offset from the current cursor position absolute vertical position in [mm]7

R= 0 1 2 3

horizontal, reading from left to right (0°) – default vertical, reading from down to top (90°)

horizontal, reading from right to left (180°) vertical, reading from top to down (270°)

Q= 0 1 2 3

Controls the position of the symbol related to current writing cursor

A= n

Only in case of PDF417: Symbol aspect ratio (height / width). Default=0.5

a= m

Only in case of PDF417: Modul aspect ratio (height of elementar row/ width of smallest bar). Default=5

D= Start user data. This must be the last parameter. If only the D= parameter is specified, the barcode data is only accumulated, not printed

The parameters B=, H=, X=, Y= use [mm] as unit of measure. The appropriate single parameters have to be selected and joint together to the print control prefix for every required barcode type and size in SAP SE73. Examples for Postscript: Some ready to use Print Control samples are listed for SAP in Chapter 8. If the Device Type in SAP once customized, the SAPscript or SmartForms formatting tool merges the Print Controls and the variable barcode data together, like this: Print Control prefix | | data | | %BARC: C=39,H=15,B=85/10,D=(12345-ABCD) The enclosing parentheses at begin and end of the character data are inserted automatically by Postscript driver, therefore should not be included neither in the Print Control nor in the data. No extra suffix is needed. Because of the leading %, this sequence is only a comment in the standard Postscript language, but interpreted by iXBC. Non SAP applications should be able to generate similar Postscript comment lines, or alternatively insert %BARC: and %BEND marking a block of postscript lines that have the barcode data.

3 0 2 1


19

Barcode data between %BARC: … %BEND in block format:

Prefix

Part of original PostScript text

%BARC: C=39,H=15,B=85/10,D= 180 510 moveto (12345-) show 195 510 moveto (ABCD) show

%BEND Suffix Prefix

Part of original PostScript text

or %BARC: C=39,H=15,B=85/10,D=

180 510 moveto <31323334352D> show 195 510 moveto <41424344> show

%BEND Suffix

In both cases the barcode data is: 12345-ABCD Examples for SAPWIN: Some ready to use Print Control samples are listed for SAP in Chapter 8. If the Device Type in SAP once customized, the SAPscript or SmartForms formatting tool merges the Print Controls and the variable barcode data together, and transfer to the Windows print demon SAPlpd: Print Control prefix | data | suffix ESCbC=39,H=7.5,B=80/10,D=12345-ABCDESC If SAPlpd encounters ESCb, calls BARCODE.dll (iXBCdll) to print the barcode in current position.

Overcome the Data Length Limit SAP has an internal limit of 70, or at Unicode mode 35 characters for transferring barcode data from layout set to the printer. See the general description in chapter 5, in Data length Limit. In case of PostScript or SAPWIN all data packets, except the last one, should contain only the D parameter. The program is buffering all the data until you issue a barcode command with at least the C parameter additional to the D parameter.


20

Data accumulation example for PostScript: PDF417: horizontal, 15x85 mm with long data %BARC: D=(ABCD) %BARC: D=(123456789-ABCDEFG) %BARC: C=PDF, D=(LASTDATA) Example for SAPWIN: PDF417: horizontal, 15x85 mm with long data ESCbD=ABCDESC ESCbD=123456789-ABCDEFGESC ESCbC=PDF, D=LASTDATAESC

Additional Information Sample Files In your Install-Package, normally in the samples directory, also a set of demo files is included. These test cases are useful to examine with an editor how printing sequence for a barcode looks like from PCL, PostScript or SAPWIN. Note: Some of these are binary files, and many need to be sent to your printer in binary mode or to be edited with a binary editor. 2 Normally the barcode is placed over the cursor baseline, while with the command line parameter –vd it is printed under the baseline (SAP versions before 4.6A assume the Prescribe positioning). 3 The width of the barcode can slightly deviate from the specified value in order to optimally combine the barcode raster with the printer resolution. 4 EAN-128: The starting FNC1 is automatically included. To place other FNC1 as field separator, use the character defined with –g command line parameter or hex 81 (129). 5 Printing OCR-B fonts: only T parameter needed. Optional parameters are B = –1 for right aligned, H = –1 for justify under the baseline and P for vertical printing. ixbc.amf font file must be installed in the same directory. 6 Required parameters are C and D. Optional parameters are Q for all possible alignment, R for vertical printing. ixbc.amf font file must be installed in the same directory. 7 Absolute vertical position is measured from the bottom of the paper at PostScript, while at SAPWIN and PCL it is measured from the top of the page.


21

7. Print Control setting in SAP The barcode settings in the SAP are made on device type level, which is applied for all printers using the same device type.

1. Find out in the “Spool Administration program” (by choosing Tools-

>CCMS->Spool->Spool administration or transaction SPAD), what kind of device type is assigned (Device Type references) to the printers on witch you want to perform barcode printing.

2. Copy the device types, that you found, onto a name reserved for SAP-

users (e.g. copy HP4100 to ZHP4100 or POST2 to ZPOST or SAPWIN to ZSAPWIN) by using Utilities->For print control->Copy device type. After that, change the Device Type references at the printers to the new ones by choosing the Devices/server tab page and clicking Output devices. Select your printer by double click. In the Device Attributes tab page you can change the Device Type (e.g. to ZHP4100).

3. Change the print controls at those new device types according to the Print

Controls described in tables 1 and 2 using the SAP Transaction SE73. Defining the Print Controls in SAP “Font Administration” You can add your new print controls for the copied device type with Tools ->SAPscript->Administration->Font (transaction SE73). Select Printer bar codes and choose Change. Select your new device type by double click. Set the cursor to a prefix-id and press “Maint. Print Control”, to edit existing Print Control or press “Create” to define a new one:

The original settings of the print controls in SAP for PCL type printers are often presented in Hexadecimal mode. In your definitions you can switch off the Hex-


22

Switch, and write the control sequence in better readable form, as in the samples in Chapter 8 and shown on the following snapshot:

The ESC character should be entered as \e. Also for SAPWIN Print Controls you should explicit enter the ESC character as \e, if you use print control property variant 1 (Direct, no extension).

• The suffix at PCL is technically needed, but carries no barcode attributes;

therefore you can let the SAP original settings: ESC(0N • You can test the correct installation of the iXBC and the print controls by

printing the bar code test document shipped with SAP in the client 000. You will find it in the Standard text menu under the name:

SAPSCRIPT-BARCODETEST,ST,E

8. Predefined SAP Device Types for iXBC You can find predefined SAP Device Types in docu directory on the CD: ZHP4100.PRI for PCL printers ZPOST2.PRI for Postscript printers ZSAPWIN.PRI for fontend printing with SAPLpd You can import the Device Types with SAP transaction SPAD.


23

9. Print Control Samples for cut and paste + modify Pay attention for maintaining attributes of print controls in SAP by SE73 “printer barcodes”: The Variant, the first field in “Maintain Print Control” window, should be 1 (direct, no extension). We do not recommend the use of Variant 5, because it could confuse you. To set the Variant to 1, you should use Print Control maintenance function in the transaction SPAD, because the Variant cannot be changed at SE73. The Hex-Switch should be blank.

PCL Print Control

Prefix Suffix Barcode characteristic (type, size)

1 \e(s1p12v75b10h24700T \e(0N Code128 autocompress 12mm high 2 \e(s1p-12v75b10h24700T \e(0N as 1, but downwards from the character baseline 3 \e(s1p12v90b10h24702T \e(0N as 1, but uncompr. Code B 90mm w. at 10 char data 4 \e(s1p12v90b10h24704T \e(0N as 3, but compressed Code C (numeric only) 5 \e(s1p13v50b10h24670T \e(0N Code39 20mm high 50mm wide at 10 charakter data 6 \e(s1p13v50b10h24671T \e(0N Same as 5, but with check digit 7 \e(s1p20v50b24620T \e(0N EAN8 20mm high 50mm wide 8 \e(s1p13v50b24630T \e(0N EAN13 13mm high 50mm wide 9 \e(s1p13v50b10h24640T \e(0N 2of5 int. 13mm high 50mm wide at 10 digit data 10 \e(s1p13v50b10h24641T \e(0N Same as 9, but with check digit 11 \e(s110T \e(0N OCR-B check-noting for optical character recognition 12 \e(s1p4850T \e(0N PDF417 with automatic sizing 13 \e (s1p16v16b24820T \e(0N DataMatrix 16x16mm 14 \e(s1p22h24821T \e(0N Stamp&Logo “Deutsche Post DV-Freimachung” 15 \e24000T \e(0N Only collect data for the next 2D barcode

Postscript Print Control SAPWIN Print Control Prefix (no Suffix needed) Prefix Suffix

1 %BARC: C=128,H=12,B=75/10,D= \ebC=128,H=12,B=75/10,D= \e 2 %BARC: C=128,H=12,B=75/10,Q=1,D= \ebC=128,H=12,B=75/10,Q=1,D= \e 3 %BARC: C=128B,H=12,B=75/10,D= \ebC=128B,H=12,B=75/10,D= \e 4 %BARC: C=128C,H=12,B=75/10,D= \ebC=128C,H=12,B=75/10,D= \e 5 %BARC: C=39,H=13,B=50/10,D= \ebC=39,H=13,B=50/10,D= \e 6 %BARC: C=39P,H=13,B=50/10,D= \ebC=39P,H=13,B=50/10,D= \e 7 %BARC: C=E8,H=20,B=50,D= \ebC=E8,H=20,B=50,D= \e 8 %BARC: C=E13,H=13,B=50,D= \ebC=E13,H=13,B=50,D= \e 9 %BARC: C=25L,H=13,B=50/10,D= \ebC=25L,H=13,B=50/10,D= \e 10 %BARC: C=25LP,H=13,B=50/10,D= \ebC=25LP,H=13,B=50/10,D= \e 11 %BARC: C=OCRB,D= \ebC=OCRB,D= \e 12 %BARC: C=PDF,D= \ebC=PDF,D= \e 13 %BARC: C=DMX,H=16,A=1,D= 14 %BARC: C=DMXDP,B=1/22,D= 15 %BARC: D= \ebD= \e

Date post:	12-Feb-2022
Category:	Documents
Upload:	others
View:	3 times
Download:	0 times

Installation guide A4 221 vor umbau - AGOSYS

Documents