Help - Global Settings

The default settings provided here are set for you automatically upon installation and for most cases are already the optimal settings for your server's performance.

Only change these settings if you are an experienced administrator and have tested the affect of the changes afterwards.

Our benchmarks show that the standard installed settings allow you to achieve sustained 3,600,000 HTTP transactions per day on a 120MHz Pentium computer, assuming an average 1Kbyte document or image size.

OS/2 Users:

You will need to modify a line in your config.sys file on your boot drive to increase the number of threads available to your overall system. Change THREADS=256 to at least THREADS=512 and preferably THREADS=1024 if you have a busy site with many simultaneous connections.

Config:/
Setting Explanation Default /
Example Data
Type Access
R,W,A,D
ConfigFile The name of the file from which the server configuration and security settings was loaded upon initialisation. If an alternative configuration file is desired, the server should be started with a command line parameter that specifies the new file. The Server Initialisation hook can make use of this variable. conf/powerweb.cfg Text R,W
GMTOffset The GMT offset (in seconds west of GMT). If GMTSET is 0, this will be 0. 0 Integer R
GMTSet Whether the timezone relative to GMT has been set. This is typically done by setting the operating system timezone environment variable (for example, "TZ" under OS/2). Without the timezone being set, it is impossible to make proper decisions regarding whether a document is out of date if the client and server operate in two different time zones. No Integer R
GMTTime The current GMT date and time, empty if GMTSet is FALSE.
The format is "yyyy/mm/dd hh:mm:ss". 1995/09/01 12:34:56 Text R
LocalTime The current local date and time. This variable is useful within PowerWeb Macro scripts for date and time stamping the receipt of a form or the transmittal of a document.
The format is "yyyy/mm/dd hh:mm:ss". 1995/09/01 14:34:56 Text R
PID The current process identifier of the server program. 123 Integer R
PIDFile The name of the file into which the current process identifier of the server program is written. logs/powerweb.pid Text R,W
PreAllocatedThreads The minimum number of threads that should be allocated by PowerWeb to handle connections across all services.
Pre-allocating threads allows your server to respond more quickly to incoming requests because it doesn't incur the overhead of creating threads until the number of simultaneous connections exceeds the value specified here.
Increase this setting if your server is heavily loaded, bearing in mind that each extra thread will consume memory according to the StackSize setting.
20 Integer R,W
Priority Changes the overall priority setting of the server. Do not change this setting from the default without testing the affect on your system. normal Integer R,W
Schedule The time of day for scheduled server maintenance events. If the server has a pending idle-time restart and has been unable to restart because it is continually busy, then it will force all connections closed and perform a restart at this time. 4:0:0 DateTime R,W
ServerRoot This directory contains all the sub-directories that contain the server program, configuration files, audit logs, administration utilities, CGI executables, etc.
VERY IMPORTANT:
If you change this directory, be sure to modify your Resources in the Resource Editor to refer to the new paths, otherwise you will not be able to access the administration and configuration facilities. This would mean that you would be locked out of your own server, unless you revert back to one of the automatically created backup copies of your configuration, by manually copying the backup to "powerweb.cfg".
c:/powerweb Text R,W
StackSize The maximum size to which the runtime stack can grow for each individual thread executing service requests. The value is common across all services, so you should set this value to be at least as large as the maximum requirement of any of your API extensions that you create. PowerWeb requires a minimum of 16K bytes to operate.
If you change this setting, you will need to perform a "Complete Restart" not a "Quick Restart" in order to have the change take effect. Alternatively, shut down the server and restart it from the command line.
32768 Integer R,W
System This is the name of the System directory underneath the Server Root directory. You should not change this setting, it is for internal purposes, and changes from version to version. A copy of the setting is also kept in the "version" file in the Server Root directory. The system directory contains all files released with a specific version, and users should not add their own files to this directory, otherwise the additions may be lost whenever an upgrade to a new version occurs. All user files should be placed in directories under the Server Root, but outside of this "System" directory. sys207 Text R,W
Threads The maximum number of threads that should be allocated by PowerWeb to handle connections across all services.
You should set this to be at least as large as the sum of the average load across all your services, plus the number of services that you are running. Depending on your operating system and what other programs you are executing, you may need to change your operating system configuration to support the extra number of threads.
512 Integer R,W
Version The version number of the server software currently executing. PowerWeb/2.04 Text R
VersionConfig The server software version number under which the configuration was created or saved. This variable is used to perform automatic upgrades from one version to another. 2.04 Text R,W

