3 Installing Eloquence on Windows
Configuration of the GUI Dialog Server
The GUI dialog server allows Eloquence programs to apply a user interface with native Windows look-and-feel. It consists of two components:
- the Run server (RUNSRV32) which permanently runs in the background on the user's PC, waiting for incoming TCP network requests from a (remote) Eloquence program
- the Dialog server (DLGSRV32) which is started by the Run server to connect with the Eloquence program and handle TCP network dialog requests
The process about how the Eloquence program (i.e. the eloqcore process) connects to the Run and Dialog servers is configured in the eloq.ini configuration file. This file is located on the system where the program is run, for example on a remote system.
On the user's PC, the eloqcl.ini configuration file specifies the configuration of the RUNSRV32 and DLGSRV32 processes, e.g. which TCP port the Run server listens to for incoming connections and the command line the Run server uses to start the Dialog server.
Customization of the eloq.ini and eloqcl.ini files
Eloquence configuration files are located in the etc subdirectory of your Eloquence installation directory (for example C:\Program Files\Eloquence\etc).
The installation program does not overwrite existing configuration files but installs the eloq.ini.sam and eloqcl.ini.sam files instead.
The 'ini' File format
The eloq.ini and eloqcl.ini files contain several sections each containing a group of related configuration items. The sections and configuration items have the following format:
[Section]
Item=Value
Section is the name of a section. The enclosing brackets ([ ]) are required and they must start at the first column. Item=Value defines a value of a configuration item. Item is the name of a configuration item. It consists of any sequence of characters (case insensitive) and digits followed by an assignment operator (=). Depending on the item type, the value may either be numeric or alphanumeric (optionally enclosed in double quotes). Comment lines must start with a semicolon (;) or a hash character (#) in the first column.
Eloquence Installation and Configuration - 29 OCT 2004