This is an instant-mix package (just add Perl) to create Oraperl,
a version of Perl which is capable of accessing Oracle databases.
To use it, you must have the Oracle Pro*C product and a version of
Perl which supports Usersubs (v3.0.27 or later).

Unshar it somewhere convenient, and edit the Makefile. You may need
to change the definitions below:

	ORACLE_HOME	your Oracle installation directory
	SRC		your Perl source directory (with the usub directory)
	OTHERLIBS	\ 
	CLIBS		 |
	OCILIB		 +- copy these from your proc.mk file
	NETLIBS		 |
	ORALIBS		/
	GLOBINCS	\ 
	LOCINCS		 +- copy these from $SRC/usub/Makefile
	LIBS		/
	DEBUG		-DDEBUGGING, -DPERL_DEBUGGING or leave blank;
			see orafns.h for an explanation
	PUTENV		\ 
	STRTOL		 +- system dependent - see Makefile for details
	STR_2MORTAL	/

I've only tested this on an Encore Multimax 520 running UMAX V (Sys Vr3.2),
using Perl 3.0.34, 4.0.00 4.0.03 and 4.0.10 with Oracle version 6, as I don't
have access to any other system with Pro*C. I'd appreciate any comments,
bug-reports etc.

In addition to this README, the package contains the following files:

Source Code:
	Makefile	building instructions
	patchlevel.h	your Oraperl patch level
	orafns.h	common declarations
	oracle.mus	function interface description
	getcursor.c	functions to deal with the cursor pool
	orafns.c	actual functions to interact with oracle
	usersub.c	initialisation routine
	colons.c	counts substitution variables in a statement

Examples
	debug-p		tests to see if debugging is available
	ex.pl		simple example of using the functions
	mkdb.pl		more extensive example, showing the use of ora_bind()
			and ora_do()

Documentation
	oraperl.doc	explains some of the thinking behind Oraperl
	oraperl.ref	quick reference - glue it into the perl reference guide
	oraperl.1	manual page

Miscellaneous
	CHANGES		Summary of changes to Oraperl
	Hints		notes on using oraperl
	Oracle-v5	Hints for compiling Oraperl with Oracle v5
	oraperl.ph	definitions of Oraperl error and debugging codes

Many thanks to Larry for Perl.

	Kevin Stock
	kstock@gouldfr.encore.fr


		    NOTICE - Warranty and Copyright

Oraperl is not a product of Encore Computer Corporation or any of its
subsidiaries. There is no warranty, and no official support is available.

It is copyright, but may be freely distributed under the same terms as
Perl itself.
