HP (Hewlett-Packard) PDF417 User Manual

Page of 33
PDF417  
Installation 
Guide 
NeoMedia Technologies, Inc. 
 
Page 7 
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: