home *** CD-ROM | disk | FTP | other *** search
/ Carsten's PPE Collection / Carstens_PPE_Collection_2007.zip / T / TOP5.ZIP / TOP5.DOC < prev    next >
Text File  |  1993-10-02  |  4KB  |  74 lines
  1. TOP5 Transfer Stats Utility by -=\The Liquidater/=-
  2.  
  3.      Again, Docs are not real important to me, since I run most my programs
  4.   without the benefit of doc <g> but here comes some quickys...
  5.  
  6.      Top5 is a small utility I wrote to give me a feature I had become used
  7.   to when I was running Celerity BBS Software, that feature was the simple
  8.   display of my top uploaders and downloaders for the current month and for
  9.   "alltime" when a user moves into the transfer area. I found that this
  10.   display actually caused some freindly competetion between my more active
  11.   users, and after all, on a elite board, file activity is what its all
  12.   about!
  13.  
  14.      Top5 works in two sections, first a PPE, defined in your CMD.LST
  15.   file from within PCBSETUP.EXE:
  16.  
  17.      Command     Security      Replacement/PPE
  18.        F           10          C:\PCB\PPL\TOP5.PPE
  19.  
  20.     This make TOP5.PPE run anytime a user uses the F (File Menu) command
  21.   from the main menu. As you can see from the source code I have included,
  22.   the PPE itself does very little. Simply saves the command line, incase
  23.   the user has 'stacked' commands ie: F 12, displays the TOP5. file and
  24.   then passes the command line back to PCBoard, to execute the commands.
  25.  
  26.      The second part of TOP5 is TOP5.EXE, written in Borland Pascal, this
  27.   program should be run in your $$LOGOFF.BAT file to keep the display file
  28.   current. TOP5.EXE reads in two files, first DOWNLOAD.TXT which is 
  29.   maintained by PCBoard as a record of all upload and downloads, TOP5.EXE
  30.   scans this file looking for the current month/year and then creates a
  31.   database on the fly (in Memory) of your most active users in both
  32.   uploads and downloads. Then TOP5 reads your USERS. file scaning for
  33.   the most active overall users. All files are opened, and read in full
  34.   share mode, so this utility can be run on a multinode system without
  35.   taking all nodes down! TOP5 then create the final output file which
  36.   it names TOP5. in the current subdirectory (C:\PCB\PPL\ on my system).
  37.  
  38.       Notes: 
  39.  
  40.         It is important that TOP5.EXE and TOP5.PPE be run from the 
  41.      same subdirectory and preferablly your \PCB\PPE subdirectory. 
  42.         
  43.         TOP5.EXE expects to find the two files it need, DOWNLOAD.TXT
  44.      and USERS. in the \PCB\MAIN\ subdirectory! If this is not correct
  45.      TOP5.EXE will accept a command line parameter of the your correct
  46.      path to these two files.
  47.                               ie: TOP5.EXE D:\PCB1\MAIN\
  48.  
  49.        If you currently don't have an $$LOGOFF.BAT just create one!
  50.      You can locate this file anywhere in your path, PCBoard will find
  51.      it, be sure you change subdirectorys in this bat file to where the
  52.      TOP5 files are located, as TOP5.EXE creates the bulletin file in the
  53.      current subdirectory where ever it is run.
  54.              ie:  Sample $$LOGOFF.BAT file
  55.              
  56.                       @ECHO OFF
  57.                       C:
  58.                       CD\PCB\PPL
  59.                       TOP5.EXE
  60.                       CD\PCB
  61.         
  62.  
  63.    SHAREWARE NOTICE:  Shareware sucks, have you noticed?
  64.  
  65.       This file is freeware and as such can be used by anyone, anytime.
  66.    I accept no responsibility if your processor blows up while running
  67.    this program. If you would like to see some improvements to this or
  68.    any of my utilities, feel free to call my board and leave me mail, if
  69.    you use this program and would like to express some thanks, how about
  70.    calling my system and uploading some 0 hour wares...<g> l8r
  71.                                                    -=\The Liquidater/=-
  72.  
  73.  
  74.