                             Contents
                             --------
              1. Installation of Rexx/SQL on Unix
              2. Installation of Rexx/SQL on OS/2 and Windows NT/95/98
              3. Testing the installation


1. Installation of Rexx/SQL on Unix
===================================
To install Rexx/SQL, unpack the archive (you have probably already done
that), run the configure script supplying the necessary command line 
parameters.  To see what parameters the configure script recognises,
type ./configure --help

Depending on the database you intend using with Rexx/SQL, these vary.
The configure script will inform you of the parameters required.

Once Rexx/SQL has been configured, simply run "make".
To install Rexx/SQL, run "make install"

Using Oracle...
---------------
If you run "make" and get an error along the lines of "don't know how
to make cdemo1.c", run make with the "all" target. ie "make all"

Using Solid Server 2.2 ...
--------------------------

*** Note: versions of Solid Server >= 2.3 the following does NOT apply ***

SolidTech have made life VERY difficult for automatic configuration
scripts as used by Rexx/SQL.  As a result, Rexx/SQL will only link
with the static library supplied with the Solid Server development kit.

The reason for this is that the name of the client library does not
conform to normal Un*x naming conventions for libraries. Add to this
the fact that the client library name also includes the version number
in the name, then it is impossible to link with the shared client library.

I urge you then to contact SolidTech and request that in future releases 
that they provide a symbolic link to both the static and shared libraries
that is prefixed with "lib" AND does not have a version number in it.
eg. the Linux static client library for version 2.2 is called scllux22.a
the suggested symbolic library name would be "libscllux.a"

I have attempted to get SolidTech to provide this symbolic link, but
to no avail :-(

PS. As of 2.3, they have listened!!

2. Installation of Rexx/SQL on OS/2 and Windows NT/95/98
========================================================
Unpack the archive. You've probably already done this.
Copy all executables and DLLs into a directory already in the systems
PATH, or to a new directory, but remember to include this directory
in the PATH. On Windows 95/98, you will need to reboot before the
new PATH is effective.

3. Testing the installation
===========================
Once you have the Rexx/SQL executables and DLLs (or shared libraries)
installed, run the sample program; simple.cmd. simple.cmd takes 3
optional parameters:
user: the username to connect to the database
pass: the password of the username to connect to the database
data: the name of the database to connect to
First run simple.cmd with the supplied Rexx/SQL executable:

Unix>  ./rexxsql user=username pass=password data=database
Win32> rexxsql user=username pass=password data=database

Next run simple.cmd disrectly with your Rex interpreter: (using regina
as the example)

Unix>  regina user=username pass=password data=database
Win32> regina user=username pass=password data=database

