home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / RASTAT16.ZIP / RA_STATS.DOC < prev    next >
Encoding:
Text File  |  1995-07-18  |  10.3 KB  |  289 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.                     █▀█▄ █▀██     ▄█▀▀ ▀▀██▀▀ █▀██ ▀▀██▀▀ ▄█▀▀
  9.                     █▀█▄ █▀██      ▀█▄   ██   █▀██   ██    ▀█▄
  10.                     ▀ ▀▀ ▀ ▀▀ ▀▀▀ ▀▀▀    ▀▀   ▀ ▀▀   ▀▀   ▀▀▀
  11.  
  12.                                       v1.06
  13.  
  14.              Copyright (c) 1995; Steve Lanning.  All Rights Reserved.
  15.                For new version update information, see RA_STATS.HIS
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.                                 - 1 -
  24.  
  25. ─────────────────────────────────────────────────────────────────────────
  26. ▒▒▒▒ Table of Contents ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  27. ─────────────────────────────────────────────────────────────────────────
  28.  
  29. Table of Contents........... 1
  30. Archive Contents............ 2
  31. What is it?................. 3
  32. Installation................ 4
  33. Legal Notices............... 5
  34. Registration Info........... 6
  35. Special Thanks.............. 7
  36. Support Sites............... 8
  37.  
  38.  
  39.                                 - 2 -
  40.  
  41. ─────────────────────────────────────────────────────────────────────────
  42. ▒▒▒▒ Archive Contents ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  43. ─────────────────────────────────────────────────────────────────────────
  44.  
  45. RA_STATS.EXE      - Main EXE File for RA_STATS
  46. STATSCFG.EXE      - Main EXE File for Configuration Utility
  47. RA_STATS.CFG *    - Configuration File
  48. RA_STATS.DOC      - Documentation File <This File>
  49. REGISTER.FRM      - Registration Form
  50. FILE_ID.DIZ       - Description <ID> of this Program
  51.  
  52. STATS#.A??      ! - Outputted Files for a specific node.
  53. STATSTOT.A??    ! - Outputted Files for Total Nodes.
  54.  
  55. "*" - Means that this file will be created by STATSCFG.EXE
  56. "!" - Files created after execution of RA_STATS
  57.  
  58.  
  59.                                 - 3 -
  60.  
  61. ─────────────────────────────────────────────────────────────────────────
  62. ▒▒▒▒ What is it?   ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  63. ─────────────────────────────────────────────────────────────────────────
  64.  
  65. RA_STATS is a program which will analyze your RemoteAccess v2.xx Log File
  66. and generates a bulletin (ANSi/ASCii) to a specific path which you can
  67. specify in the configuration file.
  68.  
  69. RA_STATS is multinode aware, it can support up to 250 Nodes!
  70.  
  71. RA_STATS will report:
  72.  
  73.                    o How many calls received today
  74.                    o What speed the callers called up at
  75.                    o How many local logins occured
  76.                    o How many file areas were accessed
  77.                    o How many messages were posted.
  78.                    o And much more...!
  79.  
  80.  
  81.                                 - 4 -
  82.  
  83. ─────────────────────────────────────────────────────────────────────────
  84. ▒▒▒▒ Installation  ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  85. ─────────────────────────────────────────────────────────────────────────
  86. #1. If you are upgrading from a previous version of RA_STATS, it may be
  87.     necessary to delete your current RA_STATS.CFG file.
  88.  
  89. The two files (RA_STATS.EXE and RA_STATS.CFG) must be in the same directory.
  90. RA_STATS.EXE must be run after each call to the board has been terminated.
  91. This way, you can ensure you have an up to date report for every single
  92. caller.  Of course if you're registered, your key file must reside in the
  93. same directory as RA_STATS.EXE also. :)
  94.  
  95. If you don't begin each day with a new log file, yesterday's and every
  96. other day therein will be appended to the report. (NOT RECOMMENDED!)
  97.  
  98. We suggest beginning each day with a new log, but this is entirely up to
  99. the board's sysop.  You have been warned.. :)
  100. ---
  101.  
  102. Installing RA_STATS couldn't be any easier, follow these methods:
  103.  
  104. 1.) Place all of RA_STATS' files into their own directory.
  105. 2.) Run STATSCFG.EXE and answer a few questions.
  106.     Remember: First delete RA_STATS.CFG *IF* you're upgrading from a
  107.               previous version.
  108. 3.) Look below for Parameters and Where to run RA_STATS.
  109.  
  110. How to run:
  111.  RA_STATS [Node#] <to generate screens for an individual node>
  112.  or
  113.  RA_STATS -Total  <to generate a screen with totals of all nodes {+}>
  114.  
  115. About the Parameters:
  116.  
  117. {+} = Supported by Registered Version Only!
  118.  
  119. RA_STATS Will write .ANS/.ASC screens for up to 250 Nodes! {+}
  120. RA_STATS will append RemoteAccess Screen Attributes of your choice! {+}
  121.  
  122. [Node#] = This simply tells RA_STATS which LOG it should scan. If 2 was
  123.           entered, then RA_STATS would scan RA2.LOG and generate an output
  124.           file called STATS2.A??, if 3 was entered, then RA_STATS would
  125.           scan RA3.LOG and generate STATS3.A??
  126.  
  127.           Supports up to 250 Nodes! {+}
  128.  
  129. -Total  = Creates a TOTAL Node Statistics screen.  Meaning all of the info
  130.           from the STATSx screens will be generated together into one screen.
  131.           Perfect for a multinode BBS.  Generates the screen STATSTOT.A??
  132.           {+}
  133.  
  134. You can run RA_STATS one of two ways.
  135.  
  136. Method #1:  Run it after every logoff!
  137. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  138.  
  139. This method will always keep the Information Updated!
  140.  
  141. To do this is simple..  (here's a sample batch file)  -- SINGLE NODE
  142.  
  143. :START
  144.  
  145. if errorlevel 30 goto AFTER
  146.  
  147. C:\RA\RA.EXE -E30
  148.  
  149. :AFTER
  150. cd\ra\ra_stats
  151. ra_stats 1
  152. goto START
  153.  
  154. * Here's the way on how to do is MULTINODE -- (Granted that the %TASK%  *
  155. * Variable is defined in the node's batch file)  Thats the easiest way. *
  156.  
  157. :START
  158.  
  159. if errorlevel 30 goto AFTER
  160.  
  161. C:\RA\RA.EXE -N%TASK% -E30
  162.  
  163. :AFTER
  164. cd\ra\ra_stats
  165. ra_stats %TASK%               ; The [Node#] was specified, and it will scan
  166. ra_stats -total               ; that specific log & it will create STATSx.A??
  167. goto START
  168.        * You can only scan 2 or more .LOG files if you are registered *
  169.  
  170. NOTE: ALL *.LOG files must reside in the same directory.  Many Multi-Node
  171.       systems have their .LOG files in their own directories.  This release
  172.       doesn't support that.
  173.  
  174.       If you are registered, just run RA_STATS -Total for combined
  175.       statistics of all nodes.
  176.  
  177.  
  178. Method #2 - Run it once nightly, before the maintenance
  179. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  180. This would be ideal, so you could have the screen Yesterday's Activity
  181. off of your Bulletin's Menu.
  182.  
  183. After you run the program, somewhere on your TOP menu or whatever menu
  184. you want, use a (Type 5) to display the screens.
  185.  
  186. Example from RACONFIG/MANAGER/MENUS/TOP.MNU Below:
  187. 12345678901234567890123456789012345678901234567890123456789012345678
  188.  
  189.  
  190. STATS1
  191.  
  192. Action   Display .ANS/.ASC file (Type 5)
  193. Display
  194. OptData
  195. HotKey
  196. AutoExec Yes
  197. Colour   Colour example
  198.  
  199. MinSec   0                  TimeUsed 0                  FlatCost 0
  200. MaxSec   0                  TimeLeft 0                  TimeCost 0
  201. A flags  --------           Age      0                  Terminal Any
  202. B flags  --------           MinSpeed 0                  Nodes
  203. C flags  --------           MaxSpeed 0                  Groups
  204. D flags  --------           Credit   0                  DayTimes
  205.  
  206. ...now you're all setup and ready to go!
  207.  
  208.                                 - 5 -
  209.  
  210. ─────────────────────────────────────────────────────────────────────────
  211. ▒▒▒▒ Legal Notices  ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  212. ─────────────────────────────────────────────────────────────────────────
  213.  
  214.                 ** USE THIS PROGRAM AT YOUR OWN RISK! **
  215.  
  216.   I (Steve Lanning) make no warranty of any kind, expressed or implied,
  217.   including without limitation any warranties of merchantability
  218.   and/or fitness for a particular purpose.  I shall not be held liable
  219.   for any damages, whether direct, indirect, special or consequential
  220.   arising from the failure of this program to operate in the manner desired
  221.   by the user.  I shall not be held liable for any damage to data or
  222.   property which may be caused directly or indirectly by the use of this
  223.   program.
  224.  
  225.   In no event will I be held liable for any damages, including (but
  226.   not limited to) any lost profits, lost savings, or other incidental
  227.   or consequential damages arising out of the use -- or the inability
  228.   to use -- this program, or for any claim by any other party.  The only
  229.   thing that RA_STATS is guaranteed to do is to take up space on your
  230.   hard drive.
  231.  
  232.  
  233.                                 - 6 -
  234.  
  235. ─────────────────────────────────────────────────────────────────────────
  236. ▒▒▒▒ Registration Info  ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  237. ─────────────────────────────────────────────────────────────────────────
  238.  
  239. RA_STATS is SHAREWARE, which means you can evaluate this program for up to
  240. 30 days, after that time, you must register or discontinue use of RA_STATS.
  241.  
  242. We do encourage registering!
  243.  
  244. If Registered, the annoying beeps and [UNREGISTERED] warnings go away,
  245. you can create individual reports for up to 250 Nodes, and your name
  246. (as defined in STATSCFG) will be appended to the report's
  247. "System Operator(s)" field instead of [UNREGISTERED SYSOP!].
  248.  
  249. If registered, you can then toggle the usage of RemoteAccess screen
  250. attributes such as ClearScreen, No Break Codes and Beeps.
  251.  
  252. Also, if you're multinode you can use the very nice -TOTAL feature!
  253.  
  254. For registration info and/or cost, please read REGISTER.FRM!
  255.  
  256.  
  257.                                 - 7 -
  258.  
  259. ─────────────────────────────────────────────────────────────────────────
  260. ▒▒▒▒ Special Thanks ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  261. ─────────────────────────────────────────────────────────────────────────
  262.  
  263. I'd like to thank everyone who sent in their suggestions on how
  264. to make RA_STATS a better program!
  265.  
  266. Special thanks to Rand Nowell, Jeremy Landvoigt and everyone else for
  267. their outstanding time and patience with me in my feeble attempt to learn
  268. Turbo Pascal with my consistant questions and beggings for help at times.
  269.  
  270. Thanks!
  271.  
  272.                                 - 8 -
  273.  
  274. ─────────────────────────────────────────────────────────────────────────
  275. ▒▒▒▒ Support Sites ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  276. ─────────────────────────────────────────────────────────────────────────
  277.  
  278. If you have any questions or need to know anything about RA_STATS, feel
  279. free to contact me at the site below:
  280.  
  281.                        Steve Lanning
  282.                        The Adventurers' Inn
  283.                        (803) 766-0176
  284.                        Charleston, SC,  USA
  285.  
  286.                        Fido#: 1:372/6577
  287.                        Speed: 9600 - 14400bps <V.FC>
  288.  
  289.