          **************************************************
          *    Phase3 Version 2.0 - Installation Notes     *
          **************************************************

       ---------------------------------------------------------
       Before reading this document, please maximize the NotePad
       window to fill the entire screen. The text in this
       document has been laid out to fit a maximized window on a
       640 x 480 screen.
       ---------------------------------------------------------


The Phase3 Installation program has detected an existing copy of Phase3 on
your system. This new version of Phase3 may contain important differences
from your existing version. Any applications you have developed using
your existing version of Phase3 may need to be amended before they can
be used with the new version. Please read the following notes about this
new version before proceeding with the installation.


------------------------------------------------------------------------
Upgrading Existing Version 1.2 Applications
------------------------------------------------------------------------

Version 2.0 now uses dBase format for storing data and indexes in the
database (versions 1.2 and earlier used the Phase3 proprietory format). 
If you have developed any applications using Phase3 version 1.2 or 
earlier, this version of Phase3 will automatically convert those 
applications to 2.0 format. Any data stored in a Phase3 database in the old
Phase3 format will also be automatically converted to dBase format. 

However, certain aspects of the database conversion will NOT be handled by 
this Beta release and must be converted manually. This section describes 
the manual changes you will need to make.

Standard dBase format imposes two restrictions on column definitions that
did not exist in the old Phase3 proprietory format:

	- the first 10 characters of a column name must be unique

	- columns of character type must be less than 256 characters in
	  length.

If your exisiting application has a database that violates either of these
restrictions, you should ABORT THIS INSTALLATION and load your application 
using the OLD VERSION of Phase3. Open the E-R diagram and amend each entity
as follows:

	- any field name that is not unique in its first 10 characters 
	  should be modified so that the first 10 characters are unique
	  ACROSS ALL ENTITIES

	- any character field that is longer than 255 characters should
	  be modified to be less than 256 characters in length (or converted
	  to a Memo field if you wish to store large amounts of text
	  in the field).

Save the amended E-R diagram and then open the Database Browser. This will
convert the database data to the new structure you have just amended.
When you have done this, you can then install the new version of Phase3 
and load the existing application. Phase3 will then be able to convert 
the existing application to the new version 2.0 format.


---------------------------------------------------------------------------
Upgrading Prior Versions of Phase3
---------------------------------------------------------------------------

When you have completed the installation of this new version of Phase3,
you will need to replace certain existing files on your system with
the new versions. This section describes how to do this.

This version of Phase3 introduces a new naming convention for the two 
Phase3 DLLs that are required by your generated applications. The DLLs
have been renamed as follows:

	Previous Name   New Name       Description
	-------------   --------       -----------

	P3RDBMS.DLL     P3RDB200.DLL   Phase3 database ("DB_") routines
	P3LIBRY1.DLL    P3LIB200.DLL   Phase3 general purpose routines

The new naming convention will allow future version upgrades to avoid
clashes with pre-existing DLLs.

If you have applications on your system that have been developed with a
previous version of Phase3 (either 1.5 or earlier), you will need to
make the following changes to each application. You should make these
changes after you have completed the installation of the new version of
Phase3.

1. Install the new version of Phase3 by completing the Install program.

2. Copy the new DLLs, P3RDB200 and P3LIB200, into the application's
directory. Alternatively, if you have stored the old Phase3 DLLs in the
Windows directory on your system, you should replace the old DLLs with
P3RDB200 and P3LIB200.

3. For C applications, copy P3USER.C and P3USER.H from the new version of
Phase3 to the application's directory.

4. For Pascal applications, copy P3USER.PAS from the new version of Phase3
to the application's directory.

5. For C applications, change the application's Make file to reflect the
new Phase3 DLL names. In the "Libraries" macro in the Make file, change
"P3RDBMS" (or "P3RDB150") to "P3RDB200" and change "P3Libry1"
(or "P3LIB150") to "P3LIB200".

6. For C applications, make sure that the include file "P3TYPES.H" is
#include'd before "P3PROCS.H". These #include's are found in the header
files for the main program and any module files (ver 1.2 and later).

Once you have made these changes, you can then re-compile the application
using the new version of Phase3.
