PDF417 Encoder Installation Guide Version 2.2 (Build 2.1.0.
PDF417 Installation Guide Liability The information in this manual is subject to change without notice and should not be construed as a commitment by NeoMedia Technologies, Inc. NeoMedia Technologies assumes no responsibility for any errors that might appear in this document. The software described in this document is furnished under a license and may be used or copied only in accordance with the terms of such license. © Copyright 1998, 1999, 2000, 2002 NeoMedia Technologies, Inc. All rights reserved.
PDF417 Installation Guide Table of Contents OVERVIEW ................................................................................................................................... 1 Windows PC-based Installation..................................................................................................... 2 Requirements ...........................................................................................................................................2 Preparing for Installation .........
PDF417 Installation Guide Compiling and Running the sample ILE COBOL Program............................................................................ 25 RPG..................................................................................................................................................................... 26 Compiling and Running the sample RPG/400 Program..................................................................................
PDF417 Installation Guide OVERVIEW This document provides the installation instructions for the NeoMedia Technologies PDF417 encoder library. For a detailed description of how to use the encoder, refer to the programmer’s manual, PDF417 Programming Guide. The PDF417 encoder library is a powerful set of functions for generating and printing PDF417 barcode symbols in a variety of hardware and software environments. The library is written in ANSI C and is shipped in compiled object form.
PDF417 Installation Guide Windows PC-based Installation It is highly recommended that the installation of the PDF417 encoder be performed by a skilled System Administrator with intimate knowledge of your Windows environment. The instructions that follow are written in a general sense and will work on most Windows based systems. However, due to the wide and varied PC-based configurations available, it is impossible to provide concise instructions for all possible scenarios.
PDF417 Installation Guide For 32-bit installation, this process will create the pdf417 directory structure (pdf417_32bit). For the 16-bit installation, this process will create the top level directory (pdf417_16bit) and copy all files into this directory. For the 32-bit installation, once you have installed the PDF417 encoder, you must copy the pdfenc_d.dll into a directory where it can be found at execution time.
PDF417 Installation Guide Contents of the pdf417_32bit\hpFont directory: Object HPPP3309.FLJ HPPL3309.FLJ HPPP3412.FLJ HPPL3412.FLJ Description Font file for HP PCL printers, portrait, 300 DPI, 3x9 pixel module size Font file for HP PCL printers, landscape, 300 DPI, 3x9 pixel module size Font file for HP PCL printers, portrait, 300 DPI, 4x12 pixel module size Font file for HP PCL printers, portrait, 300 DPI, 4x12 pixel module size Contents of the pdf417_32bit\afpOS2 directory: Object C0PD2206.
PDF417 Installation Guide C/C++ To compile and link the sample program for ‘C’: NOTE: Compiling and testing the C sample is not a required step for installation of the PDF417 Encoder. It is recommended if you will be using the C API. 1. Create a test directory to build the sample program in. Note: for the 16-bit installation, you can build the sample programs in the installation directory. 2. Change directory to the sample directory just created (...\test) and copy the following files to this directory: .
PDF417 Installation Guide ACUCOBOL To compile and link the sample program for ACUCOBOL: NOTE: Compiling and testing the COBOL sample is not a required step for installation of the PDF417 Encoder. It is recommended if you will be using the COBOL API. 1. Create a runtime which includes ACUCOBOL and PDF417 encoder library (wpruncbl.exe): • Change directory to the acu directory in the PDF417 distribution, ...\pdf417_32bit\acu • Make sure that the variables are defined correctly in wpruncbl.
PDF417 Installation Guide UNIX Installation It is highly recommended that the installation of the PDF417 encoder be performed by a skilled System Administrator with intimate knowledge of your UNIX environment. The instructions that follow are written in a general sense and will work on most UNIX systems. However, due to the wide and varied UNIX configurations available, it is impossible to provide concise instructions for all possible scenarios.
PDF417 Installation Guide Contents of the pdf417/lib directory: File Name libpdfenc.a pdfenc.h pdfdefs.h pdfrend.h Description Encoder static link library. C #include file. C #include file. C #include file. Contents of the pdf417/sample directory: Object readmeunix.txt samplec.c makesam.umf samplcob.cob nmpdf417.cob sinkfils.c sinkfile.h sinkmems.c sinkmem.h Description A standard README file. Sample C program. Makefile for compiling the sample C program. Sample COBOL program.
PDF417 Installation Guide Contents of the pdf417/fontbin/afpos2 directory: Object C0PD2206 X0PD2206 C0PD2309 X0PD2309 C0PD3309 X0PD3309 C0PD3412 X0PD3412 T1PDF417 Description Font character set for OS2 AFP printers, 240 DPI, 2x6 pixel module size Font code font for OS2 AFP printers, 240 DPI, 2x6 pixel module size Font character set for OS2 AFP printers, 240 DPI, 2x9 pixel module size Font code font for OS2 AFP printers, 240 DPI, 2x9 pixel module size Font character set for OS2 AFP printers, 300 DPI, 3x9
PDF417 Installation Guide program should be able to understand the .BMP format. Microsoft Imaging should be able to understand the .TIF format. To test the symbol, you can print the file from within the applications named above and then scan them. For the character font file, you will have to print the file with the appropriate font definition file loaded. Printing the symbol files is beyond the scope of this document. NeoMedia Technologies, Inc.
PDF417 Installation Guide ACUCOBOL To compile and link the sample program for ACUCOBOL: NOTE: Compiling and testing the COBOL sample is not a required step for installation of the PDF417 Encoder. It is recommended if you will be using the COBOL API. 1. Create a runtime which includes ACUCOBOL and PDF417 encoder library (pruncbl): • Change directory to the acu directory in the PDF417 distribution, .../pdf417/acu • Make sure that the variables are defined correctly in pruncbl.
PDF417 Installation Guide Micro Focus COBOL To compile and link the sample program for Micro Focus COBOL: NOTE: Compiling and testing the COBOL sample is not a required step for installation of the PDF417 Encoder. It is recommended if you will be using the COBOL API. 1. Create a runtime which includes Micro Focus COBOL and PDF417 encoder library (prunmf): • Change directory to the mf directory in the PDF417 distribution, .../pdf417/mf • Make sure that the variables are defined correctly in prunmf.
PDF417 Installation Guide MVS Installation It is highly recommended that the installation of the PDF417 encoder be performed by a skilled System Administrator with intimate knowledge of your MVS environment. The instructions that follow are written in a general sense and will work on most MVS systems. However, due to the wide and varied MVS configurations available, it is impossible to provide concise instructions for all possible scenarios. Some of the JCL may therefore require customization.
PDF417 Installation Guide License for specific details on which fonts have been licensed for use. Use of unlicensed fonts is a violation of the Standard Software License and is strictly prohibited. Installing the Encoder The installation media for MVS is in IEBCOPY format. As part of the installation process, three libraries must be copied from tape into three PDS. The following tables list the PDS space and DCB requirements, and each PDS contents. NOTE: The Vxxxx is the PDF417 encoder version indicator.
PDF417 Installation Guide Object SAMPLEC ISAMLEC ISAMPLEC XSAMPLEC SINKFILE SINKFILS SINKMEM SINKMEMS SAMPLCOB NMPDF417 ISAMLCB ISAMPLCB XSAMPLCB Description Sample C program. Sample JCL for building SAMPLEC. Sample JCL for building SAMPLEC using the pre-linker. Sample JCL for executing SAMPLEC. C #include file. Sample C program. C #include file. Sample C program. Sample COBOL program. COPYLIB for sample COBOL program. Sample JCL for building SAMPLCOB.
PDF417 Installation Guide //SYSPRINT DD SYSOUT=* //SYSUT3 DD SPACE=(CYL,(5,5)),UNIT=SYSDA //SYSUT4 DD SPACE=(CYL,(5,5)),UNIT=SYSDA //INDD1 DD DSN=NEO.PDFRSC.&V,UNIT=&TAPEUNIT,DISP=(OLD,KEEP), // VOL=(,RETAIN,SER=NEO417),LABEL=(1,SL) //INDD2 DD DSN=NEO.PDFOBJ.&V,UNIT=&TAPEUNIT,DISP=(OLD,KEEP), // VOL=(,RETAIN,SER=NEO417),LABEL=(2,SL) //INDD3 DD DSN=NEO.PDFFNT.&V,UNIT=&TAPEUNIT,DISP=(OLD,KEEP), // VOL=SER=NEO417,LABEL=(3,SL) //OUTDD1 DD DSN=NEOMEDIA.PDF417.
PDF417 Installation Guide COBOL To compile and link the sample program for COBOL: NOTE: Compiling and testing the COBOL sample is not a required step for installation of the PDF417 Encoder. It is recommended if you will be using the COBOL API. First, the encoder objects must be linked into a load module. A sample JCL (IPDFLNK) has been provided in the NEOMEDIA.PDF417.RSCLIB PDS for creating the load module PDF417 in NEOMEDIA.PDF417.RSCLIB PDS. 1. Edit ‘NEOMEDIA.PDF417.RSCLIB(IPDFLNK)’ and SUBMIT it.
PDF417 Installation Guide NOTE: The very first step in the XSAMPLEC has been commented out because there is nothing to be deleted during the first run of this program. If you decided to re-execute this program, then the DELETE step would be needed. For successful execution, there will be no screen output but one file will be generated as an output file via the TPDFFONT DD card defined in the JCL.
PDF417 Installation Guide C Language To compile and link the sample program for C: NOTE: Compiling and testing the C sample is not a required step for installation of the PDF417 Encoder. It is recommended if you will be using the C API. First, the encoder objects must be linked into a load module. A sample JCL (IPDFLNK) has been provided in the NEOMEDIA.PDF417.RSCLIB PDS for creating the load module PDF417 in NEOMEDIA.PDF417.RSCLIB PDS. 1. Edit ‘NEOMEDIA.PDF417.RSCLIB(IPDFLNK)’ and SUBMIT it.
PDF417 Installation Guide The XSAMPLEC member in the NEOMEDIA.PDF417.RSCLIB PDS executes the SAMPLEC executable created above. This program generates an output file via the NMPDFFNT DD card. NOTE: The very first step in the XSAMPLEC has been commented out because there is nothing to be deleted during the first run of this program. If you decided to re-execute this program, then the DELETE step would be needed.
PDF417 Installation Guide //SYSUT1 //SYSUT2 //SYSIN // DD DD DD DSN=YOUR.PDFOUT.DATA,DISP=SHR SYSOUT=*,OUTPUT=*.AFP DUMMY Execution Errors Depending on what environment you are installing in, users have encountered some execution problems. If you are getting a SOC1 or SOC4 error at execution time, check the concatenation list. The PDF417 Encoder depends on the C runtime being available at runtime. The SOC1 and SOC4 error usually indicates a missing LOADLIB or runtime system library.
PDF417 Installation Guide AS/400 Installation It is highly recommended that the installation of the PDF417 encoder be performed by a skilled System Administrator with intimate knowledge of your AS/400 environment. The following instructions are written in a general sense and will work on most AS/400 systems. However, due to the wide and varied configurations possible, it is impossible to provide concise instructions for all possible scenarios.
PDF417 Installation Guide The following objects will be restored: Object PDFVxxxx PDFENCOD PDFINITF PDFVxxSRV H QCBLLESRC QCSRC QDDSSRC QFNTRSC QLBLSRC QRPGLESRC QRPGSRC Type *LIB *PGM *PGM *SRVPGM *FILE *FILE *FILE *FILE *FILE *FILE *FILE *FILE Attribute *TEST CLE CLE CLE PF-SRC PF-SRC PF-SRC PF-SRC PF-DTA PF-SRC PF-SRC PF-SRC Text NeoMedia PDF417 Encoder Vx.x.x.
PDF417 Installation Guide Binding with the Encoder The AS/400 has two distinct development environments: OPM and ILE. The OPM (Original Programming Model) consists of language products like RPG/400, COBOL/400, and PL/I. ILE (Integrated Language Environment) consists of language products like ILE RPG, ILE COBL, and ILE C. The way the PDF417 encoder library is used in these two environments is identical; however, the way the encoder is called differs.
PDF417 Installation Guide CRTPRTF FILE(PDFVxxxx/PDF417) SRCFILE(PDFVxxxx/QDDSSRC) SRCMBR(PDF240) DEVTYPE(*AFPDS) REPLACE(*YES) To create the printer file for a 300 DPI printer, use the following: CRTPRTF FILE(PDFVxxxx/PDF417) SRCFILE(PDFVxxxx/QDDSSRC) SRCMBR(PDF300) DEVTYPE(*AFPDS) REPLACE(*YES) COBOL To compile and link the sample program for COBOL: NOTE: Compiling and testing the COBOL sample is not a required step for installation of the PDF417 Encoder.
PDF417 Installation Guide RPG To compile and link the sample program for RPG: NOTE: Compiling and testing the RPG sample is not a required step for installation of the PDF417 Encoder. It is recommended if you will be using the COBOL API. Compiling and Running the sample RPG/400 Program The sample RPG/400 program calls the PDFVxxxx/PDFENCOD program. The source for the sample program is in PDFVxxxx/QRPGSRC(RPGPDF).
PDF417 Installation Guide Following is a pictorial diagram of how the pieces fit together using RPG: RPG III (RPG/400) OPM Program CALL RPG IV (ILE) Compile w/opt 14 ILE Program Compile w/opt 15 CALL CALLB PDFINIT PDFENCOD (CRTPGM to bind) PDFvv/PDFvvSRV Service Program (PDFvv, or whatever library PDFvvSRV is installed in MUST be in the *LIBL) C Language To compile and link the sample program for C: NOTE: Compiling and testing the C sample is not a required step for installation of the PDF417
PDF417 Installation Guide CALL CPDF Output of the sample programs The sample programs generate a single PDF417 symbol to the output spooler.
PDF417 Installation Guide Font Selection As mentioned earlier, the PDF417 encoder is shipped with all available printer fonts. Supported platforms include IBM AFP, Xerox, and Hewlett Packard PCL printers. The following tables list all of the supported platforms and printers. The font name is the name of the font file in the distribution kit.
