| |
The eloqwebd.cfg configuration file is used to configure the eloqwebd
behavior that is used with Eloquence WebDLG. For detailed information
on webdlg please refer to the
Eloquence WebDLG documentation.
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]
- 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
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 [EloqSD]
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.
- 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:
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
Changes
As of B.08.40 the webdlg component is no longer included in Eloquence.
It is replaced with Eloquence WEBDLG2.
eloqwebd.cfg template file
A default configuration file eloqwebd.cfg is installed and may be customized.
A template eloqwebd config file is installed as
newconfig/config/eloqwebd.cfg.
# @(#) eloqwebd.cfg - B.08.30 ($Revision: 28.4 $)
#
# 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.3/eloqwebd.cfg
# Windows:
# Windows: C:/Program Files/Eloquence/8.3/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
# syslog daemon
#
# 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 overridden
# 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
#
# When using syslog, the following priorities
# are mapped:
# L_ERROR = LOG_ERR
# L_INFO = LOG_NOTICE
# L_DEBUG = LOG_DEBUG
# L_VDEBUG = LOG_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'.
#Hostname = localhost
# 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 multi-line EditText
# 3 - select both single- and multi-line 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
|
|
