Starting the S3SERV Process

The S3SERV process runs as either a Pathway serverclass or a standalone Guardian server process. The advantage of the Pathway option is Pathway's server process management and load-balancing features. In either case, S3SERV supports a number of startup command-line-options that control various aspects of its operation. The same options are supported in both Pathway and standalone configurations, specified as server PARAMs or command-line-options, respectively. The object file name for the S3SERV process is “S3SERV” and is located in the installation subvolume.

Starting S3SERV a Standalone Server Process

S3SERV may be started by running the S3SERV program from TACL.

tacl> run s3serv / run-options / command-line-options

Examples

The example starts the S3SERV process as $MYS3 in CPU 0.

tacl> run s3serv / name $mys3, cpu 0 / --log $zhome info --standalone

More Information

For complete information about run-options and command-line-options see S3SERV Command Line Options.

Starting S3SERV as a Pathway Server

A sample S3SERV startup macro, ZSTARTPW, is included with the release. Before using for the first time, copy or rename the file to a new name (e.g. FUP DUP ZSTARTPW, STARTPW) so it won't be overwritten by future releases. The sample macro should be suitable for most installations, but it will be necessary to modify certain parameters for your environment. To use the macro: RUN STARTPW

The S3SERV process may be configured as a Pathway server, which allows you to take advantage of Pathway's process management and load-balancing features. The configuration options are the same as those for standalone process configuration, however in the Pathway environment individual options are supplied as server PARAMs.  The following is a sample pathway server configuration. Note that the server settings here (createdelay, deletedelay, maxservers, etc.) are merely examples, not requirements or recommendations. 

reset server
set server cpus 0:1
set server createdelay 0 secs
set server deletedelay 60 secs
set server highpin on
set server linkdepth 1
set server maxservers 6
set server maxlinks 20
set server numstatic 0
set server program S3SERV
set server tmf on
set server debug off
set server param log "$0 info text"
add server S3-SERVICE

You may also provide the options in a command file by setting the SERVER STARTUP value to @<command-file>. The following is a sample pathway configuration using this technique.

reset server
set server cpus 0:1
set server createdelay 0 secs
set server deletedelay 60 secs
set server highpin on
set server linkdepth 1
set server maxservers 6
set server maxlinks 20
set server numstatic 0
set server program S3SERV
set server tmf on
set server debug off
set server startup @config
add server S3-SERVICE