home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / MISC / GAPSTA41.ZIP / GAPSTAT.DOC < prev    next >
Text File  |  1993-08-22  |  5KB  |  159 lines
  1.  
  2.  
  3.                GAPStat -  Copyright 1992 No Anchovies - Frank Capo
  4.                   No Anchovies PC (216)466-1151/1153 HST Duals
  5.  
  6.         ******    VERSION 4.1 UPDATED DOCUMENTATION  ******
  7.  
  8.    Installation
  9.    ------------
  10.    1.
  11.  
  12.    Make a configuration file.
  13.    *** You MUST name it GAPSTAT.CFG - anything else will not work ***
  14.    Here's the format of GAPSTAT.CFG:
  15.  
  16.      line #1-> c:\gap             Path - this node's DEFAULT directory 
  17.      line #2-> No Anchovies PC    Your BBS Name
  18.      line #3-> 0000               Registration Number
  19.      line #4-> 55                 Minimum security level to add to stats screen
  20.      line #5-> 109                Maximum security level to add to stats screen
  21.      line #6-> c:\gap\gen\news1   drive\path\filename for output file/screen
  22.  
  23.    Place this configuration file in the DEFAULT directory of EACH NODE that
  24.    you have.  The default directory is where GAPBBS.EXE is.
  25.  
  26.    2.
  27.  
  28.    Place GAPSTAT.EXE in the DEFAULT directory of EACH NODE that you have.
  29.  
  30.    3.
  31.  
  32.    Modify your GAP.BAT file for each node.  Here's what I use:
  33.  
  34.          @echo off
  35.          c:\
  36.          cd \gap
  37.          gapstat
  38.          gapmenu
  39.          if errorlevel 99 gap
  40.  
  41.    4.
  42.  
  43.    Configure GAP (go into GAP configuration) and set GAP to write a DOOR.SYS
  44.    at logon or have a LOGON.BAT file in GAP's default directory.
  45.  
  46.    GAPStat is now installed.
  47.  
  48.    How GAPStat Works
  49.    -----------------
  50.    GAPStat reads your DOOR.SYS file for the path to your MAIN directory so you
  51.    MUST have a LOGON.BAT or tell GAP to make a DOOR.SYS in GAPSETUP.
  52.    It also reads GAPMENU.CNF, USERS.DAT, and CALLINFO.DAT for caller data.
  53.    GAPStat creates a GAPSTAT.DAT file in your MAIN directory and stores it's
  54.    data there.  Each time your BBS recycles, GAPStat compares data found in
  55.    the various files and decides whether or not to add the last caller to
  56.    the output files.  The last 10 callers, the current day's BBS stats,
  57.    yesterday's stats and the monthly stats are written to this output file.
  58.    The output file that the users see contains GAP's @X color codes.
  59.  
  60.    New In Version 3.9 And Later
  61.    ----------------------------
  62.    GAPStat will leave a message to SYSOP on your Main Board when a new user
  63.    logs on.  I, for one, got tired of looking through the REGIS file for new
  64.    users so I added this feature.  GAPStat's message to SYSOP contains info
  65.    on the new user.  After reading this message, you can hit "F" to edit
  66.    the user.  GAPStat uses GAP's UTI drivers (they should be in your path)
  67.    to accomplish this.
  68.  
  69.    How The Author Works
  70.    --------------------
  71.    GAPStat is shareware.  If you use GAPStat on your BBS, pay for it.
  72.    I will entertain all ideas for enhancing GAPStat from sysops who decide
  73.    to purchase it.  Also, you will have access to future updates.
  74.    Send a check or money order for $15(US funds) to:
  75.  
  76.                               No Anchovies PC
  77.                               1205 Lake Avenue
  78.                               Ashtabula, OH.  44004
  79.  
  80.                      *** READ ON - IMPORTANT CHANGES ***
  81.  
  82.    v1.3 Update
  83.    -----------
  84.    GAPStat v1.3 will work on single node systems.  If you're upgrading from a
  85.    previous version, simply copy GAPSTAT.EXE over the old version.
  86.  
  87.    v1.4 Update
  88.    -----------
  89.    Single and Multi-node versions are seperate.  GAPSTATS.EXE is the single
  90.    node version and GAPSTATM.EXE is the multi-node version.
  91.  
  92.    v1.5 Update
  93.    -----------
  94.    Cleaned up the code a bit (creeping elegance).  I FINALLY figured out how
  95.    to manipulate unsigned integers in QuickBASIC.
  96.  
  97.    v1.6 Update
  98.    -----------
  99.    More creeping elegance.  Rewrote the interrupt call routine that checks
  100.    for the existence of certain files.
  101.  
  102.    v1.7 Update
  103.    -----------
  104.    Trying to find a nasty bug.  GAPStat has been reported to just error out
  105.    with a "file not found error" even after running fine for a while.  I can't
  106.    seem to force this condition to happen, but have tried to eliminate any
  107.    chance of GAPStat looking in the wrong directory for certain files.
  108.  
  109.    v2.0 Update
  110.    -----------
  111.    GAPstat is one program for multi-node or single node systems.  Added
  112.    yesterday's and monthly stats with the release of GAP 5.1b.  IF YOU'RE
  113.    UPDATING FROM A PREVIOUS VERSION, YOU'LL NEED TO CHANGE YOUR GAP.BAT FILE.
  114.    
  115.    v2.1 Update
  116.    -----------
  117.    Fixed bug in file naming routines.
  118.  
  119.    v3.0 Update
  120.    -----------
  121.    GAPStat will now run with GAP v6.0.
  122.    Changed configuration file.
  123.    GAPStat's output screen now uses @X codes.
  124.  
  125.    v3.1 Update
  126.    -----------
  127.    Optimized the code and fixed a bug or two.
  128.  
  129.    v3.2-3.4
  130.    --------
  131.    Cosmetic changes.
  132.    Added Registration Number to GAPSTAT.CFG.
  133.    Fixed a file handle error that rarely occured on some systems.
  134.  
  135.    v3.5
  136.    ----
  137.    Fixed a bug that was introduced in v3.4 that read the wrong GAP data
  138.    file to obtain network stats.
  139.  
  140.    v3.6-3.8
  141.    --------
  142.    Stayed in-house.
  143.  
  144.    v3.9
  145.    ----
  146.    Added new user reminder message to sysop.
  147.    General code clean-up.
  148.  
  149.    v4.0
  150.    ----
  151.    Revamped the output screen to show 2 screens.  The last 10 callers on one
  152.    screen and the BBS stats on the other.
  153.  
  154.    v4.1
  155.    ----
  156.    Fixed a bug where GAPStat would error out if no DAT file existed.  This 
  157.    only happened on new installations.
  158.  
  159.