1 S50002

CLIPPER 5.0 SUPPORT BULLETIN #2

BULLETIN REVISED: 27 Sept. 1990

PRODUCT: Clipper 5.0

AFFECTED VERSIONS: Rev. 1.00 - 1.03

SUBJECT: Clipper 5.0 installation procedures


This document provides information on the installation procedures
for Clipper 5.0. For information about the contents of the
distribution disks and archive files, refer to CLIPPER 5.0
SUPPORT BULLETIN #1 (S50001.TXT).



THE CLIPPER 5.0 INSTALL PROGRAM.

Clipper 5.0 distribution files are supplied in the form of
"self-expanding" archive files. Clipper 5.0 includes an
automated install program (INSTALL.EXE) which expands the
archive files into specified target locations and optionally
builds utilities and a base pre-linked library (.PLL).

INSTALL is driven by an installation script (INSTALL.INS) which
describes the location of the archive files on the distribution
disks and the default locations of the distribution files on
the target drive. The basic sequence of operations for INSTALL
is as follows:

1. Ask user for information regarding paths and installation
options.

2. Create subdirectories on the target drive.

3. Extract distribution files from the archive files on the
distribution disks.

4. Build base pre-linked library (if requested).

5. Build utilities (if requested).

6. Create AUTOEXEC.CHG and CONFIG.CHG which detail necessary
changes to your AUTOEXEC.BAT and CONFIG.SYS files.

INSTALL is designed so that it can be rerun to complete an
interrupted installation or to install optional files at a
later time. If problems occur during installation, INSTALL can
be rerun to complete the installation after the problem has
been resolved. When rerunning INSTALL, select the desired
installation options as if you were installing for the first
time. INSTALL will check the contents of the specified target
drive and directory against the distribution disks and transfer
or build any necessary files.


INSTALLATION PITFALLS.

The following are some common problems that can occur during
installation.


PROBLEM: Missing files due to insufficient disk space on the
target drive.

SOLUTION: Make more space available on the target drive and
then rerun the install program.


