home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 5 Edit / 05-Edit.zip / oraperl2.zip / README < prev    next >
Text File  |  1993-07-01  |  2KB  |  72 lines
  1. This is an instant-mix package (just add Perl) to create Oraperl,
  2. a version of Perl which is capable of accessing Oracle databases.
  3. To use it, you must have the Oracle Pro*C product and a version of
  4. Perl which supports Usersubs (v3.0.27 or later).
  5.  
  6. Unshar it somewhere convenient, and edit the Makefile. You may need
  7. to change the definitions below:
  8.  
  9.     ORACLE_HOME    your Oracle installation directory
  10.     SRC        your Perl source directory (with the usub directory)
  11.     OTHERLIBS    \ 
  12.     CLIBS         |
  13.     OCILIB         +- copy these from your proc.mk file
  14.     NETLIBS         |
  15.     ORALIBS        /
  16.     GLOBINCS    \ 
  17.     LOCINCS         +- copy these from $SRC/usub/Makefile
  18.     LIBS        /
  19.     DEBUG        -DDEBUGGING, -DPERL_DEBUGGING or leave blank;
  20.             see orafns.h for an explanation
  21.     PUTENV        \ 
  22.     STRTOL         +- system dependent - see Makefile for details
  23.     STR_2MORTAL    /
  24.  
  25. I've only tested this on an Encore Multimax 520 running UMAX V (Sys Vr3.2),
  26. using Perl 3.0.34, 4.0.00 4.0.03 and 4.0.10 with Oracle version 6, as I don't
  27. have access to any other system with Pro*C. I'd appreciate any comments,
  28. bug-reports etc.
  29.  
  30. In addition to this README, the package contains the following files:
  31.  
  32. Source Code:
  33.     Makefile    building instructions
  34.     patchlevel.h    your Oraperl patch level
  35.     orafns.h    common declarations
  36.     oracle.mus    function interface description
  37.     getcursor.c    functions to deal with the cursor pool
  38.     orafns.c    actual functions to interact with oracle
  39.     usersub.c    initialisation routine
  40.     colons.c    counts substitution variables in a statement
  41.  
  42. Examples
  43.     debug-p        tests to see if debugging is available
  44.     ex.pl        simple example of using the functions
  45.     mkdb.pl        more extensive example, showing the use of ora_bind()
  46.             and ora_do()
  47.  
  48. Documentation
  49.     oraperl.doc    explains some of the thinking behind Oraperl
  50.     oraperl.ref    quick reference - glue it into the perl reference guide
  51.     oraperl.1    manual page
  52.  
  53. Miscellaneous
  54.     CHANGES        Summary of changes to Oraperl
  55.     Hints        notes on using oraperl
  56.     Oracle-v5    Hints for compiling Oraperl with Oracle v5
  57.     oraperl.ph    definitions of Oraperl error and debugging codes
  58.  
  59. Many thanks to Larry for Perl.
  60.  
  61.     Kevin Stock
  62.     kstock@gouldfr.encore.fr
  63.  
  64.  
  65.             NOTICE - Warranty and Copyright
  66.  
  67. Oraperl is not a product of Encore Computer Corporation or any of its
  68. subsidiaries. There is no warranty, and no official support is available.
  69.  
  70. It is copyright, but may be freely distributed under the same terms as
  71. Perl itself.
  72.