home *** CD-ROM | disk | FTP | other *** search
/ New Horizons Shareware Collection / HORIZONS1.BIN / BSTATS.DOC < prev    next >
Text File  |  1995-02-25  |  7KB  |  157 lines
  1. BBS Statistics Trakker v1.0  Dated: 02/025/95
  2. Freejack's Software By Gary Price
  3. Copyrighted (c) 1995 by Gary Price, all rights reserved.
  4.  
  5. TriBBS is a Registered Trademark by TriSoft!
  6.  
  7. This program is distrubuted without warranty. Freejack's Software will not
  8. be liable in any way for any damages cause from the use of this program. 
  9. This is a Shareware program and may be used for a period of 30 days. After
  10. the 30 day trail Registration is required. See Register.txt for further info.
  11. There is no guarantee this program will do anything execpt take up harddrive
  12. space.... (:>
  13.  
  14. Now that this is out of the way, lets get on to the good stuff.
  15.  
  16. About BBS Statistics Trakker:
  17.  
  18. BBS Statstistics Trakker will show all important information read in from 
  19. the callers log and create a database and index file to hold all info. 
  20. With Bstats using a database, it will allow a Sysop to Trim / Delete their
  21. callers.log at will instead of having to keep a callers.log for 1 month if
  22. they want to show there Stats for that month...This will keep all of your
  23. Between.bat file program running faster between calls.
  24. Some of the information that is collected is, Baud rates up to 115,200, 
  25. Modem calls, local logons, will automatically show information up to 6 nodes!
  26. Average calls for day, P.M. and A.M. calls...average per hour. Total calls,
  27. Bulletin read, messages entered, new users added, etc...to many items to 
  28. write down, you will just have to run it to see it... :)
  29. Also, Bstats will create a Multi Page Screen using sharp Graphics showing all 
  30. this info in a @-varible screen so only one screen is needed for both color
  31. and mono. Bstats creates two Bar Chart screens showing Calls by A.M and 
  32. P.M. It will adjust it's callers scale to handle the amount of calls as the 
  33. month progresses. The current Scales define, 60, 120, 180, 240, 300, 360, 420, 
  34. 480, and 540 calls per hour.
  35.  
  36. Files Created by BBS Statistic Trakker:
  37.  
  38. Bstats.exe will create three other files when it is 
  39. run for the first time they are as Follows:
  40.  
  41. Bstats.dat  <-- Database for on information read to date from callers.log
  42. Bstats2.dat <-- Database for Overall Callers Number
  43. Bstats.idx  <-- Index file for Bstats2.dat file..
  44.  
  45. Ok, since BBS Statistics will create data bases, once it reads your entire
  46. callers log for the first time, you may if you wish, delete or trim the
  47. callers.log file as it won't need it anymore to reread every time to create
  48. the screens. It only needs any new infomation that has been written to the
  49. callers.log after it first runs...I delete / trim my log file every 3 days
  50. to keep my between.bat running fast between callers.
  51.  
  52. Bstats Config File Setup:
  53.  
  54. Config file layout is as follows:
  55.  
  56. c:\tribbs\bstats
  57. c:\tribbs\mwork\callers.log
  58. c:\tribbs\display\bullet4.bbs
  59.  
  60. Line 1 <-- Full path to the directory for the files that Bstats.exe will 
  61.            create and need to read later (Bstats.dat, Bstats2.dat & 
  62.            Bstats.idx).
  63. Line 2 <-- Full path and name of callers.log
  64. Line 3 <-- Full path and name of bulletin or logon screen to create.
  65.  
  66.  
  67. MultiNodes BBS's:
  68.  
  69. Put a copy of the Bstats.exe & bstats.cfg in each nodes directory or any
  70. other directory on the same Hard Drive with the other nodes.
  71.  
  72. Make sure that what ever you put in Line one of the config file that all
  73. other node's config files are the same and point back to the directory that
  74. Bstats.exe will create and look for it's files later. 
  75.  
  76. Also, I might mention, that Bstats uses a Locked Read method for the getting
  77. information from the callers.log, so if a little red box pops up stating that
  78. "Bstats is waiting for Access to callers.log" don't be alarm, this is just
  79. to show you that it is waiting it's turn to read in the callers.log file.
  80.  
  81. Operation:
  82.  
  83. This program can run either in a Between or Event batch file. Simply
  84. add BSTATS to either batch file.
  85.  
  86. Example of a Between.bat file:
  87.  
  88. cd\tribbs\bstats
  89. Bstats.exe
  90. cd\tribbs
  91.            NOTE! Between.bat files does NOT need Board.bat at the end to call
  92.            TriBBS back up.
  93.  
  94. Example of a Events.bat file:
  95.  
  96. cd\tribbs\bstats
  97. Bstats.exe
  98. cd\tribbs
  99. board
  100.  
  101. BBS Statistics Trakker will keep adding information to it's data bases until
  102. you decide to delete the 3 files it creates. So if you want to start over
  103. at the first of the month, simply go to the directory you entered on Line 
  104. 1 of the config file, and delete the 3 files BSTATS.DAT, BSTATS2.DAT, & 
  105. BSTATS.IDX. The next time it reads the callers log, it will create all new
  106. files, and keep adding info from that point on..
  107.  
  108. Sysops can start this program at any time during the month and BSTATS will
  109. will create it's database and index files based on the beginning of the 
  110. callers.log wherever it may begin. 
  111.  
  112.  
  113. In closing, I have included sample files in this archive, Bstats.cfg and
  114. Bullet4.bbs to allow you to see how the config file is set up and to see
  115. what my Stats screen looks like...You will need a @-varible editor or viewer
  116. to see the Bullet4.bbs, or you can temporary place it as a bulletin and view
  117. it from inside TriBBS! 
  118.  
  119. That's it for.... Hottest Doors Trakker v1.0 !
  120.  
  121. If you would like to report a bug, make any suggestions, or simply need  
  122. support, I can be reached at:
  123.  
  124.             ┌─────────────────────────────────────────────────┐
  125.             │░░▒▒▓▓██ F R E E J A C K ' S   P L A C E ██▓▓▒▒░░│
  126.             │░░▒▒▓▓██      TriBBS Support Board       ██▓▓▒▒░░│
  127.             │      5+ GIGABYTES w/over 30,000 Files Online    │
  128.             │                 395 File Areas                  │
  129.             │             World Message Exchange              │
  130.             │              TriBBSNET & YankeeNet              │
  131.             │                    FIDONET                      │
  132.             │                190 Conferences                  │
  133.             │               30+ ONLINE GAMES!                 │
  134.             │             NODE 1 - (205) 739-7121             │
  135.             │             NODE 2 - (205) 737-5032             │
  136.             │                28.8 USR HST, V.32               │
  137.             │                V.FC, V.TERBO, V.34              │
  138.             │                FidoNet 1:3607/26                │
  139.             └─────────────────────────────────────────────────┘
  140.                       
  141.                       NO FEES!                       NO RATIOS!
  142.             FILES!                 ONLINE GAMES!
  143.  
  144.  
  145. Many hours of hard work has gone into this program to make life a little
  146. easier for the TriBBS sysop. All attemps have been made to catch any bugs, 
  147. but that does not mean someone out there cannnot create or find one, so with 
  148. this in mind, please take the time and drop me a note (via WME , TriBBSNet, 
  149. YankeeNet or FidoNet 1:3607/26) or call my BBS and let me know of any problems 
  150. that may arise, so I can swiftly correct the problem.
  151.  
  152.              Thanks for tring, 
  153.                     
  154.                             BBS Statistics Trakker v1.0 !!!
  155.  
  156.                                     Gary Price
  157.