================================================================================
  C Sample Code for Accessing the mSQL database via Call-Level Interface (CLI)
================================================================================

Copyright and Warranty:
-----------------------

        All files in this directory are under terms of copyright. You
        may use the sources as samples of how to access the mSQL data-
        base server via CLI. You are not allowed to distribute parts or
        complete files within your software! Use is only permitted for
        self-training and learning.

        Warning! USE OF THESE FILES ON OWN RISK! There is no warranty
        for correct working. I can't guarantee for correctness within
        the code, nor compiled binaries. There should be no damage
        when using these files, but I can't guarantee this.

                (c) 1996 by Dirk Ohme - all rights reserved



Requirements:
-------------

        The samples do require either the iODBC DLL or the CLI-mSQL and
        mSQL DLL, depending on the linkage method. All DLLs could be
        found in the LIB directory (..\..\LIB\):

             a) iODBC           -> iodbc.dll
                  |
                  | requires a DLL for each database software used, e.g.
                  |
                  +--------------> libcli.dll (mSQL)
                  +--------------> db2cli.dll (DB2/2)
                  +
                 ... etc. ...

             b) CLI (mSQL)      -> libcli.dll
                  |
                  | requires (or may require)
                  |
                  +--------------> msql.dll



Contents:
---------

        Makefile        Makefile for building the programs, depending
                        on the distribution (mSQL for OS/2, stand-alone)
                        equals Makefile.OS2 or Makefile.UNX
        Makefile.OS2    original Makefile for use with OS/2 and IBM C/C++
                        Set/2 or IBM Visual Age C++
        Makefile.UNX    original Makefile for use with various UNIX OSs.
        db2conv.c       C source code of a small convertor, that con-
                        verts binaries (*.EXE) compiled for use with
                        DB2/2 (-->DB2CLI.DLL), so that they are useable
                        with mSQL for OS/2 (-->LIBCLI.DLL).
                        NOTE: This program is for use under OS/2 only!
        monitor.c       simple SQL monitor written in C. Queries for
                        a SQL statement, sends it to the server and
                        shows the results.
        showtab.c       another C source. Like 'monitor', but returns
                        additional information about the result columns.



================================================================================
        (c) 1996 by Dirk Ohme, all rights reserved
                                            Moessingen, June 26th, 1996
================================================================================
