______________________________________________

heitml README FILE
heitml Version 1.2 
(C) Copyright 1997. H.E.I. GmbH Mannheim, Germany
All rights reserved.
______________________________________________

Thank you for your interest in heitml.
If you upgrade from heitml 1.0 you should read "README1st.txt".

This file includes information on
   - where to find an introduction to and documentation for heitml,
   - how to install and register heitml,
   - how to setup the heitml samples,
   - how to contact H.E.I. and
   - the license conditions.

Please read Evallic.txt for evaluation license conditions and License.txt
for commercial license conditions.

What is heitml ?
----------------
heitml is a Server side extension of HTML with full-featured
programming language constructs that allow easy access to databases.

heitml's Key Features are
 *  extended, interactive HTML with
 *  control structures
 *  user defined tags
 *  complex expression evaluation and
 *  database access via ODBC(32-bit),

What do you need ?
------------------
To use heitml you need to have a Web Server installed on your
Windows 95 machine, as well as an ODBC compliant database system.

You need the most recent ODBC 32-bit Drivers, which can be downloaded 
from Microsoft. On http://www.microsoft.com go to the support page and 
enter ODBC as a product name.

We tested heitml with the Personal Web Server. It can be downloaded from 
Microsofts web site, usually it is found next to the Internet Explorer
download page.

heitml was also tested with O'Reillys Website (http://www.ora.com) and
netscape servers (http:www.netscape.com).

The "READMEpws.txt" file contains instructions on how to run heitml with the Personal
Web Server if you installed Personal Web Server after installing heitml.

The "READMEcgi.txt" file contains instructions on how to run heitml with
Web Server software from other companies.

We tested heitml with MS-SQL Server, MS Access, and the
MS text database driver, but any other ODBC database system
should work as well.

Where is more information ?
------------------------------
An introduction to heitml and the complete documentation can be found
online at "http://www.h-e-i.de/w95heitml" or "http://www.heitml.com"
and offline (after installation) in the following directory on your hard disk: "C:\heitml1.2\htdocs\docs\index.htm"
where "C:\heitml1.2" is the directory where you installed heitml 1.2.

Installation
---------------
The following instructions relate to the installation of heitml in
conjunction with the Personal Web Server from Microsoft. For
installation instruction using Web Server software from other vendors
see the file "READMEcgi.txt".

1. If Microsoft's Personal Web Server has already been installed on your
   machine, there should be an icon 'Personal Web Server' or 'Web-Server'
   in the Control Panel. If not, download the Personal Web Server (read the 
   section 'What do you need?' for Personal Web Server download sites),
   install it and check our "READMEpws.txt" file for further instructions.
    
2. For Windows 95 make sure that the ODBC 32-bit drivers are installed.
   There should be an icon 'ODBC-32-bit' in the Control Panel.
   heitml will NOT work with ODBC 16-bit drivers!
   On Windows NT the 32-bit ODBC drivers are named just ODBC.

3. Run the Setup.exe program to install heitml.
   By default heitml will be installed into "C:\heitml1.2", but
   you can choose your own installation directory.

4. This step is normally done by the heitml Setup program, which creates an
   ODBC System data source called heitml1.2. You may need this
   information if you want to create another ODBC System data source. 
   To do this, you must:

   a) Click on Start, then Settings, then Control Panel
   b) In the Control Panel, find the Icon called 32-bit ODBC
      and double click on it.
   c) In the Data Sources window, click the 'System DSN' button.
   d) Now click on the 'Add' button.
   e) Click on the MS Access Driver to highlight it and then
      click OK.
   f) In the 'ODBC Microsoft Access 7.0 Setup' window, enter "heitml1.2"
      as the data source name and then
   g) Click the 'Select' button
   h) In the Select Database window, first select the Drive where you
      installed heitml and then select the "heitml1.2" directory folder
      (If you installed heitml under a folder other than the default 
      name "heitml1.2", choose that folder instead.) Look for the file
      in the "htdocs\tutor" directory called "heitml.mdb" and click  on it to
      highlight it. Then click OK, which closes the Select Database
      window.
   i) In the 'ODBC Microsoft Access 7.0 Setup' window, click the 
      'Advanced' button.
   j) In the 'Set Advanced Options' window enter 'heitml' for both the
      login name and the password and click OK to close the window.
   k) In the 'ODBC Microsoft Access 7.0 Setup' window click OK to close it.
   l) In the 'ODBC Datasource Administrator' window click OK to close it.

