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