4.13.1 Parameters used for setting up the definitions for the Web server

The following table describes the parameters used for setting up the definitions, for the Web server:

For details about the contents to be specified in param-value corresponding to "Value in param-name", see the description on the list of directives in the manual Cosminexus HTTP Server. In the table below, Default value means the value that is assumed when the parameter is not specified. VR is the version of Application Server on which parameters are introduced or changed.

Table 4-7 Parameters used for setting up the definitions for the Web server

Value of param-nameValue of param-valueSpecifiable valueDefault valueVR
SetBySpecifies how to set up the Web server.
item: Specified for each item.
text: The contents of httpsd.conf (Cosminexus HTTP Server definition file) are specified directly.
The following strings can be specified:
  • item
  • text
item08-70
CoreDumpDirectorySpecifies the directory for dumping core. You can specify an absolute path or a relative path from the value specified in the ServerRoot directive. Note that the users and groups specified in the User and Group directives must be given write permission for the specified directory. In the Linux versions, a directive is only enabled when specified in the configuration file.
Note that this specified value is only enabled in UNIX.
Specify any string.&{hws.home}/servers/HWS_server-name06-50
GroupSpecifies the group name used when server processes operate.
Note that this specified value is only enabled in UNIX.
Specify a string within 16 characters using alphanumeric characters and underscore (_).bin06-50
07-00
HWSKeepStartServersSpecifies whether to maintain the number of server processes at the number specified in the StartServers directive only.
If you specify On:
The running server processes are maintained at only the number specified in the StartServers directive. If the number of server processes becomes less than the value specified in the StartServers directive, new processes are generated. This functionality is enabled when the value specified in each directive related to the process count has the following relationship:
MinSpareServers < StartServers [Figure]MaxClients
and
MinSpareServers < MaxSpareServers [Figure]MaxClients
If the value set in the StartServers directive is less than the value set in the MinSpareServers directive, the number of server processes is maintained at the value in the MinSpareServers directive.
If you specify Off:
The running server processes are not maintained at the number specified in the StartServers directive.
For details about the other directives related to the process count, see the manual Cosminexus HTTP Server.
Note that this specified value is only enabled in UNIX.
The following strings can be specified:
  • On
  • Off
Off06-50
HWSLogTimeVerboseSpecifies whether an error log and a request log time, the time required for the request processing of the access log (%T), and the time at which request processing is started (%t) will be displayed in milliseconds.
If you specify On:
The time will be displayed up to milliseconds.
If you specify Off:
The time will be displayed up to milliseconds.
Note that an error log only includes the error log specified in the ErrorLog directive. The error log of the CGI script specified in the ScriptLog directive will not be considered.
The following strings can be specified:
  • On
  • Off
On07-50
KeepAliveTimeoutSpecifies the request waiting time for the KeepAlive connection in seconds. If a next request does not arrive from the client even after the lapse of time is greater than this time, the connection will be terminated. In KeepAlive, the server process is occupied with a specific client. If more time is required than the standard time for moving from a certain Web page to the next Web page, KeepAlive causes the timeout to occur, terminates the connection, and applies the server process to the processing of other requests.
For details about directives, see the manual Cosminexus HTTP Server.
Specify the value using an integer from 0 to 65535.1506-50
ServerNameSpecifies the server name and port number of Cosminexus HTTP Server.
Specify the server name using FQDN (Fully Qualified Domain Name) or IP address.
For details on the contents specified, see the manual Cosminexus HTTP Server.
Server name and port numberwww.example.com08-70
ListenSpecifies an IP address and a port number that will receive a request. Unlike the Port directive, multiple values can be specified. You specify this tag for defining a virtual host. If you specify the Listen directive, the Port directive and the BindAddress directive will be ignored.
You can also specify IPv6 address as the IP address. When you specify IPv6 address, enclose the IPv6 address within square brackets ([ ]). However, if you omit the IP address and specify only the port number, only the requests using the IPv4 address will be received. Therefore, when using the IPv6 address, make sure that you specify the IPv6 address in the Listen directive.
The values that can be specified are as follows:
  • IPv4 address: Port number
  • Host name: Port number
  • @myhost: Port number

The host name is a string within 255 characters consisting of alphanumeric characters, underscore (_), period (.), and hyphen (-).
The port number is a one-byte numeric character from 1 to 65535.
None07-50
LogLevelSpecifies error levels to be output in an error log. The log of a level higher than the specified level will be output. However, the notice level log will be output regardless of this specification. Also, the messages, output before the level specification analysis ends such as when Cosminexus HTTP Server starts, might be output regardless of this specification.
The following are the error levels in their order of superiority:
  • emerg: Emergency message
  • alert: Prompt processing request message
  • crit: Critical status message
  • error: General error message
  • warn: Warning level message
  • notice: Standard but important message
  • info: Information message, trace of external module and CGI program runtime module#1
  • debug: Debug level message, internal module trace, and module trace corresponding to info#1
The following strings can be specified:
  • emerg
  • alert
  • crit
  • error
  • warn
  • notice
  • info
  • debug
info06-50
MaxClientsSpecifies the maximum number of clients that can be connected at the same time.
When the server starts, the number of processes specified in the StartServer directive start and wait for requests. If many requests are issued concurrently, multiple processes process the requests. If the number of processes waiting for the requests becomes less than the number specified in the MinSpareServers directive, new processes will be generated gradually. At this time, processes are generated until the process count reaches the number specified in this directive. After this, when the request processing ends and the processes waiting for requests increase, the processes will be terminated up to the number specified in the MaxSpareServers directive.
For details about the other directives related to the process count, see the manual Cosminexus HTTP Server.
Note that this specified value is only enabled in UNIX.
Specify the value using an integer from 1 to 1024.15006-50
StartServersSpecifies the number of server processes used for starting the Web server. For details about the other directives related to the process count, see the manual Cosminexus HTTP Server.
Note that this specified value is only enabled in UNIX.
Specify the value using an integer from 0 to 1024.506-50
ThreadsPerChildSpecifies the number of threads to be started as the server. The specified thread count indicates the maximum number of concurrent connections of the server.
For details about directives, see the manual Cosminexus HTTP Server.
Note that this value is enabled only in Windows.
Specify the value using an integer from 1 to 1024.5006-50
UserSpecifies the user name used when the server process is running.
Note that this specified value is only enabled in UNIX.
Specify a string within 16 characters using alphanumeric characters and underscore (_).bin06-50
07-00
DocumentRootSpecifies an absolute path for the document root directory storing the contents.
For details about directives, see the manual Cosminexus HTTP Server.
Specify any string.&amp;{hws.home}/htdocs08-00
AppendDirectivesSpecifies the directive contents to be added when a Web server is set up for each item (item is specified in the SetBy parameter).#2 For details on directives, see the manual Cosminexus HTTP Server.Specify any string.None08-70
AllTextSpecifies the contents of httpsd.conf (Cosminexus HTTP Server definition file) when the Web server files are directly set up (text is specified in the SetBy parameter). #2 For details on httpsd.conf (Cosminexus HTTP Server definition file), see the manual Cosminexus HTTP Server.Specify any string.None08-70
#1
You can specify settings to output the module trace in the request log instead of the error log. For more details, see the manual Cosminexus HTTP Server.
#2
Specify the param-value value in the CDATA section.
(Example)
<param-name>AppendDirectives</param-name>
<param-value>
<![CDATA[
<Location /server-status>
:
</Location>
]]>
</param-value>