Keywords
POLL,PORT,SYS,EXEC,SHUT,INCLUDE,LOGFILE,LOGWRITE
All keywords can be typed in whatever case. Internally they are changed to capitals.
Format of using the language is : KeyWord==Value The string is broken at "==" and key , value pairs created which are then parsed.
All the strings must be bare. i:e; there is no need for "" or '' etc.
POLL : integer, seconds. Soth server will wait POLL number of seconds after serving one round of jobs to all the ready slaves before it starts polling them to see if they are ready. There is no point in polling a slave every 100 microsecs if you before hand know it is a big job , i:e; povary rendering 2000x1000 pixels with radiosity etc.
SYS : ipnum/hostname open string. This key suggests soth server to take the value as a slave and soth will store it in the systems list.
EXEC : string, executable statement. This value is the one stored in jobs list and soth will send this to the next available slave for execution.
INCLUDE : filename,string Will do just that. Read the file as if it has been typed in this place.
SHUT : integer 0 or 1 Will instruct soth server to send a "QUIT" signal to the slaves in jobfile, to release port 5000 and closedown. 1 is yes , 0 is no.
LOGFILE : filename, string Name of file you want the Soth logs which are reasonably formatted and timed as well as somewhat elaborate.
LOGWRITE : integer 0 or 1 Do you want the logfile to be written? 1 is yes. 0 is no.
PORT : integer, port for socket This if given will force soth to use alternate port instead of 5000 which is default. Make sure you change the port number in sothc.py at the top if you intend to use it, i:e; before copying the sothc.py to all the slaves.
COMMENT : string Comment.
The compulsory keys words needed for running are only SYS and EXEC. The remaining can use defaults, which should run fine.