Wafl service configuration files use XML syntax.
Recommended configuration file name is www.wsvc,
and recommended configuration file location is the base service directory.
For MS IIS and Wafl Web Server, both recommendations are mandatory.
One configuration file configures one service.
Configuration file may contain some confidential information,
like username and password for database access.
Thus, it is recommended to carefully define access rights
on configuration files.
An example of service configuration file is available as
a following tutorial page.
the and of this pagein Doc subfolder of Wafl installation.
Tag / Attribute |
Description |
|
<WaflService |
Base service description tag that identifies the service.
Mandatory. Outermost tag.
|
name="..." |
Service name. Mandatory. |
type="WWW" |
Service type. Optional. Default value is "WWW". |
description="..." |
Short service description. Optional. Default value is empty string. |
> |
|
|
<WWW |
Configuration of Web options.
Bounds all Web specific configuration parameters.
Mandatory for services of "WWW" type. |
<Host name="..." /> |
Host name for the service.
Optional. Can be specified many times,
if many names or IP addresses are dedicated to the server. |
<Basedir path="..." /> |
Base URI path to the service, not including the host name.
It is used if the service is defined not as a complete Web site,
but as a virtual directory of a larger site.
Should begin with a slash but should not have a slash at the end.
Optional. Default value is "/". |
> |
|
|
<Directories |
Locations of specific directories. Mandatory. |
serviceRoot="..." |
Path to base service directory.
Optional. Default value is the directory
in which the configuration file is located. |
systemLib="..." |
Path to Wafl system libraries base directory.
Usually [WAFL_PATH]/Lib.
Mandatory. |
serviceLib="..." |
Path to Wafl service libraries base directory. Mandatory. |
> |
|
|
<Default |
Configuration of default parameters. Mandatory. |
file="..." |
Default Wafl program file for the service. Optional. Not used with IIS. |
mimeType="..." |
Default type of MIME resources evaluated by Wafl programs.
It is used to create the appropriate HTTP header,
if program result is not of MimeResource type.
Optional. Default value is "text/html". |
> |
|
|
<Database |
Database connection configuration.
Optional. No database connection is used if this tag is not specified. |
driver="..." |
Database driver.
Mandatory. Allowed values are DB2,
ODBC and None. |
alias="..." |
Database name (or alias) defined for the specified driver.
Mandatory. |
username="..." |
User name for the database connection. Mandatory. |
password="..." |
Password for the database connection. Mandatory. |
> |
|
|
<Evaluators |
Wafl evaluators configuration.
Optional. |
maxthreads="..." |
The maximal count of Wafl evaluator threads.
It is recommended to set this parameter slightly above the processor count.
For example, 4 threads for single processor core, 7 threads for two cores,
and double the core count for more processors.
Optional. Default value is 4.. |
> |
|
|
<Debug |
Debugging configuration.
Optional. |
on="..." |
Set debugging mode on (1) or off (0).
In debugging mode error reports are more detailed.
Optional. Default value is 0. |
errLogFileBase="..." |
The full path and the beginning of the name of log files.
The date and thread information are appended to generate exact log file name.
Optional. |
> |
|
|
<Parameters> |
Configuration of environment and service parameters.
Optional. |
<Param name="..."
value="..."> |
Definition of a service parameter name and value.
Optional. Can be specified many times. |
<EnvParam name="..."
value="..."> |
Definition of an environment parameter name and value.
Optional. Can be specified many times. |