sffui (Sat Oct 25 2014 01:31:01)

sffui

SFFUI is the user interface but it can also be used in batch mode typically to
start and stop processes on startup or via crontab.

Allowable commands are :
	s show status
		s all	to display all settings
	a activate
		a xmp	start 'xmp'
		a all	start all processes
	k kill
		k all	kill all
		k set	kill the setter
		k ftp	kill the ftp program
	l list log
		l	list the last 32 items from the log
		l 05s	list the last 32 entries containing '05s'
		l !x	list program errors
	m more log
		m	more the log from midnight
		m 99p	more the log for entries containing '99p'
	y look at yesterday's and previous logs
		y 1 	more yesterday's log
		y 2 ftp	more the log from 2 days ago for 'ftp' entries
	e show error codes
		e 2	show one line description of a Unix error code 2
	w show contents of main queues
		w	short list of number of entries in main queues
		w all	list of all files in the queues
	i look at the files in the 'info' queue
		i	list help files
		i mdpfip.help	more this file
	d show current date
	v show version number of this program
	q quit

Input parameters are
	-a : start this name/group/program/all		default: no
	-i : start this name/group/program/all then start the local group
							default: no
	-k : stop  this name/group/program/all		default: no
	-h : new hostname for the prompt		default: hostname
		Use this if your System Manager has given your UnixBox
		a name which is too verbose or meaningless.
	-l : logonname for permissions			default: yourlogon
	-t : start and go into "Tail the Log"		default: no
		A Cntrl C will return to the prompt.
	-T : chk all are running/start all and go into "Tail the Log"	default: no
		A Cntrl C will return to the prompt.

Note that if -l logon is used, queues spool, x, saves and log should be set
chmod -R 777 spool x saves log

This reads a parameter file, SFFSYSTEM, in its table queue. The format of this
file is
	; comment lines start with a semicolon
	(name)	(Group)	(Program to start with all its parameters)
	where
		name is just a handle for turning this line off and on
		group is another code for turning groups of things off and on
		The program must be specified in all its glory including path if you dont
trust the enviroment!

eg:
	; spoolers
	2mac	mac	sffspl -i /data99/tomacs -p tomatos
	rip1	

It uses a environment variable, SFF_ID, which must be set to the correct
scrambled egg code which any fippo can give you.
	setenv SFF_ID	zimzumzog

Other env varis can be used to define where the system is :
	SFF_HOME	where the home or top queue is.		default: /fip/
			eg	setenv	SFF_HOME	/ripexpress/underware
	SFF_TABLES	where the parameter files are		default: (SFF_HOME)/tables/sff
	SFF_INFO	where the help file/doc queue is	default: (SFF_HOME)/info
	SFF_LOG		where the log files queue is		default: (SFF_HOME)/log
	SFF_BIN		where the programs and scripts are	default: (SFF_HOME)/bin
	SFF_SPOOL	where the data queues are		default: (SFF_HOME)/spool
	SFF_TMP		where the tmp data queues is		default: (SFF_HOME)/x
			THIS MUST BE ON THE SAME UNIX VOLUME as SFF_SPOOL queues.
			ie if spools are on /data99 which is hard disk /dev/sd0, you MUST also
			have the TMP queue on the same disk/partition

NOTE that for all BUT SFF_HOME, if the parameter starts with a '/' then it is a
hard, absolute path; if not then the spool area is under SFF_HOME.
	eg	setenv	SFF_SPOOL	/data7		will look under /data7 for queues
	while	setenv	SFF_SPOOL	data7		will look under /fip/data7


(copyright) 2014 and previous years FingerPost Ltd.