MSSQL::DBlib 1.005
MSSQL::Sqllib 1.005

Brief overview

Michael Peppler developped Sybperl. Christian Mallwitz of Intershop GmbH ported Sybperl 2.03 to NT (there is now a more recent NT port that comes with the regular Sybperl distribution). From their work, I created MSSQL::DBlib.

MSSQL::Sqllib is fairly generic SQL library built on top of the DBlib class, with an interface which is focused on being simple to use.

Alternative distribution

This is a source-only distribution, and you will need a C++ compiler and a MAKE utility to install it. At my web site you can find binary distributions (with source included) for ActiveState 3xx and 5xx:

Prerequisites

To install this you need. If you only have MS SQL Server 6.0 or 4.2:

How to install

Text in this type face indicates command you run from the command prompt.
  1. Extract the zip file anywhere you like.
  2. Edit DBlib/makefile.pl so that $SQLDIR points to where you inlucde and link libraries for DB-Library are included.
  3. DBlib/makefile.pl also includes a dynamic_lib option, which I don't know whether it will work with other compilers than Visual C++. For better startup performance, you are encouraged to find the corresponding command-line option for your compiler. However, you can remove it if you don't care.
  4. Open a Command Prompt, and change directory to where you extracted the files.
  5. Perl makefile.pl.
    I suggest that you run this from the top directory.
  6. MAKE
    Or NMAKE, DMAKE or whatever your MAKE utility you use.
  7. If you want to run the test scripts, edit DBlib/t/sqllogin.pl and Sqllib/t/sqllogin.pl so that they contain a valid combination of user, password and server. They're shipped to run as sa with no password on the local server. Don't forget to remove sensitive information, once the tests are OK.
  8. MAKE test
    See tests.html for notes on the tests.
  9. MAKE install
You're on the air!

Manuals

The docs subdirectory contains documentation for the two modules. There is a POD and an HTML file for each module. You may want to rebuild the HTML files, so that references to Perl elements outside MSSQL are resolved. The file DOPOD.BAT is a simple file that just builds the HTML files locally.

Sample scripts

The directory eg contains a small collection of sample scripts, some that I've inherited from the Sybperl distribution. You also find one utility that might be useful, SPTRITEST, which tests all stored procedures in a database for trivial errors. WARNING! Don't run SPTRITEST on a live database, but only a database you can afford to waste. There is a separate README for this directory.

Reporting bugs or problems

Please mail bug reports and suggestions to sommar-perl@algonet.se. Try to make your reports as specific as possible. Paricularly don't forget to include which versions of Perl, NT, SQL Server etc you are using. Please have patience with me, if I cannot address your issue on the spot. I am sometimes a busy man. ...and don't forget to read the manual!


Last updated 99-01-30 19:49