mSQLBase C/API version 1.00                                      10 Jul 1995
----------------------------------------------------------------------------

This is a wrapper for the mSQL API library to use SQLBase C/API (*) calls
to get at mSQL.

It's now a nearly full implementation of the most necessary functions
(listed below), you need to deal with mSQL like an SQLBase database.

I tried to implement the same behavior as SQLBase - you get, in most cases
the same fetchflags, returncodes and errormessages.

In sql.h, I added only the constants/defines, that I need for compilation
of my own code. If you need extra ones (for sqlset/get i.e), just add them.

One difference to SQLBase are the parameters for sqlcnc. I added an extra
parameter for the host to which the cursor will connect (see the man-page).

In difference to mSQL, only uppercase database/table/columnnames are
supported.


if you have questions, bug reports or suggestions, mail me.

Klaus Thiele
kth@oblib.teuto.de

--
(*) SQLBase - C Application Programming Interface
    Version 6.0
    Gupta Technologies, Inc.


Archive Location
----------------
The current version of mSQLBase can be found via ftp from
ftp://Bond.edu.au/pub/Minerva/msql/Contrib/mSQLBase-n.nn.tgz


Tested with mSQL 1.0.7
----------------------

   Linux 1.3.8
      gcc/g++ 2.5.8

   NCR Unix System V Release 4.0 Version 3.0
      MetaWare High C Compiler R2.3x13
      NCR System 3000 C/C++ Compiler, Version 02.00.05


KNOWN BUGS
----------
Don't try to use column/table names larger than mSQL supports
(NAME_LEN in msql_priv.h) - core dump - at the time i have no mind
to correct the bug.


LICENSE
-------
This program is free software; you can redistribute it and/or modify
if under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2, or (at your opinion)
any later version.

This program is distributed in the hope that it will be useful, but
WITHOUT ANY WARRENTY; without even the implied warrenty of 
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
General Public License for more details.

You should have received a copy of the GNU General Public License;
if not, write to the Free Software Foundation, Inc. 675 Mass Ave,
Cambridge, MA 02139, USA. 



mSQLBase API Functions by Category
----------------------------------

Binding
        +----------+--------------------------+
        ! Function ! Description              !
        +----------+--------------------------+
        ! sqlbnd   ! BiNd Data by name        !
        ! sqlbnn   ! BiNd data by Number      !
        ! sqlcbv   ! Clear Bind Variables     !
        ! sqlnbv   ! Number of Bind Variables !
        +----------+--------------------------+


Compiling and executing
        +----------+--------------------------+
        ! Function ! Description              !
        +----------+--------------------------+
        ! sqlcex   ! Compile and EXecute      !
        ! sqlcom   ! Compile                  !
        ! sqlexe   ! EXEcute                  !
        +----------+--------------------------+


Connecting and disconnecting
        +----------+--------------------------+
        ! Function ! Description              !
        +----------+--------------------------+
        ! sqlcnc   ! CoNnect Cursor           !
        ! sqlcnr   ! Connect with No Recovery !
        ! sqldis   ! DISconnect               !
        ! sqldon   ! DONe                     !
        +----------+--------------------------+


Database administration
        +----------+--------------------------+
        ! Function ! Description              !
        +----------+--------------------------+
        ! sqldbn   ! Database Names           !
        ! sqldbt   ! Database Tables          !
        +----------+--------------------------+


Environment control
        +----------+--------------------------+
        ! Function ! Description              !
        +----------+--------------------------+
        ! sqlget   ! GET database parameter   !
        ! sqlset   ! SET database parameter   !
        +----------+--------------------------+


Error handling
        +----------+--------------------------+
        ! Function ! Description              !
        +----------+--------------------------+
        ! sqlepo   ! Error POsition           !
        ! sqlerr   ! ERRor message            !
        ! sqlrbf   ! Roll Back Flag           !
        ! sqlrcd   ! Return CoDe              !
        ! sqltem   ! Tokenize Error Message   !
        +----------+--------------------------+


Queries
        +----------+--------------------------+
        ! Function ! Description              !
        +----------+--------------------------+
        ! sqldes   ! DEScribe items in SELECT !
        ! sqldsc   ! DEScribe items of SELECT !
        ! sqlfet   ! FETch next row           !
        ! sqlnrr   ! Number of Rows in Result !
        ! sqlnsi   ! Number of SELECT items   !
        ! sqlssb   ! Set Select Buffer        !
        +----------+--------------------------+


Restriction mode and Result set mode
        +----------+--------------------------+
        ! Function ! Description              !
        +----------+--------------------------+
        ! sqlcrs   ! Close Result Set         !
        ! sqlprs   ! Position in Result Set   !
        ! sqlspr   ! StoP Restriction mode    !
        ! sqlsrs   ! Start ReStriction mode   !
        !          ! and Result Set mode      !
        +----------+--------------------------+


Transaction control
        +----------+--------------------------+
        ! Function ! Description              !
        +----------+--------------------------+
        ! sqlcmt   ! CoMmiT                   !
        ! sqlrbk   ! RollBacK                 !
        +----------+--------------------------+


Miscellaneous
        +----------+--------------------------+
        ! Function ! Description              !
        +----------+--------------------------+
        ! sqlcty   ! Command TYpe             !
        ! sqlrow   ! number of ROWs           !
        +----------+--------------------------+


--
|/    ___                              \\///     65510 Huenstetten, Germany
|\laus |hiele                         ( . . )    eMail:  kth@oblib.teuto.de
-----------------------------------oOo--(_)--oOo-----------------------------
