home *** CD-ROM | disk | FTP | other *** search
/ Usenet 1994 October / usenetsourcesnewsgroupsinfomagicoctober1994disk2.iso / misc / volume37 / sybperl / part01 / README < prev    next >
Text File  |  1993-05-04  |  4KB  |  111 lines
  1.  
  2.                  Sybperl, version 1.0
  3.  
  4.  
  5.  
  6.    Sybperl is a set of user-defined subroutines letting you access a
  7.    Sybase data server using Perl.
  8.  
  9.    Requirements: Perl ver 3.0.27 or higher (4.035 strongly suggested!).
  10.          Sybase DB-Library (aka Open Client)
  11.  
  12.  
  13.    Compiling & Installing Sybperl:
  14.    
  15.    Unshar somewhere convenient, and edit Makefile to reflect your
  16.    system setup. The following macros/defines may need to be set:
  17.  
  18.        PERL_VERSION     Uncomment if you're using a Perl version
  19.              earlier than 4.03
  20.        UPERL/SAVESTR     See the comments in the Makefile, and the
  21.              BUGS file. The defaults should work.
  22.        HAS_CALLBACK     This enables the use of Perl subroutines as
  23.              DB-Library error & message handlers. This is
  24.              a new feature of Perl 4.018, but it might
  25.              work with earlier versions.
  26.        DBLIB42          If this Makefile macro is defined, then the
  27.              newer datatypes (such as SYBREAL) will be
  28.              handled correctly, and dbsafestr() will be
  29.              implemented.
  30.        SET_VAL         If this macro is set, then attempts to set a
  31.              Sybperl user-variable (such as
  32.              $NO_MORE_RESULTS) will result in a fatal
  33.              error. Otherwise such attempts are silently
  34.              ignored.
  35.        NULL_UNDEF     If this macro is set, then NULL values
  36.              returned from a select statement will be
  37.              returned as 'undef' values. Otherwise, they
  38.              are returned as the string 'NULL'.
  39.        OLD_SYBPERL     This is a backwards compatibility flag -
  40.              mainly for myself :-). It's main impact is to
  41.              silently call dblogin()/dbopen() with default
  42.              arguments if you omit to do so in the script.
  43.  
  44.    The Makefile will not attempt to build uperl.o if it can't find it.
  45.  
  46.    You may also need to edit the lib/sybperl.pl file to addapt it to
  47.    your environment.
  48.  
  49.    There are some test scripts in the t directory which you can run to
  50.    see if all is well, and to get an idea of what can be done with
  51.    sybperl. There are also some example scripts in the 'eg' directory.
  52.  
  53.    Sybperl has been tested succesfully in the following environments:
  54.  
  55.    Sun Sparc, SunOS 4.1.1, Sybase 4.0.1, Perl 4.010
  56.    Sun 3/80, SunOS 4.0.3, Sybase 4.0.1, Perl 4.010
  57.    Sun Sparc, SunOS 4.1, Sybase 4.2, Perl 4.010
  58.    Pyramid MIServer 2/2, OSx V5.1a, Sybase 4.0, Perl 4.010
  59.    
  60.    I use sybperl daily in a production environment on a Sun 4/65 under
  61.    SunOS 4.1.1, with Sybase version 4.0.1 and Perl 4.035
  62.  
  63.    BUGS:
  64.  
  65.    Both DBlibrary and Perl define a symbol named 'savestr', resulting
  66.    in the Perl version being called from DBlibrary. See the BUGS file
  67.    for ways to get around this problem.
  68.  
  69.    Memory usage can also be a problem in certain cases. Again see the
  70.    BUGS file for details.
  71.  
  72.    BCP functions are not available, but would probably be useful.
  73.  
  74.    Access to IMAGE datatypes isn't handled in &dbnextrow().
  75.  
  76.  
  77.  
  78.    
  79.    Have fun using it and let me know of any improvements, problems,
  80.    whatever...
  81.  
  82.    Michael Peppler            mpeppler@itf.ch    mpeppler@bix.com
  83.    ITF Management SA            BIX:   mpeppler                         
  84.    13 Rue de la Fontaine        Phone: (+4122) 312 1311  
  85.    CH-1204 Geneva, Switzerland  Fax:   (+4122) 312 1322  
  86.  
  87.    
  88.  
  89.                    NOTICE - Warranty and Copyright
  90.  
  91.            
  92.    Sybperl is not a product of ITF Management. There is no warranty,
  93.    and no official support.
  94.  
  95.    Sybperl is copyright, but may be freely distributed under the
  96.    same terms as Perl itself.
  97.  
  98.  
  99.  
  100.    My thanks to the following people for testing Perl, and suggesting
  101.    improvements:
  102.  
  103.    Teemu Torma            Brent Milnor
  104.    Matthew Merzbacher        Eric Fifer
  105.    Dan Banay            Mark Lawrence
  106.    Jeffrey Wong            Wolfgang Richter
  107.    Anders Ardo            Gijs Mos
  108.    Minh Ton Ha            G. Roderick Singleton
  109.    Peter Gutmann
  110.    
  111.