Eloquence WebDLG example programs
=================================

The Eloquence WebDlg examples are started with a browser
at the following URL:

http://<system>/eloq/webdlg/

where <system> is the name or IP address of the server system.


Eloquence configuration:
-----------------------

1. Make sure the volume EXAMPLE is uncommented in the eloq.config file.

VOLUME EXAMPLE /opt/eloquence/8.2/share/example

2. Add a user and password to the eloqsd.user configuration file and
define the same user/password in the eloqwebd.cfg.

-- eloqsd.user --
[webdlg]
Name = Used with WebDLG examples
Password = webdlg

-- eloqwebd.cfg --
User = webdlg
Password = webdlg


Example database:
----------------

The customer example uses the sample database. Please make sure
the eloqdb server is running and the sample database has been
installed (see examples/sampledb for more information).


Load Apache module:
------------------

LoadModule eloq_module /opt/eloquence/8.2/lib/mod_eloq22.so

Depending on the Apache version a different Eloquence module
must be loaded:

   mod_eloq2.so      - Apache 2.0.x
   mod_eloq22.so     - Apache 2.2.x
   mod_eloq24.so     - Apache 2.4.x

On the HP-UX platform, the path of the module depends on the
Apache build:

   pa11_32   - PA-RISC 1.1, 32-bit
   pa20_32   - PA-RISC 2.0, 32-bit
   pa20_64   - PA-RISC 2.0, 64-bit
   hpux32    - Itanium, 32-bit
   hpux64    - Itanium, 64-bit


Common Apache configuration:
---------------------------

#### Eloquence WEBDLG

Alias /eloq/webdlg "/opt/eloquence/8.2/share/example/webdlg"

<Directory "/opt/eloquence/8.2/share/example/webdlg">
  # MultiViews should be disabled to avoid ambiguities
  # if the mod_eloq Location refers to an alias
  Options -MultiViews
  AllowOverride None
  Order allow,deny
  Allow from all
</Directory>

<IfModule mod_eloq.c>
  <Location /eloq/webdlg>
    EloqPageHeader /opt/eloquence/8.2/share/example/webdlg/page_header.tmpl
    EloqPageTrailer /opt/eloquence/8.2/share/example/webdlg/page_trailer.tmpl
    EloqSessionFinishedDocument /eloq/webdlg/index.html
  </Location>

  <Location /eloq/webdlg/hello>
    SetHandler eq-web-dlg
    EloqCommand "webdlg/HELLO,EXAMPLE"
  </Location>

  <Location /eloq/webdlg/box>
    SetHandler eq-web-dlg
    EloqCommand "webdlg/BOX,EXAMPLE"
  </Location>

  <Location /eloq/webdlg/webdlg>
    SetHandler eq-web-dlg
    EloqCommand "webdlg/WEBDLG,EXAMPLE"
  </Location>

  <Location /eloq/webdlg/cust>
    SetHandler eq-web-dlg
    EloqCommand "webdlg/CUSTOMERS,EXAMPLE"
  </Location>
</IfModule>