Oratcl - Tcl interface to Oracle database server * Oracle interface to Tcl * * Copyright 1993 Tom Poindexter and U S WEST Advanced Technologies, Inc. * * Permission to use, copy, modify, and distribute this software and its * documentation for any purpose and without fee is hereby granted, provided * that the above copyright notice appear in all copies. * Tom Poindexter and U S WEST make no representations about the suitability * of this software for any purpose. It is provided "as is" without express or * implied warranty. By use of this software the user agrees to * indemnify and hold harmless Tom Poindexter and U S WEST from any * claims or liability for loss arising out of such use. * *----------------------------------------------------------------------- * Version 1.0 July, 1993 * Tom Poindexter, Boulder Colorado * tpoind@advtech.uswest.com or tpoindex@nyx.cs.du.edu *----------------------------------------------------------------------- * Version 2.0 November, 1993 * Tom Poindexter, Boulder Colorado * tpoind@advtech.uswest.com or tpoindex@nyx.cs.du.edu *----------------------------------------------------------------------- * Version 2.1 February, 1994 * Tom Poindexter, Boulder Colorado * tpoind@advtech.uswest.com or tpoindex@nyx.cs.du.edu *----------------------------------------------------------------------- * Version 2.11 April, 1994 * Tom Poindexter, Boulder Colorado * tpoind@advtech.uswest.com or tpoindex@nyx.cs.du.edu *----------------------------------------------------------------------- * Version 2.2 October, 1994 * Tom Poindexter, Denver Colorado * tpoindex@nyx.cs.du.edu <<>>>>>> I've put oratcl-2.4.tar.gz on ftp.nesoft.com in /pub/tcl/extensions/oratcl-2.4.tar.gz see the newsgroup comp.lang.tcl for general Tcl discussion and the Tcl Frequently Asked Questions. I've built Oratcl in SunOS 4.1.2 (BSD), Solaris 2.3 (Sys 5.4), and HP-UX 10.x. Other users have reported successful compiles on: DG/UX Sequent PTX 2.1 AIX Dec Alpha OSF/1 (mail to me on a successful port on other platforms; I'll add to this list) SAMPLES Some samples are included using the Extended Tcl tcl(1) and wishx(1) interpreters. In particular, the "wosql" (Windowing Oracle SQL) program is a handy replacement for Sql*Plus for ad hoc queries. Wosql does not attempt to provide any of the report generating and formatting capabilities of Sql*Plus. Also in samples/ is iud_maker, an Oratcl that builds insert-update-delete applications for a single table. See ./samples/README.samples plus each file's comments and code. MAN PAGE You're in luck! I've written one. OTHER DOCUMENTATION The directory doc contains a draft of a chapter I'm writing on Oratcl for an upcoming book on Tcl extensions, to be published by O'Reilly & Associates late summer 1996 (?). BUG REPORTS Comments, suggestions, et.al., should be mailed to me at the above email address, or posted to comp.lang.tcl if general enough nature. Hell, you can even mail to me if you like Oratcl! Mail bug reports to: tpoindex@nyx.net Please *always* include: -version of Oratcl -version of Tcl, Tk, and TclX -version of Oracle server and OCI libary -version of your operating system -compiler used, stock cc or Gcc -samples of SQL or Oratcl code causing problems -relevant database table definitions, views, procedures KNOWN BUGS !!! Oracle's 7.1.4 release seems to have introduced several problems with their Oracle Call Interface (OCI) libraries that Oratcl uses. Symptoms include excessively long connect times (2+ minutes) when using Sql*Net, or possibly "fetch out of sequence" errors when retrieving rows. Use 7.0.x or 7.1.6+ OCI libraries if you experience problems with 7.1.4. See the file OCI714.bug for additional details. INSTALLATION See the file INSTALL. GNU Autoconf is used to generate the Makefile. OTHER See the file CHANGES for changes in versions of Oratcl. -finis-