Config:/
Setting	Explanation	Default / Example	Data Type	Access R,W,A,D
ConfigFile	The name of the file from which the server configuration and security settings was loaded upon initialisation. If an alternative configuration file is desired, the server should be started with a command line parameter that specifies the new file. The Server Initialisation hook can make use of this variable.	conf/powerweb.cfg	Text	R,W
GMTOffset	The GMT offset (in seconds west of GMT). If GMTSET is 0, this will be 0.	0	Integer	R
GMTSet	Whether the timezone relative to GMT has been set. This is typically done by setting the operating system timezone environment variable (for example, "TZ" under OS/2). Without the timezone being set, it is impossible to make proper decisions regarding whether a document is out of date if the client and server operate in two different time zones.	No	Integer	R
GMTTime	The current GMT date and time, empty if GMTSet is FALSE. The format is "yyyy/mm/dd hh:mm:ss".	1995/09/01 12:34:56	Text	R
LocalTime	The current local date and time. This variable is useful within PowerWeb Macro scripts for date and time stamping the receipt of a form or the transmittal of a document. The format is "yyyy/mm/dd hh:mm:ss".	1995/09/01 14:34:56	Text	R
PID	The current process identifier of the server program.	123	Integer	R
PIDFile	The name of the file into which the current process identifier of the server program is written.	logs/powerweb.pid	Text	R,W
PreAllocatedThreads	The minimum number of threads that should be allocated by PowerWeb to handle connections across all services. Pre-allocating threads allows your server to respond more quickly to incoming requests because it doesn't incur the overhead of creating threads until the number of simultaneous connections exceeds the value specified here. Increase this setting if your server is heavily loaded, bearing in mind that each extra thread will consume memory according to the StackSize setting.	20	Integer	R,W
Priority	Changes the overall priority setting of the server. Do not change this setting from the default without testing the affect on your system.	normal	Integer	R,W
Schedule	The time of day for scheduled server maintenance events. If the server has a pending idle-time restart and has been unable to restart because it is continually busy, then it will force all connections closed and perform a restart at this time.	4:0:0	DateTime	R,W
ServerRoot	This directory contains all the sub-directories that contain the server program, configuration files, audit logs, administration utilities, CGI executables, etc. VERY IMPORTANT: If you change this directory, be sure to modify your Resources in the Resource Editor to refer to the new paths, otherwise you will not be able to access the administration and configuration facilities. This would mean that you would be locked out of your own server, unless you revert back to one of the automatically created backup copies of your configuration, by manually copying the backup to "powerweb.cfg".	c:/powerweb	Text	R,W
StackSize	The maximum size to which the runtime stack can grow for each individual thread executing service requests. The value is common across all services, so you should set this value to be at least as large as the maximum requirement of any of your API extensions that you create. PowerWeb requires a minimum of 16K bytes to operate. If you change this setting, you will need to perform a "Complete Restart" not a "Quick Restart" in order to have the change take effect. Alternatively, shut down the server and restart it from the command line.	32768	Integer	R,W
System	This is the name of the System directory underneath the Server Root directory. You should not change this setting, it is for internal purposes, and changes from version to version. A copy of the setting is also kept in the "version" file in the Server Root directory. The system directory contains all files released with a specific version, and users should not add their own files to this directory, otherwise the additions may be lost whenever an upgrade to a new version occurs. All user files should be placed in directories under the Server Root, but outside of this "System" directory.	sys207	Text	R,W
Threads	The maximum number of threads that should be allocated by PowerWeb to handle connections across all services. You should set this to be at least as large as the sum of the average load across all your services, plus the number of services that you are running. Depending on your operating system and what other programs you are executing, you may need to change your operating system configuration to support the extra number of threads.	512	Integer	R,W
Version	The version number of the server software currently executing.	PowerWeb/2.04	Text	R
VersionConfig	The server software version number under which the configuration was created or saved. This variable is used to perform automatic upgrades from one version to another.	2.04	Text	R,W