Index of /tcl/ftparchive/sorted/databases/adabastcl-0.6

      Name                   Last modified     Size  Description


[DIR] Parent Directory       18-Dec-99 07:01      -  
[   ] README                 14-Jan-97 15:47     5k  
[CMP] adabastcl-0.6.tar.gz   14-Jan-97 16:54   254k  
[   ] changes                11-Jan-97 07:52     6k  
[DIR] manuals/               29-Jan-99 12:24      -  


   AdabasTcl 0.6 - TCL interface to the ADABAS D database server
   *************************************************************

   What is AdabasTcl?
   ------------------

   AdabasTcl is an extension to TCL (Tool Command Language), that provides
   access to an ADABAS D database server of Software AG.
   AdabasTcl adds additional Tcl commands that connect to a database,
   pass SQL code, read results, etc.
   AdabasTcl was inspired by similar extensions for other database servers,
   notably oratcl by Tom Poindexter.

   There are also four TK (ToolKit) applications, that provide the access
   to the database in the X11 environment with the motif look and feel.

   panel:   A tool for driving the database server (the traffic light).
   tkquery: A tool for interactive SQL queries.
   tkuser:  A tool for setting default attributes for user keys.
   fotos:   A application to demonstrate the capability to display
                   pictures out of LONG columns.

   Copyright (c) 1996 Christian Krone. All rights reserved.
   This program is free software; you can redistribute it and/or
   modify it under the same terms as Tcl itself.
   See also licence.terms

   Requirements
   ------------

   Since AdabasTcl is an extension to TCL, you should already have TCL, or be
   prepared to get it via ftp.
   To use the feature of dynamically loading the AdabasTcl extension into the
   TCL interpreter (tclsh), you must have TCL version 7.5.
   The tk applications need the installed TK widget set version 4.1.

   Tcl7.6: ftp://ftp.smli.com/pub/tcl/tcl7.6.tar.gz
   Tk4.2:  ftp://ftp.smli.com/pub/tcl/tk4.2.tar.gz

   It will work also with tcl7.5 and tk4.5.

   Of course, you must also have access to an ADABAS D databaser server.  
   AdabasTcl must be linked with the Adabas D precompiler libraries.
   I've linked and tested it with a server version 6.1 and version 6.2.

   Installation
   ------------

   To configure, compile and install AdabasTcl, you have to go through the
   following 3 steps.


   1. First start './configure' in this directory.
      You have a good chance, that this will work out all the options
      for your machine correctly.
      If it stops or determines invalid values for some of its variables,
      you can tune it with options on its command line;
      here are some examples:
      './configure --with-tclinclude=/usr/local/include'
      './configure --with-adabas=6.1 --without-x'
      An extensive list of all options is available by
      './configure --help'.
      After this you could (but don't have to) inspect the Makefiles; the most
      important one is located in the extension subdirectory.
      See also Porting Notes below.
   2. Then a call of 'make' should build all targets in the
      subdirectories. If something went wrong, most likely some variables
      in the Makefile needs more attention. Again, see Porting notes below.
   3. If all went well, a call of 'make install' installs
      the extension plus the applications and their help pages.

   Porting Notes
   -------------

   This package has been compiled and tested on the following platforms:

   Linux:        With ELF Kernel it should compile out of the box
                   (one of the development platforms).
   Unixware 2.1: Without any problem (the other development platform).
   SCO V4.2:     No dynamic loading and no X, but adabastclsh runs okay
                   (former development platform).
   DEC Unix 3.2: (Actually I compiled the release 0.4 on this one; I am
                   remembering no big problems).
   HP-UX:        I had to use the following call of make to get it compiled.
                   'make CC="c89 -D_INCLUDE_POSIX_SOURCE"'
		   A loading of Adabastcl.sl isn't possible, because there is
		   not enough memory (that's, what the loader said!). So there
                   should be the --disable-load option present in the call
                   of configure.
   SUN_OS 5.5.1: I had to set the LIBS variable to '-lcurses' to get
		   configure running; also LD_LIBRARY_PATH should point
                   to $DBROOT/lib when executing any program.
   Windows95/NT: For configuration you have to call the Tk program
		   'mkMakfileVC.tcl'. There you should customize
                   the mentioned configuration variables.
		   After this a call of 'nmake install' should build
                   and install everything. You have to create icons for
                   the tk appls manually. Currently there is a bug, that every
                   application reports an invalid instruction on exiting;
                   everything else should work okay.

   Bug reports
   -----------

   Comments, suggestions, bugs reports, et.al., should be mailed to me
   'krischan@cs.tu-berlin.de'
   or posted to 'comp.lang.tcl' if general enough nature.

   Please always include:


   - version of AdabasTcl
   - version of Tcl and Tk
   - version of Adabas D server
   - version of your operating system
   - samples of SQL or AdabasTcl code causing problems
   - relevant database table definitions, views, procedures

   Have fun, Krischan

   Christian Krone
   Varziner Str. 12
   D-12161 Berlin
   'krischan@cs.tu-berlin.de'