ZClasses for Database Access

   This archive is the mSQL part of a project to provide
a consistent object oriented C++ API to commonly used
databases.  It is designed to be platform non-specific.
The databases currently supported by this API are mSQL,
Oracle 7 and a generic ODBC access class will be on the
way soon. 

    This is the first public release of these classes
so I expect to find bugs/design flaws.  Comments and/or
patches are welcome.

TO USE THESE CLASSES:

	Make sure that libmsql.a is available in the linker
	search path or modify the Makefile to suit your
	config.

	Edit the msql.h file to have extern "C" defined as thusly;
		
		#ifdef _cplusplus
		extern "C"	{
		#endif
		
		...declaration of msql API functions...

		#ifdef _cplusplus
		}
		#endif


	Edit ztest.cc to preform a valid SQL by editing the
	"TheSQL" string near the top.(The default should work
	if you have run any of the test utils that come with 
	the mSQL package.)

	Modify the Makefile to meet your system configuration.
	
	Type make all.

	Make sure msqld is running.

	Run ztest.  The output should be first a list of the
	fields selected and their lengths, then a listing
	of the records returned by the SQL.  Each field should
	be on a newline and each record should be delimited
	by a dashed line.

	if ztest doesn't work, check zdb.log for possible
	causes of failure... If no luck then mail me and I
	will be glad to help.

That's about it.  After ztest runs correctly you can put the 
.o files where you want or make a lib or whatever.  Just make
sure you link in the zdb.cc and zmsql.cc code somehow.  Also
in every app you want to use the classes in make sure you pass
-D_cplusplus on the command line of #define it somewhere, else
you will get lots of errors about undefined symbols...

This software is available via:
	ftp://alfred.niehs.nih.gov/pub/Database/zclass/zmsql.tar.Z
	http://alfred.niehs.nih.gov/Dean/software.html

	if you have probs resolving the host name, PLEASE send
	me a mesage, fuqua@niehs.nih.gov. Our DNS is a bit confused
	right now and it would help rectify them problem.

Good Luck,
Dean Fuqua
fuqua@niehs.nih.gov
http://alfred.niehs.nih.gov/Dean/home.html


