NeoMedia Encoder PDF417 Installation Manual

Hewlett packard encoder installation guide

Advertisement

Quick Links

PDF417 Encoder
Installation Guide
Version 2.2
(Build 2.1.0.4 or later)

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the Encoder PDF417 and is the answer not in the manual?

Questions and answers

Subscribe to Our Youtube Channel

Summary of Contents for NeoMedia Encoder PDF417

  • Page 1 PDF417 Encoder Installation Guide Version 2.2 (Build 2.1.0.4 or later)
  • Page 2 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.
  • Page 3: Table Of Contents

    PDF417 Table of Contents OVERVIEW ... 1 Windows PC-based Installation... 2 Requirements ...2 Preparing for Installation ...2 Installing the Encoder ...2 Linking with the Encoder ...4 ... 5 ACUCOBOL... 6 UNIX Installation... 7 Requirements ...7 Preparing for Installation ...7 Installing the Encoder ...7 Linking with the Encoder ...9 ...
  • Page 4 PDF417 Compiling and Running the sample ILE COBOL Program... 25 RPG... 26 Compiling and Running the sample RPG/400 Program... 26 Compiling and Running the sample ILE RPG Program ... 26 C Language ... 27 Compiling and Running the sample ILE C Program... 27 Output of the sample programs ...
  • Page 5: Overview

    PDF417 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.
  • Page 6: Windows Pc-Based Installation

    ACUCOBOL runtime and a batch file to compile a COBOL program. The fourth directory, pdf417_32bit\docs, contains the user documentation files in Microsoft Word format. The fifth directory, pdf417_32bit\hpfont, contains the font binary files for HP PCL printers. The sixth directory, pdf417_32bit\afpos2, contains the font binary files for OS2 AFP printers.
  • Page 7 PDF417 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.
  • Page 8: Linking With The Encoder

    Contents of the pdf417_32bit\hpFont directory: Object Description HPPP3309.FLJ Font file for HP PCL printers, portrait, 300 DPI, 3x9 pixel module size HPPL3309.FLJ Font file for HP PCL printers, landscape, 300 DPI, 3x9 pixel module size HPPP3412.FLJ Font file for HP PCL printers, portrait, 300 DPI, 4x12 pixel module size HPPL3412.FLJ...
  • Page 9: C/C

    PDF417 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.
  • Page 10: Acucobol

    PDF417 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.
  • Page 11: Unix Installation

    Micro Focus COBOL runtime and a shell script to compile a COBOL program. The fifth directory, pdf417/fontbin, contains a directory ../hp which contains the font binary files for HP PCL printers and the directory../afpos2 which contains the font binary files for OS2 AFP printers.
  • Page 12 Contents of the pdf417/fontbin/hp directory: Object Description HPPP3309.FLJ Font file for HP PCL printers, portrait, 300 DPI, 3x9 pixel module size HPPL3309.FLJ Font file for HP PCL printers, landscape, 300 DPI, 3x9 pixel module size HPPP3412.FLJ Font file for HP PCL printers, portrait, 300 DPI, 4x12 pixel module size HPPL3412.FLJ...
  • Page 13: Linking With The Encoder

    PDF417 Contents of the pdf417/fontbin/afpos2 directory: Object Description C0PD2206 Font character set for OS2 AFP printers, 240 DPI, 2x6 pixel module size X0PD2206 Font code font for OS2 AFP printers, 240 DPI, 2x6 pixel module size C0PD2309 Font character set for OS2 AFP printers, 240 DPI, 2x9 pixel module size X0PD2309 Font code font for OS2 AFP printers, 240 DPI, 2x9 pixel module size C0PD3309...
  • Page 14 PDF417 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.
  • Page 15: Acucobol

    PDF417 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.
  • Page 16: Micro Focus Cobol

    PDF417 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.
  • Page 17: Mvs Installation

    This will depend on your environment’s needs and conventions. The third library, NEO.PDFFNT.Vxxxx, contains fonts for IBM AFP, Xerox, and HP PCL printers. While all fonts are shipped with the NeoMedia Technologies PDF417 encoder, you may not be licensed to use them.
  • Page 18: Installing The Encoder

    PDF417 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.
  • Page 19 PDF417 Object SAMPLEC ISAMLEC ISAMPLEC XSAMPLEC SINKFILE SINKFILS SINKMEM SINKMEMS SAMPLCOB NMPDF417 ISAMLCB ISAMPLCB XSAMPLCB Contents of the NEOMEDIA.PDF417.OBJLIB: Object PDF417EN Contents of the NEOMEDIA.PDF417.FNTLIB: Object Description C0PD2206 AFP character set, bounded box, 240 dpi. 2x6 pixel module size C0PD2309 AFP character set, bounded box, 240 dpi.
  • Page 20: Linking With The Encoder

    PDF417 //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.RSCLIB, DISP=(NEW,CATLG,DELETE), VOL=SER=&DISKVOL,SPACE=(CYL,(1,1,15)), DCB=(RECFM=FB,LRECL=80,BLKSIZE=23440,DSORG=PO) //OUTDD2 DD DSN=NEOMEDIA.PDF417.OBJLIB, DISP=(NEW,CATLG,DELETE), VOL=SER=&DISKVOL,SPACE=(CYL,(1,1,15)), DCB=(RECFM=FB,LRECL=80,BLKSIZE=3200,DSORG=PO) //OUTDD3 DD DSN=NEOMEDIA.PDF417.FNTLIB, DISP=(NEW,CATLG,DELETE), VOL=SER=&DISKVOL,SPACE=(CYL,(1,1,15)), DCB=(RECFM=VBM,LRECL=12284,BLKSIZE=27998,DSORG=PO) //SYSIN DD DUMMY PEND...
  • Page 21: Cobol

    PDF417 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.
  • Page 22 PDF417 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.
  • Page 23: C Language

    PDF417 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.
  • Page 24 PDF417 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.
  • Page 25: Execution Errors

    PDF417 //SYSUT1 //SYSUT2 //SYSIN 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.
  • Page 26: As/400 Installation

    If you require either Xerox or HP PCL fonts, a separate media (usually a diskette) will have been shipped containing the appropriate fonts. Please refer to your NeoMedia Technologies Standard Software License for specific details on which fonts have been licensed for use.
  • Page 27 PDF417 The following objects will be restored: Object Type PDFVxxxx *LIB PDFENCOD *PGM PDFINITF *PGM PDFVxxSRV *SRVPGM *FILE QCBLLESRC *FILE QCSRC *FILE QDDSSRC *FILE QFNTRSC *FILE QLBLSRC *FILE QRPGLESRC *FILE QRPGSRC *FILE STEP 2: Compiling the font resources If you are using an IPDS printer, you will need to create the PDF417 font resources from the source files provided.
  • Page 28: Binding With The Encoder

    PDF417 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.
  • Page 29: Cobol

    PDF417 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.
  • Page 30: Rpg

    PDF417 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.
  • Page 31: C Language

    PDF417 Following is a pictorial diagram of how the pieces fit together using RPG: RPG III (RPG/400) Program CALL PDFINIT 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.
  • Page 32: Output Of The Sample Programs

    PDF417 CALL CPDF Output of the sample programs The sample programs generate a single PDF417 symbol to the output spooler. If you view the spooler, you should see several lines of text characters looking something line the following: OOEDGEALCJBNAC LBKC HDNCICJILAOMAD OOEDGMDCBNLOMMF DOAAADLKOCOEAMOMAD OOEDFJGLBALHMFHG KLLFGNEHKE OIOMAD OOEDGMBOKCDBAACMNJALGGKBCJKNOIOMAD...
  • Page 33: Font Selection

    The information has been broken into two tables; one for UNIX and PC Platforms (ASCII platforms) and a second for IBM S/370, S/390, and AS/400 systems (EBCDIC platforms). Printer Family HP PCL HP PCL Printer Family IBM AFP...

Table of Contents