• Whenever mod_eloq requests a new session, eloqwebd contacts the configured Eloquence eloqsd application server to start the desired program.

• Next, a DLG connection between eloqwebd and the program is established automatically.

• During the program's runtime, eloqwebd stays in contact with the program and handles its DLG requests until a DLG STOP occurs. On each interactive DLG statement (DLG DO and POPUP BOX), it generates HTML output from the current dialog and uses mod_eloq to delegate it back to the user's browser.

Contents:

• Introduction
• Server Configuration
• Session Configuration
• EloqSD Protocol
• RunSrv Protocol
• HTML Generator

Introduction

Each section is introduced with its title in sqare brackets, e.g. [Server]. Inside a section, a variable number of name = value pairs represent the various configuration items. Both the section and item names are case-insensitive. If a value contains space characters it must be enclosed in double quotes. Everything after a hash (#) character is considered a comment and therefore ignored.

Server Configuration

[Server]
UseKeepAlive	Numeric flag if the KEEP ALIVE socket option should be used. Valid values are 1/0. If this option is active, the server will check after a system defined period of inactivity if the client is still alive.
	Example: UseKeepAlive = 1
	The default value is 1.
NoDNS	If set, no reverse DNS lookup is performed on connection to the eloqwebd server. A broken DNS configuration or a slow DNS server could lead to long connection times.
	Example: NoDNS = 0
	The default value is 0 (reverse DNS lookup enabled).
LogFile	This defines where log messages are written to. This configuration value either specifies a path/file or one of the keywords: console - log messages are written to the console syslog - log messages will be sent to the syslog daemon
	Example: LogFile = syslog
	The default value is "syslog".
SysIdent	When logging to the syslog daemon, you can define a syslog identifier. See syslogd(1M) for more information.
	Example: SysIdent = eloqwebd
	The default value is "eloqwebd".
SysFacility	When logging to the syslog daemon, you can define a syslog facility (USER/DAEMON/LOCAL0..LOCAL7). See syslogd(1M) for more information.
	Example: SysFacility = USER
	The default value is "USER".
LogFlags	Each log message has an associated origin and severity. The log flags define which messages will be logged. The "*" origin matches all message origins, so it can be used to setup a default which can be overriden for a specific message origin (eg. "*1N0"). The following origins are in use: * = All origins S = The server framework C = Configuration subsystem E = Child process execution D = DLG subsystem N = Network communications The following severities are in use: 0 - error messages 1 - information 2 - debug 3 - verbose debug
	Example: LogFlags = *0
	The default LogFlags are "*0".

Session Configuration

[Session]
Expires	Number of seconds until a DLG session expires. During a DLG DO or POPUP BOX command, this is the maximum idle time until an error #684 is returned.
	Example: Expires = 3600
	The default value is 3600 seconds (1 hour).
InitTimeout	Initial timeout in seconds until the DLG connection to the Eloquence program is expected to be established.
	Example: InitTimeout = 10
	The default value is 10 seconds.
DlgTimeout	Maximum number of seconds between two DLG DO or POPUP BOX commands. This should avoid that a session hangs infinitely.
	Example: DlgTimeout = 60
	The default value is 60 seconds.
Cache	Depending on this setting, the browser will be allowed to cache any WEBDLG document locally. This could be useful for debugging purposes if the browser does not provide the HTML source code unless caching would be allowed. In such a case, a value of 1 can be configured here.
	Example: Cache = 0
	The default value is 0 which disallows the browser any local caching. This is the recommended setting which should be used in a production environment.

EloqSD Protocol

If all or most of your programs require the same eloqsd settings it is convenient to configure them in the [EloqSD] section. Different settings per program can be defined in the mod_eloq configuration.

Regardless if a program is started locally or remotely, an eloqsd server must be appropriately configured and running on the system where the particular program is about to be started.

[EloqSD]
Hostname	The host name or IP address of the system where the Eloquence programs are started by default.
	Example: Hostname = 127.0.0.1
	The default value is "localhost" (aka. 127.0.0.1).
Service	The default eloqsd service name (as defined in /etc/services) or the port number.
	Example: Service = eloqsd
	The default value is "eloqsd".
User	The default user name which is used to log-on to the eloqsd.
	Example: User = eloqwww
Password	The default Password which is used to authenticate to the eloqsd.
	Example: Password = secret

HTML Generator

[HTML]
SelectOnFocus	Whether the contents of edittext fields are selected on focus: 0 - don't select anything 1 - select singleline edittext 2 - select multiline edittext 3 - select both single- and multiline edittext Please note that JavaScript must be activated or this setting won't have any effect. However, due to the different implementation levels of HTML 4.0 in the current browsers even with JavaScript activated this is not guaranteed to work correctly with every browser.
	Example: SelectOnFocus = 1
	The default value is 1.
RuleOnChange	Whether an edittext rule is triggered when contents change: 0 - rule is triggered when edittext loses focus 1 - rule is triggered when edittext contents change Aditionally, this behavior can be controlled for each dialog, groupbox and object by means of the .ruleonchange attribute.
	Example: RuleOnChange = 0
	The default value is 1. This is the recommended setting because it minimizes HTTP overhead. The 0 setting could cause the current dialog to flicker unexpectedly because each HTTP transaction redraws the current dialog (i.e. the current HTML document). However, some applications probably require the 0 setting because it is fully compatible to ASCII DLG and JDLG. In this case, it should be considered to use the .ruleonchange attribute for a specific dialog, groupbox or object instead.
XRaster	Width in pixels of a character cell, used for internal coordinate calculations. Change this setting if your dialogs appear too wide or too narrow. However, since the size of your dialogs depend on the particular font configuration on the user's browser this is only a hint and not an absolute setting.
	Example: XRaster = 9
	The default value is 9 pixels.
YRaster	Height in pixels of a character cell, used for internal coordinate calculations. Change this setting if your dialogs appear too high or too low. However, since the size of your dialogs depend on the particular font configuration on the user's browser this is only a hint and not an absolute setting.
	Example: YRaster = 18
	The default value is 18 pixels.
TableComments	Depending on this setting, additional comments are included into any HTML table generated: 1 - for each DLG object This could be useful for debugging purposes to clarify the structure of the HTML source code.
	Example: TableComments = 0
	The default value is 0 which will not include any comments.
TableBorder	Sets the border attribute of any HTML table generated. This could be useful for debugging purposes to clarify the particular HTML table layout.
	Example: TableBorder = 0
	The default value is 0 which will disable any table borders.
ExtCharset	Configures the character set encoding of external files which are accessed with the .file attribute. The following character sets are recognized: HPROMAN8 - external files' encoding is HP Roman 8 ISO8859-1 - external files' encoding is ISO 8859-1
	Example: ExtCharset = ISO8859-1
	The default value is "HPROMAN8".
PopupBorder	Configures the border width of POPUP BOX objects in pixel units. If set to 0, the border width can be specified with a CSS definition for the .eq_popup_box class.
	Example: To use a CSS definition to specify the POPUP BOX border width, first set PopupBorder to 0: PopupBorder = 0 The following CSS definition then specifies that POPUP BOXes will be displayed with a 3 pixels wide 3D-border: .eq_popup_box { border-width:3px; border-style:groove; } Please refer to the Compatibility document for details about using CSS definitions.
	The default value is 3.