Configuration items contain information in the form of single lines of text. Lines starting with a hash character (#) are comments.

The following configuration sections are supported:

• Server configuration [server]
• Session configuration [Session]
• EloqSD protocol [EloqSD]
• HTML generator [HTML]

Server configuration [server]

UseKeepAlive

Numeric flag if the KEEP ALIVE socket option should be used. Valid values are 1/0. The default value is 1.
If this option is active, the server will check after a system defined period of inactivity if the client is still alive.

#UseKeepAlive = 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. The default value is 0 (reverse DNS lookup enabled).

NoDNS = 1

LogFile

This defines where log messages are written to. This configuration value either specifies a path/file or one of the keywords below:

• console - log messages are written to the console
• syslog - log messages will be sent to the syslog daemon (HP-UX, Linux) or the Windows Event Log.

The default value is "syslog".

SysIdent (HP-UX, Linux)
SysFacility (HP-UX, Linux)

This may be used to specify the syslog identifier and facility. Supported facility values are: USER/DAEMON/LOCAL0..LOCAL7. The default syslog identifier is "eloqwebd". The default syslog facility is "USER". Please refer to syslogd(1M) for more information.

#SysIdent = eloqwebd
#SysFacility = USER

LogFlags

Each log message has an associated origin and severity. The log flags define which messages are be logged. The "*" origin matches all message origins, so it can be used to setup a default which can be overridden for a specific message origin (e.g. "*1N0"). The default LogFlags are "*0".

The following origin 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:

• ERROR = 0 - error messages
• INFO = 1 - information
• DEBUG = 2 - debug
• VDEBUG = 3 - verbose debug

When using syslog, the following priorities are mapped:

• ERROR = LOG_ERR
• INFO = LOG_NOTICE
• DEBUG = LOG_DEBUG
• VDEBUG = LOG_DEBUG

Enabling log messages with DEBUG or VDEBUG severity may result in a huge number of log messages.
To suppress anything but fatal messages, you can set LogFlags to "*0". To enable informational log messages LogFlags should be set to "*1".

LogFlags = *1

Expires

Number of seconds until DLG session expires. During a DLG DO or POPUP BOX command, this is the maximum idle time until an error #684 is returned. The default value is 3600 seconds (1 hour).

#Expires = 3600

InitTimeout

Initial timeout in seconds until the DLG connection to the Eloquence program is expected to be established. The default value is 10 seconds.

#InitTimeout = 10

DlgTimeout

Maximum number of seconds between two DLG DO or POPUP BOX commands. This should avoid that a session hangs infinitely. The default value is 60 seconds.

#DlgTimeout = 60

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.
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.

#Cache = 0

Hostname

The host name or IP address of the system where the Eloquence programs are started by default. The default value is 'localhost' (aka. 127.0.0.1).

#Hostname = 127.0.0.1

Service

The default eloqsd service name (as defined in /etc/services) or the port number. The default value is "eloqsd".

#Service = eloqsd

User

The default user name which is used to log on to eloqsd. If HTTP Basic Authentication is used, this must be empty.

#User =

Password

The default password which is used to log on to eloqsd. If HTTP Basic Authentication is used, this must be empty.

#Password =

EnableAjax

The Ajax functionality allows dynamic updates of HTML dialogs without reloading the HTML page. Depending on this setting, the Ajax functionality is globally enabled or disabled.

• 0 - Ajax functionality is disabled.
• 1 - Ajax functionality is enabled if supported by the browser.

The default value is 1.

#EnableAjax = 1

FocusTabMode

Specifies whether the Dialog tab order is enforced and whether the RETURN and ENTER keys are enabled for tab navigation.

• 0 - The browser handles the tab navigation. The tabindex HTML attribute is used to propose the desired tab order to the browser.
• 1 - The Dialog tab order is enforced. The TAB key is enabled for tab navigation.
• 2 - The Dialog tab order is enforced. The TAB and RETURN and ENTER keys are enabled for tab navigation.

The default value is 2.

#FocusTabMode = 2

SelectOnFocus

Whether the content of EditText fields are selected on focus:

• 0 - don't select anything
• 1 - select single-line EditText
• 2 - select multiline EditText
• 3 - select both single- and multiline EditText

The default value is 1.

#SelectOnFocus = 1

RuleOnChange

Whether an EditText rule is triggered when the content changes:

• 0 - rule is triggered when EditText loses focus
• 1 - rule is triggered when EditText content changes

The default value is 0.

#RuleOnChange = 0

XRaster

Width in pixels of a character cell, used for internal coordinate calculations. Sub-pixel values are recognized, for example: XRaster = 9.5 The default value is 9 pixels.

#XRaster = 9

YRaster

Height in pixels of a character cell, used for internal coordinate calculations. Sub-pixel values are recognized, for example: YRaster = 18.5 The default value is 18 pixels.

#YRaster = 18

TableComments

Depending on this setting, additional comments are included in the generated HTML code:

• 1 = for each DLG object

The default value is 0 which will not include any comments.

#TableComments = 0

TableBorder

Sets the border attribute of the generated HTML table. This could be useful for debugging purposes to clarify the particular HTML table layout. The default value is 0 which disables HTML table borders.

#TableBorder = 0

ExtCharset

Configures the character set encoding of external files which are accessed using 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

The default value is "HPROMAN8".

#ExtCharset = 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. The default value is 3.

#PopupBorder = 3

JsInline

Specifies whether the JavaScript functions are provided in a separate session-specific document, or whether they are part of the HTML document containing the Dialog.

• 0 - The JavaScript functions are provided in a separate session-specific document.
• 1 - The JavaScript functions are part of the HTML document containing the Dialog.

The default value is 0. Depending on the browser capabilities, this may allow the browser to keep the compiled functions in memory, which may cause a better JavaScript performance.

#JsInline = 0

# eloqwebd.cfg
# @(#) $Revision: 27.2 $
#
# This file defines the configuration of the Eloquence web daemon.
# The default location depends on the operating system:
#
# HP-UX and Linux:
#    /etc/opt/eloquence/8.2/eloqwebd.cfg
# Windows:
#    Windows: C:/Program Files/Eloquence/8.2/etc/eloqwebd.cfg

# Format:
#
# The section names are not case sensitive. String values can be
# enclosed in double quotes to protect leading or trailing spaces.
# Everything after a hash (#) character is considered a comment.

### Server configuration

[Server]

# UseKeepAlive  Numeric flag if the KEEP ALIVE socket option
#               should be used. Valid values are 1/0.
#               The default value is 1.
#               If this option is active, the server will check
#               after a system defined period of inactivity if the
#               client is still alive.

#UseKeepAlive = 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. The default
#               value is 0 (reverse DNS lookup enabled).

#NoDNS = 0

# LogFile       This defines where log messages are written to.
#               This configuration value either specifies a path/file
#               or one of the keywords below:
#
#               console  - log messages are written to the console
#               syslog   - log messages will be sent to the
#                          Windows event log
#
#               The default value is "syslog".

#LogFile = syslog

# SysIdent      When logging to the syslog daemon, you can define
#               a syslog identifier. Default is eloqwebd.
#               See syslogd(1M) for more information
#
# SysFacility   When logging to the syslog daemon, you can define
#               a syslog facility (USER/DAEMON/LOCAL0..LOCAL7)
#               The default setting is "USER".
#               See syslogd(1M) for more information

#SysIdent = eloqwebd
#SysFacility = 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"):
#               Default LogFlags are "*0"
#
#               The following origin 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:
#                  L_ERROR  = 0   - error messages
#                  L_INFO   = 1   - information
#                  L_DEBUG  = 2   - debug
#                  L_VDEBUG = 3   - verbose debug
#
#               Enabling log messages with L_DEBUG or L_VDEBUG severity
#               may result in a huge number of log messages.
#               To suppress anything but fatal messages, you can set
#               LogFlags to "*0". To enable informational log messages
#               you can set the LogFlags to "*1".

#LogFlags = *0

### Session configuration

[Session]

# Expires       Number of seconds until DLG session expires. During a DLG DO
#               or POPUP BOX command, this is the maximum idle time until an
#               error #684 is returned.
#               The default value is 3600 seconds (1 hour).

#Expires = 3600

# InitTimeout   Initial timeout in seconds until the DLG connection to the
#               Eloquence program is expected to be established.
#               The default value is 10 seconds.

#InitTimeout = 10

# DlgTimeout    Maximum number of seconds between two DLG DO or POPUP BOX
#               commands. This should avoid that a session hangs infinitely.
#               The default value is 60 seconds.

#DlgTimeout = 60

# 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.
#               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.

#Cache = 0

### EloqSD protocol
###
### This is used to start Eloquence programs either locally or on remote
### systems. These are the default settings which can be overridden per program
### in the mod_eloq-related configuration of the Apache web server.
### 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.
#               The default value is 'localhost' (aka. 127.0.0.1).

#Hostname = 127.0.0.1

# Service       The default eloqsd service name (as defined in /etc/services)
#               or the port number.
#               The default value is 'eloqsd'.

#Service = eloqsd

# User          The default user name which is used to log on to eloqsd.
#               If HTTP Basic Authentication is used, this must be empty.

#User =

# Password      The default password which is used to log on to eloqsd.
#               If HTTP Basic Authentication is used, this must be empty.

#Password =

### HTML generator

[HTML]

# EnableAjax    The Ajax functionality allows dynamic updates of HTML dialogs
#               without reloading the HTML page. Depending on this setting,
#               the Ajax functionality is globally enabled or disabled.
#                  0 - Ajax functionality is disabled.
#                  1 - Ajax functionality is enabled if supported
#                      by the browser.
#               The default value is 1.

#EnableAjax = 1

# FocusTabMode  Specifies whether the Dialog tab order is enforced and whether
#               the RETURN and ENTER keys are enabled for tab navigation.
#                  0 - The browser handles the tab navigation.
#                      The tabindex HTML attribute is used to propose
#                      the desired tab order to the browser.
#                  1 - The Dialog tab order is enforced.
#                      The TAB key is enabled for tab navigation.
#                  2 - The Dialog tab order is enforced.
#                      The TAB and RETURN and ENTER keys are enabled
#                      for tab navigation.
#               The default value is 2.

#FocusTabMode = 2

# SelectOnFocus Whether the content of EditText fields are selected on focus:
#                  0 - don't select anything
#                  1 - select single-line EditText
#                  2 - select multiline EditText
#                  3 - select both single- and multiline EditText
#               The default value is 1.

#SelectOnFocus = 1

# RuleOnChange  Whether an EditText rule is triggered when the content changes:
#                  0 - rule is triggered when EditText loses focus
#                  1 - rule is triggered when EditText content changes
#               The default value is 0.

#RuleOnChange = 0

# XRaster       Width in pixels of a character cell, used for internal
#               coordinate calculations. Sub-pixel values are recognized,
#               for example: XRaster = 9.5
#               The default value is 9 pixels.

#XRaster = 9

# YRaster       Height in pixels of a character cell, used for internal
#               coordinate calculations. Sub-pixel values are recognized,
#               for example: YRaster = 18.5
#               The default value is 18 pixels.

#YRaster = 18

# TableComments Depending on this setting, additional comments are included
#               in the generated HTML code:
#                  1 = for each DLG object
#               The default value is 0 which will not include any comments.

#TableComments = 0

# TableBorder   Sets the border attribute of the generated HTML table.
#               This could be useful for debugging purposes to clarify
#               the particular HTML table layout.
#               The default value is 0 which disables HTML table borders.

#TableBorder = 0

# ExtCharset    Configures the character set encoding of external files
#               which are accessed using 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
#
#               The default value is "HPROMAN8".

#ExtCharset = 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.
#               The default value is 3.

#PopupBorder = 3

# JsInline      Specifies whether the JavaScript functions are provided in
#               a separate session-specific document, or whether they are
#               part of the HTML document containing the Dialog.
#                  0 - The JavaScript functions are provided
#                      in a separate session-specific document.
#                  1 - The JavaScript functions are part of
#                      the HTML document containing the Dialog.
#               The default value is 0. Depending on the browser capabilities,
#               this may allow the browser to keep the compiled functions in
#               memory, which may cause a better JavaScript performance.

#JsInline = 0