                             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"
If the platform you are installing Rexx/SQL on does not support dynamically
loadable libraries, you may get some errors during the "make install";
these can be ignored.
Where the platform does support dynamically loadable libraries, you may
need to tell your operating system where these shared libraries are. The
method of doing this varies between operating systems, but generally
involves adding the installed directory to an environment variable such
as LD_LIBRARY_PATH, LIBPATH, etc.

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 simple.cmd user=username pass=password data=database
OS/2>  rexxsql simple.cmd user=username pass=password data=database
Win32> rexxsql simple.cmd user=username pass=password data=database

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

Unix>  regina simple.cmd user=username pass=password data=database
OS/2>  regina simple.cmd user=username pass=password data=database
Win32> regina simple.cmd user=username pass=password data=database

