sffui

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) 2024 and previous years FingerPost Ltd.