home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / UTILITY / USTATV20.ARJ / USERSTAT.DOC < prev    next >
Text File  |  1989-02-15  |  4KB  |  100 lines
  1.              USERSTAT - The user statistics program
  2.                     
  3.                       ver 2.0 documentation
  4.                              
  5.                              
  6. Legal shit:  Please don't distribute changed versions.  I am not
  7. responsible if this software eats your hard drive.  I am not
  8. liable for any damages or loss of time if this software does not
  9. perform as expected. I make no guarantees as to the suitability
  10. of this software for any purpose, not even that for which it was
  11. designed.
  12.  
  13. The SOURCE CODE is NOT for distribution after you have modified
  14. it.  You may ONLY distribute the UNMODIFIED executables. (just
  15. like WWIV)..
  16.  
  17. Compatibilty:  This software has been run under MS-DOS 3.2 on an
  18. Compaq Deskpro and a Cheap Noname tawainese clone.  It has run
  19. on a IBM PS/2 both models 25 and 30 under PC-DOS 3.3 and Novell
  20. Netware.  It is designed to work with any version of WWIV v4.x
  21.  
  22. Ok. Enough of that.  Using USERSTAT on your WWIV system is
  23. pretty easy.  There are two methods of doing so.  The first is
  24. to make it the "Daily" external event.  This can be set in the
  25. INIT program.  If you don't know how, read your docs.
  26.  
  27. Secondly, it can be set up to run as an "online" program.
  28. It uses DOS interupts, and does not require ANSI.
  29.  
  30. The program itself.. This program will generate three text files
  31. of the 10 best and 10 worst users in three separate catagories.
  32. (One for each text file, clever huh?)  This text files will be
  33. placed in your GFILES directory in a sub directory called
  34. USERSTAT. <<YOU MUST CREATE THIS DIRECTORY>>  Simply type CD
  35. GFILES (or whatever your GFILES directory is called) and MD
  36. USERSTAT.  Now you will want to add a "GFILEEDIT" entry for
  37. these text files. but first, run the program once.  Drop to dos
  38. and type:
  39.  
  40. USERSTAT /F /U /P 
  41.  
  42. (repeat this with the /a option if you want
  43. the full color ANSI lists as well)
  44.  
  45. this will create the three text files. Now run WWIV, type G from
  46. the WFC.  Now add an entry for the USERSTAT directory. Log on,
  47. go to that entry.. Type A .. You can now enter whatever
  48. descriptive names you would like..
  49.  
  50. The file FMRATIO.MSG is the listing of the best and worst users
  51. using the formula of:
  52.  
  53. [Upload K + (Number of Posts * xK)] / Download K 
  54.  
  55.     where x is set by the sysop with the /K parameter.  Defaults
  56. to 3K per post.
  57.  
  58. The file UDRATIO.MSG is the listing of the best and worst users
  59. using the formula of:
  60.  
  61. Upload K / Download K
  62.  
  63.    Pretty simple huh..
  64.    
  65. The file PTRATIO.MSG is the listing of the best and worst users
  66. using the formula of:
  67.  
  68. Number of Posts / Number of Logons
  69.  
  70.    Also rather simple.
  71.    
  72.    
  73.    
  74. The command line options for USERSTAT are as follows:
  75.  
  76. /S      Don't count sysop in calculations
  77. /U      Generate Upload/Download List
  78. /P      Generate Post/Logon List
  79. /F      Generate Formula ratio list (my personal favorite)
  80. /Lxx    Don't count users with less than xx logons
  81. /Kxx    Count each post as xx K worth of uploads in the Formula List
  82. /D      Display Dedication line, and my BBS phone number.
  83. /?      Display a small help screen..
  84. /A      Generate ANSI messages... (end in .ANS instead of .TXT)
  85. /Nxx    Let's sysop specify number of users to print for each
  86.         category 1 < xx < 99...
  87. /T      Generate tables of ALL users instead.
  88.  
  89. JGG     1@16
  90.         502@1
  91.  
  92. You can contact me at my BBS:
  93.  
  94. Fred's Floating Bar and Grill WWIV node 16
  95. (213) 479-7043 300/1200/2400/19.2k Baud (Telebit)
  96. Mac Software, Mucho Messages
  97. Home of MacWWIV v4.0
  98.  
  99.  
  100. Good Luck.