home *** CD-ROM | disk | FTP | other *** search
/ High Voltage Shareware / high1.zip / high1 / DIR10 / PCBATI6.ZIP / PCBATI6.DOC < prev    next >
Text File  |  1993-10-11  |  14KB  |  292 lines
  1.                               PCBATI6 Version 1.0
  2.        Automatic Line Noise Monitor for PCBoard and U.S. Robotics Modems
  3.  
  4.     Copyright (c) 1993 by Clark Development Co., Inc.  All Rights Reserved
  5.  
  6.  
  7. =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  8. DESCRIPTION
  9. =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  10.  
  11. PCBATI6 is a program which, in conjunction with U.S. Robotics HST Modems, can
  12. monitor line noise, keep a history of line noise problems, and even inform
  13. your callers when they experience line noise.
  14.  
  15. PCBATI6 is compatible with PCBoard v14.5a and v15.0.  It is placed in your
  16. $$LOGOFF.BAT file so that it is run after every caller logs off.  When run, it
  17. issues an ATI6 command to your U.S. Robotics HST modem.  The ATI6 command asks
  18. the modem to report session statistics for the most recent connection.  These
  19. statistics hold the clues as to what kind of line noise a caller experienced
  20. while online.
  21.  
  22. By running PCBATI6 you can AUTOMATICALLY inform your users when they experience
  23. excessive line noise.  This helps them to understand why their file transfers
  24. were slower than expected, or why the keyboard response time was sluggish.
  25.  
  26. What many people seem to have forgotten is that, in spite of the advent of MNP
  27. and v.42 modems, line noise STILL EXISTS today!  These fancy modems do not
  28. magically make line noise disappear.  Rather, these error correcting modems do
  29. exactly as their name implies:  they CORRECT errors that occur due to line
  30. noise.  Line noise still exists even though the caller no longer sees it, as
  31. garbage while typing, or as errors in file transfers.  Instead, the caller sees
  32. line noise as a "slow down" in file transfer speeds or as "sluggishness" when
  33. typing at the keyboard.
  34.  
  35. Even sysops, the ones that are more likely to understand these new modems,
  36. often jump to the erroneous conclusion that when a transfer is slower than
  37. expected that it must be the fault of:  a) the software, b) the network, c)
  38. the multitasker, or d) the modem.  What seldom crosses their minds is that the
  39. true cause of the slowdown is probably nothing more than what people have
  40. experienced ever since modems first came into existence:  line noise.
  41.  
  42. PCBATI6 is here to help educate callers.  To let them know when they have
  43. experienced excessive line noise.  To show them how it has been determined that
  44. line noise was, in fact, experienced.  And to let them know what they can do to
  45. improve the situation.
  46.  
  47. After a caller is disconnected, PCBATI6 will be run.  It will issue the ATI6
  48. command and then ANALYZE the results to determine if excessive line noise was
  49. experienced.  If it was, then the program will automatically generate a message
  50. for the caller, optionally placing it in the same conference the caller was in
  51. at the end of the call, with a customized message that indicates what was
  52. experienced and what the caller can do to improve his connections.
  53.  
  54.  
  55. =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  56. NO SUPPORT
  57. =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  58.  
  59. By popular demand, PCBATI6 is being released.
  60.  
  61. We use this program on our own BBS, the Salt Air BBS (Home of PCBoard) and it
  62. works great.  It works on all models of PCBoard, from /2 to /1000 and even
  63. supports the MultiPort (/M) version.
  64.  
  65. HOWEVER, as desireable as it may be for this program to be "supported" or
  66. even "enhanced", it won't be.  This program is not a part of PCBoard, it's not
  67. a part of CDC's official offerings.  It costs you nothing to obtain or use it.
  68. If it works for you, great.  If it doesn't, no loss, you got what you paid for.
  69.  
  70.  
  71. =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  72. NOTES
  73. =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  74.  
  75. 1) This program works ONLY with USR HST modems.  That includes both the regular
  76.    HST as well as the HST Dual Standard.  The reason for this restriction is
  77.    that the only modems that have the ATI6 command, that we are aware of, are
  78.    the HST line of modems.
  79.  
  80. 2) This program is compatible with v15.0's IDX files as well as the old NDX
  81.    format.
  82.  
  83. 3) The message written can be placed in a fixed location by specifying which
  84.    conference you want the messages sent to (see /CONF:###).  Or, by using
  85.    /CONF:SYS the message will be left in the same conference the caller was in
  86.    when he logged off or lost carrier.  If your callers are likely to rejoin
  87.    the conference they left and look for mail there, then the /CONF:SYS may be
  88.    preferable.
  89.  
  90. 4) The messages that PCBATI6 creates are receiver-only and non-echoed.  So if
  91.    the caller was in an echoed conference and /CONF:SYS is used, the messages
  92.    will not be exported.
  93.  
  94. 5) If a v15.0 system is used, PCBATI6 will automatically put a packout date on
  95.    the message that is 3 days from the date on which the message was posted.
  96.    Some callers read mail offline and do not kill their messages after
  97.    receiving them.  The automatic packout date will prevent the messages from
  98.    cluttering up your message base.
  99.  
  100.  
  101. =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  102. INSTALLATION
  103. =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  104.  
  105. To install PCBATI6 all you need to do is copy the following files into your
  106. PCBoard directory:
  107.  
  108.          PCBATI6.EXE
  109.          PCBATI6.TXT
  110.  
  111. If you don't already have a $$LOGOFF.BAT file you can also copy the sample
  112. file, called SAMPLE.BAT, over to $$LOGOFF.BAT in your PCBoard directory.
  113.  
  114. The sample looks like this (the PCBATI6 command is all on one line)
  115.  
  116.   @echo off
  117.   ati6 /file:pcbati6.cap /conf:sys /text:pcbati6.txt
  118.  
  119. If all you want to do is capture ATI6 reports, and NOT create messages for your
  120. users, you can do so by leaving off the /CONF and /TEXT parameters.
  121.  
  122. Typing PCBATI6 without parameters will remind you of the parameters.  Here they
  123. are for your review:
  124.  
  125.   usage:  PCBATI6 (command line parameters)
  126.  
  127.   parameters:  /FILE:filename    - name of file to track ATI6 history
  128.  
  129.   optional:    /TEXT:filename    - name of text file to base message on
  130.                /CONF:# or SYS    - conference number to post messages
  131.                                    /CONF:SYS reads pcboard.sys to get the
  132.                                    conference the caller was in at logoff
  133.  
  134.   examples:   PCBATI6 /FILE:C:\\PCB\\MODEM.TXT
  135.  
  136.               The above just captures ATI6 reports to a file so that you can
  137.               review the results.
  138.  
  139.               PCBATI6 /FILE:ATI6.CAP /CONF:SYS /TEXT:PCBATI6.TXT
  140.  
  141.               The above captures ATI6 reports and also writes the caller a
  142.               message, in the conference from which he logged off, using the
  143.               PCBATI6.TXT file as the source of the text for the message.
  144.  
  145.  
  146. =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  147. CUSTOMIZATION
  148. =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  149.  
  150. The PCBATI6.TXT file is a text file which can be translated or modified with a
  151. few small guidelines:
  152.  
  153. 1) The first two lines define the name to be used in the FROM and SUBJECT
  154.    fields (respectively) of the message to be written to the caller.
  155.  
  156.    The first line is taken verbatim and used as the FROM field.  There is a
  157.    limit of 25 characters on that line.
  158.  
  159.    The second line has a "%d" in it.  As long as the "%d" is not removed, the
  160.    NODE NUMBER will be put in its place.  If you are not running multiple
  161.    nodes or don't wish to have the node number recorded in the message you
  162.    can remove the entire "(NODE %d)" portion of the subject.
  163.  
  164. 2) There are 7 more sections in the file:  TOPTEXT, RESENT, RETRAINS,
  165.    MODEMERRORS, FINALSPEED, DISCONNECT, and FINALTEXT.
  166.  
  167.    Each section begins with ** and the name of the section.  For example, the
  168.    first line in the file is **TOPTEXT.
  169.  
  170.    The last line of each section is just ** (or the end of the file).  The
  171.    ORDER of the file is VERY IMPORTANT.  Do not change the order of the
  172.    sections.
  173.  
  174. 3) The content of each section can be rewritten, translated, modified in
  175.    anyway you see fit with just one exception:
  176.  
  177.    The "%ld" and "%s" parameters in each section MUST REMAIN in the same
  178.    order and in the same section in which they are found.
  179.  
  180.    PCBATI6 will translate the %ld and %s parameters into numbers and text.
  181.  
  182.  
  183. =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  184. WHAT CAN YOU DO ABOUT LINE NOISE
  185. =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  186.  
  187. Unfortunately, the only course of action *may* be to simply hang up and try
  188. your call again - hoping for a cleaner connection the next time around.
  189.  
  190. The phone company can route your call MANY different ways - even when calling
  191. across town but more so when calling long distance.
  192.  
  193. Some things you can do are:
  194.  
  195. 1) Use only high quality modems with v.32 and v.32bis modulation with mnp or
  196.    v.42 error correction.
  197.  
  198. 2) Call your local phone company and have them inspect your phone lines.
  199.  
  200. 3) Try a different long distance carrier.
  201.  
  202.    If you are calling long distance then switching to a different long distance
  203.    carrier can often result in cleaner phone lines.  In our experience, and in
  204.    the experience of several of our customers, the most reliable long distance
  205.    carrier has been AT&T.  (though in some areas even AT&T may not be the best
  206.    carrier to use)
  207.  
  208.    EVEN IF AT&T is not your default long distance carrier you can TRY THEM OUT
  209.    as an experiment to see if AT&T can give you a better connection.  All you
  210.    have to do is dial 10288 in front of the number you want to dial.
  211.  
  212.    For example, to reach the Salt Air BBS via AT&T dial:  10288,1-801-261-8976.
  213.  
  214.    If AT&T *is* your long distance carrier then trying a *different* carrier
  215.    may still be the solution!  Here are a few more common codes:
  216.  
  217.      10022 - MCI
  218.      10033 - SPRINT
  219.      10700 - Tel-America
  220.      10759 - Telenet
  221.  
  222.    There are many more.  Contact your local phone company for other long
  223.    distance carrier "equal access" codes.
  224.  
  225.  
  226. =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  227. ANALYSIS
  228. =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  229.  
  230. So just what DOES the analysis entail?  The following are the current rules
  231. used by PCBATI6 to determine whether or not a message should be generated.  If
  232. one or more of the following is true the a message is written to the caller:
  233.  
  234.   - 1000 or more blocks were sent AND 25% or more blocks had to be RE-sent
  235.   - Retrains Requested or Granted is greater than 20
  236.   - The number of Blers, Link Naks or Link Timeouts, individually, is
  237.     greater than 150
  238.  
  239. Note that values less than those looked for in the above can STILL indicate
  240. that line noise was experienced but that it simply was not sufficient to
  241. warrant a message being generated.  If a caller asks why the transfers were
  242. slow but did not receive an automated message, you can look up in the capture
  243. file to get a copy of the ATI6 report.
  244.  
  245. The number of blocks RE-sent is a very clear indication of line noise.  Any
  246. amount of time spent RE-sending a block of data that has already been sent has
  247. a direct impact on the throughput and is only necessary if the receiving modem
  248. was unable to receive the block properly the first time around.
  249.  
  250. Retrains requested and granted is another very clear indication of line noise.
  251. The modems attempt to shift to a lower (or higher) bps rate as line conditions
  252. change in search of a speed which can be more effecient.  In other words, it is
  253. possible for a 4800 bps connection to be FASTER than a 9600 bps connection if
  254. it means that fewer errors will occur!
  255.  
  256. Modem errors such as Blers, Link Naks and Link Timeouts also generally reflect
  257. line noise and are often seen in combination with the above items.  However,
  258. they can also be the result of INCOMPATIBLE MODEMS talking to each other.  It
  259. is highly recommended that the highest quality modems be used.  In the world of
  260. modems you really do "get what you pay for".
  261.  
  262. The final speed of the connection is also reported if it is SLOWER than the
  263. original connection speed.  Obviously if retrains have caused the connection
  264. speed to drop from 14400 bps down to 7200 bps the caller should *expect* to see
  265. slower file transfers.  PCBATI6 will let the caller know that this occured even
  266. though his very own modem likely will not!
  267.  
  268. The disconnect reason is provided so that the caller can see why the connection
  269. was dropped.  Many, for some reason, tend to believe that the SOFTWARE HUNG UP
  270. on them when, in fact, it was the modem that decided to hang up due to the
  271. excessive line noise.
  272.  
  273.  
  274. =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  275. REVISION HISTORY
  276. =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  277.  
  278. Version 1.1
  279. -----------
  280. Forgot to include /M compatibility in the 1.0 release.  Fixed.
  281.  
  282.  
  283. Version 1.0
  284. -----------
  285. This version was actually preceeded by a program called ATI6 which we privately
  286. distributed to those who asked for it.  ATI6's only function was to capture
  287. ATI6 reports and log them to disk.
  288.  
  289. PCBATI6 v1.0 is the first public release of the program and the first release
  290. to analyze the content of the ATI6 report and generate a message for the user
  291. if excessive line noise was experienced.
  292.