Wafl Home

Using Web Servers Tutorial

Service Configuration

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.

Configuration File Options

The following XML tags are available for use in configuration files:

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.

 

Table of Contents

Let's Start

Program Structure

Primitive Data Types

List

Tuple

Record

HTML

Command Line Interpreter

Using Web Servers

Syntax

Examples

Tips

The most of examples evaluates with both command line and Web server Wafl interpreters. If any example is based on specific features of an interpreter, it is explicitly annotated.