home *** CD-ROM | disk | FTP | other *** search
/ Media Share 9 / MEDIASHARE_09.ISO / hamradio / logcon.zip / LOGCON.DOC < prev    next >
Text File  |  1992-11-30  |  8KB  |  186 lines
  1.  
  2.                                 LOGCON
  3.  
  4.    LOGCON  is only of use to those who run the G1NNA mailbox  software
  5. on   a   PC.  I  hold  the  copyright  for  the  LOGCON  program   and
  6. documentation.  You  may  use  it  free of  charge  for  personal  use
  7. involving no pecuniary gain. It scans a mailbox log file and looks for
  8. incoming  or  outgoing  connections. There is no check  that  outgoing
  9. connections  were  successful.  This program will work  with  all  NNA
  10. versions  including  V2.0 and can scan both the standard log file  and
  11. the verbose log file.
  12.    When  the  mailbox log file has been scanned then a graph is  drawn
  13. using  text characters. The graph shows either connections versus time
  14. of  day or connections versus days of the week. Connections are  shown
  15. as  absolute  values instead of e.g. averages. Mailbox SysOps can  use
  16. these graphs to get an accurate picture of activity times and days.
  17.  
  18.    The menu looks like this:-
  19. ------------------------------------------------------------
  20. 1) Draw graph of incoming connections.
  21. 2) Draw graph of outgoing connections.
  22. 3) Draw graph of both way connections.
  23. 4) Change log file to examine. It is E:\NNA\LOG\LOG.0
  24. 5) Change callsigns to examine. It is ALL
  25. 6) Change the X axis. It is hours of the day.
  26. 7) Change output destination. It is an appended LOGCON.DAT file.
  27. 8) Automatic mode: 18 graphs to file LOGCON.DAT
  28. 9) End.
  29.  
  30. Which?
  31. ------------------------------------------------------------
  32.  
  33. MENU OPTIONS 1, 2, 3
  34.  
  35.    Options 1, 2, and 3 will start the program churning away.
  36.  
  37. MENU OPTION 4
  38.  
  39.    Option  4 must be set to suit your own drive, path and filename  so
  40. that the program can find the log file to be examined.
  41.  
  42. MENU OPTION 5
  43.  
  44.    Option  5  offers the choice of callsigns to examine  and  selects:
  45. ALL,   GB7,  NON-GB7  and  a  specified  callsign.  ALL  will  examine
  46. connections   made  to  or  from  all  callsigns.  GB7  will   examine
  47. connections  to  or from callsigns starting with GB7  i.e.  mailboxes.
  48. NON-GB7  examines  connections to or from callsigns which  start  with
  49. anything else except GB7 i.e. mailbox users.
  50.    There  is  no facility to cater for the two "non-standard"  mailbox
  51. callsigns  starting with GB3 as if they were GB7 callsigns. If this is
  52. a  problem  then  send me a packet message and I'll knock  up  another
  53. version.
  54.    The  final option 5 choice is a specified callsign e.g. G8EIA. Like
  55. the  GB7 choice, there is an implied wildcard, so specifying  callsign
  56. G4 will examine connections to or from all callsigns starting with G4.
  57.  
  58. MENU OPTION 6
  59.  
  60.    Option  6  selects the graph's X axis as being either hours of  the
  61. day  (24  hr  clock) or days of the week. As the graph  uses  absolute
  62. values, note that if your log file contains information for eight days
  63. then one of the days of the week in the graph will be loaded more than
  64. the other seven.
  65.  
  66. MENU OPTION 7
  67.  
  68.    Option  7 states where the graph will go. The default is to add  it
  69. to  a  file  called  LOGCON.DAT in the same  directory  as  LOGCON.EXE
  70. without  deleting any existing data in LOGCON.DAT if this file already
  71. exists.  Other  choices are to send the graph to the screen only  (the
  72. full graph is more than 25 lines tall), to a printer on LPT1:, or to a
  73. new LOGCON.DAT data file.
  74.  
  75. MENU OPTION 8
  76.  
  77.    Option 8 will make the program churn away, automatically produce 18
  78. standard  graphs, each of which could have been produced by  selecting
  79. the  required parameters and manually running this program. The  first
  80. nine  graphs have the hours of the day as the X axis, the second  nine
  81. have the days of the week. The nine graphs have the parameters:
  82.  
  83. Incoming, ALL
  84. Outgoing, ALL
  85. Bothway,  ALL
  86. Incoming, GB7
  87. Outgoing, GB7
  88. Bothway,  GB7
  89. Incoming, NON-GB7
  90. Outgoing, NON-GB7
  91. Bothway,  NON-GB7
  92.  
  93.    Option  8 can take a very long time to run, especially if used on a
  94. monthly  log file near the end of the month. If the output graphs  are
  95. written to the default file then the time taken is also written there.
  96. As  a guide, my 486DX-33 PC took 13 mins 55 secs to examine a 600K log
  97. file  and produce the 18 graphs. When running in a Desqview window, it
  98. took 29 mins 47 secs for the same 18 graphs.
  99.  
  100. SAMPLES OF GRAPHS
  101.  
  102.    In  the  following graph, the log file had a total of 872  incoming
  103. connections   from  non-GB7  callsigns.  The  peak  number  of   these
  104. connections  occurred  between 19:00 and 19:59 hrs and there  were  82
  105. such connections.
  106.  
  107. ------------------------------------------------------------
  108. Incoming mailbox connections for NON-GB7 callsigns. Total is 872
  109. Mbx log covers 01/11/92 to 25/11/92.
  110. The peak number of connections is 82
  111.  
  112. 100%                                                           X
  113.  95%                                                           X
  114.  90%                                                           X  X
  115.  85%                                                           X  X
  116.  80%                                                           X  X
  117.  75%                                                           X  X
  118.  70%                                                           X  X  X
  119.  65%                                                           X  X  X  X
  120.  60%                                                           X  X  X  X
  121.  55%                                                        X  X  X  X  X  X
  122.  50%                                X                 X     X  X  X  X  X  X
  123.  45%                             X  X           X     X     X  X  X  X  X  X
  124.  40%  X  X                       X  X     X     X     X  X  X  X  X  X  X  X
  125.  35%  X  X  X                    X  X  X  X     X  X  X  X  X  X  X  X  X  X
  126.  30%  X  X  X              X     X  X  X  X     X  X  X  X  X  X  X  X  X  X
  127.  25%  X  X  X              X  X  X  X  X  X     X  X  X  X  X  X  X  X  X  X
  128.  20%  X  X  X  X           X  X  X  X  X  X  X  X  X  X  X  X  X  X  X  X  X
  129.  15%  X  X  X  X           X  X  X  X  X  X  X  X  X  X  X  X  X  X  X  X  X
  130.  10%  X  X  X  X  X        X  X  X  X  X  X  X  X  X  X  X  X  X  X  X  X  X
  131.   5%  X  X  X  X  X  X  X  X  X  X  X  X  X  X  X  X  X  X  X  X  X  X  X  X
  132.      00 01 02 03 04 05 06 07 08 09 10 11 12 13 14 15 16 17 18 19 20 21 22 23
  133.  
  134. Incoming mailbox connections for ALL callsigns. Total is 2763
  135. Mbx log covers 01/11/92 to 25/11/92.
  136. The peak number of connections is 478
  137.  
  138. 100%                           X
  139.  95%       X                   X
  140.  90%   X   X                   X
  141.  85%   X   X                   X
  142.  80%   X   X                   X
  143.  75%   X   X       X   X       X
  144.  70%   X   X   X   X   X       X
  145.  65%   X   X   X   X   X       X
  146.  60%   X   X   X   X   X       X
  147.  55%   X   X   X   X   X   X   X
  148.  50%   X   X   X   X   X   X   X
  149.  45%   X   X   X   X   X   X   X
  150.  40%   X   X   X   X   X   X   X
  151.  35%   X   X   X   X   X   X   X
  152.  30%   X   X   X   X   X   X   X
  153.  25%   X   X   X   X   X   X   X
  154.  20%   X   X   X   X   X   X   X
  155.  15%   X   X   X   X   X   X   X
  156.  10%   X   X   X   X   X   X   X
  157.   5%   X   X   X   X   X   X   X
  158.       Mon Tue Wed Thu Fri Sat Sun
  159. ------------------------------------------------------------
  160.  
  161. RUNNING LOGCON AT SAME TIME AS YOUR MAILBOX
  162.  
  163.    If you wish to run LOGCON.EXE at the same time as your mailbox then
  164. be aware of two important points:-
  165.  
  166. a) If your mailbox log file is updated while LOGCON is running then it
  167. may cause problems. One answer is to copy the log file to another name
  168. e.g. copy log.bbs log.0
  169. b) If using the days of the week for the X axis then this program uses
  170. a  cheap and nasty way of changing the date into the days of the week.
  171. This  was  laziness on my part (efficiency?) as it was a  lot  quicker
  172. writing  the program to use DOS5 to supply the day of the week for any
  173. date than it was to write a separate subroutine to do it.
  174.    LOGCON  notes the current date, tells DOS a new date, reads the day
  175. of  the  week given by DOS, then tells DOS the true date  again.  This
  176. could  alter the current date in your messages or log file if you  run
  177. LOGCON while the mailbox is running. I may get around to a new version
  178. which  works  out the day of the week independently of DOS5 but  don't
  179. hold your breath.
  180.  
  181. Richard I. Trotter, November 1992.
  182. G8EIA @ GB7NEM
  183.  
  184.  
  185.  
  186.