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