NAME

 MonetDB::CLI - MonetDB Call Level Interface

SYNOPSIS

 use MonetDB::CLI();

 my $cxn = MonetDB::CLI->connect( $host, $port, $user, $pass, $lang );

 my $req = $cxn->query('select * from env');
 while ( my $cnt = $req->fetch ) {
   print $req->field( $_ ) for 0 .. $cnt-1;
 }

DESCRIPTION

 MonetDB::CLI is a call level interface for MonetDB, somewhat similar
 to SQL/CLI, ODBC, JDBC or DBI.

 Note: In its current incarnation, this interface resembles the MonetDB
 Application Programming Interface.
 In the future, MAPI will be replaced by the MonetDB/Five Communication Layer
 (MCL).
 It is not guaranteed that this call level interface stays the same!

PREREQUISITES

 MonetDB::CLI::* (implementation modules)

 MonetDB (http://monetdb.cwi.nl)

INSTALLATION

 To install this module type the following:

   perl Makefile.PL
   make
   make test
   make install

 You need to use the correct make command. That may be nmake or dmake,
 depending on which development environment you are using.

TESTING

 The supplied tests will connect to the database using some
 environment variables, e.g.:

   set MONETDB_HOST=myhost
   set MONETDB_PORT=4711

 Don't specify port and language (if possible). The server should
 listen on the default ports for sql and mapi.

 If the server doesn't accept the default username/password, then
 set the relevant environment variables, e.g.:

   set MONETDB_USER=test
   set MONETDB_PASS=secret

 Make sure libMapi is in your library search path (depending on the
 MonetDB::CLI implementations in use).

AUTHORS

 Steffen Goeldner <[email protected]>.

COPYRIGHT AND LICENCE

 The contents of this file are subject to the MonetDB Public License
 Version 1.1 (the "License"); you may not use this file except in
 compliance with the License. You may obtain a copy of the License at
 http://monetdb.cwi.nl/Legal/MonetDBLicense-1.1.html

 Software distributed under the License is distributed on an "AS IS"
 basis, WITHOUT WARRANTY OF ANY KIND, either express or implied. See the
 License for the specific language governing rights and limitations
 under the License.

 The Original Code is the MonetDB Database System.

 The Initial Developer of the Original Code is CWI.
 Portions created by CWI are Copyright (C) 1997-2006 CWI.
 All Rights Reserved.