home *** CD-ROM | disk | FTP | other *** search
/ Collection of Hack-Phreak Scene Programs / cleanhpvac.zip / cleanhpvac / USTAT3~3.ZIP / USTAT.DOC < prev    next >
Text File  |  1995-03-01  |  6KB  |  130 lines
  1.          
  2.                 USTAT - User Statistics Ver 3.00 for RemoteAccess
  3.                ===================================================
  4.  
  5.  
  6.          DISCLAIMER:
  7.  
  8.          While reasonable care has been taken in creating this program, 
  9.          no warranty is made that it will perform the way you would like. 
  10.          You (and not the author) are responsible for any problems 
  11.          occurring by the use of this program. If you cannot accept this 
  12.          responsibility, do not run this program. However, if you should 
  13.          run across a problem, please contact the author so that it may 
  14.          be possible to fix the problem (see note at end about info on 
  15.          contacting the author). As with any program, bugs are possible 
  16.          even though the product has been tested. To protect against 
  17.          this, you should be making regular backups. 
  18.  
  19.  
  20.          This package is supplied as shareware and no warranty is 
  21.          implied or expressed in any way. This program is used at your 
  22.          own risk although every effort has been made to ensure it will 
  23.          work on all systems. The only thing I do guarantee is that it 
  24.          will take up disk space. I cannot be held responsible if the 
  25.          program trashes your user file. 
  26.  
  27.  
  28.          You have a four week evaluation period to try out the package 
  29.          and if you like it and wish to continue using it please fill in 
  30.          the registration form and send it to the address thereon with 
  31.          the registration fee of R20.00. You will then be sent your 
  32.          registration key for the use of the program. This will remove 
  33.          the UNREGISTERED message from the display files. It will also 
  34.          enable the creation of AVATAR screens. The unregistered version 
  35.          will only create ANSI and ASCII screens.
  36.          
  37.  
  38.          The use of this program is very simple. Just insert the program 
  39.          name into your nightly maintenance routine batch file along 
  40.          with the command line parameters (the number of users you wish 
  41.          to display and your registration key - if you have a registered 
  42.          copy). The maximum number of users that can be processed is 
  43.          1200. The program is quite memory hungry. I accepted this as a 
  44.          spinoff for speed. 
  45.  
  46.                 
  47.          eg. :  USTAT 5             for  5 users to be listed
  48.                 USTAT 10            for 10 users to be listed
  49.  
  50.  
  51.          The files created are as follows:-
  52.  
  53.              BEST-UF.ANS/ASC/AVT      Best Uploader - Files 
  54.              BEST-UK.ANS/ASC/AVT      Best Uploader - Kb 
  55.              BEST-DF.ANS/ASC/AVT      Best Downloader - Files 
  56.              BEST-DK.ANS/ASC/AVT      Best Downloader - Kb 
  57.              BEST-CAL.ANS/ASC/AVT     Best Caller 
  58.              BEST-MES.ANS/ASC/AVT     Best Message writer 
  59.  
  60.  
  61.          All these files can be displayed as a menu option using Menu 
  62.          type 45. If you want to, you make use of the included menu 
  63.          (TOPUSERS.MNU) to display the files created. Just insert a line 
  64.          in one of your existing menu, that does a GOSUB TopUsers. The 6 
  65.          files will be displayed one after the other, and you will be 
  66.          returned to your calling menu. 
  67.  
  68.          
  69.          Ustat Requires the following Files to Operate.
  70.  
  71.          CONFIG.RA  UStat takes most of it's parameters from here.
  72.          USERS.BBS  This is where the info comes from.
  73.          
  74.          These files do not have to be in the current directory. UStat 
  75.          uses the environment Variable "RA" to find CONFIG.RA. From here 
  76.          it gets all other information needed to read USERS.BBS and 
  77.          write the text files.
  78.  
  79.  
  80.          If you have any Comments or Bug Reports please send me a 
  81.          message to the following address.
  82.  
  83.          Magnum BBS          Or: FidoNet:    5:7102/111
  84.          c/o: Joe Rinck          TechNet:    111:490/4706
  85.          P.O. Box 5493           Internet:   No Address Currently
  86.          Cape Town
  87.          8000
  88.  
  89.  
  90.          VERSION INFO
  91.  
  92.          1.00    First release - Write ANSI and ASCII screens
  93.  
  94.          1.01    Made some modifications as per user requests: Renaldo 
  95.                  Rheeder (PE Technikon BBS) suggested I change the 
  96.                  "WORST Downloader" to "HIGHEST Downloader", and 
  97.                  indicate that the program is registered. Previously 
  98.                  it would only put the BBS and Sysop name into the 
  99.                  display files when registered.
  100.                    
  101.          1.02    Fixed a bug that Oliver Steudler reported. When there 
  102.                  was no backslash (\) at the end of the pathnames to the 
  103.                  messagebase and textfiles directory the program would 
  104.                  complain "Could not open USERS.BBS" and abort. If there 
  105.                  was no backslash on the textfile directory, the program 
  106.                  would do nothing.
  107.          
  108.          2.00    Added creation of AVATAR screens in registered mode only.
  109.  
  110.          2.01    Fixed a small bug where ANSI codes would be written to the
  111.                  Avatar File.
  112.  
  113.          2.50ß   This is a beta Release for those Sysops that have already 
  114.                  changed over to RA 2.01. I could only test this version on 
  115.                  a converted version of 2.01, as I am still running 1.11. 
  116.                  Changes made are: 
  117.                  1) Added RA 2.00 support (I had to remove 1.11 support - a 
  118.                  later version may support 1.11 as well as 2.01.) 
  119.                  2) The files are opened Shareable/Read-Only, so Multiline 
  120.                  systems can run USTAT while other lines are up and 
  121.                  running. 
  122.                  3) Cleaned up some code to optimise it. 
  123.                  4) Show-SysOp and the Hidden Flags are checked, and the 
  124.                  users are only listed if these flags are off. 
  125.  
  126.          2.51ß   Fixed a small bug, where the Registration sequence number
  127.                  was not shown on the ASC and AVT screens.
  128.  
  129.          3.00    Public Release
  130.