Sys
The sys layer is used to initiate and control a group of processes.
A system of processes is defined in a configuration file (see config layer).
Under Construction.
The System Wide keywords supported:
TCP
Define a tcp port. Must have logical port name, hostname, port, [encryption
type, and encryption key].
See Io layer configuration.
BINDIR
Directory where binaries can be found.
LOGDIR
Directory where trace and error logs are written.
CAGSERVER
Name or address of the CAG server.
If a logical port name is used, it must
be defined using the TCP. directive.
See Io layer configuration.
CAGGROUP
CAGHOST
PROCPORT
IO port for the (usually first) process. Other process ports will increment this value.
If this appears anywhere but at the beginning of the config file,
it will reset the process port number.
STARTUPDELAY
CHILD
PROC
INCLUDE
Include another config file at this point.
FOREGROUND
Sysgo will remain in the foregroun instead of becomming a daemon.
This is used for running under init.
BRUTEFORCEKILL
BOOTDELAY
Delay this many milliseconds before starting processes.
RESTARTDLY
The Individual Process keywords supported:
NO_RESTART
If this process dies (or exits), don't automatically restart it.
NO_AUTOSTART
Do not automatically start the process (infCtl may be used to start it).
CLONE_OK
Enable cloning of a process.
CLONE N
Manually (via config) clone a process N times.
RESTART_OK
The default, restart any processes which dies.
HIDE_NAME
For use on some unix systems (HP-UX) and some applications (Progress).
SOFT_KILL
Use SIGTERM to kill the process. Normally SIGKILL is used.
SRVSYNC
Wait for the process to "call-home" after start and before
starting other processes.
TRCD
PORT
USER
Run this process as the indicated user id.
PERMS
Run this process with the indicated permissions.
UNIXENV
Calling this will transmogrify the current process into a daemon.
int
syInit( int argc, char* argv[] )
Initializes the system control layer, runs infInit (read config file).
int
syMakPath( char* path )
Create all directories in path "path".
int
syStart( )
Stars the sub-system, all process that are not prohibited are started. Processes from previous incarnations of the system will be re-acquired as children.