This file includes instructions on building Rexx/SQL with ODBC support
provided by the Easysoft ODBC-ODBC Bridge.

The Easysoft ODBC-ODBC Bridge has been proven with Rexx/SQL 2.4beta
and should work with later versions too.

About Rexx/SQL
==============

Rexx/SQL provides Rexx programmers with a consistent, simple, yet
powerful interface to SQL databases.

Rexx/SQL's WWW home is http://www.lightlink.com/hessling/.

The Rexx/SQL anonymous ftp site is mirrored in the US at
ftp://ftp.lightlink.com/pub/hessling/REXXSQL.

The Rexx/SQL home page contains download links, documentation, mailing
list instructions and links to other Rexx resources.

Building Rexx/SQL with OOB
==========================

You will need a Rexx interpreter to run the Rexx/SQL test code and
your Rexx programs using Rexx/SQL. The Rexx interpreter called Regina
was used by Easysoft during testing of OOB with Rexx/SQL and is
available at ftp://ftp.lightlink.com/pub/hessling/Regina/ (we used 
version 0.08f).  You may use ./configure --help in Rexx/SQL to see 
which Rexx interpreters are supported.

Please ensure you install a Rexx interpreter before attempting to
build Rexx/SQL.

These instructions assume you are building from a source distribution
of Rexx/SQL.

1. Install the OOB first. This is essential as Rexx/SQL needs an ODBC
   driver to compile and link with. Make a note of the installation
   path used when OOB was installed as you will need it when building
   Rexx/SQL.

2. Download Rexx/SQL from Rexx/SQL's home page
   http://www.lightlink.com/hessling/ (or alternatively
   ftp://ftp.easysoft.com/pub/beta/odbc-odbc-bridge/Rexx_SQL) and
   unpack the distribution.

3. Please read very carefully the INSTALL files in the Rexx/SQL and
   OOB distributions. A FAQ is distributed with OOB if you require
   further assistance.

4. Unpack Rexx/SQL and run ./configure --help to locate the option
   required for your Rexx interpreter (we used Regina and hence
   --with-regina). Depending on yuor interpreter you may need to add
   extra configure options.

5. You need to pass configure a minimum of an interpreter,
   --with-easysoft-oob (for Easysoft's ODBC-ODBC Bridge) and the
   location of the OOB library and header files (--with-dblibdir and
   --with-dbincdir). e.g. assuming you installed OOB in the default
   directory and use Regina as a Rexx interpreter you might configure
   Rexx/SQL with:

   ./configure --with-regina --with-easysoft-oob \
	       --with-dbincdir=/usr/local/easysoft/oob/client/include \
	       --with-dblibdir=/usr/local/easysoft/oob/client

6. Once Rexx/SQL is configured type "make all" to build it.

7. You should then consult the "Testing the Installation" section of
   the Rexx/SQL INSTALL file. To perform the tests in this section you
   must define an OOB ODBC datasource local to the machine where the
   OOB client and Rexx/SQL are installed. 
**** as the instructions are based on the source distribution ***
**** then refering to Windows as the local machine is not relevant ***
**** The configure script does not work on Windows platforms; there ***
**** is a seperate makefile for different compilers there. ***
   In Windows this requires
   adding an OOB datasource via the ODBC Administrator. 
**********************************************************************
   To do this you must create an odbc.ini file containing the
   datasource (see DSN_definition.txt in the OOB
   distribution). If the remote machine is a Windows platform, you
   also need to create an ODBC datasource for the database you wish to
   connect to, using the ODBC Administrator.

   As an example, assume you have MS SQLServer running on a remote
   windows machine (called ntbox) where you have installed the OOB
   Server. You use "myname" and "mypassword" to log into the Windows
   machine "ntbox". You have set up a datasource on ntbox with the ODBC
   Administrator for MS SQLServer called "mydata" which requires
   database authentication "db_user" and "db_password". You want to
   access data in MS SQLServer on ntbox from your Rexx program on the
   other machine where you have just installed the OOB client and
   Rexx/SQL. Your odbc.ini file would look like this:

   [rexx_sql_test]
   Server = ntbox
   Port = 8888
   Transport = tcpip
   LogonUser = myname
   LogonAuth = mypassword
   TargetDSN = mydata

   Once you have defined the local datasource you can try the Rexx/SQL
   tests. e.g

   ./rexxsql user=db_user pass=db_passwd data=rexx_sql_test

   To MS SQLServer you should then see something like this:

   Rexx/SQL Version: rexxsql 2.4 21 Jul 1999 UNIX ESOOB
   Database Name:    Microsoft_SQL_Server
   Database Version: 07.00.0255
   Disconnect succeeded!

   Rexx/SQL contains other test code such as samples/tester.cmd.  You
   can run this by defining and exporting the environment variables
   REXXSQL_USERNAME, REXXSQL_PASSWORD and REXXSQL_DATABASE as your
   database user, password and data source name then running

   ./rexxsql samples/tester.cmd setup

   The setup argument creates the tables. Then you can run the same
   command again but without the setup argument to exercise Rexx/SQL
   and OOB more thoroughly.


