home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1994 #1 / monster.zip / monster / BBS_UTIL / TRAC205B.ZIP / TRACKER.DOC < prev    next >
Text File  |  1994-02-11  |  12KB  |  275 lines
  1. ───────────────────────────────────────────────────────────────────────────────
  2.        ▄██████████▄               Copyright 1989-1994 Cory Wright
  3.        ▀▀▀▀████▀▀▀▀
  4.            ████  ██████▄ ▄█████▄ ▄█████▄ ██  ▄██ ▄██████ ██████▄
  5.            ████  ██   ██ ██▄▄▄██ ██      ██▄██▀  ██▄▄▄▄  ██   ██
  6.            ████  ██████  ██▀▀▀██ ██      ██▀██▄  ██▀▀▀▀  ██████
  7.            ▀██▀  ██  ▀██ ██   ██ ▀█████▀ ██  ▀██ ▀██████ ██  ▀██
  8. ───────────────────────────────────────────────────────────────────────────────
  9.      Copyright 1989-1994 Cory Wright  (Documentation and Program)
  10.  
  11.                                 Tracker
  12.            Statistical BBS User and Sysop Information Utility
  13.  
  14.              For use with GT Power v15.00-v18.00, inclusive
  15.                  Supports single and multi-node systems
  16.  
  17.            From TRC Development and The Rising Connection BBS
  18.  
  19.                            February 11, 1994
  20.  
  21. Purpose and Objective
  22. ---------------------
  23. Almost every program is designed with a purpose in mind and has a goal to
  24. acheive.  Tracker is multi-faceted and has more to offer than meets the
  25. eye.  It keeps up with user information, board activity, callers today
  26. and yesterday, and mail waiting for users.  Once the batch files are set
  27. up, Tracker is self-maintaining and will carry out its daily and weekly
  28. duties on its own.  Once a week, you will get a board activity summary
  29. in your sysop message base, so you'll always be in touch with Tracker!
  30.  
  31.  
  32. Tracker Warnings
  33. ----------------
  34. Do not redirect Tracker.  It has built-in communications routines and
  35. monitors carrier.  If carrier is lost, Tracker exits gracefully.  DO NOT
  36. use GATEWAY, DOORWAY, or any other program to redirect the output of
  37. Tracker or monitor the carrier!!
  38.  
  39.  
  40. Operation
  41. ---------
  42. Your GTPATH should be set like this:  SET GTPATH=<gt dir>
  43.  
  44. Tracker is flexible and can be either easy or  a bit complicated to set up,
  45. but we can do it with about 10 minutes of your decidated time in front of
  46. these instructions.
  47.  
  48. Please place the following lines in the designated batch files:
  49.  
  50.   GTLOGON.BAT <and/or GTNLOGON.BAT>
  51.   -----------
  52.    TRACKER <command line options>
  53.  
  54.   GTLOGOFF.BAT <and/or GTNLOGOF.BAT>
  55.   ------------
  56.    TRACKER END
  57.  
  58.   <In nightly maintainence>
  59.   -------------------------
  60.    TRACKER NULL
  61.    TRACKER INIT
  62.    TSCAN
  63.  
  64. Now, you'll need to run TCONFIG.EXE to set up the appropriate data
  65. files.  Browse through the menus and set things up like you want them.
  66. Only 2 things should need much explaining:
  67.  
  68.   (L)evels for ratio exemption -
  69.       Use to prevent the ratio warning appearing to access
  70.       levels after the colon.  Access levels are, of
  71.       course, case sensitive.  If the current caller's level
  72.       matches one of the ones in this string of characters & are
  73.       below the ratio you've defined, the ratio line will not
  74.       appear.  Example: ABdEf93 will exempt levels 'A',
  75.       'B', 'd', 'E', 'f', '9', and '3'.  This is good if you have a
  76.       class of user that you would never want to inform of how "bad" his
  77.       or her download/upload ration is.
  78.  
  79.   Baud Rate Options:  This allows you to deny callers based on their
  80.       baud rate.  All options should be set to (Yes) if you want to allow
  81.       everyone to log on.  Also, the DTRDROP.EXE program that
  82.       accompany this package should be in your GT directory along with
  83.       TRACKER.EXE.
  84.  
  85.     ** Exceptions to the rule can be made!  For instance, if you have a
  86.     friend, John Dolittle, who only has a 300 baud modem, but you still
  87.     wish to deny access to 300 baud callers, you may create a file
  88.     called ACCEPT.TRC in your GT directory that has this format:
  89.  
  90.     ACCEPT <baudrate>        Example:  ACCEPT 300
  91.       caller 1                           John Dolittle
  92.       caller 2                         END
  93.       caller 3
  94.       etc...
  95.     END
  96.  
  97.     There can be up to 4 sections.  ACCEPT 300, ACCEPT 1200, ACCEPT
  98.     2400, ACCEPT 4800.  The list of names are for people who you want to
  99.     accept a call from that would otherwise be disconnected due to their
  100.     baud rate.  If you are accepting calls from all baud rates, you do
  101.     not need this file at all.
  102.  
  103. I believe everything else in the configuration is self explanatory.  If
  104. you are having major problems, feel free to netmail me at GTPN 070/002,
  105. or write me at my address at the end of this document.  Information on
  106.  
  107. <other command line options> - each must be separated by a space on the
  108.                                command line.
  109.  
  110. For your general information, Tracker knows when the sysop logs on and
  111. will be transparent to the other users.  Unless the OVERRIDE switch is
  112. included on the command line, the sysop's name will not be stored as the
  113. 'last user' for the next caller, nor will the call be added to the total
  114. calls or the calls for the day.  It is very important for TRACKER to be
  115. run EVERY TIME A CALLER LOGS ON.  To skip running Tracker will be
  116. counterproductive and is highly, highly discouraged.
  117.  
  118.    NULL   - Always run NULL before INIT in your maintanence so that the
  119.             dates won't get mixed up and you won't miss having your
  120.             caller file bulletins updated.
  121.  
  122.    OVERRIDE
  123.       1.  When coupled with INIT, Tracker counts all users' calls
  124.            that are level 0 (SYSOP level).
  125.       2.  When running in the logon batch file, it adds the sysop to
  126.            the call count and 'last user on' fields
  127.  
  128.  
  129. Text Configuration
  130. ------------------
  131. Tracker allows you to define every line of its output via the TRAKSCRN
  132. files.
  133.  
  134.   Power variables
  135.   ---------------
  136.   The following variables can be substituted in the TRAKSCRN.BBS and
  137.   TRAKSCRN.CBS files in the TRC directory created off of your GT
  138.   directory.
  139.  
  140.         Informational Variables
  141.         -----------------------
  142.          @F@   - first name of user
  143.          @L@   - last name of user
  144.          @W@   - whole name of user
  145.          @DK@  - number of kilobytes downloaded
  146.          @DF@  - number of files downloaded
  147.          @UK@  - number of kilobytes uploaded
  148.          @UF@  - number of files uploaded
  149.          @LVL@ - access level of user
  150.          @D@   - current date (always in the form, XX-XX-XX)
  151.          @T@   - current time (always in the form, XX:XX ?m)
  152.                               (ex: 1:43 pm, 12:12 am, 8:30 pm)
  153.          @B@   - current baud rate (DCE rate if using /OZ and WhoDis)
  154.          @C@   - city of current user
  155.          @P@   - unformatted phone number of current user
  156.          @M@   - time left in minutes
  157.          @LD@  - long date (ex: Saturday, December 23, 1989)
  158.          @LO@  - full name of last user on
  159.          @LC@  - city of last user on
  160.          @CN@  - caller number of current caller
  161.          @TC@  - total calls 'to date' to the BBS
  162.          @N@   - code for "calls today" by user.  For example: "John,
  163.                  you've called @N@ times today" or "John, this is call #@N@".
  164.  
  165.  @CHECKFORMAIL - This will run a check for the current user's mail
  166.                  waiting and inform which message bases he has mail waiting
  167.                  to be read.
  168.  
  169. @CHECKFORRATIO - This will check the user's download ratio.  If it
  170.                  exceeds the parameters you specified in TCONFIG, it
  171.                  will alert the user.  It will skip any user with a
  172.                  level you have specified in TCONFIG that is eligible
  173.                  to skip the check.
  174.  
  175.  
  176.  
  177. TRAKSCRN.BBS and TRAKSCRN.CBS
  178. -----------------------------
  179. These 2 files are the complete output files of Tracker.  You can
  180. completely design and customize these screens.  The .BBS screen will be
  181. shown to callers without ANSI capabilities and the .CBS screen will be
  182. given to the users using ANSI.
  183.  
  184. There are 2 example screens included.  They should be moved to the TRC
  185. directory, and should be customized.  TheDraw is a good program to use
  186. for this, and you can use the examples as a guide to making really good
  187. looking screens for use on your BBS.  Any of the substitutions above can
  188. be used.
  189.  
  190.  
  191. DISCLAIMER
  192. ----------
  193.  
  194.           The author of this software,  Cory Wright,  is not liable
  195.       for  any lost funds,  equipment,  or data due to the use of  this 
  196.       program  under any circumstances.
  197.  
  198.  
  199. BETA TESTING
  200. ------------
  201.  
  202.           Each  version  of Tracker is extensively beta tested on  my
  203.       system and others, not to mention other bulletin board systems
  204.       choosing   to  beta  test  my  software  throughout  the   world.  
  205.       Basically,   I  try to make sure that when you get a copy of  the 
  206.       'released'   version  that there is nothing in there  that  could 
  207.       possibly go wrong.   Please realize that,  though every effort is 
  208.       made,  some things may slip through.   If this is the case please 
  209.       notify  me  immediately
  210.           If you are  interested  in becoming a beta  tester for future 
  211.       releases of Tracker,  please let me know via our BBS.  All
  212.       that  is  required is that you run the latest  Tracker  version
  213.       available to you and that you check in with The Rising Connection
  214.       regularly to obtain upgrades and report on how well things are
  215.       running.
  216.  
  217.  
  218.  
  219. A WORD ON USER SUPPORTED SOFTWARE
  220. ---------------------------------
  221. User supported software is an attempt to provide quality software
  222. at low cost to both the provider and the user.  The cost of a software
  223. offering through conventional channels is very large, resulting in high
  224. prices and the inability of independent authors and small companies
  225. to develop and promote new products.  User supported software is an
  226. attempt to develop a new, low cost, marketing channel for software
  227. distribution.
  228.  
  229. If the user supported software concept works, then everyone will
  230. benefit.  The user will benefit by receiving quality products at a
  231. low cost and by being able to throughly evaluate the product before
  232. buying it.  The author benefits by being able to enter the software
  233. market without the high front end costs and risks.  Unfortunately,
  234. this concept can only work if all software users honor the author's
  235. request for support.  If you, as a software user, benefit from a
  236. "shareware" program then it must be worth something to you.  If so,
  237. you should send a contribution to the author.  Without contributions,
  238. good software authors will not be able to supply and support the high
  239. quality software that you demand.
  240.  
  241. The author provides this software, as is, with no warranties
  242. express or implied including the warranties of MERCHANTABILITY and
  243. fitness for the specific purpose intended by the user.  It is expected
  244. that most users will inspect and use the software prior to making any
  245. payment to the author.
  246.  
  247. The medium that the software is supplied on is not warranted by the
  248. author.  If the medium was received directly from the author and is
  249. not readable, please return it and a replacement will be supplied.
  250. You may freely copy  and distribute this software, as well as make a
  251. sufficient number of backups for yourself.  Please be sure that all
  252. copies that you distribute are complete and unmodified.
  253.  
  254. If you are having any difficulty with the software, please write to
  255. me, and I will make every attempt to clarify and correct the problem.
  256. Priority will be given to the correction of errors reported by registered
  257. users.
  258.  
  259.  
  260. REGISTRATION
  261. ------------
  262. Please use the enclosed registration form or call The Rising Connection
  263. BBS and order online with your VISA or MasterCard.
  264.  
  265. Mail all registration, comments, and suggestions to:
  266.  
  267. Cory Wright
  268. P. O. Box 53041
  269. Knoxville, TN  37950-3041
  270.  
  271. The Rising Connection BBS
  272. 919/783-8946
  273.  
  274. ** END **
  275.