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

Page 11
Image 11
HP Encoder PDF417 manual Unix Installation