Qualis(tm) 1.0 Installation Guide
---------------------------------------------------------------------------

To print this file from MS-DOS, type "print install.txt" at the command 
line.

Installing Qualis(tm) 1.0:
==========================

Qualis is distributed in 2 forms: 

   qual10s.zip  -- the "Qualis only" distribution, for users who 
		   already have ODBC installed
   qual10so.zip -- the "Qualis + ODBC" distribution, for users 
		   without ODBC installed 

The archives should contain the following files:

   readme.txt      -- the readme file
   install.txt     -- this file, the installation guide
   agreement.txt   -- the Qualis shareware license
   register.txt    -- registration information
   sharware.txt    -- information about shareware
   qual_sea.exe    -- the Qualis self-extracting archive

The qual10so.zip distribution also should contain:

   odbc_sea.exe    -- the ODBC self-extracting archive

If you are missing any of the files above, please contact Tarsus --
you may have an altered version of the software.

Qualis requires ODBC to be installed in Windows before it can access and 
use its database.  If you have ODBC installed already, you can skip to
the "To Install Qualis" section below.  Otherwise, install ODBC first.

To install Qualis, you must first start Windows.  The ODBC setup program
will run only from Windows, and you can only run Qualis from Windows.


To Install ODBC:
----------------
   1)  First create a temporary directory for installation using the 
       Windows' File Manager, then copy the "odbc_sea.exe" file into it.

   2)  Run "odbc_sea.exe" by double-clicking it in File Manager.  It will   
       expand into the ODBC install files.

   3)  Still using File Manager, locate the "setup.exe" file and run it 
       (by double-clicking it).

   4)  ODBC Setup will start, installing ODBC onto your system.
	
       ** make sure you let ODBC install at *least* the **
       ** Microsoft Access data driver.  This is the    **
       ** default driver used by Qualis in the absence  **
       ** of another driver.                            **

   5)  Once ODBC has been installed, you may delete the temporary 
       directory from your hard drive.  You won't need the files in this 
       directory any longer.


To Install Qualis:
------------------
   1)  Locate or create the directory you would like to install the Qualis
       executeable files in, using Windows' File Manager, and copy the 
       "qual_sea.exe" file into this directory.

   2)  Run the "qual_sea.exe" file by double-clicking it in File Manager.
       It will expand into the following files:

       qualis.exe    -- the Qualis executable
       qualis.hlp    -- the Qualis help file and user guide.
       agreemnt.wri  -\
       register.wri  --+- Windows Write versions of the .txt docs. 
       sharware.wri  -/

   3)  delete the "qual_sea.exe" self-extracting archive file.

   4)  Set up a program item in File Manager for Qualis by using the "New"
       command in the Windows' File menu.  Select "New Program Item" and 
       then type in the path to the Qualis executeable file in the "Command
       Line" box, or press the "Browse" button and point to the directory
       where the Qualis executeable is located.

   5)  Click on the Qualis Icon to Start!


Setting up a Data Source
========================

Before Qualis can store your data, it needs to have a data source to store
it in.  You may have a preferred data format for which you have an ODBC
driver, or you can use the default data source that comes with Qualis to
store your data.

Setting up the Default Data Source:
-----------------------------------
   To set up the default data source (a Microsoft Access database), just
   double-click on the Qualis icon in Program Manager (if there's no icon,
   see the above sections on how to install Qualis).  Qualis will state  
   that it can't find the data file and will ask you if you would like to
   create one.  Just press the "Yes" button.
   
   You will then get a dialog called "ODBC Microsoft Access Setup" which
   shows "Qualis Data" as the data source name.  It is important to leave
   the data source name as "Qualis Data", or Qualis won't be able to find
   its database!
   
   Press the "Create Database" key on the dialog, and use the resulting
   file requestor to name and locate the data file.  It can be anywhere 
   you like.  I would suggest calling it "qualdata.mdb", but you can  
   choose another name -- as long as the extension is ".mdb"!

   Press the "OK" button to accept this, and ODBC administrator will
   create the data file -- you should get a message showing success.
   
   Then select the "OK" button on the ODBC Setup screen to register your 
   data source.

   Qualis will then set up the data source and table for you -- and you can
   begin using the program!

Setting up Other Data Sources:
------------------------------
   If you have a database package that uses another data type and you wish
   to use this, you must have the ODBC driver for that package installed.
   Most modern databases come with ODBC drivers, and will install them when
   you install the database software.  If you don't have one installed, or
   you don't know how to get your software to set up its ODBC driver,
   contact your database manufacturer's customer support personnel and ask
   about it.

   If you have the ODBC driver installed, here's what you need to do to set
   up a data source Qualis can use.

   1) Create a data source with a table called "ADDRDATA" using your
      database application.
  
   2) Create the following fields:

   Field Name              Data Type
		   Access          dBase, FoxPro,Paradox
   ------------------------------------------------------
   FName           TEXT (20)       CHAR (20)
   LName           TEXT (25)       CHAR (25)
   ARef            TEXT (1)        CHAR (1)
   Addr1           TEXT (40)       CHAR (40)
   Addr2           TEXT (40)       CHAR (40)
   City            TEXT (25)       CHAR (25)
   State           TEXT (2)        CHAR (2)
   ZipCode         TEXT (10)       CHAR (10)
   HPhone          TEXT (20)       CHAR (20)
   DPhone          TEXT (20)       CHAR (20)
   OPhone          TEXT (20)       CHAR (20)
   FPhone          TEXT (20)       CHAR (20)
   EMail           TEXT (60)       CHAR (20)
   Quals           TEXT (254)      CHAR (254)
   Notes           MEMO            MEMO

   3) Register the data source in ODBC using the ODBC manager in the 
      Windows Control Panel.  Select "Add New Data Source" and then select 
      your data source using the requestors.  Be sure to name your data
      source "Qualis Data".  This is the data source Qualis looks for when
      saving and retrieving its data.
      
   Qualis has been tested with Access, dBase, and FoxPro.  If you have 
   another data type and report success, let us know the driver you used 
   and configuration -- we can pass this information on to other users who 
   would like to use that data type.


Where To Go For More Information
--------------------------------
   Use the "Help Index" command in Qualis' Help menu for information about
   running the program, adding data records, and about ordering Qualis and
   contacting Tarsus.

--------------------------------------------------------------------------
Qualis is a trademark of Tarsus.
Microsoft, MS-DOS, Windows, Access, and FoxPro are registered
  trademarks of Microsoft Corporation.
dBase and Paradox are registered trademarks of Borland International, Inc.

