home *** CD-ROM | disk | FTP | other *** search
/ GEMini Atari / GEMini_Atari_CD-ROM_Walnut_Creek_December_1993.iso / files / bbs / fn132bin / man / callstat.man next >
Text File  |  1991-09-05  |  3KB  |  93 lines
  1.  
  2.  
  3. CALLSTAT(1)          FNORDADEL BBS SOFTWARE           CALLSTAT(1)
  4.  
  5. NAME
  6.      callstat.tos - digest calllog.sys and produce silly statis-
  7.      tics
  8.  
  9. SYNOPSIS
  10.      callstat [-cdhsu]
  11.  
  12. DESCRIPTION
  13.      Callstat expects to be run from the directory which contains
  14.      ctdltabl.sys.  It will munch your call log
  15.      (#audit\calllog.sys) and produce pretty graphs and tables,
  16.      showing how many people at what baud rates have called and
  17.      for how long they were connected.
  18.  
  19.      If callstat encounters weirdness in your call log, it will
  20.      complain about it and exit.  The usual problem is that the
  21.      system has crashed while someone was logged in, resulting in
  22.      an entry in the call log which has a login time but no
  23.      logout time.  Use an editor to fix this or any other weird-
  24.      ness, and run callstat again.
  25.  
  26.      Callstat keeps an ongoing statistics file for its own uses,
  27.      called calldata.sys, which lives in your #sysdir.  The main
  28.      output file is callstat.sys, which is written to the #audit-
  29.      dir.  In addition, a supplementary file may be written in
  30.      callbaud.sys, giving some extra information about calls at
  31.      each hour of the day, for all baud rates.  This is REALLY
  32.      esoteric stuff.
  33.  
  34. OPTIONS
  35.      -c   Write callbaud.sys.
  36.  
  37.      -d   Debug flag.
  38.  
  39.      -h   Display a brief help message.
  40.  
  41.      -s   Don't count sysConsole activity in the statistics.  If
  42.           the Sysop logs in a lot, the results will probably be
  43.           skewed towards shorter average connections and such-
  44.           like.
  45.  
  46.      -u   Delete your calllog.sys and update the running statis-
  47.           tics file calldata.sys.
  48.  
  49. NOTES
  50.      Callstat doesn't do anything with file logging yet.
  51.  
  52.      The program is a bit vague when giving warnings about bad
  53.      stuff in your call log; you have to go searching through it
  54.      to find the error.
  55.  
  56.      Callstat can be run from a shellscript as a nightly event;
  57.      you may wish to run it without the -u flag for this purpose.
  58.      It will still produce the same statistics, but will leave
  59.      your call log alone.  When you want to delete the call log,
  60.      just manually run 'callstat -u', to properly update the run-
  61.      ning totals file.
  62.  
  63. BUGS
  64.      None that we know of; just "misfeatures".
  65.  
  66. FILES
  67.      callstat.tos             The silly statistics generator.
  68.      ctdltabl.sys             The system tables file.
  69.      #auditdir\calllog.sys    The call log.
  70.      #auditdir\callstat.sys   The main silly statistics file.
  71.      #auditdir\callbaud.sys   The additional silly statistics
  72.                               file.
  73.      #sysdir\calldata.sys     Callstat's running totals.
  74.  
  75. SEE ALSO
  76.      The Fnordadel Reference Manual
  77.  
  78. AUTHOR
  79.      Royce Howland
  80.  
  81. HISTORY
  82.      Callstat was written by Royce Howland some time after he
  83.      switched to orc's STadel from his old BBS (which ran on a
  84.      Basis 108 Apple ][ clone).  He missed the neat histogram
  85.      features he had hacked into his old BBS, and so wrote
  86.      callstat.
  87.  
  88.      The title banner, "The Antithesystem Memorial Histogram", is
  89.      meant to be a reminder of the heady days of early-80's
  90.      BBSing in Edmonton, when the Round Table and the Antithesys-
  91.      tem were the two best conversation boards in town.  Unfor-
  92.      tunately, only RT has survived; may Anti rest in peace.
  93.