home *** CD-ROM | disk | FTP | other *** search
/ Hall of Fame / HallofFameCDROM.cdr / rbbs / topupv31.lzh / TOPUP.DOC < prev    next >
Text File  |  1989-07-29  |  4KB  |  104 lines
  1.    Top Uploader/Downloader Version 3.1         28 July 1989
  2.  
  3.    By: Mike Clark - Sysop of  'The Alabama Connection RBBS'
  4.  
  5.   WHO UPLOADED and DOWNLOADED what?
  6.  
  7.   I got tired of working with the CALLERS file extracting different
  8.   data from it to generate reports and bulletins.  There is a lot
  9.   of information in it, and that made it bulky to work with.
  10.   
  11.   So I decided to modify RBBS to give me a few output files,
  12.   dedicated to a specific subject.  The two mods in this package
  13.   track who uploaded and downloaded what, and when. 
  14.  
  15.   Ever get a trashed or commercial upload and wanted to find out
  16.   who uploaded it?  It usually takes a while searching through the
  17.   Callers file. 
  18.  
  19.   The 2 short mods in WHO17_1X.BAS create files called 'UPLOAD.WHO'
  20.   and 'DOWNLOAD.WHO'. 
  21.  
  22.   The source mods required for the newest release of RBBS (RBBS 17.2A)
  23.   are also included as WHO17_2X.BAS. Use only those patches for 17.2x.
  24.  
  25.     UPLOAD.WHO is appended after every upload with the FILE NAME,
  26.                SIZE IN BYTES, USERS NAME, DATE, and TIME.
  27.  
  28.   DOWNLOAD.WHO is appended after every download with the same    
  29.                information as in UPLOAD.WHO.
  30.  
  31.   TOPUP.EXE is a program I wrote to generate a Top Uploader, Top
  32.   Downloader bulletin from those two files. 
  33.   
  34.   TOPUP is easily configured and will work out of any directory.
  35.   
  36.   To configure TOPUP:
  37.  
  38.   CREATE a config file called 'TOPUP.DEF'.
  39.  
  40.  
  41. * Format *
  42.  
  43.   The format for TOPUP.DEF IS:
  44.  
  45. LINE 1 - BBS NAME
  46. LINE 2 - Path and file name of BULLETIN to create
  47. LINE 3 - Path and file name of UPLOAD.WHO 
  48. LINE 4 - Path and file name of DOWNLOAD.WHO
  49. LINE 5 - TOP WHAT? (example: 10,20,25,etc..)
  50. LINE 6 - Sort by B)ytes or F)iles 
  51. LINE 7 - Include Sysop downloads/uploads  N)o or Y)es
  52. LINE 8 - Start date 
  53. LINE 9 - End Date
  54.  
  55.    Example from my BBS:
  56.  
  57.    THE ALABAMA CONNECTION RBBS        ' BBS name
  58.    C:\BULLET\BULLET4                  ' Output file
  59.    C:\RBBS\UPLOAD.WHO                 ' UPLOAD.WHO LOCATION
  60.    C:\RBBS\DOWNLOAD.WHO               ' DOWNLOAD.WHO LOCATION
  61.    20                                 ' TOP 'WHAT' as in 'Top 20'
  62.    B                                  ' Sort by 'Bytes'
  63.    N                                  ' Sysop xfers (Y)es-include (N)o-dont
  64.    06-01-1989                         ' Start date'
  65.    07-30-1989                         ' End Date'
  66.  
  67.   TOPUP.DEF and TOPUP.EXE can be in any directory, but both must
  68.   be in the SAME directory. I put them both in my BULLETIN directory.
  69.  
  70.   When you first start you won't have many different uploaders or downloaders.
  71.   If TOPUP.DEF is set higher then what is actually in your file, the program
  72.   will check that and just display what you do have. So if you have TOPUP.DEF
  73.   set to 20 (for the TOP 20), and there have only been 5 different uploaders, 
  74.   then the bulletin created will default to the 'TOP 5'.
  75.  
  76.   Color is also supported. 2 Output files are created, BULLETx and BULLETxC.
  77.  
  78.   It's important to note that the output file name can only be 7 characters, 
  79.   as 'BulletxxC' won't be generated.  So if you use the Standard RBBS name of
  80.   Bulletins: 'BULLET', make sure your TOP UPLOADER/DOWNLOADER bullet number
  81.   is between 1 and 9 (BULLET1 ... BULLET9). 
  82.  
  83.   Topup now supports unattended Batch file use for Automatically generation
  84.   during an event. It will not pause for any key presses and now does NOT
  85.   display the bulletin after generation (removed to save run-time).
  86.  
  87.   Hope you enjoy the mod. I am continuing to work on TOPUP.EXE and some
  88.   future features are:
  89.   
  90.   1) List most popular downloads.
  91.   2) Selectable dates for the report.  (VER. 3.0)
  92.   3) List Users Ratio (file or byte selectable) by files or bytes. (VER. 2.0)
  93.   4) Top RATIO holders. 
  94.   
  95.  
  96.  
  97.                         Mike Clark
  98.                         The Alabama Connection RBBS
  99.                         Dothan, Alabama 36301
  100.                         
  101.                         Data: (205) 794-6045
  102.  
  103.  
  104.