PROBLEM: Insufficient memory to build utilities ("memory
overbooked" messages).

EXPLANATION: To build the utilities, INSTALL requires
approximately 523K of free memory.

SOLUTION: Make additional memory available by rebooting your
computer without memory resident utilities or network software,
then rerun INSTALL.

ALTERNATE SOLUTION: Build the utility programs manually (see
BUILDING UTILITIES MANUALLY below).


PROBLEM: System hangs while building utilities.

EXPLANATION: INSTALL generates a batch file in order to build
the utilities. This batch file includes a SET PATH command to
add some necessary directories to the PATH environment
variable. Under some versions of DOS, attempting to increase
the length of the PATH environment variable beyond 128 bytes
causes COMMAND.COM to hang.

SOLUTION: Remove unnecessary entries from PATH and rerun
INSTALL.

ALTERNATE SOLUTION: Build the utility programs manually (see
BUILDING UTILITIES MANUALLY below).


PROBLEM: Problems installing in DOS 4.x environment.

EXPLANATION: When creating the batch files to build utilities,
INSTALL may generate a SET PATH command which ends with a
semicolon. Under DOS 4.x this causes COMMAND.COM to issue an
error message.

ALTERNATE SOLUTION: Build the utility programs manually (see
BUILDING UTILITIES MANUALLY below).



OTHER PROBLEMS

If you experience an installation problem that is not listed
here, please contact Nantucket Technical Support at
213-390-7923 or via Compuserve NANFORUM (leave message for
SYSOP). If possible, please include this information about
your environment: machine make and model, DOS version, memory
available during installation, any memory-resident software you
are using.



MANUAL INSTALLATION

As noted above, Clipper 5.0 distribution files are supplied in
the form of "self-expanding" archive files. The archive files
are executable (.EXE) files. Each archive file, when executed,
creates one or more of the Clipper 5.0 distribution files. The
archives are executed automatically by INSTALL. They may also
be executed directly, allowing all or any part of Clipper 5.0
to be installed manually.



DEFAULT DIRECTORY STRUCTURE

Clipper 5.0 is designed to be installed in a directory
structure (i.e. a directory and a series of subdirectories) on
a hard disk. The distribution files are grouped into archives
in such a way that each archive is associated with a particular
subdirectory of the default directory structure.

Shown below is the default directory structure and its relation
to the archive files. For more information about the directory
structure, refer to the "Getting Started Guide." For
information about the contents of the distribution disks and
the archive files, refer to CLIPPER 5.0 SUPPORT BULLETIN #1
(S50001.TXT).


\CLIPPER5
\BIN containing files from
archive file BIN.EXE

\INCLUDE containing files from
archive file INCLUDE.EXE

\LIB containing files from
archive files LIB1.EXE and LIB2.EXE

\PLL containing file BASE50.LNK from
archive file LIB2.EXE

\SOURCE
\DBU containing files from
archive file DBU.EXE

\PE containing files from
archive file PE.EXE

\RL containing files from
archive file RL.EXE

\SAMPLE containing files from
archive file SAMPLE.EXE

\NG containing files from archive files NG1.EXE and NG2.EXE



HOW TO INSTALL A SINGLE ARCHIVE FILE

1. Determine which archive file is required based on which part
of Clipper 5.0 is to be installed (refer to CLIPPER 5.0 SUPPORT
BULLETIN #1, S50001.TXT).

2. Place the appropriate distribution disk in a floppy drive.

3. Choose the target drive and directory to contain the
distribution files.

4. If necessary, create the target directory on the target
drive.

5. Select the target drive as the current drive and change
directory to the target directory.

6. Execute the appropriate archive file from the floppy. The
archive file will create the appropriate distribution files in
the current drive and directory.


EXAMPLE: MANUALLY INSTALLING THE DBU DISTRIBUTION FILES

1. The archive file required is DBU.EXE.

2. Place the appropriate distribution disk in floppy drive A.
For the 5-1/4 inch distribution disks, DBU.EXE is on disk #4.
For the 3-1/2 inch distribution disks, DBU.EXE is on disk #2.

3. Choose the target drive and directory to contain the
distribution files. Assuming that drive C is the target drive
and that you wish to use the default directory structure, the
DBU files should be installed in C:\CLIPPER5\SOURCE\DBU.

4. If necessary, create the target directory on the target
drive. If the directory C:\CLIPPER5\SOURCE\DBU does not exist,
create the missing directory or directories. Example:

c:
md \clipper5
md \clipper5\source
md \clipper5\source\dbu

(Note that the "md" commands will fail if the specified
directory already exists -- this is normal.)

5. Select the target drive as the current drive and change
directory to the target directory. Example:

c:
cd \clipper5\source\dbu

6. Execute the appropriate archive file from the floppy.
Example:

a:dbu



MODIFYING YOUR ENVIRONMENT VARIABLES

Certain environment (SET command) variables should be set for
Clipper 5.0. Generally this is accomplished by modifying your
AUTOEXEC.BAT file to automatically set the variables each time
you boot your computer. The required settings are as follows:

The PATH variable should include the directory where Clipper
5.0 executable files reside (example: C:\CLIPPER5\BIN).

The LIB variable should include the directory where Clipper 5.0
library files reside (example: C:\CLIPPER5\LIB).

The INCLUDE variable should include the directory where Clipper
5.0 include files reside (example: C:\CLIPPER5\INCLUDE).

Example (placed at the end of AUTOEXEC.BAT):

set path=c:\clipper5\bin;%path%
set lib=c:\clipper5\lib
set include=c:\clipper5\include

You may also wish to set other environment variables. For more
information, refer to the "Getting Started Guide" and
"Programming and Utilities Guide". For general information
about the DOS environment and setting environment variables,
refer to your DOS manual.



BUILDING UTILITIES MANUALLY

Certain Clipper 5.0 utility programs (DBU, PE, RL) are supplied
in source code form. These utilities must be compiled and
linked before they can be used. INSTALL will optionally
install and build these utilities automatically. If you
elected not to install or build the utilities, or if INSTALL
failed to build them successfully, they may be built manually.

IMPORTANT: before the utilities can be successfully built, the
following requirements must be met:

- The Clipper 5.0 executables, libraries, and include files
(the files in C:\CLIPPER5\BIN, C:\CLIPPER5\LIB, and
C:\CLIPPER5\INCLUDE, respectively) must be properly installed.

- Your environment variables must be set correctly (see above).

- The source files for the desired utility must be available.
If the source files have not been transferred from the
distribution disks, you can retrieve them using the INSTALL
program or the manual procedure described above.

Each utility includes a make file (a .RMK file used by RMAKE)
which will compile and link the utility. To make a utility,
simply go to the appropriate directory and execute RMAKE on the
script (.RMK) file.


EXAMPLE: BUILDING DBU

c:
cd \clipper5\source\dbu
rmake dbu

NOTE: this example will create the DBU executable file
(DBU.EXE) in the current directory (C:\CLIPPER5\SOURCE\DBU).
You should copy the executable file into the \CLIPPER5\BIN
directory so that it is accessible via SET PATH.



MANUALLY CREATING THE BASE PRE-LINKED LIBRARY.

Pre-linked libraries (.PLL files) allow faster linking and code
sharing among different applications. The distribution disks
contain a linker script file (BASE50.LNK) which will create a
general purpose .PLL called BASE50.PLL (for information on
building and using .PLL's, refer to the "Programming and
Utilities Guide"). BASE50.PLL is optionally created by INSTALL
during installation. If you elected not to create BASE50.PLL,
or if INSTALL did not create it successfully, you can create it
manually.

IMPORTANT: before BASE50.PLL can be successfully created, the
following requirements must be met:

- The Clipper 5.0 executables and libraries (the files in
C:\CLIPPER5\BIN and C:\CLIPPER5\LIB, respectively) must be
properly installed.

- Your environment variables must be set correctly (see above).

- The PLL directory (\CLIPPER5\PLL) must have been created and
the BASE50.LNK file must reside in it.

To build the BASE50.PLL, change directory to the PLL directory
and run .RTLink on the supplied script file (BASE50.LNK).
Example:

c:
cd \clipper5\pll
rtlink @base50



INSTALLING THE ENTIRE SYSTEM MANUALLY

If necesary, the entire Clipper 5.0 system can be installed
manually using the techniques described above. To do this,
manually install each archive file from the distribution disks
(see HOW TO INSTALL A SINGLE ARCHIVE FILE above). Then modify

your environment variables (MODIFYING YOUR ENVIRONMENT
VARIABLES above). Finally, if desired, the utilities and base
pre-linked library can be created.


END: CLIPPER 5.0 SUPPORT BULLETIN #2