WAA server Professional

The configuration data for "waa1srv.exe" is provided in two ways: via environment variables and with the "waa1srv.cfg" configuration file. The "waa1srv.cfg" file contains the locations of package DLLs to be loaded automatically when "waa1srv.exe" is started. Check the "waa1srv.cfg" file for the correct locations of package DLLs.

You must specify the environment variables required by "waa1srv.exe". The easiest way to do this, is by creating a batch file similar to this one:

REM File: STARTWAA.BAT 
REM 
REM Setting environment variables for WAA1SRV.EXE 
SET WAA_WORKERTHREADS=10 
SET WAA_HOST=www.smartguys.com 
SET WAA_PORT=1024 
START %1 WAA1SRV.EXE 

This batch file ("startwaa.bat") sets the environment variables before "waa1srv.exe" is invoked. For debugging WAA packages, the Xbase++ debugger may be passed as parameter to the batch file. The WAA executable is then loaded into the debugger.

The following environment variables are supported by the "waa1srv.exe":

WAA_WORKERTHREADS

This is the maximum number of threads available for servicing client requests. The recommended value is 10. You can increase this number later if this is required. The maximum number of threads equals the maximum number of simultaneously-serviced client connections. When you develop package DLLs providing complex and time consuming application logic, you should increase the maximum number of threads.

WAA_HOST

This is the host name of the workstation on which the WAA server is running.

WAA_PORT

This indicates the port number which is used for communication between WAA gateway and server. You must enter the same port number in the "waa1gate.cfg" configuration file for setting up the gateway.

WAA_NAME

This environment variable is only required when more than one WAA server is running on a computer (e.g.: SET WAA_NAME=WAASERVER1). In a normal, single server installation, WAA_NAME does not need to be specified.

WAA_TRACE

If this environment variable is set to "ON", then more detailed information about the request is printed into the WAA log file. By default WAA_TRACE is set to "OFF".

WAA_INTERNAL_LOG

If this environment variable is set to "ON", then the WAA log file contains information about internal server errors recovered by the error management. This might be helpful for Alaska Technical Support to analyze WAA related issues. WAA_INTERNAL_LOG is set to "OFF" by default.

WAA_CONFIGURATION

Normally this environment variable is created by the WAA installation package and contains the directory path from where the package configuration file "waa1srv.cfg" is loaded.

If the environment variable WAA_CONFIGURATION is not set, then the file "waa1srv.cfg" is read from the directory where the WAA server is installed and the log files are created in the same directory.