README
1README for LEANODBC
2===================
3
4Version 0.9 03-01-2001
5
6This extension is a thin wrapper to a restricted subset of the ODBC 3.x API.
7It is not object-oriented and the functions share the same names as their
8ODBC 3.x counterparts. The restricted subset of the API only includes Core
9Interface functions for read-only operations.
10
11Compiling
12---------
13
14This Perl extension includes a DLL which must be compiled using same version
15of Perl with which it will run. This means that a version compiled with
16ActiveState 5xx builds (Perl 5.00x) will not run with ActiveState 6xx builds
17(Perl 5.6).
18
19To compile you must have the Microsoft Visual C++ command line tools
20(compiler, linker, etc) installed and configured (i.e. run VCVARS32.BAT
21included with the Visual C++ distribution) and the libraries odbc32.lib
22and kernel32.lib included with Visual C++ 5.0 or greater.
23
24Edit the file Makefile.PL and change the line:
25 'LIBS' => ['-lc:\vc98\lib\odbc32.lib -lc:\vc98\lib\kernel32.lib'],
26to match the paths of these libraries on your system.
27
28Run:
29 perl Makefile.PL
30 nmake
31
32
33Installing
34----------
35
36Once the extension has compiled successfully, to install run:
37 nmake install
38
39This installs to the local machine. To install remotely, you can make an
40ActiveState Perl Package and then use ppm. Follow the directions at
41http://velocity.activestate.com/docs/ActivePerl/faq/ActivePerl-faq2.html.
42
43Documentation
44-------------
45
46To make HTML documentation, run:
47 pod2html LeanODBC.pm > LeanODBC.html
48
49Testing
50-------
51
52Before running the test, you need to configure an ODBC Data Source to
53point to the Northwind sample database included with Microsoft Office. Use
54the ODBC Control Panel applet (under Administrative Tools on Windows 2000
55by default). Create a data source named 'NORTHWIND' pointing to the Access
56*.mdb file.
57
58To run the test, use:
59 nmake test
60
61If you don't have Microsoft Office installed and you are familiar with
62ODBC and SQL, you can modify the test.pl file to use an ODBC Data Source
63in your environment.
64
65License
66-------
67
68Cricket license terms apply to this package, LeanODBC.
69
70LeanODBC is Copyright (c) 2001 by Jake Brutlag
71