home *** CD-ROM | disk | FTP | other *** search
/ Jason Aller Floppy Collection / 176.img / SLBBS76M.ZIP / TOPTEN.ZIP / TOPTEN.DOC
Text File  |  1989-04-11  |  4KB  |  98 lines
  1.  
  2. TOPTEN                                                   Oct 1987
  3. Searchlight BBS Top Ten User Program                 by F. LaRosa
  4.  
  5.  -----------------------------------------------------------------
  6.             (c) Copyright 1987 Searchlight Software.
  7.       This program may be used free of charge by registered
  8.                   SEARCHLIGHT BBS owners only.
  9.  -----------------------------------------------------------------
  10.  
  11. Last Update: 6/17/1988
  12.  
  13. Description
  14.   TOPTEN is a program which will compute and print "Top-10" user 
  15. listings for bulletin boards using the Searchlight BBS software.  It 
  16. will produce listings by one of three criteria- number of calls, 
  17. amount of uploads, or amount of downloads- and you may specify the 
  18. number of users you want listed (ten is the default, but the entire 
  19. user list can be printed if desired).
  20.   TOPTEN writes the listing to standard output, and you may redirect 
  21. it to a text file if desired.  This program is suitable for use with 
  22. the SLBBS Doors system.
  23.  
  24.  
  25. Useage
  26.   The syntax for running TOPTEN is as follows:
  27.  
  28.   TOPTEN [CUD][n] [a] [/w] [/p<path>]
  29.  
  30.   where: [CUD] is one of
  31.     C: computes top caller listing
  32.     U: computes top uploaders
  33.     D: computes top downloaders
  34.   You can only specify one list at a time.
  35.   The default, if no option is specified, is C.
  36.  
  37.   [n] is the number of positions you desire in the list.
  38.       If missing, it defaults to 10.
  39.       A value of 0 indicates that ALL users are to be listed.
  40.  
  41.   [a] is the maximum access level to list.
  42.       If given, only those users with access levels less than or 
  43.       equal to this number are listed.
  44.       This parameter is useful for leaving the SYSOP out of a top
  45.       ten user listing.
  46.  
  47.  [/w] if specified, the "wait" parameter causes the program to wait
  48.       after displaying the Top-10 listing until a key is pressed.
  49.       This parameter may appear anywhere on the command line.
  50.  
  51.  [/p] allows you to specify the name of the directory containing the
  52.       CONFIG.BBS file, if other than the current directory. Do not
  53.       type a trailing backslash (ie. type 'C:\BBS' not 'C:\BBS\').
  54.  
  55.  
  56. Here are some examples:
  57.  
  58.   TOPTEN
  59.   prints a listing of the top ten callers;
  60.  
  61.   TOPTEN C20
  62.   gives a listing of the top 20 callers;
  63.  
  64.   TOPTEN U15 240
  65.   prints top 15 uploaders, excluding users with access level
  66.   greater than 240;
  67.  
  68.   TOPTEN D0 /W /PC:\BBS1
  69.   lists the entire user file sorted in order of most to least
  70.   amount of downloads. The program will wait until a key is
  71.   pressed before continuing. The CONFIG.BBS file is in directory
  72.   C:\BBS1.
  73.  
  74.  
  75. You can use the I/O redirection feature of DOS to have the listing 
  76. sent to a text file rather than to the screen.  Simply append the 
  77. right-bracket followed by a filename to the end of the command line.
  78. For example,
  79.  
  80.   TOPTEN U15 100 >TOPUL.TXT
  81.  
  82. will produce the indicated Top listing and write it to the file 
  83. TOPUL.TXT.  A filename of PRN will cause the listing to go to the 
  84. printer. Don't use the "/W" option when redirecting output.
  85.  
  86. You can run TOPTEN as a DOOR.  Place a command line such as:
  87.  
  88.   1;0;0;2;BBS Top Ten User Listing;.;TOPTEN.EXE C 254
  89.  
  90. into your DOORS.DEF file.  The specification of "." for the directory
  91. tells the BBS to remain in the current directory when executing 
  92. TOPTEN, so that it may have access to the USER.BBS file.
  93.  
  94.  
  95.                                                           12/03/87
  96.  -----------------------------------------------------------------
  97. 
  98.