home *** CD-ROM | disk | FTP | other *** search
/ Columbia Kermit / kermit.zip / archives / msr313src.zip / msmaaa.hlp < prev    next >
Text File  |  1994-06-16  |  10KB  |  202 lines
  1. File MODEMS.DOC                                                       June 1994
  2.  
  3.              MS-DOS KERMIT MODEM DIALING SCRIPTS
  4.  
  5.              Christine M. Gianone, Frank da Cruz
  6.                  Columbia University
  7.  
  8.                  John Klensin
  9.               United Nations University
  10.  
  11.  
  12. The following modem dialing scripts are available for use with the DIAL
  13. command in MS-DOS Kermit 3.12 and later.  Store the desired files in the same
  14. directory as your MSKERMIT.INI file (this directory should be in your DOS
  15. PATH).
  16.  
  17. The DIAL command is a macro defined in the standard MSKERMIT.INI file on the
  18. MS-DOS Kermit diskette.  It looks up the number (or name) in your dialing
  19. directory, making the appropriate substitution, and passes the phone number to
  20. your dialing script in a variable.  See "Using MS-DOS Kermit" and KERMIT.HLP
  21. (MSKERM.HLP) for details about the DIAL command and the dialing directory.
  22.  
  23. If you lack the DIAL macro definition, you can define your own simple DIAL
  24. macro (which does not use the dialing directory) as follows:
  25.  
  26.   DEFINE DIAL TAKE xxx.SCR
  27.  
  28. where xxx is the modem type, described below.
  29.  
  30. The default modem type (if you are using the standard MSKERMIT.INI file) is
  31. HAYES.  To select a different type of modem for dialing, do any one of the
  32. following:
  33.  
  34.   1. Type SET MODEM=xxx at the DOS prompt before starting MS-DOS Kermit, or
  35.   2. Add SET MODEM=xxx to your AUTOEXEC.BAT file and reboot your PC, or
  36.   3. Type DEFINE _MODEM xxx at the MS-DOS Kermit prompt, or
  37.   4. Add DEFINE _MODEM xxx to your MSCUSTOM.INI file.
  38.  
  39. xxx is name of the modem, corresponding to the part of the dialing script
  40. filename before ".SCR".  For Telebit T3000 modems, for example, the script
  41. file is called T3000.SCR, and "xxx" would be "T3000".  If you obtain these
  42. files over the network, you should rename as shown in the DOS Filename column
  43. below.  Here are the dialing scripts that are supplied with MS-DOS Kermit:
  44.  
  45.   Modem Type             DOS Filename  Internet               BITNET/EARN/CREN
  46.  
  47. *  AT&T DataPort 14400    DATAPORT.SCR  kermit/a/msmdatap.scr    MSMDATAP SCR
  48. *  Boca 14.4 Faxmodem     BOCA.SCR      kermit/a/msmboca.scr     MSMBOCA.SCR
  49. *  Digicom Connection144+ CONN144P.SCR  kermit/a/msmc144p.scr    MSMC144P.SCR
  50.    Hayes 1200 or 2400     HAYES.SCR     kermit/a/msmhayes.scr    MSMHAYES SCR
  51. *  Hayes Ultra 144        ULTRA144.SCR  kermit/a/msmultra.scr    MSMULTRA SCR
  52. *  Multitech MT1432       MT1432.SCR    kermit/a/msmmt1432.scr   MSMMT1432 SCR
  53. *  Penril Alliance V.32   PENRIL.SCR    kermit/a/msmpenril.scr   MSMPENRIL SCR
  54. *  Practical Peripherals  PP14400.SCR   kermit/a/msmpp14400.scr  MSMPP1440 SCR
  55.    Rolm CBX DCM           ROLM.SCR      kermit/a/msmrolm.scr     MSMROLM SCR
  56. *  SupraFAXmodem V.32bis  SUPRA.SCR     kermit/a/msmsupra.scr    MSMSUPRA SCR
  57. *  Telebit QBlazer V.32   QBLAZER.SCR   kermit/a/msmqblazer.scr  MSMQBLAZER SCR
  58. *  Telebit T3000 V.32bis  T3000.SCR     kermit/a/msmt3000.scr    MSMT3000 SCR
  59. *  US Robotics Sportster  SPORT.SCR     kermit/a/msmsport.scr    MSMSPORT SCR
  60.    Vadic VA2400PA         VA2400PA.SCR  kermit/a/msmva2400.scr   MSMVA2400 SCR
  61. ** VIVA 2442ef FAX/MODEM  VIVA.SCR      kermit/a/msmviva.scr     MSMVIVA SCR
  62. *  Wang 14/14i or 14/14e  WANG14.SCR    kermit/a/msmwang14.scr   MSMWANG14 SCR
  63. *  Zoom Telephonics 14400 ZOOM.SCR      kermit/a/msmzoom.scr     MSMZOOM SCR
  64. *  ZyXEL 1496             ZYXEL.SCR     kermit/a/msmzyxel.scr    MSMZYXEL SCR
  65.  
  66. NOTE: The PP14400.SCR file should be usable with any Practical Peripherals
  67. V.32 or V.32bis model: PM9600, PM9600SA, PM9600FXMT, PM14400FXSA, PM14400FXMT.
  68.  
  69. If your modem does not appear in this list, feel free to adapt one of these
  70. scripts to work with your modem (and send your new script back to Columbia so
  71. others can use it too).
  72.  
  73. WHAT THE DIALING SCRIPTS HAVE IN COMMON
  74.  
  75. These scripts use your modem's default dialing method, pulse or tone; they do
  76. not specify one or the other, since neither method is supported by all
  77. telephones everywhere.  To force Tone dialing, begin your phone number with T,
  78. for example:
  79.  
  80.   DIAL T7654321
  81.  
  82. Similarly, to force pulse dialing, start the phone number with P.
  83.  
  84. If you give a DIAL command whose telephone number is simply = (equal sign),
  85. the modem will be initialized, but no call will be placed.  In some cases,
  86. the dialing script will also ask the modem to display its configuration.
  87.  
  88. When dialing a real phone number, you can include special characters in the
  89. phone number to accomplish pauses, wait for secondary dialtone, etc.  See your
  90. modem manual.
  91.  
  92. If you dial a number that is busy, most of these scripts will wait 30 seconds
  93. and then redial automatically, up to 5 times.  You can cancel the redial
  94. operation by pressing any key after you see the message:
  95.  
  96.   Line is busy, will dial again in 30 seconds.
  97.   Press any key to cancel...
  98.  
  99. Each dialing script returns SUCCESS if dialing succeeds and FAILURE if it
  100. doesn't, so you can use an IF FAIL or IF SUCCESS statement after a DIAL
  101. command in a script.
  102.     
  103. THE ROLM DIALING SCRIPT
  104.  
  105. ROLM.SCR is for the Rolm/Siemens (formerly IBM) Computerized Branch Exchange
  106. (CBX) data communications module (DCM).  It dials at your current speed, and
  107. does not change speeds since the DCM is speed-sensitive.  It does not attempt
  108. to redial if the line is busy.  For Rolm 244PCs, use HAYES.SCR, and always use
  109. Tone dialing.
  110.  
  111. THE HAYES 1200/2400 AND VADIC 2400PA DIALING SCRIPTS
  112.  
  113. The Hayes 2400 script, HAYES.SCR, should work on any Hayes-1200, Hayes-2400,
  114. or compatible modem.  It does not change any modem settings (S registers).  It
  115. assumes that the modem changes its interface speed to match the negotiated
  116. modulation speed, if the modulation speed is reported as 1200 or 2400;
  117. otherwise, Kermit does not change its interface speed.
  118.  
  119. The Vadic 2400PA script, VA2400PA.SCR, works in much the same way, except it
  120. also recognizes a 300 bit-per-second connect message.  The Vadic modem
  121. supports only pulse dialing.
  122.  
  123. HIGH-SPEED MODEM SCRIPTS
  124.  
  125. The entries marked with "*" above are for high-speed modems that include
  126. error-correction and data-compression features.  (Exception: the Viva modem is
  127. a 2400 bps modem that does error correction, compression, and speed
  128. buffering).  These scripts attempt to use these modems at a fixed interface
  129. speed of 57600 bps (or 38400 bps, if that is the highest speed supported by
  130. the modem), to allow the modem's data compression to operate at its full
  131. effectiveness, and they enable hardware flow control (RTS/CTS) to prevent loss
  132. of data.  Note that flow control will be fully effective only if the answering
  133. modem and computer also have an effective flow control method between them.
  134.  
  135. The high-speed modem scripts:
  136.  
  137.  . Configure the modem to echo commands, issue verbose result codes, and
  138.    hang up upon loss of DTR from the PC (as when you tell Kermit to HANGUP).
  139.    (If Kermit's HANGUP command doesn't work with your modem, you can find
  140.    a workaround in the KERMIT.BWR (MSKERM.BWR) file.)
  141.  
  142.  . Start out at the highest supported modulation, V.32bis, with downwards
  143.    negotiation enabled (V.32, V.22bis, etc.)  If a lower modulation technique
  144.    is negotiated, the interface speed remains fixed and the modem does "speed
  145.    buffering", for which effective flow control is an absolute requirement.
  146.  
  147.  . Enable error correction and compression, starting out at the highest
  148.    supported levels (V.42 and V.42bis) and falling back to lower levels
  149.    (usually MNP), or to none at all.
  150.  
  151.  . Configure to modem to pass BREAK signals through transparently when you
  152.    type Alt-B.
  153.  
  154. Dialing     Interface   Highest      Error        Data
  155. Script       Speed      Modulation   Correction   Compression   Remarks
  156.    
  157. BOCA.SCR     57600      V.32bis      V.42->MNP    V.42bis->MNP
  158. DATAPORT.SCR 57600      V.32bis      V.42->MNP    V.42bis->MNP
  159. PENRIL.SCR   38400      V.32(bis?)   V.42->MNP    V.42bis->MNP
  160. PP14400.SCR  57600      V.32bis      V.42->MNP    V.42bis->MNP  PM14400 models
  161. PP14400.SCR  57600      V.32         V.42->MNP    V.42bis->MNP  PM9600FXMT
  162. PP14400.SCR  38400      V.32         V.42->MNP    V.42bis->MNP  PM9600/9600SA
  163. QBLAZER.SCR  38400      V.32         V.42->MNP    V.42bis->MNP
  164. SPORT.SCR    57600      V.32bis      V.42->MNP    V.42bis->MNP
  165. SUPRA.SCR    57600      V.32bis      V.42->MNP    V.42bis->MNP
  166. T3000.SCR    57600      V.32bis      V.42->MNP    V.42bis->MNP
  167. ULTRA144.SCR 38400      V.32bis      V.42->MNP    V.42bis->MNP
  168. VIVA.SCR     19200      V.24         V.42->MNP    V.42bis->MNP
  169. WANG14.SCR   57600      V.32bis      V.42->MNP    V.42bis->MNP
  170. ZOOM.SCR     57600      V.32bis      V.42->MNP    V.42bis->MNP
  171.  
  172. The Telebit T3000 script should also work on the Telebit WorldBlazer.
  173.  
  174. The Telebit QBlazer script should also work on the Telebit T1600.
  175.  
  176. The Hayes Ultra 144 gives you a failure code if the modem reports NO CARRIER:
  177.  
  178.   0  Normal hangup
  179.   4  Physical carrier loss
  180.   5  Error control was required but was not negotiated
  181.   6  Other error-control modem did not respond to feature negotiation
  182.   7  Other modem is synchronous-only
  183.   8  Modems could not find a common framing technique
  184.   9  Modems could not find a protocol in common
  185.  10  Incorrect feature negotiation message sent by other modem
  186.  11  Timed out waiting for synchronous data
  187.  12  Normal disconnect initiated by other modem
  188.  13  Other modem did not respond after many retransmissions
  189.  14  Protocol violation
  190.  15  Compression failure
  191.  
  192. The PP14400 script attempts to identify the modem model and set the interface
  193. and connection speeds accordingly.  If it tells you "Unknown Practical
  194. Peripherals Modem model", you'll have to add your model identification to
  195. the script; the required changes should be self-evident.
  196.  
  197. For further information, read the script files themselves.  They are ordinary
  198. text files that you can TYPE, PRINT, or view with a text editor such as DOS
  199. 5.0 EDIT.
  200.  
  201. (End of MODEMS.DOC)
  202.