CALLSTAT(1)          FNORDADEL BBS SOFTWARE           CALLSTAT(1)

NAME
     callstat.tos - digest calllog.sys and produce silly statis-
     tics

SYNOPSIS
     callstat [-cdhsu]

DESCRIPTION
     Callstat expects to be run from the directory which contains
     ctdltabl.sys.  It will munch your call log
     (#audit\calllog.sys) and produce pretty graphs and tables,
     showing how many people at what baud rates have called and
     for how long they were connected.

     If callstat encounters weirdness in your call log, it will
     complain about it and exit.  The usual problem is that the
     system has crashed while someone was logged in, resulting in
     an entry in the call log which has a login time but no
     logout time.  Use an editor to fix this or any other weird-
     ness, and run callstat again.

     Callstat keeps an ongoing statistics file for its own uses,
     called calldata.sys, which lives in your #sysdir.  The main
     output file is callstat.sys, which is written to the #audit-
     dir.  In addition, a supplementary file may be written in
     callbaud.sys, giving some extra information about calls at
     each hour of the day, for all baud rates.  This is REALLY
     esoteric stuff.

OPTIONS
     -c   Write callbaud.sys.

     -d   Debug flag.

     -h   Display a brief help message.

     -s   Don't count sysConsole activity in the statistics.  If
          the Sysop logs in a lot, the results will probably be
          skewed towards shorter average connections and such-
          like.

     -u   Delete your calllog.sys and update the running statis-
          tics file calldata.sys.

NOTES
     Callstat doesn't do anything with file logging yet.

     The program is a bit vague when giving warnings about bad
     stuff in your call log; you have to go searching through it
     to find the error.

     Callstat can be run from a shellscript as a nightly event;
     you may wish to run it without the -u flag for this purpose.
     It will still produce the same statistics, but will leave
     your call log alone.  When you want to delete the call log,
     just manually run 'callstat -u', to properly update the run-
     ning totals file.

BUGS
     None that we know of; just "misfeatures".

FILES
     callstat.tos             The silly statistics generator.
     ctdltabl.sys             The system tables file.
     #auditdir\calllog.sys    The call log.
     #auditdir\callstat.sys   The main silly statistics file.
     #auditdir\callbaud.sys   The additional silly statistics
                              file.
     #sysdir\calldata.sys     Callstat's running totals.

SEE ALSO
     The Fnordadel Reference Manual

AUTHOR
     Royce Howland

HISTORY
     Callstat was written by Royce Howland some time after he
     switched to orc's STadel from his old BBS (which ran on a
     Basis 108 Apple ][ clone).  He missed the neat histogram
     features he had hacked into his old BBS, and so wrote
     callstat.

     The title banner, "The Antithesystem Memorial Histogram", is
     meant to be a reminder of the heady days of early-80's
     BBSing in Edmonton, when the Round Table and the Antithesys-
     tem were the two best conversation boards in town.  Unfor-
     tunately, only RT has survived; may Anti rest in peace.