home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / TUSERSP4.ZIP / TOPUSERS.DOC < prev    next >
Encoding:
Text File  |  1992-12-24  |  3.7 KB  |  91 lines
  1. Welcome to TOPUSERS version 4.0!
  2.  
  3. Created by Erik VanRiper 1:107/230
  4.  
  5. Usage:
  6.           TUSERSP [config_file]
  7.  
  8. Example: 
  9.           TUSERSP
  10.  
  11. Or:
  12.  
  13.           TUSERSP topusers.cfg
  14.  
  15. Run it whenever you wish, I run it during my midnight maintenence.  It is
  16. fast enough to run each time a user logs off if you really want to be up to
  17. date.
  18.  
  19. I use a:
  20.  
  21. [Display_File]Misc\Topusers
  22.  
  23. to show it off on my Bulletins menu.
  24.  
  25. This version will handle up to 4000 users!  (untested at that many users,
  26. but what the heck.  That is what support is for!)
  27.  
  28. The configuration file must be edited to suit your system and color
  29. preferences, as well as style of lines and number of "top" users.
  30. Everything in TOPUSERS.MEC is explained, with one outside reference: the
  31. ColorVacant command.  Vacant is the word I chose to use when there is no
  32. user that can fit in the list, such as a system with few files, there may
  33. not be 10 people (or 100) that have uploaded anything.  So, instead of
  34. placing someones name there, a "----- Vacant! -----" is placed there
  35. instead.
  36.  
  37. The SysOp keyword warrants a bit of explaination as well.  If you include
  38. this keyword, then the SysOp (user 0) will be included in the output
  39. listing. Including all of the SysOps calls/ups/downs in the total fields at
  40. the end of the listing.  If this keyword is commented out, then the SysOps
  41. totals are not included, giving a more realistic value to each column.
  42.  
  43. The totals at the end of the display are for ALL users in your user file,
  44. not just the top ten, and with the noted exception above.
  45.  
  46. THE IMPORTANT THING TO REMEMBER about the configuration file is that there
  47. is only one space between the key words adnd their arguments (if any).  The
  48. reason for this is because Mecca's RLE will make the spaces shrink, and add
  49. characters to the actual argument as it is compiled.
  50.  
  51. If you started your system as a single line, then put up more nodes, you
  52. will probably want to also include node number 0 as well.  I have found
  53. that when MAX goes multi-line, it will copy BBSTAT00.BBS to BBSTAT01.BBS,
  54. then create empty ones for each node after that.  HOWEVER, then only info
  55. that is properly transfered is the number of callers, NOT the DL's, UL's
  56. and messages posted. So, what I did was used the EDITCALL utility that came
  57. with Maximus, and edited to BBSTAT00.BBS file to a decent number of calls,
  58. and use 0, 1, 2, and 3 (3 is my local node, 1 and 2 are my public nodes,
  59. and 0 was the old public node before going multi line) in the TOPUSERS.CFG
  60. file.
  61.  
  62. You can have as many configuration files as you want, allowing you to
  63. create many different lists.  The default configuration file name is
  64. TOPUSERS.CFG, found in the same directory that TOPUSERS is run from.
  65.  
  66. Users with the "Do not list me in the userlist" flag will not be displayed
  67. in the output listing.
  68.  
  69. I think I have added everything that I can think of in terms of being able
  70. to have control over the output, if you can think of anything else please
  71. let me know.
  72.  
  73. Questions?  Comments?  Suggestions for Version 5.0?  Send 'em NetMail, or
  74. contact me through the Maximus support conference MUFFIN.
  75.  
  76. Source code available on request.  It was written in C, and I used
  77. Borland's TC++ 1.0 compiler in the normal C mode.
  78.  
  79. Special thanks to:
  80.  
  81.  Carl Slawinski of the Buccaneer's Harbor BBS (+1-901-873-2837)
  82.  Janis Kracht of the <<PRISM BBS (+1-914-344-0350)
  83.  Noel Smith of the Cave in the Woods BBS (+1-203-744-5494)
  84.  Don Dawson of the Treasure Island BBS (+1-203-791-8532)
  85.  Dave Morhun of the Peace of Mind BBS (+1-306-384-0861)
  86.  
  87. And Ray Gardner for his qsort routine "A version of qsort that uses Shell's
  88. sort algorithm." dated 11/91 and placed in the public domain.
  89.  
  90. /* Erik */
  91.