5. You must now restart the Personal Web Server.

   a) The Control Panel that you opened in step 4 should still be 
      opened at this point in time. Find the 'Personal Web Server'
      or 'Web-Server' icon and double click on it.
   b) In the Properties of Personal Web Server window, click on
      the 'Startup' Tab. A message will appear telling you the
      current state of the Web Server. At this point in time it
      should say 'The Web Server is stopped.' Click on the 'Start'
      button and the message will change to 'The Web Server is 
      Running.' Click on OK to close the window.
   c) Close the Control Panel Window.

   Instead of restarting the Personal Web Server, 
   you can also reboot the machine.

6. If you use a proxy server, configure your browser so that no
   proxy server is used for localhost.

7. Double-click the 'heitml' icon in the heitml program group.
   The heitml pages will tell you how to proceed.

   If you want to use a database other than Access to use the 
   heitml examples, you need to use the functions on the 
   Maintenance page to create the neccessary database relations.


Getting Started
------------------
After trying out the examples, we recommend that
you create a heitml page of your own or update one of the
sample files contained in the "C:\heitml1.2\htdocs\my"
or the "C:\heitml1.2\htdocs\myout" directory
where "C:\heitml1.2" is the directory where you installed heitml 1.2.
You can edit them using any text editor, just like editing
ordinary HTML pages.

How to develop heitml applications
----------------------------------
To develop your own heitml applications, you should create your
own directories and connect them to the Personal Web Server using the
administrative functions. You must give the directory "execute"
permission and "read" permisson.

To access other databases, first create another datasource as described
in step 4 of the installation. Then start the heitml Configuration
assistant by clicking the 'admin' icon in the heitml program group,
go to the directory where you want to develop your heitml application, 
click the 'New configuration' button, click on the link
'view contents' and click on the link 'Database'. Edit the 
datasource name, and possibly the username and password 
(in case the database system requires this).

By clicking the link 'Programming', you can also give the include path
where heitml looks for its include files.

How to publish your pages
-------------------------
There are 4 ways to publish heitml pages:
1. Connect your Windows 95 computer to the Internet via a leased line,
   or by a call-back router. This method is, however, not recommended,
   since Windows 95 machines are not intended for permanent operation.
2. Contact your Internet Provider and ask him for Leased heitml Web
   Space. After that, everything else should work just like
   publishing HTML pages. You can upload them by ftp (or another
   tool) to your Provider's Web Server.
3. Contact H.E.I. and ask for heitml Web Space on one of our Servers.
4. Build your own heitml Web Server on Windows NT or Unix.


In case of problems
-------------------
-  Personal Web Server does not run.

   Look into the "READMEpws.txt" file for further information.

-  Your Browser shows the heitml Source Code instead of the HTML
   generated page.

   First make sure that you have re-started the Web Server after
   installing heitml, and that heitml itself was installed AFTER
   the installation of the Web Server.

   Then make sure that the Web Directory entered in the
   Personal Web Server has "execute" permission.

-  Graphic files do not show up.
   Make sure that the directory of the ".hei" files
   has read permission besides the execute permisssion.

-  I would like to access another data source
   You must create another directory for your web pages
   and put a "heitml.ini" file there containing the new data source
   name.

-  I would like to execute an ODBC SQL statement returning
   multiple relations.
   Sorry, this is not supported by heitml version 1.2.

-  heitml no longer finds the include files after I created
   my own directory.
   Make sure the include path in the "heitml.ini" file is set correctly.
   The include path in the tutor "heitml.ini" file is a relative path.
   When your directory is located somewhere else, you need to
   modify this.

-  If all fails: Contact H.E.I. For a limited time we will
   provide email support, also to non-registered users during the
   30-day evaluation period.


Registration
-----------------
You must register heitml if you want to use it after the 30-day
evaluation period.

1. Register at "http://www.h-e-i.de/heitml/register.hei".

2. You will then receive from us one serial key for your Web Server
   and, if necessary, additional keys for any Virtual Servers you
   are operating. These serial keys must be entered into the following
   file on your local hard disk: "C:\heitml1.2\program\serial.key"
   where "C:\heitml1.2" is the directory where you installed heitml 1.2.


HOW TO CONTACT H.E.I.
-------------------------------------
H.E.I. Representative...

Phone: +49/621/795141
Fax:   +49/621/795161
Internet: heitml@h-e-i.de
