IIUG Software Repository Files

$Id: README,v 1.12 1993/12/08 16:05:23 bill Exp $

  This file is part of the isqlperl system.

  (c) Copyright 1993 by William Hails
      All rights reserved.

    This program is free software; you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
    the Free Software Foundation.

    This program is distributed in the hope that it will be useful, 
    but WITHOUT ANY WARRANTY; without even the implied warranty of 
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    GNU General Public License for more details.

    You should have received a copy of the GNU General Public License
    along with this program; if not, write to the Free Software
    Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.

  You can email me as bill@tardis.co.uk or write to William Hails, CLI
  Connect Ltd., 19, Quarry Street, Guildford, Surrey, GU1 3UY. England.


Isqlperl is a perl interface to Informix databases, implemented as a set
of usub extensions to perl.

See the file CHANGES for facilities and features new with this release.
See the man page (isqlperl.man, pre-formatted as isqlperl.doc) for
documentation.

This is only a temporary measure, isqlperl will soon be supplanted by
DBperl, but for the time being it may attract some Informix users to
the Perl fold (and I needed a perl/Informix i/f FAST.)

Many thanks to Winthrop Chan who provided the original sql script, and
who did much work on porting version 1.1. Thanks also to Neil S.
Briscoe For help in porting and testing version 1.2, and for his
general enthusiasm towards isqlperl.

		BUILDING

To build, you must have perl already installed, (make runs some perl
scripts) and the mus program must be in the usub directory of the perl
distribution. There will need to be a `usub.o' (built when perl is
built) in the perl distribution directory.

You will also need to have Informix ESQL/C installed on the
machine on which you are doing the build.

Edit the Makefile, appropriate to your site.

Run `make'. It should only take a minute or so.

		TESTING

Have a look at the isqlperl script testisql, change the database and
table names to something on your site, then run it. Also check out the
sql script, contributed by W. Chan, for an example of a command driven
SQL interpreter written in isqlperl.

		INSTALLING

After you're happy with the tests, check over the Makefile again.
You can opt to install the sql script, in which case you will also
have to install the finderr.pl library module which it requires.
Then run `make install'.