home *** CD-ROM | disk | FTP | other *** search
/ Amiga Elysian Archive / AmigaElysianArchive.iso / comm / mstat13c.lha / M-Stat.doc < prev    next >
Text File  |  1993-07-28  |  7KB  |  183 lines
  1.                                  M - S t a t
  2.  
  3.                                     v1.3c
  4.  
  5.                     A statistics generator for DLG BB/OS
  6.  
  7.                         (c) Phillip Eastham July 1993
  8.  
  9. ------------------------------------------------------------------------------
  10.  
  11.  
  12. What is it?
  13. ~~~~~~~~~~~
  14.        M-Stat is a new statistics generating program.  M-Stat will generate
  15. several text files which show the users who is best at the different areas of
  16. the BBS.  Also listed is the percentage of the total each of the top users
  17. has attained.  The top 10/15 (see later) users values are totalled and both a
  18. number and a percentage of the total is included.
  19.  
  20.  
  21. Why?
  22. ~~~~
  23.        I had been using DLGTopX for 12 months or so when I logged onto a
  24. local BBS and had a look at the statistics program he was running. I thought
  25. it was quite nifty so I set about writing something similar. M-Stat is the
  26. result.
  27.  
  28.  
  29. How do I use it?
  30. ~~~~~~~~~~~~~~~~
  31.        M-Stat requires a configuration file.  It also has a few command line
  32. switches available.
  33.  
  34.    Config file: The config file is a standard ASCII text file which contains
  35.                 the path and name of each of the statistic panels produced.
  36.                 No comments or blank lines are allowed. Only the path/name on
  37.                 each line is allowed! An example config is included. The
  38.                 config file should be placed in 'DLGConfig:Misc/M-Stat.cfg'.
  39.                 The order is:-
  40.  
  41.           Line 1:  Sysop name
  42.           Line 2:  Downloaded KBytes
  43.           Line 3:  Uploaded KBytes
  44.           Line 4:  Uploaded Files
  45.           Line 5:  Downloaded Files
  46.           Line 6:  Messages written
  47.           Line 7:  Messages read
  48.           Line 8:  Calls
  49.           Line 9:  On-line time
  50.           Line 10: User averages
  51.           Line 11: Usage graph
  52.           Line 12: Characters to use in the usage graph. (See below)
  53.  
  54.        NOTE: The config MUST have 12 lines. If the program returns an 'end of
  55. file' error, edit the file and make sure that each line is terminated with a
  56. LF.
  57.  
  58.    Switches: These are the switches available:-
  59.  
  60.        -B     Turn on the horizontal bar's for the usage graph.
  61.        -E     Inform user they are on top via 'Event.log'
  62.        -Lxx   Use xx records instead of 10.
  63.        -P     Do NOT produce stats panels. Use to just produce usage graph.
  64.        -V     Be verbose. Completely silent otherwise unless a program error
  65.               occurs.
  66.        -S     Include sysop in statistics. Name taken from config.
  67.        -Txx   Set number of lines to use for usage display.
  68.        -U     Generate Usage graph
  69.        -?     A short help screen.
  70.  
  71.  
  72.        Place the command in your midnight event script, or run it several
  73. times a day via TpTCron.
  74.  
  75.        You will then need to set up a menu item for each stats panel.  Use
  76. the DLG supplied 'DF' command to display the text file.  A menu entry would
  77. look like this:
  78.  
  79.    [ 1] Letter:                   D
  80.    [ 2] Executable: (path/name)   DLG:DF DLGConfig:Text/TopFDn.TXT
  81.    [ 4] Description:              Worst file downloaders
  82.    [ 5] Type:                     Executable
  83.    [ 6] Help File:                STATS/D
  84.    [ 7] Lower level:              1
  85.    [ 8] Upper level:              255
  86.    [ 9] Hidden:                   NO
  87.    [10] Load type:                OVERLAY
  88.    [11] Ask user if sure:         NO
  89.    [12] Pend messages:            YES
  90.    [13] Cli mode:                 NO
  91.    [14] Pause on completion       YES
  92.  
  93.        Or you can use the inclosed prepaired M-Stat.menun file. It will
  94. display all the panels and the usage graph generated by M-Stat's default
  95. config file. All you need to do is change the sysop name in the config.
  96.  
  97.  
  98. A note about the usage graph:
  99. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  100.        It is best to run the usage graph section of M-Stat just before
  101. midnight.  If you run it just after midnight, chances are the current day will
  102. be empty.
  103.  
  104.        The usage graph allows the sysop to select a 2 character wide
  105. representation for each of the 4 catagories. Either leave this blank or
  106. include 8 characters. If its left blank, a double ANSI solid block will be
  107. used. See the config for an example.
  108.  
  109.        When a value close to the minimum value is found, a half height ANSI
  110. block will be used instead of the defined sysop character.
  111.  
  112.  
  113. Other files accessed:
  114. ~~~~~~~~~~~~~~~~~~~~~
  115.        M-Stat requires several files in order to run. First is the file
  116. DLGConfig:Misc/Users.BBS. The program will exit if this file doesn't exist.
  117. M-Stat then reads in each users data file.
  118.  
  119.        Should an error occur, an error message will be sent the Sysop's
  120. 'Event.log' file informing of the error.
  121.  
  122.        The filenames stored in the config file are not checked for existance.
  123. Make sure the path you give exists!
  124.  
  125.        The 7 log files contained in DLGConfig:Text/ are also needed for usage
  126. graph production. If a file is not present, it will be skipped.
  127.  
  128.        DLG.Library V2.0 is now required for M-Stat to run.
  129.  
  130.  
  131. Program status:
  132. ~~~~~~~~~~~~~~~
  133.        M-Stat is freeware.  Use it as you please.  Any bug reports or
  134. suggestions for improvements can be sent to me via Fido or UUCP:
  135.  
  136.      FidoNET:  Phillip Eastham@3:622/406
  137.      InterNET: phillip_eastham@kumear.apana.org.au
  138.  
  139.  
  140. History:
  141. ~~~~~~~~
  142.       Version 1.0  - Initial release.
  143.  
  144.       Version 1.1  - Made byte values dynamic to each system. Will switch
  145.                      between Bytes, KBytes, and MBytes depending on how many
  146.                      bytes the top user has accumulated.
  147.                    - Adjusted output so the graph was a little wider.
  148.                    - Streamlined operations a little.
  149.  
  150.       Version 1.2  - Fixed a problem when there are no more users with
  151.                      non-zero values. Now the entire line is just left blank.
  152.                    - Streamlined operations a little more!
  153.                    - Changed several error-trapping routines.
  154.                    - Added error output to sysop's 'Event.log' file.
  155.  
  156.       Version 1.3  - Added usage graph generation.
  157.                    - Made number of records totally sysop settable.
  158.                    - Changed formatting a little.
  159.  
  160.       Version 1.3a - Fixed a problem with incorrect ANSI on usage graph when
  161.                      stats panels not generated.
  162.                    - Fixed a bug in detection of Sysop in stats generation.
  163.                    - Made total for top users in byte down/uploads conform to
  164.                      2 decimal places if there is room.
  165.                    - Added a bit more verbosity when turned on.
  166.  
  167.       Version 1.3b - Fixed a problem with the message bar of usage graph
  168.                      using the upload bar's characters for custom bar's.
  169.                    - Added the -B option to make the usage graph more
  170.                      customisable.
  171.  
  172.       Version 1.3c - Implemented some library calls.
  173.  
  174.  
  175. Thanks to:
  176. ~~~~~~~~~~
  177.        Thanks go to Mike West for testing the program on a sparsely populated
  178. BBS.
  179.  
  180.        Thanks to the person who wrote the ARexx script from which the usage
  181. graph is taken. Sorry I can't remember your name!
  182.  
  183.