HP Encoder PDF417 manual Unix Installation

Page 11

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. Some of the instructions may therefore require customization.

Requirements

The encoder is supported for use with the following products:

C/C++

ACUCOBOL

Micro Focus COBOL

After completing the installation, the PDF417 encoder will be available as a static library that can then be linked with your applications. While linking and running the encoder with products other than those listed above may be possible, these types of configurations are not supported by NeoMedia Technologies.

Preparing for Installation

The PDF417 encoder is distributed as a standard tar archive. The archive consists of a root directory, pdf417, with the following five sub-directories.

The first directory, pdf417/lib, contains the PDF417 encoder static library (.a) and C header files which will need to be included in your application.

The second directory, pdf417/sample, contains a variety of resources for the programmer, including sample programs, callback function definition source files, and C header files.

The third directory, pdf417/acu, contains the ACUCOBOL specific files required for building an ACUCOBOL runtime and a shell script to compile a COBOL program.

The fourth directory, pdf417/mf, contains the Micro Focus COBOL specific files required for building a 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.

Installing the Encoder

The installation media for UNIX is in tar archive format. Use tar with the appropriate device for your system to extract the files. The following example is for extracting from a floppy disk on an SCO UNIX system:

%umask 0

%tar xvf /dev/rfd0 .

The following tables list the contents of each of the directories:

NeoMedia Technologies, Inc.

Page 7

Image 11
Contents Installation Guide Liability Table of Contents Compiling and Running the sample ILE Cobol Program Overview Preparing for Installation Installing the Encoder Windows PC-based InstallationFile Name Description Linking with the Encoder \test nmake /f samplec.mak Acucobol Unix Installation File Name Unix C compiler cc is being used Installation Guide $ make -f pruncbl.umf Micro Focus Cobol IBM Cobol MVS InstallationVBM Samplec Linking with the Encoder Cobol Installation Guide Language Sysout DD SYSOUT= Sysudump Execution Errors Restoring the encoder from tape AS/400 InstallationCompiling the font resources Binding with the Encoder Compiling and Running the sample COBOL/400 Program Compiling and Running the sample RPG/400 Program Compiling and Running the sample ILE C Program Output of the sample programs IBM S/370, S/390, AS/400 Printer Family Font Selection