                       WWW Data
              Vers. 1.0-ab / March 1998
            Copyright (C) 1996, 1997, 1998 SW Wings

DESCRIPTION

WWW Data is a data base system specifically designed to be accessed
and used on the World Wide Web. WWW Data targets all the application
domains in which it is required to make data available to a large forum
of users, across the Web. With WWW Data the end users interact with the
data base, enter their queries (without having to know "SQL") and obtain
their results directly at their location. The WWW Data Man Machine
Interface gives the end users the feeling they are interacting with a
local application and not with a remote data base system.
The same level of usability is offered to the people who want to publish
their data. They only need to specify in a simple data definition language
the data they want to publish and which end users (on the Web) areallowed
to access and manipulate these data. After that, WWW Data uses this
specification to automatically create the data base, the required HTML form,
the CGI application as well as a set of tools to initially populate and
maintain the data base.

INSTALLATION

1. Requirements

WWW data requires a C/C++ compiler. The user generated schema is
converted by WDCOMP into a C module that needs to be compiled and linked
to the WWW Data distribution files. For Windows (Windows 95 and Windows
NT), the Microsoft Visual C++ 5.0 (or above) Compiler is required. 

2. Decompress WWW Data Distribution Files


The WWW Data distribution contains the following files:
        htm_w32.zip - WWW Data HTML documentation 
        www_w32.zip - WWW Data object and executable files 
        uti_w32.zip - Utilities to register WWW Data
        readme.txt  - this file 

Supposing that the files set has been downloaded in the directory

c:\tmp

these are the commands that have to be executed:

c:                              (the actual target disk must be put
                                 here, so instead of c: we could
                                 have d:, e: and so on)
cd \                            (to go to the root)
pkunzip -d c:\tmp\htm_w32.zip   (to decompress the HTML files)
pkunzip -d c:\tmp\www_w32.zip   (to decompress WWW Data files)
pkunzip -d c:\tmp\uti_w32.zip   (to decompress the registration
                                 utilities)

When using a Windows version on "pkunzip" care must be taken so that the
original directories/files names are kept. 


3. Setting the WWW Server

The World Wide Web Server has to be set up in such a way that the WWW
Data CGI can access all the relevant HTML files. Supposing that the
server is similar to the NCSA one, hereafter are listed the required
changes. 

3.1 "access.conf"

In the file "access.conf" an entry similar to the following has to be
inserted. This change will make the SWWINGS directory visible to the WWW
Server.

<Directory C:/SWWINGS/>
</Directory>

3.2 "srm.conf"

In the file "srm.conf", and namely in the "alias" section, an entry
similar to the following has to be inserted. This change will allow the
hyper-links in the WWW Data HTML pages to work properly. 


Alias /swwings/ C:/SWWINGS/

4. Preparing for the first run

After all the steps described above have been performed, it will be
possible to create the first schema as described in the Detailed
Description (Check the HTML documentation files). 

When the schema is ready, it will only be necessary to put its name in
the distributed "makefile". This is accomplished by changing its first
line, as follows:

# Insert in the CSCHEMA variable the actual schema name
CSCHEMA = library

After this operation, the command

make all

will generate all the WWW DATA executable files.

NOTE

It is recommended to put these applications, as well as the registration
utilities, in a different directory than the original ones. The batch
files "go.bat" in WWWDATA and UTILS directories will put these
executable files in the directory /SWWINGS/BIN. It is also recommended
to add this directory to the environment variable PATH; this way all the
WWW Data executable files and the registration utilities will be
directly available.


REGISTRATION

WWW Data is shareware (and not freeware). If you find WWW Data valuable
you should register it. 

The unregistered copy of WWW Data can only handle up to 50 records per
data file. This constraint only applies to WWW Data CGI (i.e. all the
other tools needed to locally create, populate and mantain the data base
work normally). Moreover the text "unregistered copy" is printed in the
title of every single form used by WWW Data CGI and on a "Javascript
scroller" in the status line of the browser. The registered copy does
not have these limitations. 

To register check out the relevant HTML pages in the distributed
documentation. 


COPYRIGHT AND DISCLAIM

1. Copyright

Copyright (c) 1996, 1997, 1998 SW Wings.

Permission to copy, distribute and use the unregistered version of WWW
Data and its documentation is hereby granted without fee, provided that
the above copyright notice and this permission notice appear in all
copies of this software and related documentation. 


2. Disclaim

WWW Data is provided "as-is" and without warranty of any kind, express,
implied or otherwise, including without limitation, any warranty of
merchantability or fitness for a particular purpose. 

In no event shall SW Wings be liable for any special, incidental,
indirect or consequential damages of any kind, or any damages whatsoever
resulting from loss of use, data or profits, whether or not advised of
the possibility of damage, and on any theory of liability, arising out
or in connection with the use or performance of this software. 


PROBLEMS AND FEEDBACKS

Installation/usage problems, feedbacks and so on can be reported to
SW WINGS. 

Alessandra Scarpari
SW WINGS
Van der Weijdenlaan 26
2211 JM Noordwijkerhout
The Netherlands
swwings@swwings.com
