home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / BBS / GTLOG411.ZIP / GTLOGANS.DOC next >
Text File  |  1992-12-28  |  13KB  |  367 lines
  1. GTLOGANS v4.11
  2. ==============
  3.  
  4. Usage:
  5. =======
  6.  
  7. GTLOGANS /u:n | /p:n | /d:n | /s:n [/l:<file_spec>] [/c[b]] [/sd:<date>]
  8.  
  9. /u:n           = Calls/Hour Bulletin number.
  10. /p:n           = Protocol Usage Bulletin number.
  11. /d:n           = Calls/Day Bulletin number.
  12. /s:n           = Calls/Speed Bulletin number.
  13. /l:<file_spec> = Complete path and filename for alternate log file.
  14. /c             = Clear screen (ANSI only).
  15. /cb            = Clear screen (ANSI and ASCII).
  16. /sd:<date>     = Date from which to read the logfile.
  17.  
  18. Either /u: or /p: or /d: or /s: can be set but at least one of them must be. 
  19.  
  20. The defaults:
  21.  
  22. Logfile is GT.LOG in the LOG directory.
  23. Not to clear any screens.
  24.  
  25. Description:
  26. ============
  27.  
  28. GTLOGANS (GTLOG ANalySer) produces four files suitable for use as 
  29. bulletins, showing graphical representations of BBS and protocol usage. 
  30. The calls/hour shows the number of connects versus hour of day. The 
  31. Protocol bulletin shows the number of files transferred by a particular 
  32. protocol. The calls/day bulletin shows the number of calls per day. The 
  33. calls/speed shows connect speed versus number of connects. All these 
  34. graphs are based on the last 24 days of activity or the 24 days from the 
  35. start date. Assuming of course that the log file contains that much 
  36. data. GTLOGANS does keep a data file of the last 24 days information so 
  37. if you delete your log file you don't get empty graphs.
  38.  
  39. The Boring Bit:
  40. ===============
  41.  
  42. I retain the copyright to GTLOGANS. 
  43.  
  44. Version 4.11 can be freely distributed, provided no fee is levied, 
  45. specifically, to obtain GTLOGANS. I admit no liability for the use of 
  46. GTLOGANS or for it's ability, or otherwise, to preform a specific task.
  47.  
  48. If you like GTLOGANS please let me know and buy me a pint or two when we 
  49. next meet. I'm planning a little world trip for sometime early 1993 as I 
  50. will have been made redundant at the end of Nov '92. A bit of floor 
  51. space will be just as acceptable as a pint.  <grin>
  52.  
  53. Any feedback or comments would be appreciated. You can mail them to me, 
  54. wrapped in five pound notes... at:
  55.  
  56. GT.......: 050/039, Dave Liquorice, The Broken Biscuit, +44 (0)272 744579
  57.  
  58. E-Mail...: allsorts@cix.compulink.co.uk (Best)
  59. Internet.: allsorts@nexus.demon.co.uk   (Not regularly checked)
  60.  
  61. History
  62. =======
  63.  
  64. 10-11-91 v1.0ß
  65. --------------
  66. Version 1.0ß released into beta test.
  67.  
  68.  
  69. 24-11-91 v1.1ß
  70. --------------
  71. 1) Method of finding dates changed. No longer requires the line "LOG 
  72.    STARTED" to find the start date. Year dropped from the display and 
  73.    the display changed to the form "21st January".
  74.  
  75. 2) /B: and /L: option added.
  76.    You now need to prefix the Bulletin filename with /B:.
  77.    The /L: option lets you specify the Log file to be processed. The 
  78.    default Log file is GT.LOG in the GTPATH directory.
  79.    Both need to include the complete drive, path and filename. 
  80.  
  81. 3) LOCAL logons not counted, they weren't before but it was queried.
  82.  
  83.  
  84. 03-12-91 v1.21ß
  85. ---------------
  86. 1) Fixed bug which still showed Local logons on the Time of Day versus 
  87.    Number of Calls graph but not in the Speed versus Number of Calls 
  88.    graph.
  89.  
  90. 2) Fixed problem with not counting 300 answers with GT17.00 logs and 
  91.    certain modems.
  92.  
  93. 3) Added a "Usage" line if no command line parameters are entered. 
  94.  
  95.  
  96. 15-12-91 v1.22ß
  97. ---------------
  98. 1) Fixed bug in date display, 11st December is now 11th December.
  99.  
  100. 2) Corrected minor problem with the copyright message.
  101.  
  102.  
  103. 21-01-92 v2.00ß
  104. ---------------
  105. Major rewrite to include new features and make GTLOGANS a bit more 
  106. friendly.
  107.  
  108. 1) Reads the GT.CNF file in the GTPATH directory to get
  109.    a) Default file area directory (for bulletins).
  110.    b) Colour information (should be the ones that the BBS uses).
  111.    c) Names of all external protocols
  112.  
  113. 2) Now detects all the external and internal protocols that GT can 
  114.    support.
  115.  
  116. 3) Automatically produces a colour (.CBS) version of each requested 
  117.    bulletin.
  118.  
  119.  
  120. 22-01-92 v2.01ß
  121. ---------------
  122. 1) Bug fix so that the displayed count of the number of calls on the 
  123.    Connections graph will go above 99. Also applied to the protocol counts. 
  124.    The number in the Time of Day graph is still limited to two digits 
  125.    and shows the two most significant ones. ie 246 would display as 24. 
  126.    I'll try and think of away round this, I don't think a three digit 
  127.    number would look nice.
  128.  
  129. 2) Small internal change to fix an unimportant problem with internal line 
  130.    lengths.
  131.  
  132. 25-01-92 v2.02ß
  133. ---------------
  134. 1) Tidied up the protocol graph so at least one block is printed if 
  135.    there is a count for that protocol. Also the position of the number 
  136.    should now be in the right place.
  137.  
  138. 2) Couple more internal tidies.
  139.  
  140. 12-02-92 v2.03ß
  141. ---------------
  142. 1) Fixed the error of writing a file called "UNSET" if only one bulletin 
  143.    was requested on the command line. Please check you default file area 
  144.    for this file and delete it if it exists.
  145.  
  146. 2) Added a Total: to the number of connects v speed graph. This is the
  147.    total of all calls received during the period shown at the top of the
  148.    bulletin.
  149.  
  150. 3) If the number of calls for any given hour is greater than 99 then  
  151.    is displayed at the top of the column.
  152.  
  153. 4) File transfers done while GT is in CONNECT mode as appeased to ANSWER 
  154.    mode are now not counted. It is assumed that you only want the 
  155.    bulletins to reflect User file transfer activity not yours. It is 
  156.    also assumed that you are not running the GT call back facility.
  157.    (Note: Callback not Ringback, theres a difference). There is a slight 
  158.    increase in speed due to this change as well. 
  159.  
  160. 16-02-92 v2.04ß
  161. ---------------
  162. 1) Removed leading spaces from the counts at the end of each graph line 
  163.    in the Protocol and Speed versus counts graphs.
  164.  
  165. 2) Fixed a cosmetic problem with the time/count and speed/count graphs 
  166.    due to scaling the data to fit the space.
  167.  
  168. 27-02-92 v2.10ß
  169. ---------------
  170.  
  171. 1) Added the third bulletin showing the number of calls per day for the 
  172.    last 24 days. This is created by using the command line option /db:n. 
  173.    Where n is the number of the bulletin required.
  174.  
  175. 03-03-92 v2.10
  176. --------------
  177.  
  178. 1) Removed the ß symbol and released GTLOGANS into the world to be torn 
  179.    apart.
  180.  
  181. 24-03-92 v2.20ß
  182. ---------------
  183.  
  184. 1) Added an average to the calls/day and calls/hour bulletins. The 
  185.    calls/day average is across the days shown only. The calls/hour 
  186.    average is across the entire period of the log file. Requested by 
  187.    Paul Richards.
  188.  
  189. 2) Added the option to clear the screen before displaying the bulletin. New 
  190.    command line switch /c controls this. /c adds the ANSI clear screen 
  191.    instruction to only the ANSI bulletins. /cb adds the ANSI clear 
  192.    screen instruction to the ANSI bulletins and adds a form feed to the 
  193.    ASCII bulletins. Requested by Warren Leadbeatter.
  194.  
  195. 3) Separated the calls/speed graph from the calls/hour graph. Added the 
  196.    new command line option /s: to get this bulletin drawn.
  197.  
  198. 4) Fixed a bug with the calls/speed graph. Two blocks would get printed 
  199.    even if only one connect had been made.
  200.  
  201. 28-03-92 v2.21ß
  202. ---------------
  203.  
  204. 1) Tidied up the layout and sequence of events associated with the 
  205.    changes done in v2.20.
  206.  
  207. 12-04-92 v2.22ß
  208. ---------------
  209.  
  210. 1) Fixed a slight date reporting problem in the protocol/uses graph.
  211.  
  212. 18-04-92 v2.23
  213. --------------
  214.  
  215. 1) Found away of detecting days in which no User calls where received. 
  216.    These now show in the calls/day graph with a date of "nc" for No 
  217.    Calls. The average shown in this graph is, as a result, more 
  218.    representative of the real BBS usage.
  219.  
  220. 19-04-92 v2.24ß
  221. ---------------
  222.  
  223. 1) Sort of fixed the "Invalid background Colour" problem reported by 
  224.    Dave Nichols and Frank Calvaresi. Now need to fix how the colours are 
  225.    changed in the display... background colours bleed across the screen.
  226.  
  227. 21-04-92 v2.30ß
  228. ---------------
  229.  
  230. 1) Fixed the background colours making nasty smears across the screen. 
  231.    The output is now acceptable most of the time. The problem is that in 
  232.    the calls/day and calls/hour graphs you need so many colour changes 
  233.    you end up with horribly long lines (>500 characters!). New version 
  234.    number as this fix required a major rewrite of one of the procedures.
  235.  
  236. 2) Fixed a buglet in the calls/speed graph if there was a lot of 
  237.    connects at one speed and only a few at another funny things would 
  238.    happen to the display layout.
  239.  
  240. 3) Added an CRLF pair after the copyright at the end of each bulletin 
  241.    file so that GT's prompt is nicely spaced away from the last line.
  242.  
  243. 19-07-92 v2.31ß
  244. ---------------
  245.  
  246. 1) Fixed a bug that *still* counted Local logons in the calls/day graph.
  247.  
  248. 2) Added the ability to report usage of the two extra external protocols 
  249.    added in GT17.06.
  250.  
  251. 3) Fixed a bug with getting the external protocol names.
  252.  
  253. 28-07-92 v2.23ß
  254. ---------------
  255.  
  256. 1) Installed a work around for when the .LOG file contains incorrectly 
  257.    formatted date information, such as that put in by Megamail. GTLOGANS 
  258.    now ignores these entries.
  259.  
  260. 14-08-92 v3.00ß
  261. ---------------
  262.  
  263. 1) Big rewrite to include a data file. GTLOGANS now stores the last 24 
  264.    days worth of data in a file GTLOGANS.DTA in the GTPATH directory. 
  265.    This means if you delete your GT.LOG file you don't end up with empty 
  266.    graphs. Be warned how ever if you use the /l: option, it will only 
  267.    read in data that is newer than that which it has already seen.
  268.  
  269. 12-09-92 v3.01ß
  270. ---------------
  271.  
  272. 1) GTLOGANS by default now looks for the logfile in the LOG directory 
  273.    set up in GT. The /l: option still needs the full path and file name.
  274.  
  275. 23-09-92 v3.10ß
  276. ---------------
  277.  
  278.      *** Delete the file GTLOGANS.DTA in the %gtpath% directory ***
  279.  
  280. 1) Added the ability to specify a start date from which to read the 
  281.    logfile. This date must be in GT.LOG format ie: mm-dd, the month can 
  282.    either have a leading space or 0. The graphs produced give details 
  283.    of the 24 days from the given startdate. If the start date given is 
  284.    before the beginning of the logfile, the first 24 days in the logfile 
  285.    are shown. Requested by Dave Wall.
  286.  
  287. 2) Added detection and counting of 4800 bps connects. GTLOGANS now sees 
  288.    300, 1200, 2400, 4800, 9600 and 14400 strings from the modem.
  289.    Are there any more?
  290.  
  291. 3) Added the node name (if it exists) to the beginning of each bulletin. 
  292.    Requested by Iain Paterson.
  293.  
  294. 24-09-92 v3.11ß
  295. ---------------
  296.  
  297.      *** Delete the file GTLOGANS.DTA in the %gtpath% directory ***
  298.  
  299. 1) Added detection and counting of 16800 bps connects. Hence having to 
  300.    delete the data file again. Nothing serious happens if you don't, but 
  301.    you'll get a runtime error.  B-)
  302.  
  303. 2) Cosmetic change to the Calls/Hour graph.
  304.  
  305. 16-10-92 v3.12ß
  306. ---------------
  307.  
  308.      *** Delete the file GTLOGANS.DTA in the %gtpath% directory ***
  309.  
  310. 1) Added a few more DCE rates to the list of those detected. The full 
  311.    list is now: 16800, 14400, 12000, 9600, 7200, 4800, 2400, 1200, 600 
  312.    and 300. This forced a change in the display order, it now starts 
  313.    with the fastest not the slowest.
  314.  
  315. 10-11-92 v4.00
  316. --------------
  317.  
  318.      *** Delete the file GTLOGANS.DTA in the %gtpath% directory ***
  319.  
  320. 1) Another complete re-write! Basically to tidy up the protocol and speed 
  321.    detection.
  322.  
  323. 2) Now counts the number of files transferred in each direction for each 
  324.    protocol. Should cope with internal, external and the DSZ log options 
  325.    correctly.
  326.  
  327. 3) Now only counts connects if the login is successful. That is a
  328.    password has been accepted by GT.
  329.  
  330. 4) Sorted out the ANSI sequences. Only the codes required to generate 
  331.    the required screen change are now put into the control sequence.
  332.  
  333. 5) Dropped the ß from the version number. Seems a bit silly having it 
  334.    there.
  335.  
  336. 18-11-92 v4.01
  337. --------------
  338.  
  339. 1) Fixed a bug that messed up the counting if a call arrived in the hour 
  340.    after midnight.
  341.  
  342. 24-11-92 v4.02
  343. --------------
  344.  
  345. 1) Ran a spell checker through the source code and doc file in an idle 
  346.    moment. Found a few as well...
  347.  
  348. 27-11-92 v4.10
  349. --------------
  350.  
  351. 1) Extracted the useful, generic, bits of the program into a .TPU, so 
  352.    I can use them in other programmes.
  353.  
  354. 2) Amended the averages to show the first decimal place.
  355.  
  356. 3) Now saves the .DTA file in the LAN path or the %gtpath% if the LAN 
  357.    path isn't set. Also changed the name to GTLOGDTA.<Pid No>. These 
  358.    changes are in readyness for when I get round to developing a prog to 
  359.    add the data files to give total system usage graphs. But don't hold 
  360.    your breath.   B-)
  361.  
  362. 28-12-92 v4.11
  363. --------------
  364.  
  365. 1) Fixed a bug when background colours have values greater than 7.
  366.  
  367.