home *** CD-ROM | disk | FTP | other *** search
/ Columbia Kermit / kermit.zip / archives / msr313src.tar.gz / msr313src.tar / msvv90.bwr < prev    next >
Text File  |  1993-10-17  |  93KB  |  1,950 lines

  1.             MS-DOS V9KERMIT 3.13  BEWARE FILE
  2.  
  3.         FOR VICTOR 9000 and SIRIUS 1 MS-DOS COMPUTERS
  4.  
  5.      [Originally MSKERMIT.BWR for IBM PC Family, Compatibles, and Other MS-DOS
  6.         computers;  minor modifications for Victor 9000 and Sirius 1 computers
  7.                         by R.N. Folsom,  October 1993]
  8.  
  9.  
  10.  
  11.  
  12.                 BUGS, LIMITATIONS, HINTS & TIPS
  13.  
  14. Most recent IBM version update: Thursday 8 July  18:56:14  1993
  15.  
  16.  
  17.  
  18. This file discusses common problems installing or using MS-DOS Kermit and
  19. presents solutions or workarounds in many cases.  It applies to version 3.13
  20. of MS-DOS Kermit for the IBM PC family and compatibles.  See V9KERMIT.HLP
  21. (modified from MSKERMIT.HLP) for copyright information, terms and conditions,
  22. and a summary of MS-DOS Kermit commands.
  23.  
  24. The user manual for MS-DOS Kermit 3.13 is the book "Using MS-DOS Kermit",
  25. Second Edition, by Christine M. Gianone, published by Digital Press, Bedford,
  26. MA (1992), order number EY-H893E-DP.  Call 1-800-344-4825 (toll free, USA) to
  27. order, or order from Columbia University.  Changes since the book was
  28. published are described in V9KERMIT.UPD (originally KERMIT.UPD or MSKERM.UPD).
  29.  
  30. Please consult "Using MS-DOS Kermit" and this file before contacting Kermit
  31. technical support staff.  Report problems via e-mail to kermit@columbia.edu on
  32. the Internet or to KERMIT@CUVMA.BITNET, or call +1 212 854-5126, or by Fax to
  33. +1 212 663-8202, or write to Kermit Distribution, Columbia University Academic
  34. Information Systems, 612 West 115th Street, New York, NY 10025, USA.
  35.  
  36. INCOMPATIBILITIES BETWEEN MS-DOS KERMIT 3.13 AND EARLIER VERSIONS:
  37.  
  38.  1. The TERMINALR/S macro capability is replaced by host-initiated change
  39.     of screen writing direction (details in KERMIT.UPD).  As a consequence
  40.     of this, host-based WordPerfect won't be able to load your key settings
  41.     (see next section).  Any other host software that sent the TERMINALR/S
  42.     sequences will also need to be converted in similar fashion.  See the
  43.     APC section in V9KERMIT.UPD for further details.
  44.  
  45.  2. STATUS command removed.  There is no longer any way to display all of
  46.     MS-DOS Kermit's settings on a single screen.  Now use the SHOW command to
  47.     display categories of settings: SHOW TERMINAL, SHOW COMMUNICATIONS, SHOW
  48.     PROTOCOL, etc.
  49.  
  50.  3. STATISTICS, which displays file transfer statistics, has been added as a
  51.     top-level command, for compatibility with C-Kermit.     So if you were used
  52.     to typing "stat" to get a screenful of settings values, now you will get
  53.     file transfer statistics instead.
  54.  
  55.  4. Alt-n was previously bound by default to the \Knethold verb.  It is now
  56.     bound to the new \Knextsession verb.  \Knethold (used on TES, EBIOS, 
  57.     NASI/NACS, and various other PC networks or asynchronous communication
  58.     servers) has been moved to Alt-z.
  59.  
  60. WORDPERFECT
  61.  
  62. To make host-based UNIX WordPerfect work with MS-DOS Kermit 3.13, follow these
  63. directions (courtesy of Chris Thompson at Vanderbilt University).  Presumably
  64. similar steps can be followed for the VMS version:
  65.  
  66. . Go into the directory where the terminal definitions are stored (in my case
  67.   of WP 5.1 for AIX, it was /usr/wp51/shlib), and execute "wpterm" (it usually
  68.   requires you to be super-user).
  69.  
  70. . A screen containing all the terminal definitions will appear.  Highlight the
  71.   current Kermit terminal definition and hit Create.
  72.  
  73. . It will ask "Model new definition after Kermit?"  Answer yes.
  74.  
  75. . It will then ask for a new name for your new terminal definition.  Call it
  76.   something like KERMIT313.
  77.    
  78. . At the bottom of the screen, several options will appear.  Choose the option
  79.   for Terminal Control Characters.  It will then bring up a screen with the
  80.   different initialization strings and their values.  The first four items are
  81.   the ones that need altering (Terminal Initialization, Terminal Reset, Quick
  82.   Initialization, and Quick Reset).  Just delete "[27][?34h" or "[27][?34l"
  83.   (for initialization and reset, respectively) from the string and replace it
  84.   with "[27]_take \kermit\wpunix.ini[27]\" or "[27]_set key clear[27]\",
  85.   leaving the rest of the string intact.
  86.    
  87. . Be sure to change your WPTERM environment variable if you decided to create
  88.   a definition with a different name.
  89.  
  90. TROUBLESHOOTING MS-DOS KERMIT SERIAL PORT AND MODEM PROBLEMS
  91.  
  92.   "Why can't MS-DOS Kermit find my COM3 or COM4 port?"
  93.   "Why can Kermit send characters to my COM port, but not read them?"
  94.   "Why doesn't Kermit work with my internal modem?"
  95.  
  96. Rule out the obvious: Is everything connected and turned on?  Did you
  97. give a SET PORT command for the right device, and did you give it BEFORE any
  98. other device-related commands, such as SET SPEED and SET PARITY?  Remember,
  99. port-related settings apply to the port that was selected in the most recent
  100. SET PORT command, so a proper sequence might be:
  101.  
  102.   SET PORT COM2          ; First select the port
  103.   SET SPEED 19200     ; Then set its speed
  104.   SET PARITY EVEN     ; and other parameters for this port...
  105.   SET FLOW RTS/CTS
  106.   SET LOCAL-ECHO ON
  107.  
  108. Each of these parameters is remembered for each port, so switching ports (e.g.
  109. SET PORT COM1 after you have given the above sequence of commands) changes
  110. all these parameters to their previous (or default) values for the port you
  111. have switched to.  To see communication parameters for the current port:
  112.  
  113.   SHOW COMMUNICATIONS
  114.  
  115. Check them carefully to be sure they are what you intended.
  116.  
  117.   The following discussion is detailed and technical, but most of it boils
  118.   down to (a) telling Kermit two numbers, the port address and IRQ value; and
  119.   (b) fiddling with your modem.     Keep that in mind as you read more about PC
  120.   hardware than you ever wanted to know.
  121.  
  122. HOW A PHYSICAL COMMUNICATION PORT IS ASSOCIATED WITH A DOS COMn DEVICE
  123. [Not applicable to Victor;  included for information]
  124.  
  125. DOS PCs come with full support for two communication ports, COM1 and COM2, and
  126. with provisions for two more, COM3 and COM4.  COM3 and COM4 are not well (or
  127. consistently) supported in most types of PCs, as are COM1 and COM2 which
  128. rarely (by themselves) cause any problems.  This discussion considers only
  129. COM1-COM4, since higher-numbered COM ports are rare, and in any case not
  130. supported by MS-DOS Kermit.
  131.  
  132. The digit in the port name (like the "2" in COM2) is an index into an area in
  133. memory that contains the address of the serial port hardware.  The PC's Basic
  134. Input/Ouput System (BIOS) has four words starting at segment 40 (hexadecimal),
  135. word 0, for the addresses of the first four COM ports.  Word 0 is for COM1,
  136. word 2 (two bytes per word) for COM2, word 4 COM3, and word 6 COM4.  To view
  137. these addresses:
  138.  
  139.   C:\> debug         (start the debug program)
  140.   -d 40:0         (display segment 40)
  141.   -q             (quit the debug program)
  142.  
  143. ("C:\>" is the DOS prompt, "-" is the debug prompt.)  Here are the results
  144. on a PS/2 with 3 COM ports:
  145.  
  146.   0040:0000  F8 03 F8 02 20 32 00 00-BC 03 00 00 00 00 60 03  .... 2........`.
  147.              ^^^^^ ^^^^^ ^^^^^ ^^^^^
  148.              COM1  COM2  COM3  COM4
  149.  
  150. The first line (like the one above) contains the COM port information (ignore
  151. the other lines, as well as the characters on the right).  "F8 03" is the
  152. 2-byte COM1 address, expressed in hexadecimal (base 16) with the low byte
  153. first.  Thus the actual COM1 address is 03F8 hex, expressed in Kermit commands
  154. as \x3f8.  The COM2 address is 02F8, the COM3 address is 3220, and (since
  155. there is no COM4) the COM4 address is 0000.  That is how both DOS and the BIOS
  156. understand which ports are defined and where to find them.
  157.  
  158. When your PC is powered up, the BIOS startup code checks for serial port
  159. hardware (that is, a Universal Asynchronous Receiver/Transmitter, or UART) at
  160. the two port addresses 03F8 and 02F8.  If it finds a UART at the first address
  161. then that address is placed in word 40:0 and declared to be COM1.  Then the
  162. BIOS tries the second address and if successful this address goes into the
  163. first available word at that time, typically 40:2 as the address of COM2.
  164. Thus if you remove a COM1 device then a previously COM2 device will appear in
  165. the COM1 BIOS storage area as COM1 to DOS and Kermit.  What happens to the
  166. other two words depends on the PC model and BIOS.  The IBM PS/2 BIOS fills in
  167. all four words on startup, but most others handle only the first two because
  168. that's how IBM did it with the original PCs.
  169.  
  170.   So... just setting switches or jumpers on a serial port board or internal
  171.   modem does NOT necessarily define the board to be a particular COM port.
  172.  
  173. So why do some communication programs work with COM3 and COM4 without any
  174. special fiddling?  These programs ASSUME certain COM3 and COM4 addresses, even
  175. when there are no entries in the BIOS communication-port area.  Some of these
  176. programs show you their assumptions in a menu (and might allow you to change
  177. them), others do not.  The assumed values are usually as follows:
  178.  
  179.   Port     Assumed Address (hexadecimal)
  180.   COM1          03F8
  181.   COM2          02F8
  182.   COM3          03E8
  183.   COM4          02E8
  184.  
  185.   NOTE: PS/2s use different addresses for COM3 and COM4 -- 3220 and 3228,
  186.   respectively.  Well-behaved communication software (like Kermit) will use
  187.   these addresses rather than the defaults listed above.  Ill-behaved software
  188.   ignores the segment-40 addresses and erroneously attempt to use its own
  189.   values, right or wrong.
  190.  
  191. Unchecked use of an assumed port address is DANGEROUS if the device is not
  192. really where the software expects, especially if some other kind of device,
  193. say a network adapter, is at the given address.  It can also produce unwanted
  194. conflicts under Windows, OS/2, and DesqView, whose drivers often set the
  195. port's segment-40 word to 0 when they want to use the port exclusively and
  196. without interference, and then restore the real address when done, and similar
  197. unwanted interference with Int 14H redirectors that allow serial-port
  198. communication software to be used on network connections.
  199.  
  200. Unlike most other PC communication software, Kermit does NOT attempt to use a
  201. communications port unless:
  202.  
  203.   (a) It finds its address in the BIOS comm-port area, segment 40, or:
  204.   (b) You specify the address yourself.
  205.  
  206. AND:
  207.  
  208.   The device at the given address passes certain tests, in which registers
  209.   must contain certain values that are legitimate for a UART.
  210.  
  211. In other words, KERMIT IS MORE CAREFUL than most other communication software,
  212. because does not want to risk disrupting normal operation of your PC.
  213.  
  214. SPECIFYING THE PORT ADDRESS
  215. [Not applicable to Victor;  included for information]
  216.  
  217. If you tell MS-DOS Kermit to SET PORT COMn (where n is 1, 2, 3, or 4), and
  218. Kermit responds:
  219.  
  220.   Warning, no hardware for this serial port.
  221.   This port will be operated through the BIOS as BIOSn
  222.  
  223. it means that Kermit did not find an address for the port in the BIOS area or
  224. it did find one but the hardware at that address did not look like a UART.  If
  225. the cause of the message is a missing address, you can tell MS-DOS Kermit the
  226. address of the port by issuing the following command:
  227.  
  228.   SET COMn \xhhhh
  229.  
  230. where n is 1, 2, 3, or 4, and hhhh are four hexadecimal digits (0-9, A-F)
  231. representing the 16-bit address.  This command not only informs Kermit of the
  232. address, but also inserts the address into the BIOS so other programs can find
  233. the port (if they follow the rules), and so you don't have to give this
  234. command to Kermit again until after the next time you reboot.
  235.  
  236. After giving the SET COMn command, give a SET PORT COMn command for the same
  237. port, e.g.:
  238.  
  239.   set com3 \x3f8   ; FIRST specify the address of COM3 
  240.   set port com3       ; THEN select COM3
  241.  
  242. How do you know what addresses to give?     If have purchased an internal modem
  243. or an add-on serial port, the installation instructions should tell you.  The
  244. device must be configured -- generally by setting little switches or
  245. installing or removing jumpers.     You have to make sure that the address that
  246. you have chosen agrees with the address that Kermit will use.
  247.  
  248. Although it is not recommended that you guess at address values, sometimes it
  249. is the only way (as often with inherited equipment), for which occasions here
  250. is a list of the addresses commonly used for serial ports and internal modems:
  251.  
  252.   Port     Likely Addresses (hexadecimal)
  253.   COM1         03F8
  254.   COM2         02F8
  255.   COM3         03E8, 3220 (PS/2)
  256.   COM4         02E8, 3228 (PS/2), 02E0
  257.  
  258. You probably won't find a serial port at any address not listed above, but you
  259. might find a port at another port's expected address.  The use of these
  260. addresses in SET COMn commands should be relatively harmless (provided you
  261. don't also specify an interrupt, explained later); if there is no error
  262. message, Kermit found a possibly usable port. If there is an error message, no
  263. harm should have been done.
  264.  
  265. Now let's look at the other cause for the "This port will be operated through
  266. the BIOS" message, namely that an address was found in segment 40, but the
  267. device at that address does not appear to be a genuine serial port.
  268. Explanations might include:
  269.  
  270.  1. The device is at a different address.  Check your device's configuration
  271.     again, or else your SET COMn command.
  272.  
  273.  2. Your device is indeed at the given address, but its registers do not
  274.     contain values expected of a true PC serial port.  In that case, BIOS
  275.     operation is the only alternative.
  276.  
  277.  3. Your device is at the given address, but there is a conflict with another
  278.     device at that address or the machine's bus speed (not CPU speed) is set 
  279.     so high that the hardware test gave confusing results.
  280.  
  281. When Kermit operates a port through the BIOS, rather than directly, it will be
  282. MUCH slower and might not work at all because the BIOS requires the CD, CTS,
  283. and DSR modem signals to be asserted by the device connected to the port (and
  284. the CD signal is normally NOT asserted by a modem before it has made a
  285. connection to another modem).  In that case, you will have to configure the
  286. device (e.g. modem) to assert DSR, CTS, and CD always, or wire your modem
  287. cable to fake these signals (e.g. by connecting CD and DSR together).
  288.  
  289. Assuming you have found the right address for your COM3 or COM4 port (or
  290. nonstandard address for COM1 or COM2), and you want these addresses to be set
  291. correctly for Kermit at all times, even if it doesn't read its initialization
  292. file, you can put a command like the following in your AUTOEXEC.BAT file:
  293.  
  294.   set kermit=com3 \x3e8; com4 \x2e8;
  295.  
  296. INTERRUPTS
  297. [Not applicable to Victor;  included for information]
  298.  
  299.   "I can send characters to the modem, but I never see any on my screen."
  300.  
  301. This complaint (often arising from the user's observation of the modem lights
  302. and speaker), also known as "can-talk-but-not-listen syndrome", usually means
  303. that the communication device was found at the expected address, but Kermit's
  304. idea of its interrupt is wrong.     What's an interrupt?
  305.  
  306. To achieve high-speed communication without impacting other applications,
  307. Kermit reads characters from a serial device using "interrupts".  Whenever a
  308. character arrives at the serial device, the device sends a signal, called an
  309. interrupt, that can be "caught" by application software like Kermit, leaving
  310. the application free to do other work in the meantime without having to
  311. constantly look at the serial port to see if any characters have arrived (an
  312. operation called "polling", which is used by some other communications
  313. programs).  Communications programs that use polling are not sensitive to
  314. interrupts being set improperly and might therefore work with improperly-
  315. configured machines where Kermit will not (until you give it the required
  316. information), but they also tend to take over the entire computer.
  317.  
  318. In contrast to polling programs, Kermit is normally waiting for input from the
  319. keyboard, and is therefore idle if you are not typing and no characters are
  320. arriving at the communication port.  In multi-tasking environments such as
  321. Windows or OS/2, this allows other applications the largest possible share of
  322. the CPU while Kermit is running.
  323.  
  324. When a character arrives at the port, an interrupt signals Kermit to wake up
  325. from its keyboard-wait state and read the character from the port.  But Kermit
  326. needs a way of knowing which device the interrupt came from, so it will not
  327. erroneously read characters from the wrong one.  The device is identified by
  328. an Interrupt Request (IRQ) number, a small number like 3 or 4.  The BIOS does
  329. not record the IRQ number used by a serial port because the BIOS uses polling
  330. rather than interrupts.  The communications software has to know which IRQ to
  331. use.  By convention from the original IBM PC, COM1 uses IRQ 4 and COM2 uses
  332. IRQ 3.  There is no standard for COM3 and above, but certain conventions are
  333. normally followed:
  334.  
  335.   Port     PS/2  Others
  336.   COM3     IRQ3    IRQ4
  337.   COM4     IRQ3    IRQ3
  338.  
  339.   WARNING: Certain serial port cards and internal modems allow
  340.   themselves to be configured with different IRQ numbers (such as 9),
  341.   even on COM1 or COM2.     Check your device's installation instructions.
  342.  
  343. Some types of PCs (PS/2s, for example) allow sharing of IRQ numbers, provided
  344. each application has its own interrupt service routine and each such routine
  345. is built to "chain" interrupts properly (i.e. pass them along to other
  346. applications if they have arrived at the wrong place).  This works, for
  347. example, with Kermit on a PS/2; you can run two copies of Kermit under
  348. Windows, one using COM2/IRQ3 and the other using COM3/IRQ3 (i.e. two ports,
  349. same IRQ), both doing input and output simultaneously with no confusion.  But
  350. on most types of PCs, IRQs can NOT be shared, so each device must have a
  351. unique IRQ number. This caution applies especially when you have a serial
  352. mouse on IRQ 3 or 4.
  353.  
  354. Once Kermit knows the COM port's address, it tests to see which IRQ number, 3
  355. or 4, the device uses.  This is a safe test and doesn't cause any modem
  356. signaling or communication to take place.  The PC architecture has a limited
  357. range of IRQ numbers available, and so (usually) there can not be a unique IRQ
  358. number for each serial port when there are more than two, so in most cases no
  359. more than two serial ports can be active at once.
  360.  
  361. MS-DOS Kermit tests first for IRQ4, and then if there is no response, IRQ3.
  362. If both tests fail, a default value is used (on PS/2s, the default is IRQ4 for
  363. COM1 and IRQ3 for COM2-4; on others is it is IRQ4 for COM1 and COM3, IRQ3 for
  364. COM2 and COM4).     No error message is given in this case, but
  365. "can-talk-but-not-listen syndrome" is a likely result.
  366.  
  367. Some add-on communication boards or internal modems are set up to use IRQ
  368. numbers other than 3 or 4 in order to avoid conflicts with COM1 or COM2 and/or
  369. to allow more than two COM ports to be active at once. But this can be
  370. dangerous -- for example, IRQ 5 (which is often used for this purpose) is also
  371. used by the hard disk controller on the PC/XT.  IRQ 7 is often used by network
  372. boards.  For this reason, Kermit does not automatically test any IRQ numbers
  373. other than 3 or 4, and does not use any other IRQ number by default.
  374.  
  375. But it is sometimes necessary, particularly on ISA (Industry Standard
  376. Architecture) bus machines (PC/ATs and compatibles) and earlier (such as PCs
  377. and XTs) to use an IRQ other than 3 or 4, for example when when an internal
  378. modem is installed as COM3 on IRQ4, and then use of COM1 prevents COM3 from
  379. working, and vice versa.  This problem can often be solved by reconfiguring
  380. the board to use an otherwise unused unique IRQ number.  Ideally this would be
  381. a normally free IRQ such as 10 or 11, but unfortunately most communication
  382. boards are not configurable for IRQs higher than 7.  Here is a brief, and
  383. definitely not comprehensive, guide to the low IRQ numbers (with IRQ numbers
  384. expressed in decimal):
  385.  
  386.      2    Normally available, but some video boards use it to obey an obsolete
  387.     standard for indicating vertical refresh.  Adjust video board jumpers
  388.     to not do this.     On 286's and above, IRQ 2 is also known as IRQ 9:
  389.     same IRQ, alternate number.  Windows 3.0 had difficulty with devices
  390.     using IRQ 2, but Windows 3.1 is better.
  391.  
  392.      3    Normally COM2 and COM4.     PS/2's use IRQ 3 for all serial ports above
  393.     COM1.  IRQ3 is also a favorite "factory default" of many local area
  394.     network (LAN) adapters.
  395.  
  396.      4    Normally COM1 and informally COM3 (except on PS/2s).
  397.  
  398.      5    Secondary parallel port.  Parallel ports are rarely interrupt-driven
  399.     (except for Novell RPRINTER users) so this wire becomes free if
  400.     you unjumper the IRQ on the parallel port board.  LAN adapters are
  401.     frequently placed on IRQ 5.  PC/XTs use IRQ 5 for the hard disk.  Be
  402.     careful with this one.
  403.  
  404.      6    Floppy disk drives. Leave it alone!
  405.  
  406.      7    Primary parallel port.    Remove as described for IRQ 5.    Be careful,
  407.     LAN adapters are frequently placed here.
  408.  
  409.      9    Alias for IRQ 2.
  410.  
  411.     10    Usually free.
  412.  
  413.     11    Usually free.
  414.  
  415.     12    Used by the IBM bus mouse, otherwise usually free.
  416.  
  417.     13    Math coprocessor errors are trapped here, otherwise frequently free.
  418.  
  419.     14    Used by hard disk on 286 and above.  Leave alone!
  420.  
  421.     15    Some SCSI controllers use this.     Usually free.
  422.     
  423. If your communication board uses an IRQ other than 3 or 4, you will experience
  424. the "can talk but not listen" syndrome when using Kermit.  To fix it, simply
  425. inform Kermit of the device's IRQ number.  This is done in the SET COMn
  426. command, after the address:
  427.  
  428.   SET COMn <address> <irq>
  429.  
  430. for example:
  431.  
  432.   SET COM3 \x03e8 5
  433.  
  434. When you include a number (like 3, 4, 5, 6, or 7) after the port address
  435. (separated by a space), Kermit skips its IRQ test and uses the IRQ number you
  436. specified the next time you give a SET PORT command for that port.
  437.  
  438.   AVOID address and IRQ conflicts; these items MUST NOT overlap existing
  439.   equipment. SERIOUS DAMAGE can result if, for example, the IRQ number you
  440.   give is the same as the one used by your disk controller or network
  441.   adapter.  Incorrect operation can result if the interrupt is in use by a
  442.   less critical device, such as a mouse.
  443.  
  444. It is necessary to specify the IRQ number in either of these two situations:
  445.  
  446.   1. The communication device uses an IRQ number other than 3 or 4.
  447.  
  448.   2. Kermit's IRQ test interferes with Windows or a similar environment.
  449.  
  450. Check your PC's configuration carefully before specifying an IRQ number.
  451. Before starting Kermit, you can use certain public domain or commercial
  452. utilities, such as MAPMEM, Northgate QAPLUS, Quarterdeck MFT, or the MSD
  453. utility shipped with Windows 3.1 to get an idea of which IRQ numbers are
  454. already in use (these utilities are, of course, not foolproof -- for example,
  455. they can't tell what IRQs are used by programs that are not presently loaded).
  456.  
  457. If, even after establishing the device's interrupt, Kermit still fails to
  458. operate correctly (or reliably), check to see whether:
  459.  
  460.   1. Some other device (such as a mouse or LAN adapter) is generating the 
  461.      same interrupt.
  462.  
  463.   2. Some other software (such as a mouse or video driver) is catching the 
  464.      same interrupt.
  465.  
  466. If you find a conflict, you'll have to resolve it: remove the offending device
  467. driver or TSR from your CONFIG.SYS or AUTOEXEC.BAT file or turn it off
  468. temporarily (e.g. with the MOUSE OFF command for certain mouse drivers); or,
  469. if possible, reconfigure one of the conflicting devices to use a different
  470. interrupt.
  471.  
  472. Example: A PC (not PS/2) is delivered with a serial mouse on COM1 and with
  473. COM2 as a free serial port.  COM2 can be used with an external modem, but you
  474. can't put an internal modem on COM3 because its IRQ conflicts with the mouse
  475. and the COM4 address clashes with an 8514/A video adapter (such as the ATI
  476. Ultra+).  Neither the mouse interrupt nor the video board address can be
  477. changed.  So to install an internal modem, you must remove the serial mouse
  478. and driver and, if you need a mouse, replace it with a bus mouse.
  479.  
  480. PROBLEMS WITH MODEMS
  481.  
  482.   "I just bought and installed an XYZ V-Dot-Everything internal modem, and
  483.   it works with <name-deleted> communication package, but not with Kermit".
  484.  
  485. This has long been a common complaint about internal modems.  The same
  486. complaint is also now being heard with alarming frequency about some of the
  487. newer external modems.  With internal modems, particularly when they are
  488. installed on COM3 or COM4, the most common problems are:
  489.  
  490.  1. Kermit doesn't know the modem's address, or the device is using an IRQ
  491.     number other than 3 or 4.  These problems can be fixed by giving the
  492.     appropriate SET COMn command to Kermit.
  493.  
  494.  2. The internal modem is installed incorrectly, with an address or IRQ that
  495.     conflicts with one already in use on your PC.
  496.  
  497.  3. The internal modem does not correctly emulate a real IBM PC serial port,
  498.     and therefore fails Kermit's hardware test, and therefore can only be
  499.     used through the BIOS.
  500.  
  501.  4. The device is in a laptop, notebook, or palmtop computer, and power to 
  502.     the internal modem or serial port has been disabled in the CMOS setup,
  503.     or has been turned off automatically when the cover is closed or the
  504.     machine shut down.
  505.  
  506. In mid-1992, a new generation of low-cost, high-speed modems, both internal
  507. and external, began to appear on the market.  These modems typically offer a
  508. wide range of features: V.32 and V.32bis modulation, V.42 and MNP error
  509. correction, V.42bis and MNP data compression, etc.  Unfortunately, many of
  510. these modems suffer from bugs not found in earlier modems.  The problems are
  511. generally related to initialization of the modem and interaction with its
  512. command processor.  Some common complaints:
  513.  
  514.  1. "The modem won't dial or respond to commands".  Or the modem ignores
  515.     commands when Kermit's PARITY is set to a particular value, like EVEN.  Or
  516.     commands are not processed correctly above a certain interface speed.
  517.  
  518.  2. "I can dial successfully, and in general send characters to and through
  519.     the modem, but I never get any characters back."  This looks suspiciously
  520.     like the "talk-but-not-listen" problem, but in some cases it is a bug in,
  521.     or a configuration problem with, the modem, having nothing to do with
  522.     Kermit: the modem is simply not sending any characters to the PC.
  523.  
  524.  3. "After using the modem with <name-omitted> communication software, it
  525.     also works with Kermit, but it won't work with Kermit unless I run
  526.     <name-omitted> first."
  527.  
  528.  4. "I can communicate in command-mode with the modem, up until I give it
  529.     an ATZ command, at which point it seems to die."
  530.  
  531.  5. The modem does not pass the BREAK signal.
  532.  
  533.  6. The DSR signal goes off after successful dialing.
  534.  
  535. And so on.  All of these are modem, not Kermit, problems.  Some suggestions
  536. for overcoming them:
  537.  
  538.  1. Before giving a DIAL command, which invokes a macro containing OUTPUT
  539.     commands for the modem's command processor, give the command:
  540.  
  541.     SET OUTPUT PACING <milliseconds>
  542.  
  543.     For example:
  544.  
  545.     SET OUTPUT PACING 100
  546.     OUTPUT AT Q0 E1 V1 &F\13
  547.  
  548.  2. External modems only: Check that your modem cable has wires for (at least)
  549.     the TD, RD, SG, CTS, RTS, DSR, CD, and DTR RS-232 signals.    If it does
  550.     not, replace the cable with a real modem cable, or (temporarily) configure
  551.     your modem to compensate for the missing signals.
  552.  
  553.  3. Read your modem manual and check your modem's configuration.  Perhaps its
  554.     interface speed is locked to a different speed than the one Kermit is
  555.     using.  Perhaps Kermit is set to use RTS/CTS flow control, but the modem
  556.     is not asserting CTS.  Also, check its factory and/or saved settings, and
  557.     under what conditions they are restored (for example, are they restored
  558.     when the PC drops DTR?).  How are you selecting saved settings -- read
  559.     your modem manual about (e.g.) the difference between AT&F and AT&F2.  Be
  560.     aware that the AT&Fn commands might not restore all S-registers, so double
  561.     check them.  Be particularly sensitive to the registers that control
  562.     interface speed, modulation technique, error correction, data compression,
  563.     negotiation, and fallback, and note that each modem maker probably uses
  564.     different registers and commands to control each of these features.
  565.  
  566.  4. Try the following sequence to initialize the port (using COM3 in this
  567.     example):
  568.  
  569.     SET COM3 <address> <irq>    ; (if necessary)
  570.     SET PORT 3            ; Select port 3
  571.     HANGUP                ; Drop DTR on port 3
  572.     SET PORT 3            ; Re-initialize port 3
  573.  
  574.  5. SET PARITY NONE when talking to the modem, and then set parity to whatever
  575.     the remote host or service requires after making the connection.  (NOTE:
  576.     MS-DOS Kermit might set its parity to some other value automatically as a
  577.     result of automatic parity detection during file transfer.)
  578.  
  579.  6. Ensure your PC bus speed is 8MHz.  Some PCs (not PS/2s) come with a BIOS
  580.     SETUP facility that lets you change the PC's bus speed, memory wait
  581.     states, etc.  In general, it is dangerous to deviate from the defaults,
  582.     particularly from the 8MHz bus speed, a standard for add-on devices; it
  583.     might be required by your communication board or internal modem.
  584.  
  585.  7. Dial at a lower speed.  Make your interface speed match the modulation
  586.     speed -- e.g. use 9600 for V.32, 2400 for V.22bis, etc.  Turn off modem
  587.     error correction and compression.  etc etc.  NOTE: connection problems
  588.     between the two modems have nothing to do with Kermit and are beyond the
  589.     scope of this document.  If a modem appears to dial correctly, gets
  590.     connection tones, and then hangs up, it is a problem between the two
  591.     modems (involving one or both modems and/or the phone company), and
  592.     indicates a modem configuration problem, a bug, or a basic incompatibility
  593.     between the calling and answering modems.
  594.  
  595.  8. The ATZ problem.  If the modem doesn't work after an ATZ command, HANGUP
  596.     and the SET LINE again.  If that doesn't do it, power the modem off and on.
  597.  
  598.  9. If the modem can't be configured to pass the BREAK signal, but it does
  599.     correctly implement a command for sending BREAK, such as AT\B9, define
  600.     an MS-DOS Kermit macro, SBREAK, to send a BREAK as follows:
  601.  
  602.       define sbreak pause 1, output +++, pause 1, output ATB\{92}9\13, -
  603.     pause 1, output ATO\13, connect
  604.     
  605.     and assign it to the key of your choice, for example F1:
  606.  
  607.       set key \315 {Ksbreak}
  608.  
  609. 10. Call your modem maker's technical support number.  Ask if they have
  610.     replacement chips to fix bugs in your modem.
  611.  
  612. DISK INTERRUPT CONFLICTS
  613.  
  614. On certain PCs, Kermit file transfers (or terminal sessions that are being
  615. logged to disk) through serial communication devices (COM1 thru 4) can suffer
  616. from data loss during disk read/write operations.  This is apparently because,
  617. on these PCs, the entire interrupt mechanism is TURNED OFF during disk reads
  618. or writes.  Thus, while the disk driver is active, no interrupts are generated
  619. by incoming characters, and therefore they are likely to be lost (particularly
  620. if the UART does not have its own buffer).
  621.  
  622. If you experience data loss during uploads (watch the "Retries" counter), try
  623. sending the same file from a RAM disk; if the retries go away, your PC has
  624. this problem.  If downloads to disk have lots of retries, try downloading the
  625. same file to the NUL device (tell MS-DOS Kermit to RECEIVE NUL); same deal.
  626.  
  627. On some PC's, it has been observed that the disk-interrupt conflict occurs
  628. when using a certain COM port, but not a different one.  For example, on a
  629. PS/2 Model 70 A20, conflicts occur on COM2 but not COM1.
  630.  
  631. MS-DOS 5.0 AND 6.0
  632. [Not applicable to Victor;  included for information]
  633.  
  634. You should not use MS-DOS Kermit (or other communications software) under
  635. DOSSHELL.  Unlike Windows, DesqView, OS/2, etc, DOSSHELL is NOT a multitasking
  636. environment.
  637.  
  638. MICROSOFT WINDOWS, DESQVIEW, OS/2, ETC.
  639. [Omitted;  Not applicable to Victor]
  640.  
  641. VIDEO PROBLEMS
  642. [Not applicable to Victor;  included for information]
  643.  
  644. Kermit does not mix well with NNANSI.SYS, a public domain (or shareware?)
  645. console driver that replaces ANSI.SYS, and which implements "hardware
  646. scrolling", a case of two non-cooperating programs directly manipulating
  647. the video adapter at the same time!  Similar comments apply to other console
  648. drivers that access the screen directly, including ANSI.COM (from PC Magazine,
  649. circa 1988).
  650.  
  651. To turn off NNANSI.SYS's direct screen access, put the following commands in
  652. your MSCUSTOM.INI file:
  653.  
  654.   echo \27[=98l                  ; Reset "fast mode"
  655.   define on_exit echo \27[=98h   ; Set "fast mode"
  656.  
  657. SERIAL COMMUNICATIONS
  658. [UART discussion not applicable to Victor;  included for information]
  659.  
  660. On PCs with high-quality buffered UARTs, Kermit can be used at speeds up to
  661. 57600 bps under DOS (under Windows or DesqView, the maximum speed is probably
  662. lower).     115200 bps works only with a very short shielded cable, and the async
  663. adapters of the two machines in perfect tune.  Some VAX serial port interfaces
  664. are out of tolerance at 19,200 bps and faster.    Some of the new high-speed PCs
  665. (486s like, for example, the IBM PS/VP or the Gateway 2000) come with
  666. unbuffered UARTs.  Despite the speed of the CPUs, these new machines perform
  667. serial communications less reliably than older machines that run at 1/4 the
  668. speed or less, but that have buffered UARTs (like the PS/2-70).
  669.  
  670. MS-DOS Kermit will tell you whether you have a buffered UART:
  671.  
  672.   SET PORT 2
  673.   SHOW COMMUNICATIONS
  674.   ...
  675.   COM1 Address: Port \xf38, IRQ 4, 16550A UART FIFO
  676.  
  677. 16550A UART means you have the good kind, FIFO means it has a "First-In
  678. First-Out" buffer.  If Kermit does not say you have a 1655A UART FIFO, and you
  679. are suffering from performance or data loss problems, replace it (if
  680. possible!)  with a 16550A.
  681.  
  682. If your speed is set too high, the symptom might be lost or garbled characters
  683. or graphics images on the screen, or data-overrun beeps.  Normally flow control
  684. prevents these problems so use it if you can.  Printing while in CONNECT mode
  685. needs flow control to be active.
  686.  
  687. MS-DOS Kermit does not monitor the communication line for carrier loss during
  688. terminal emulation or file transfer.  You can SHOW MODEM or SHOW COMMUNICATIONS
  689. to inquire about CD, DSR, and CTS.  The script command WAIT permits sensing
  690. carrier presence in a script program.
  691.  
  692. The SHOW MODEM and WAIT commands work right only if your modem or other
  693. communication device is configured to raise and lower the DSR, CTS, and CD
  694. signals appropriately, and the cable that connects your PC to the modem passes
  695. these signals through.    For some modems, the factory setting is to always keep
  696. CD on, even if there is no connection.    Consult your modem manual.
  697.  
  698. For serial devices, the HANGUP command (and Ctrl-]H in CONNECT mode) works
  699. only if the cable that connects your PC to the communication device passes the
  700. DTR signal through, and if the communication device itself is configured to
  701. hang up or otherwise terminate the connection when the DTR signal is lowered
  702. by the PC.  For some modems, the factory setting is to ignore DTR transitions.
  703. Consult your modem manual (for example, tell a Hayes modem to "AT&D2").     NOTE:
  704. in version 3.11, the HANGUP command turned off DTR for about 1/2 second and
  705. then turned it back on again.  In version 3.12 and later, the HANGUP command
  706. turns off DTR until the next time you issue a command that accesses the serial
  707. port.  If you can't make the HANGUP command work, define a macro to send a
  708. hangup command to the modem, for example (for Hayes modems):
  709.  
  710.   DEFINE MYHANGUP PAUSE 1, OUTPUT +++, PAUSE 1, OUTPUT ATH0\13
  711.  
  712. and then use this macro in place of the regular HANGUP command.
  713.  
  714. TERMINAL EMULATION
  715.  
  716. Kermit's VT320/340 emulator lacks the following features:
  717.  
  718.  . Smooth scroll
  719.  . Downloadable soft fonts
  720.  . ReGis graphics (VT340/330)
  721.  . Dual sessions in split screens (VT340/330)
  722.  . Local screen editing and block transmission (for security reasons)
  723.  . True double height/width characters (these are simulated)
  724.  . Selective erasure (as a character attribute, a formatted screen item)
  725.  . Some of the exotic and rarely-used features of the DEC VT340/330 series:
  726.    formatted screen and graphics operations highly specialized to DEC hardware.
  727.  
  728. MS-DOS Kermit does not include "ANSI" or "PCTERM" emulation.  If you need
  729. this, as when logging in to a PC-based BBS, make sure you have the ANSI.SYS
  730. (part of DOS) console driver loaded, and then tell MS-DOS Kermit to SET
  731. TERMINAL TYPE NONE, SET PARITY NONE, and SET TERMINAL BYTESIZE 8, and make
  732. sure your PC's code page agrees with what the BBS thinks it is, otherwise
  733. box-drawing characters might come out looking like accented letters. Since
  734. Kermit's own terminal emulator is not active when your terminal type is NONE,
  735. the mode line, screen rollback, similar features are not available.
  736.  
  737. On certain "national keyboards", like the German one, Kermit's normal escape
  738. character, Ctrl-] (Control-Rightbracket) does not seem to work. This is because
  739. certain control characters are typed differently on these keyboards.  On the
  740. German keyboard, Ctrl-] is produced by holding down the Ctrl (Strg) key and
  741. pressing the + (plus) key.  MS-DOS Kermit has no way of knowing this, and
  742. continues to display the escape character as "^]" in the mode-line help text.
  743.  
  744. Kermit does not work with certain Swedish keyboard drivers because of a bug in
  745. the keyboard driver.  Workaround: use a different keyboard driver.  Reportedly
  746. there are several different Swedish keyboard drivers available.
  747.  
  748. Do not attempt to plug an "enhanced" (101) keyboard into a PC/XT or earlier.
  749. The BIOS on early PCs does not support the newer keyboards, even if you
  750. install the corresponding keyboard driver.
  751.  
  752. If VAX/VMS thinks you have a VT220 or VT320, it sends 8-bit control sequences.
  753. Kermit does not understand them unless you SET TERMINAL BYTESIZE 8.  The
  754. symptom is the appearance of fragments of escape sequences on the screen and
  755. wrong cursor positioning, and possibly fractured tab settings, particularly
  756. during EVE sessions.  You can prevent VMS from sending 8-bit control sequences
  757. (if you really do not have an 8-bit connection) by giving the VMS command SET
  758. TERMINAL /NOEIGHT.  For VAX/VMS, you should also use Xon/Xoff flow control in
  759. both directions (SET TERM /TTSYNC /HOSTSYNC on VMS).
  760.  
  761. In VT100/200/300 emulation on the IBM PC family, receipt of ESC [ 4 m (turn on
  762. underscore) results in a color change rather than underscore on IBM CGA, EGA
  763. and other color displays.  IBM display adapters have one less attribute than
  764. DEC monochrome terminals, and in addition the two systems intensify dots
  765. differently (IBM does foreground/character dots only, whereas DEC can
  766. illuminate any dot).
  767.  
  768. SET TERMINAL COLOR 1 [3xx 4xx] (used to make the foreground color bright), if
  769. issued when SET TERMINAL SCREEN REVERSE is in effect, reverts to normal video.
  770.  
  771. If certain incomplete escape sequences (e.g. Operating System Command) are
  772. received during terminal emulation, Kermit can hang waiting for the string
  773. terminator that never comes, usually because of noise on the communication
  774. line.  Reset the terminal emulator by pressing Alt-= (Alt-equals), the default
  775. key for \Kreset.
  776.  
  777. Kermit assumes 25 screen lines but can adapt to other lengths if it knows how
  778. to get this information from the video adapter.     There still might be some
  779. confusion about screen length when switching between text and graphics modes,
  780. or between 80 and 132 column mode, or escaping back from CONNECT mode, due
  781. primarily to lack of reliable or consistent information from the many different
  782. kinds of video adapters.
  783.  
  784. To get properly formatted screens during terminal emulation, be sure to inform
  785. the remote host of your screen width and length.
  786.  
  787. So that key translation and macros can work on both IBM and non-IBM compatible
  788. PCs, Kermit uses the system BIOS to obtain key scan codes.  But the IBM BIOS
  789. does not produce scan codes at all for certain keys, and may produce duplicate
  790. scan codes for others.    Num Lock, Print Screen, Scroll Lock, and Pause are
  791. examples.
  792.  
  793. When you PUSH to DOS (including when you use Kermit's RUN command), and you
  794. have XON/XOFF flow control enabled, Kermit sends an XOFF (Ctrl-S) to the host
  795. when you leave, and XON (Ctrl-Q) when you return (if you have RTS/CTS flow
  796. control enabled, Kermit turns off RTS).     This prevents data transmitted by the
  797. host from being lost.  However, if you are using Xon/Xoff and you do this
  798. while using the EMACS text editor on the host, the Ctrl-S will be interpreted
  799. as a Search command, and the Ctrl-Q as a Quote command.     When you return to
  800. EMACS, type several Ctrl-G's to get back to normal.
  801.  
  802. Similar comments about sending Xoff and Xon apply when Kermit is commanded
  803. to change its screen size between 80 and 132 columns.
  804.  
  805. Session logging can be turned on using the LOG SESSION command, and it can
  806. be toggled on and off during terminal emulation by using whatever keys are
  807. associated with the verbs \Klogoff and \Klogon.     One user stated the
  808. requirement to enable a session log, but to have it initially turned off.
  809. This can be done as follows (using the F1 and F2 keys as examples):
  810.  
  811.   SET KEY \315 {\Kloginit}  ; F1 to turn on log
  812.   SET KEY \316 \klogoff        ; F2 to turn log off
  813.   DEFINE loginit log session, set key \315 \klogon, define loginit, connect
  814.  
  815. To log your session to a printer, add the word PRN after "log session" in
  816. the third line above.
  817.  
  818. The session log is written to disk by DOS.  The frequency with which DOS
  819. updates this file is governed by the BUFFERS= line in your CONFIG.SYS file (see
  820. your DOS manual).  If you allocate a large number of buffers in CONFIG.SYS,
  821. disk operations occur infrequently and this improves performance.  If you need
  822. to have the session log updated more frequently to minimize the loss of data
  823. when there is a power failure, you can do this (at the expense of efficiency)
  824. by allocating a smaller number of buffers in CONFIG.SYS.
  825.  
  826. 132-COLUMN MODE
  827.  
  828. If you have a monitor with fixed horizontal frequency but a video adapter that
  829. Kermit knows how to switch into 132 column mode, you will see only garbage on
  830. your screen whenever Kermit switches to 132 columns.  There is no way to tell
  831. Kermit to ignore "switch to 132 columns" commands.  If you buy a
  832. 132-column-capable video adapter, be sure you have a compatible monitor.
  833.  
  834. GRAPHICS TERMINAL EMULATION
  835.  
  836. In earlier releases, MS-DOS Kermit responded to ESC 1 and ESC 2 for
  837. automatically switching into and out of Tektronix graphics mode, for the
  838. benefit of some long-forgotten host-based graphics software.  This feature
  839. has been discontinued because these escape sequences mean something entirely
  840. different, namely "switch character size" in VT340 Tek mode.
  841.  
  842. PS/2 Model 25 and 30 MCGA adapter is used in low-resolution CGA mode by
  843. default; images may be elongated or truncated.    Hi-resolution graphics can be
  844. done (as of version 3.11) via SET TERM GRAPHICS VGA, but the PC might not be
  845. able to keep up at speeds above 9600 bps.
  846.  
  847. When you type the escape character (normally Ctrl-]) while in Tektronix
  848. graphics mode, the screen goes back to text memory.  Then when you type the
  849. argument character, the graphics screen reappears (unless the argument was C or
  850. P).  Ctrl-]F will not file the graphics screen, but rather the text screen,
  851. because that's the screen that's showing after type the Ctrl-] key.  To file
  852. the graphics screen (in TIFF format), use \Kdump (normally on Ctrl-Keypad-End).
  853.  
  854. You can't dump the Tektronix screen while the GIN-mode crosshair cursor is
  855. active; Kermit's keyboard translator is not active.  Key strokes (of regular
  856. typewriter keys) or mouse actions are used to transmit the crosshair
  857. coordinates.  If you press a non-typewriter key, Kermit just beeps.
  858.  
  859. Kermit does not emulate a particular kind of color graphics terminal, such as a
  860. DEC ReGIS display or a Tektronix 41xx or 42xx series.  However, it can be used
  861. for color graphics by mixing ANSI color-setting escape sequences with Tektronix
  862. or Sixel commands.  This requires graphics software vendors adding support for
  863. MS-DOS Kermit graphics to their packages (so far, WordPerfect Corp has done
  864. this for their host-resident products).  There is at least one ReGis-to-Sixel
  865. converter on the market: RETOS, a DEC product for VAX/VMS.
  866.  
  867. Problems may occur when using Kermit with host-resident (VAX/VMS) versions of
  868. WordPerfect because the color palette report sent upon request of WordPerfect
  869. is very long. If the host is not configured properly, parts of the report will
  870. be lost because of overruns on the VMS side.  SET TERM /HOSTSYNC and /TTSYNC
  871. are required for WP/VMS.  Even then intervening communication boxes (e.g.
  872. terminal servers) can become overloaded with the 200++ byte response.
  873.  
  874. PRINTER SUPPORT
  875.  
  876. Kermit uses DOS services for printing. There is no knowledge of particular
  877. printer types in Kermit.  Kermit determines whether the printer is ready, or
  878. whether there has been a printing error, via DOS's return code.  If DOS tells
  879. Kermit the printer is not ready, Kermit changes the printer device name to NUL
  880. so subsequent print operations won't block.  To reenable printing operations
  881. (e.g. after turning on the printer, adding paper, etc), use a SET PRINTER
  882. command such as SET PRINTER PRN or SET PRINTER LPT1.
  883.  
  884. The Print Screen and Shift-PrintScreen keys are never seen by Kermit.  They
  885. are intercepted and acted upon by the BIOS.  Thus Kermit has no control over
  886. the format of the printed output.  For example, a formfeed is not added to the
  887. end to force a page eject.  If you want to print the current screen with a
  888. formfeed at the end, use the following procedure:
  889.  
  890.   SET DUMP PRN    ; Specify that screen dumps go to the printer
  891.  
  892. and then use the \Kdump keyboard verb to accomplish the screen dump.  This
  893. verb is assigned by default to the keypad Ctrl-End key, but you can assign it
  894. to another key of your choice (but not Print Screen), for example:
  895.  
  896.   SET KEY \315 \Kdump  ; Assign screen dump to F1
  897.  
  898. (Shift-)Printscreen can cause the PC to hang if there is no attached printer.
  899. This is a BIOS feature, Kermit never receives the command.  If this happens
  900. during terminal emulation, try pressing Alt-= (hold down Alt and press the "="
  901. key) several times to reset the terminal emulator.
  902.  
  903. Serial printers are not well supported by DOS, and since Kermit does all its
  904. printing through DOS, Kermit's printing features might not work well with
  905. serial printers.  To use a serial printer effectively, you must have a driver
  906. for it that takes care of flow control, such as MSPSPD, available on the
  907. MS-DOS Kermit Utilities and Technical Documentation diskette.
  908.  
  909. Transparent printing starts when the host sends the sequence ESC [ 4 i and
  910. stops when the host sends ESC [ 5 i.  All characters, including escape
  911. sequences, that arrive at the port are passed directly to the printer without
  912. translation (but the parity bit is stripped if Kermit's parity is not NONE).
  913. If character translation is desired, or it is desired not pass screen-control
  914. escape sequences to the printer, use Autoprint rather than Transparent print
  915. (ESC [ 0 i, ESC [ ? 4 i, ESC [ ? 5 i).    In that case, characters are translated
  916. to the current IBM code page.  If your printer doesn't support your IBM code
  917. page, you need an external utility to translate from the PC code page to the
  918. printer's character set.  You can use SET PRINTER xxxx to capture Transparent
  919. print or Autoprint data into a file.
  920.  
  921. INTERNATIONAL CHARACTER SETS
  922.  
  923. MS-DOS Kermit does not directly support Cyrillic terminal sets; that is, you
  924. can't set your TERMINAL CHARACTER-SET to a Cyrillic set.  However, you can
  925. still have a Cyrillic terminal session if you have a Cyrillic code page loaded
  926. and you have issued the appropriate collection of SET KEY and SET TRANSLATE
  927. INPUT commands (see the CYRILLIC directory on the distribution diskette).
  928.  
  929. MS-DOS Kermit does not support Japanese Kanji character-set translation during
  930. terminal emulation.  However, version 3.13 does support the Kanji video mode
  931. used on IBM-compatible DOS/V PCs, which allows Kanji terminal emulation if
  932. the remote character set happens to be Shift-JIS (CP982).
  933.  
  934. Character-set translation during terminal emulation is done between the remote
  935. TERMINAL CHARACTER-SET and the PC's current code page. During file transfer,
  936. it's between the TRANSFER CHARACTER-SET and the PC's code page.  At startup,
  937. MS-DOS Kermit asks DOS to report the current code page, and it sets your FILE
  938. CHARACTER-SET and your TERMINAL CODE-PAGE to this value.  But DOS often lies
  939. about the code page, so in most cases when your actual code page is anything
  940. but 437 (or maybe 850), you, yourself, will have to tell MS-DOS Kermit what
  941. your code page *really* is, using the following two commands:
  942.  
  943.   SET TERMINAL CODE-PAGE CPnnn ; Your actual current code page.
  944.   SET FILE CHARACTER-SET CPnnn ; The code page for incoming text files.
  945.  
  946. The two would normally be the same, but MS-DOS Kermit lets you set them
  947. differently if you want to, for example if you have a Hebrew code page loaded
  948. for display purposes, but you want to download a Russian file that you will
  949. display later, after loading a Cyrillic code page.
  950.  
  951. MS-DOS Kermit does not allow all possible combinations of FILE and TRANSFER
  952. character sets.     The Hebrew code page (CP862) forces the Hebrew transfer
  953. character set, and vice-versa.    Similarly for Cyrillic and Latin-2, etc.
  954. Latin-1, however, can be used with many code pages: 437, 850, 861, 863, 865.
  955.  
  956. Some of the ISO 2022 or DEC-specific character-set designation escape
  957. sequences, which *do* work correctly, nevertheless fail to have an effect on
  958. the character-set field of the SHOW TERMINAL display.
  959.  
  960. LOG SESSION records characters that arrive at the serial port, before
  961. translation by either Kermit's built-in terminal character set translation
  962. tables or by user-specified SET TRANSLATION INPUT commands.  This allows
  963. REPLAY to work correctly but it prevents special characters from being logged
  964. after translation to the PC's own character set.  Screen dump (Ctrl-End or
  965. Ctrl-]F) and autoprint, however, record the translated characters.
  966.  
  967. SET TERMINAL CHARACTER SET is effective only for text screens, not for
  968. graphics screens.  This is because the fonts for all the special characters
  969. have not been designed yet (and may never be, and even if they are, they would
  970. require a lot of memory).
  971.  
  972. International characters in macro names are not case independent.
  973.  
  974. Case-independent string matching operations (e.g. SET INPUT CASE IGNORE,
  975. IF EQUAL xxx yyy) won't necessarily work with international characters.
  976.  
  977. COMMAND PROCESSING
  978.  
  979. When a command field begins with the @ (at-sign) character, the following
  980. characters are interpreted as a filename that contains the rest of the
  981. command.  If you need to type a command field that actually starts with @, or
  982. respond to an ASK or ASKQ query with text that starts with an atsign, you have
  983. to encode the atsign as \64 or \{64}.
  984.  
  985. \B in an OUTPUT command tells Kermit to send a BREAK.  \L Tells Kermit to
  986. send a Long BREAK.  If you need to output \B or \L literally, use two OUTPUT
  987. statements, e.g.:
  988.  
  989.   define xbreak pause 1, output +++, pause 1, output AT\92, output B, -
  990.     pause 1, output ATO\13, connect
  991.   set key <key-of-your-choice> {\Kxbreak}
  992.  
  993. Notice that the backslash itself is written as "\92" to output it literally.
  994.  
  995. Certain commands, such as RUN, DIRECTORY, TYPE, etc, invoke COMMAND.COM
  996. "underneath" Kermit, and COMMAND.COM might, in turn, invoke other programs.
  997. If you get the message "Can't run program" in response to such a command, it
  998. usually means there is not enough memory.  But you should also check your
  999. SHELL environment variable.
  1000.  
  1001. If you include the word STAY anywhere on the Kermit command line, e.g.:
  1002.  
  1003.   kermit echo stay
  1004.  
  1005. it is interpreted as a STAY command.
  1006.  
  1007. A command file that contains lines or commands too long for DOS's line buffer
  1008. (usually 128 characters) can hang your PC: a DOS problem, not a Kermit problem.
  1009.  
  1010. Commands in command files can be continued by including "-" as the last
  1011. character on the line, but NOT if the line ends with a trailing comment.  In
  1012. other words, you can't have a trailing comment on a continued line. If you
  1013. need to end a line with a dash, but the dash is part of the command rather
  1014. than a continuation symbol, use \45 instead or add a trailing comment.
  1015.  
  1016. Trailing comments can be used only in command files.  All text starting with
  1017. the first semicolon through the end of line is ignored.     If you need to include
  1018. an actual semicolon in a command, precede it with a backslash (\;).
  1019.  
  1020. The name and password that you specify in SET SERVER LOGIN must be matched
  1021. exactly by the ones in REMOTE LOGIN.  Case matters.  If you need to include
  1022. spaces within the username, password, or account field of the REMOTE LOGIN or
  1023. SET SERVER LOGIN commands, surround the field with {braces}.
  1024.  
  1025. DISABLE ALL is not equivalent to all the other DISABLE commands given
  1026. separately.  For example, DISABLE DELETE restricts REMOTE DELETE commands from
  1027. the client to working only in the MS-DOS Kermit server's current directory,
  1028. while DISABLE ALL prevents all types of modifications to the PC's file system,
  1029. including file deletion and creation.
  1030.  
  1031. KEY MACROS
  1032.  
  1033. Key macros are executed while in CONNECT mode. If you assign the \Khangup verb
  1034. to a key, Kermit remains in CONNECT mode after the hangup takes place.  On a
  1035. serial dialup connection, Kermit turns off the DTR signal, and you should see
  1036. a confirmation message from the modem, such as NO CARRIER, on your screen.  On
  1037. a TCP/IP network connection, however, Kermit does indeed drop the connection,
  1038. but since Kermit is still in CONNECT mode, it is immediately reestablished.
  1039. If you want to terminate a network session by pressing a key, use a method
  1040. that leaves CONNECT mode.  You can do this by defining a macro to hang up, and
  1041. then assigning execution of the macro to the key, e.g. Alt-d:
  1042.  
  1043.   define xxx hangup
  1044.   set key \2336 {\Kxxx}
  1045.  
  1046. This causes Kermit to return from CONNECT mode and execute the macro without
  1047. returning to CONNECT mode.  This technique works for both serial and network
  1048. connections.
  1049.  
  1050. To assign several verbs to a single key, use braces as in this example:
  1051.  
  1052.   set key \315 {\{Kgold}\{KdecF13}}
  1053.  
  1054. or this:
  1055.  
  1056.   set key \315 {\{Kfoo}\{Kdump}\{Kbar}}
  1057.  
  1058. in which "foo" and "bar" are macro names, and \Kdump is Kermit's screen-dump
  1059. verb.
  1060.  
  1061. FILE TRANSFER
  1062.  
  1063. SET EOF CTRL-Z, when used with text files that actually contain Ctrl-Zs, might
  1064. result in gaps or truncation in the vicinity of the Ctrl-Z.  This is a DOS
  1065. "feature".
  1066.  
  1067. When using Kermit through a terminal server (particularly those that execute
  1068. the TCP/IP Telnet protocol), or directly through a SET PORT TCP connection, it
  1069. is sometimes necessary to SET PARITY SPACE for file transfer. It is sometimes
  1070. impossible to use very long packets with terminal servers.  Try SET RECEIVE
  1071. PACKET-LENGTH 80, working up or down to the longest length that works.
  1072.  
  1073. REMOTE TYPE and other REMOTE commands resulting in an error "Unable to open
  1074. CON": insufficient FILES= in CONFIG.SYS.  FILES= should be at least 20.
  1075.  
  1076. MS-DOS Kermit uses the program named in the DOS Environment command line
  1077. starting as SHELL= as a replacement for COMMAND.COM.  Such a line is seen by
  1078. typing SET at the DOS prompt, and it is not associated with the SHELL= line
  1079. appearing in file CONFIG.SYS.
  1080.  
  1081. The MS-DOS Kermit command REMOTE SET BLOCK-CHECK will generally have no effect
  1082. upon a remote server unless the SET BLOCK-CHECK is also given locally to
  1083. MS-DOS Kermit.
  1084.  
  1085. The host prompt for TRANSMIT is a single character (SET TRANSMIT PROMPT).  It
  1086. is not possible to specify a multi-character or varying transmit-prompt.
  1087.  
  1088. SCRIPT PROGRAMMING
  1089.  
  1090. The terminal emulator is not active during execution of script commands such
  1091. as INPUT and OUTPUT.  This means:
  1092.  
  1093.  1. If the host sends the escape sequence that tells the terminal to identify
  1094.     itself, it is ignored.  You have to put the appropriate INPUT and OUTPUT
  1095.     commands in your script program.  Here is a macro to set your terminal type
  1096.     in Kermit and to set up the appropriate response string as well as terminal
  1097.     type string:
  1098.  
  1099.     def term if not def \%1 def \%1 vt320,-
  1100.      set term type \%1,-
  1101.      if error end 1,-
  1102.      assign _ttype \%1,-
  1103.      if eq \%1 vt320 assi _tid \27[\{63}63\;1\;2\;4\;8\;9\;15c,-
  1104.      if eq \%1 vt220 assi _tid \27[\{63}\62\;1\;2\;4\;8\;9\;15c,-
  1105.      if eq \%1 vt102 assi _tid \27[\63\;6c,-
  1106.      if eq \%1 vt100 assi _tid \27[\63\;1c,-
  1107.      if eq \%1 vt52  assi _tid \27/Z
  1108.  
  1109.     Whenever you switch terminal emulations, do "term vt102" instead of "set
  1110.     term type vt102" (substitute your preferred terminal type).     In any script
  1111.     that responds to ESC Z (or whatever), have it "output \m(_tid)", and any
  1112.     prompt that asks for your terminal type you can "output \m(_ttype)".  And
  1113.     be sure to execute a "term" command in your MSKERMIT.INI file, so your
  1114.     initial terminal type is set.
  1115.  
  1116.  2. A host-generated escape to put the terminal in Tektronix mode has no
  1117.     effect.  Put explicit SET TERMINAL TYPE TEK commands in the appropriate
  1118.     places in your script program.
  1119.  
  1120.  3. Screen formatting escape sequences have no effect.    If you have SET INPUT
  1121.     ECHO ON, they are simply displayed as-is.
  1122.  
  1123. If the remote host is sending ANSI (VTxxx) escape sequences during execution of
  1124. the script program, then users of IBM PCs can use the ANSI.SYS or similar
  1125. console driver to interpret the escape sequences.  This is particularly useful
  1126. when running a script that logs in to a full-screen system, such as an IBM
  1127. mainframe through a protocol converter.     But beware: ANSI.SYS is not totally
  1128. compatible with Kermit's VT emulator, and it may produce unwanted side effects,
  1129. the most annoying of which is suddenly popping your PC into 40-column mode!  If
  1130. you experience difficulties with your screen display while using Kermit script
  1131. programs, use SET INPUT ECHO OFF.  Or remove ANSI.SYS from your CONFIG.SYS file
  1132. and reboot.
  1133.  
  1134. PAUSE, WAIT, and similar commands also cause port input to be echoed to the
  1135. screen if INPUT ECHO is ON.  Use SET INPUT ECHO OFF to defeat this effect.
  1136.  
  1137. If the REINPUT command fails to find the requested text in the INPUT command
  1138. buffer, it will wait (up to the timeout interval) for more characters to
  1139. arrive from the communication channel.
  1140.  
  1141. INPUT / REINPUT combinations will not work if the INPUT buffer is smaller than
  1142. the amount of text that separates the INPUT text from the REINPUT text.  You
  1143. can increase the size of the INPUT buffer by including the desired size in
  1144. your KERMIT=INPUT <size> environment variable.  The default size is 256 bytes.
  1145.  
  1146. Script programming hint: To test whether a readable floppy disk is available
  1147. in drive A:, do this:
  1148.  
  1149.   SPACE A:
  1150.   IF FAILURE ECHO No diskette in drive A:.
  1151.  
  1152. The ON_EXIT macro is intended only for automatic execution when MS-DOS Kermit
  1153. exits.  It only works once, to prevent recursion (as would happen, for
  1154. example, if you put an EXIT command in your ON_EXIT definition).
  1155.  
  1156. MEMORY MANAGEMENT
  1157. [Not applicable to Victor;  included for information]
  1158.  
  1159. MS-DOS Kermit, like any DOS or Windows program, is likely to misbehave if your
  1160. PC memory is insufficient or is incorrectly configured.  MS-DOS Kermit runs in
  1161. conventional memory (the first 640K [on the Victor, as much as 896k]) of your
  1162. PC.  It occupies about 280K initially, and then allocates additional memory as
  1163. needed for rollback screens, file-transfer packet buffers, etc.  Kermit uses
  1164. additional memory to execute certain commands such as TYPE and DIRECTORY, for
  1165. which it invokes a second copy of COMMAND.COM (appoximately 30K) in conventional
  1166. memory, as well as RUN, which can invoke not only COMMAND.COM, but an additional
  1167. program to be run by COMMAND.COM, for example "run edit".  If there is
  1168. insufficient memory, these operations will not work; thus it is always best to
  1169. have as much free conventional memory as possible.
  1170.  
  1171. Memory for file-transfer packets is allocated at the time the transfer begins,
  1172. based on the current sliding-window size (SET WINDOW) and packet-length (SET
  1173. RECEIVE PACKET-LENGTH), and is deallocated when the transfer ends.  So SHOW
  1174. MEMORY won't reveal the effect of the packet buffers.  If insufficient memory
  1175. is available for the requested window size and packet length, MS-DOS Kermit
  1176. automatically reduces its RECEIVE PACKET-LENGTH.  Conventional memory is
  1177. always used for packet buffers. Thus packet buffers and RUN/PUSH/TYPE/
  1178. DIRECTORY commands "time-share" the same conventional memory.
  1179.  
  1180. Memory for graphics screens is taken from your video display adapter.  Storage
  1181. of graphics images in the video adapter's on-board memory allows rapid
  1182. switching between text and graphics screens provided (a) your video has
  1183. sufficient memory, (b) the memory is not "mapped away", and (c) you are not
  1184. running Kermit under Windows.
  1185.  
  1186. Memory for rollback screens is allocated when the CONNECT command is first
  1187. given, i.e. when Kermit first displays its terminal emulation window, and
  1188. remains allocated until you EXIT from Kermit.  This can be demonstrated by
  1189. starting Kermit, giving the command SHOW MEMORY, then giving the CONNECT
  1190. command, then escaping back (Alt-x), and then giving the SHOW MEMORY command
  1191. again -- see how available memory has shrunk.  Approximately 4K is required
  1192. per 24x80 rollback screen (more for bigger screens).  The default number of
  1193. rollback screens is 10, but the number can be set to practically any value at
  1194. all (0 or greater) by giving the following command to DOS before you start
  1195. Kermit (interactively, or in your AUTOEXEC.BAT file):
  1196.  
  1197.   SET KERMIT=ROLLBACK 40
  1198.  
  1199. The smaller the number, the less memory required; the bigger, the more memory.
  1200. In version 3.13, you can also give the new command:
  1201.  
  1202.   SET ROLLBACK <number-of-screens>
  1203.  
  1204. at the MS-Kermit prompt at any time, and the rollback memory will be adjusted
  1205. when you next CONNECT.
  1206.  
  1207. A large number of rollback screens can crowd out other possibilities, like the
  1208. ability to use Kermit's RUN, PUSH, TYPE, DIRECTORY, and other commands that
  1209. run inferior processes.
  1210.  
  1211. [Expanded memory features given below not tested on Victor, but they may work on
  1212. Victors equipped with a Western Automation Laboratories Escort expanded memory
  1213. board.]
  1214. Version 3.13 of MS-DOS Kermit lets you store your rollback screens in Expanded
  1215. Memory (EMS) if you have more than 1MB of physical memory and you have an
  1216. expanded memory manager for it like Quarterdeck QEMM or EMM386 and HIMEM that
  1217. come with DOS 5.0 and Windows 3.1.  [These memory managers do not work on the
  1218. Victor.]
  1219.  
  1220. Using expanded memory for rollback screens frees 40K of conventional memory if
  1221. you are using the default number (10) of rollback screens, and it also allows
  1222. you to have a much larger number of rollback screens.  The following steps are
  1223. required to keep your rollback screens in expanded memory:
  1224.  
  1225. 1. Make sure the desired amount of expanded (EMS) (not "extended", or XMS)
  1226.    memory is available.     The DOS MEM command will tell you this. [Not on the
  1227.    Victor.]
  1228.  
  1229. 2. In your AUTOEXEC.BAT file, set the desired number of Kermit rollback
  1230.    screens.  For example, for 250 screens (requiring about 1 megabyte):
  1231.  
  1232.       SET KERMIT=ROLLBACK 250
  1233.  
  1234. 3. Give the following command to MS-DOS Kermit:
  1235.  
  1236.       SET TERMINAL EXPANDED-MEMORY ON
  1237.  
  1238.    If this command fails, Kermit prints an appropriate error message.
  1239.  
  1240. Now start a Kermit session, scroll some text off the screen during CONNECT
  1241. mode, and check the operation of the PageUp/PageDown keys.  If they work,
  1242. you're done.  And as an added benefit, graphics screens will also be stored
  1243. in expanded memory, allowing you to switch between graphics and text screens
  1244. (Alt-minus), even under Windows, without losing the graphics screen.
  1245.  
  1246. If it doesn't work, then welcome to the bewildering world of DOS memory
  1247. management.  The most common symptom of a bad memory configuration is that
  1248. your PC will freeze the first time Kermit tries to scroll a line off the
  1249. screen or the first time it tries to clear the screen.    Now you should begin
  1250. looking at your CONFIG.SYS file.
  1251.  
  1252. [Remainder of this section omitted;  not applicable to the Victor.]
  1253.  
  1254. If all else fails, tell Kermit to SET TERMINAL EXPANDED-MEMORY OFF (this is
  1255. the default anyway).  NOTE: whenever you switch Kermit's expanded memory
  1256. status from OFF to ON or vice versa, your previous rollback screens are lost.
  1257.  
  1258. HARDWARE-RELATED PROBLEMS
  1259.  
  1260. Many of the newer low-cost, high-speed clone PCs suffer from noisy buses,
  1261. interrupt or address conflicts, and other maladies not seen on earlier, more
  1262. expensive (but slower) models.
  1263.  
  1264. INTERACTIONS WITH DOS
  1265.  
  1266. A REMOTE HOST or similar command sent to an MS-DOS Kermit server can invoke the
  1267. DOS critical error handler, which issues its familiar "Abort, Ignore, Retry?"
  1268. message on its real screen, and is waiting for a response from its own real
  1269. keyboard, and so the server will no longer respond.  Kermit attempts to catch
  1270. many of these errors before DOS learns learns about them, but some cannot be
  1271. avoided (like disk i/o errors).
  1272.  
  1273. Similarly, a REMOTE DIRECTORY command sent to an MS-DOS Kermit server can
  1274. cause the server to hang if its default directory command pauses after each
  1275. screen (DIRCMD=/P).  In fact, the server will hang any time a subprocess
  1276. invoked by any REMOTE command (watch out, in particular, for REMOTE HOST)
  1277. requests keyboard input.
  1278.  
  1279. Interaction between MS-DOS Kermit and various terminate-and-stay-resident
  1280. (TSR) programs is necessarily unpredictable.  Console, mouse, clock, or
  1281. graphics drivers might interfere with file transfer, e.g. the CMOSCLK.SYS
  1282. driver on the PS/2 model 55SX.  If TSR programs are interfering with Kermit
  1283. (by taking over the timer or serial port interrupts), you should remove them
  1284. all from your AUTOEXEC.BAT or CONFIG.SYS files, and then put them back one by
  1285. one until you have identified the culprit.
  1286.  
  1287. Use caution when invoking certain TSR programs while PUSHed from Kermit
  1288. (e.g. using the PRINT command for the first time), as not all of these
  1289. programs observe proper etiquette for allocating and freeing memory, and the
  1290. TSRs will be loaded above Kermit into the middle of memory where they may
  1291. prevent large programs from loading later.
  1292.  
  1293. NETWORKS
  1294.  
  1295. When communicating across certain network pathways, the longest burst of
  1296. information tolerated from the PC can be rather short. For example, the LAT
  1297. path with SET PORT DECNET (PATHWORKS) has a limit of 256 bytes and the SET
  1298. PORT TES path has a limit of 512 bytes in a burst (or less, depending on the
  1299. TES release).  Longer bursts can cause the network software on one end or the
  1300. other to drop the connection.  This is most likely in the following situations:
  1301.  
  1302.  1. During file transfer, when sending files from the PC using long packets
  1303.     and/or sliding windows.  The total size of the packets in the window
  1304.     (packet length times the number of window slots) must be less than the
  1305.     burst limit for the network.
  1306.  
  1307.  2. During VT320 terminal emulation, if the host application (such as VMS
  1308.     or UNIX WordPerfect) sends a Terminal State or Color Palette Request
  1309.     escape sequence, DECRQTSR, "ESC [ 2 ; 2 $ u".  The response to this
  1310.     request is more than 200 characters long and has been known to break
  1311.     LAT and TES connections.
  1312.  
  1313. This is not a Kermit problem, but rather a limitation (or bug) in the
  1314. underlying networking method.  Workarounds include:
  1315.  
  1316.  1. If you have a DECnet LAT connection, make a DECnet CTERM connection
  1317.     instead (i.e. unload your LAT TSR and load the CTERM TSR instead).
  1318.  
  1319.  2. Enable RTS/CTS flow control between MS-DOS Kermit and the device it is
  1320.     most immediately connected to, if possible.     Otherwise, enable Xon/Xoff
  1321.     flow control in MS-DOS Kermit and at the host on the far end (e.g. tell
  1322.     VMS to SET TERM/HOSTSYNC/TTSYNC).
  1323.  
  1324.  3. Use a different networking method, e.g. TCP/IP instead of DECnet.
  1325.  
  1326. Sending BREAK over network connections via SET PORT BIOS1 + Int 14h
  1327. interceptor may or may not work, depending upon the actual network and drivers
  1328. in use.     Kermit uses the BREAK facility if the driver and network support it.
  1329.  
  1330. Symptom: PC no longer works after installing a network board.  Diagnosis: a
  1331. 16-bit VGA display adapter is running in 16-bit mode.  Cure: Jumper it back to
  1332. 8 bits and all should start working again.
  1333.  
  1334. PC-NFS prevents applications programs such as Kermit from creating a file in
  1335. the root directory of a PC-NFS disk drive.  When the applications program asks
  1336. if a particular file exists in the root, PC-NFS always responds with "volume
  1337. label present", whether or not the actual file is present.
  1338.  
  1339. SET PORT TELAPI performance is good with version 4 of Novell's LAN WorkPlace
  1340. for DOS but it is poor with version 3.5 because that older version sends each
  1341. Kermit byte in an individual packet.  Because the TELAPI interface lacks the
  1342. ability to resolve Internet, names you can use the small Kermit macro below to
  1343. invoke Novell's program TSU to resolve names and set up a session:
  1344.  
  1345.   define telapi run tsu -o \%1 k1,run tsu -a k1 1,set port bios1
  1346.  
  1347. Use as Kermit command "telapi my.favorite.host" followed by CONNECT.  This
  1348. tells TSU to "o"pen a connection to the host named in Kermit variable \%1 and
  1349. give the session a TSU tag of "k1".  Then run TSU again and "a"ttach this
  1350. session to COM"1" meaning Kermit's BIOS1 port.    Four sessions can be started
  1351. by choosing different tags and port numbers, though this macro does not make
  1352. the changes.  An alternative to SET PORT BIOS1 is SET PORT 3COM for much
  1353. faster throughput; an end-of-session signal is not available with this method
  1354. so the user must exit manually.
  1355.  
  1356. You can't run LAN Workplace for DOS (LWP) and make SET PORT TCP/IP connections
  1357. with Kermit at the same time, because only one protocol stack of a given kind
  1358. can run over a single network board.  If you want to make a TCP/IP connection
  1359. with Kermit when LWP is loaded you can either (a) use SET PORT TELAPI rather
  1360. than SET PORT TCP/IP (slower and less flexible), or (b) unload LWP from the
  1361. DOS prompt by typing TCPIP UNLOAD, and then start Kermit.
  1362.  
  1363. The Interconnections TES product, which Kermit fully supports, has a fancy
  1364. menu that pops up if you type the TES "hot key", Alt-LeftShift-T.  Reportedly,
  1365. this pop-up menu interferes with the LK250 driver that is distributed with
  1366. Kermit (it works fine with regular IBM keyboards).  The LK250 driver uses a
  1367. special interrupt, and the TES menu program might not properly chain this
  1368. interrupt.  The workaround is to use TES's text-mode menu, which Kermit brings
  1369. up if you type Alt-Home during terminal emulation.  Version 3.13 of MS-DOS
  1370. Kermit transparently supports both older and the latest TES products.
  1371.  
  1372. For DECnet/DOS (PATHWORKS) LAT connections, it is often necessary to tell the
  1373. LAT control program on the PC to reserve enough memory for all of the local LAT
  1374. host names.  By default, space for 16 names is allocated.  Increase your LAT
  1375. control program's memory allocation if you have more than 16 hosts on your
  1376. DECnet network.     Also, remove ALL permanent LAT names from your database and
  1377. let the network provide them (this can mean waiting a minute or two for all
  1378. broadcasts to be heard).
  1379.  
  1380. Reportedly, when making NETBIOS or 3COM(BAPI) connections under Windows,
  1381. characters from a DOS window can show up in the Kermit window.  Reportedly,
  1382. this can be fixed by setting Kermit's foreground and background priority to
  1383. 150 and setting the priority of the other DOS applications to 5000.
  1384.  
  1385. NETBIOS STATION-TO-STATION CONNECTIONS
  1386.  
  1387. The procedure for establishing a NETBIOS PC-to-PC connection is as follows:
  1388.  
  1389.  1. On the first PC:
  1390.       SET NETBIOS NAME <xxx>
  1391.       SET PORT NETBIOS
  1392.       SERVER
  1393.  
  1394.  2. On the second PC:
  1395.       SET PORT NETBIOS <xxx>.K
  1396.  
  1397. (<xxx> is any name you choose, up to 14 characters long.)
  1398.  
  1399. Now you can initiate file transfer and other Kermit protocol operations from
  1400. the second PC.    If you want the two PCs to "chat" in terminal mode, send a
  1401. FINISH command from the second PC (or type Ctrl-C on the first, server, PC),
  1402. and then give the following commands to both PCs:
  1403.  
  1404.   SET TERMINAL NEWLINE ON
  1405.   SET LOCAL-ECHO ON
  1406.   CONNECT
  1407.  
  1408.  
  1409. TCP/IP SUPPORT
  1410.  
  1411. As of version 3.11, MS-DOS Kermit contains built-in TCP/IP and TELNET protocol
  1412. support.  This allows a PC equipped with an Ethernet or other network board
  1413. that is connected to a TCP/IP network to communicate with any other node on
  1414. the network, without requiring any additional TCP/IP software on your PC.  You
  1415. need an external Ethernet-style (Class 1) packet driver for your network
  1416. interface board, or (as of version 3.12) a SLIP Packet Driver or a Novell ODI
  1417. driver, or (as of version 3.13) the Novell SLIP_PPP ODI driver.     You can also
  1418. use any of various "shims" to sit between Kermit and other kinds of board
  1419. drivers (e.g. NDIS) to make them look to Kermit like Ethernet packet drivers.
  1420.  
  1421. With ODI, Kermit's Telnet operates across Ethernet (many frame kinds), Token
  1422. Ring, Arcnet, and PCnet.  Kermit does not contain built-in network device
  1423. drivers.  Packet drivers are available from network interface manufacturers,
  1424. and via anonymous FTP from Columbia University, host watsun.cc.columbia.edu
  1425. [128.59.39.2], cd packet-drivers, get the READ.ME file, read it, and take it
  1426. from there.  These files, now called the Crynwr packet driver collection, are
  1427. also available from Columbia University via mail order.     ODI drivers are
  1428. available from makers of the LAN adapter and in some cases from Novell.     See
  1429. Novell archive "novlib" on CompuServe and on machines ftp.is.sandy.novell.com
  1430. [137.65.12.2] and mirrors such as netlab2.usu.edu [129.123.1.44] for Novell
  1431. supplied ODI drivers.
  1432.  
  1433. The TCP/IP code in this version of Kermit has been tested successfully with at
  1434. least the following boards and packet drivers (according to reports from
  1435. users):
  1436.  
  1437.   Ungermann-Bass PC/NIC board with Clarkson UBNICPC packet driver 9.1
  1438.   3COM 3C501 with Clarkson 3C501 packet driver 5.0.
  1439.   3COM 3C503 with Clarkson 3C503 packet driver 9.4.0.
  1440.   Western Digital WD8003E with Crynwr (not WD) WD8003E packet driver 9.7.0
  1441.   Cabletron 2000 and 3000 series DNI boards with CSIPD_E 1.0x and later packet
  1442.     drivers on unshielded twisted pair, thin Ethernet, and thick Ethernet,
  1443.     on both PC/AT and Microchannel buses.
  1444.   Micom-Racal NI5210 with NI5210 packet driver.
  1445.   AT&T EN100 with Clarkson AT&T packet driver.
  1446.   IBMTOKEN.COM 3C501 emulation packet driver 1.9 over various Token Ring 
  1447.     boards and drivers.
  1448.   DIS_PKT over NDIS for LAN Manager networks and NDIS-compliant boards
  1449.     including SD8003, 3C503, AT&T 10MB/sec thinwire
  1450.   Harvard ODIPKT over LSL, LANSUP, and IPXODI over Ethernet (but not
  1451.     Token Ring) 
  1452.   Novell NE2000 with Crynwr NE2000 packet driver (not the Novell MLID!)
  1453.  
  1454. Token Ring, Arcnet, and LocalTalk packet drivers are not supported, as they
  1455. are not Ethernet- or SLIP-class Packet drivers.
  1456.  
  1457. The performance of the 3C50x packet drivers is poor, but the operation seems
  1458. correct.  Suggestion from a 3COM 3C503 Ethernet board user: "When installing
  1459. the packet driver for 3Com 503 cards, one has to pay attention that the memory
  1460. option on the card is not disabled.  It was in my case, and the packet-driver
  1461. did not complain.  Since other drivers (e.g.  the DEC PATHWORKS driver) do not
  1462. require the memory enabled, the default is disabled."
  1463.  
  1464. Reportedly, the packet driver supplied by Western Digital with their WD8003E
  1465. and/or Elite network boards cannot be found by Kermit.    The Crynwr WD8003E
  1466. packet driver, however, works correctly with both the WD8003E and Elite boards.
  1467. Same comments apply to WD8003E.SYS shipped with PC-NFS.
  1468.  
  1469. To reconfigure a Novell network (NetWare 3.xx or earlier) for packet drivers
  1470. so Kermit and Novell software can be used concurrently, use software from
  1471. Brigham Young University, available via anonymous ftp from dcsprod.byu.edu.
  1472. For further information, read the Kermit Distribution file MSABYU.HLP.
  1473.  
  1474. An Ethernet-simulation packet driver "shim" is available for systems using the
  1475. NDIS (Network Driver Interface Specification) program.    NDIS is frequently
  1476. used with LAN Manager networks, including AT&T's StarGROUP network and DEC's
  1477. Pathworks for DOS.  The interface program is named DIS_PKT and originated with
  1478. FTP Software Inc.  Their program DIS_PKT.GUP is available by anonymous ftp to
  1479. vax.ftp.com, and a research version DIS_PKT9.ZIP is available from Utah State
  1480. University by anonymous ftp to netlab2.usu.edu.     Instructions for configuring
  1481. Lan Manager to include DIS_PKT are included with the program.  (Also available
  1482. from watsun.cc.columbia.edu, in the packet-drivers.new directory and on the
  1483. MS-DOS Kermit diskette.)
  1484.  
  1485. Here is a setup with which one user reports success in using MS-DOS Kermit's
  1486. built-in TCP/IP support with LAN Manager and a Novell NE2000 Ethernet board:
  1487.  
  1488. CONFIG.SYS
  1489. ---------------------------
  1490. SHELL=C:\COMMAND.COM /P /E:1024
  1491. DEVICE=C:\WINDOWS\HIMEM.SYS
  1492. DEVICE=C:\WINDOWS\EMM386.EXE noems I=B000-B7FF i=e000-efff
  1493. DOS=HIGH,UMB
  1494. COUNTRY=61,,C:\DOS\COUNTRY.SYS
  1495. BUFFERS=13
  1496. FILES=50
  1497. STACKS=0,0
  1498. LASTDRIVE=Z
  1499. DEVICEHIGH=C:\DOS\ANSI.SYS
  1500. DEVICEHIGH=C:\WINDOWS\MOUSE.SYS
  1501. DEVICEHIGH=C:\LANMAN\DRIVERS\PROTMAN\PROTMAN.DOS /i:C:\LANMAN
  1502. DEVICEHIGH=C:\LANMAN\DRIVERS\ETHERNET\NE2000\NE2000.DOS
  1503. DEVICEHIGH=C:\KERMIT\DIS_PKT9.DOS
  1504.  
  1505. PROTOCOL.INI
  1506. ----------------------------
  1507. [PROTMAN]
  1508.   DRIVERNAME = PROTMAN$
  1509.   DYNAMIC = YES
  1510.   PRIORITY = NETBEUI
  1511.  
  1512. [PKTDRV]
  1513. ; This section added for kermit
  1514.   DRIVERNAME = PKTDRV$
  1515.   BINDINGS = NE2000_NIF
  1516.   INTVEC = 0x65
  1517.  
  1518. [NETBEUI_XIF]
  1519.   DRIVERNAME = NETBEUI$
  1520.   SESSIONS = 8
  1521.   NCBS = 12
  1522.   BINDINGS = "NE2000_NIF"
  1523.   LANABASE = 0
  1524.  
  1525. [NE2000_NIF]
  1526. ; protocol.ini section for the Novell NE2000 Card
  1527.   IOBASE = 0x300
  1528.   INTERRUPT = 5
  1529.   DRIVERNAME = MS2000$
  1530.  
  1531. Kermit's TCP/IP support does not work over the Harvard ODIPKT driver on a Token
  1532. Ring network because it requires Kermit to use Token Ring rather than Ethernet
  1533. frames (but it does work with ODIPKT over Ethernet).  Version 3.12 and later
  1534. support ODI directly; ODIPKT is not necessary except when using Windows.
  1535.  
  1536. Direct use of ODI drivers permits Kermit's TCP/IP to run with several kinds of
  1537. Ethernet frames: DIX/Blue-Book/Ethernet_II, 802.2, 802.2 with SNAP, and 802.3,
  1538. as well as with Token Ring, Arcnet, and PCLan broadband.  No extra protocol
  1539. "shim" is needed, but you must have the ODI drivers which come from Novell or
  1540. from your network board vendor.
  1541.  
  1542. The ODI interface will be tried if a Packet Driver is not found, and it can be
  1543. selected in preference to a packet driver by the command:
  1544.  
  1545.    SET TCP/IP PACKET-DRIVER-INTERRUPT ODI
  1546.  
  1547. where "ODI" replaces the interrupt number of a Packet Driver.
  1548.  
  1549. For ODI, the file NET.CFG should have the lines "Protocol IP etc" similar to
  1550. the example below:
  1551.  
  1552.     # File NET.CFG, example
  1553.     PB buffers=10
  1554.     show dots=on
  1555.  
  1556.     Link Support
  1557.         buffers 6 1514
  1558.         MemPool 2048
  1559.  
  1560.     Link Driver SMCPLUS
  1561.         Port  280 20
  1562.         Mem   000CA000 2000/10
  1563.         Int   7
  1564.         frame Ethernet_II
  1565.         Protocol IPX    8137    Ethernet_II
  1566.         Protocol IP    0800    Ethernet_II
  1567.         Protocol ARP    0806    Ethernet_II
  1568.         Protocol RARP    8035    Ethernet_II
  1569.  
  1570. To make TCP/IP connections, Kermit requires three "protocols", IP, ARP, and
  1571. optionally RARP as shown above.     The frame kinds can be anything the board
  1572. will support: Ethernet, Token Ring, Arcnet, all IEEE 802.2-based frames etc.
  1573. ODI will complain if the frame type cannot support these protocols.  Arcnet
  1574. uses different TYPE values, D4 for IP, D5 for ARP, and D6 for RARP, rather
  1575. than 0800 etc, as per RFC-1201.
  1576.  
  1577. Which board Kermit (or IPX or other application) will use if two or more
  1578. boards are available?  Although one would think the board could be selected by
  1579. placing the Protocol IP, etc, lines under the desired Link Driver section,
  1580. such is not really the case; those lines tell LSL the frame kind to associate
  1581. with the protocol (say IP) but not the board.  The frame lines are associated
  1582. with particular boards, however.  The default method for finding a board is
  1583. that the application chooses "the first board" offering a suitable frame,
  1584. regardless of whether or not the Protocol IP, etc, lines are present for that
  1585. board.  "First" refers not to the contents of NET.CFG but to the order in
  1586. which board drivers are loaded at DOS level.  So the indented protocol lines
  1587. tell ODI which frame a protocol needs, and a TYPE to use for recognizing
  1588. packets, but the lines do not identify a particular board.
  1589.  
  1590. To target a particular board a separate main section is used in NET.CFG.  The
  1591. section starts with the word Protocol against the left margin and has Bind
  1592. indented beneath it, like this -
  1593.  
  1594.     Protocol Kermit            Identifies Kermit section of NET.CFG
  1595.         bind SMCPLUS        Bind to SMCPLUS board driver
  1596.  
  1597. When a board name is used more than once then the alternative form is to use
  1598. a board number in place of the name:
  1599.  
  1600.     Protocol Kermit
  1601.         bind #2            bind to the board loaded second
  1602.  
  1603. Kermit considers the text in these sections to be case-insensitive.  The
  1604. #<digit> construction must not have a separation between the number sign (#)
  1605. and the digit.    The #<digit> case is normally used when two or more boards
  1606. share the same driver and thus are not distinguishable by name alone.
  1607.  
  1608. A sample STARTNET.BAT file might look like this:
  1609.  
  1610. @echo off            run quietly
  1611. c:\lsl >nul            LSL is always loaded before boards
  1612. c:\smcplus.com >nul        SMC/WD8003E board, the first
  1613. c:\exos.com >nul        EXOS-205T board, the second
  1614. rem c:\odinsup            Odinsup can coexist with Kermit
  1615. rem c:\odipkt 0 96        Odipkt can coexist with Kermit
  1616. c:\ipxodi >nul            IPX is always loaded after boards
  1617. rem echo Starting network...    may be needed to help some drivers
  1618. c:\bnetx ps=my-preferred-server > nul
  1619. rem (Packet Burst mode)    NETX loads after IPX
  1620. @echo on
  1621.  
  1622. If both EXOS and SMCPLUS boards offer frame Ethernet_II Kermit will choose the
  1623. first loaded board, SMCPLUS, in the absence of a "bind" command.  Putting the
  1624. section "Protocol Kermit, bind <board name or number>" anywhere in NET.CFG
  1625. selects a particular board for Kermit.    A complete NET.CFG file using two
  1626. boards is shown below and applies to both regular NetWare shells and the
  1627. newer VLM shells (but with minor changes to the no-board parts of things).
  1628.  
  1629. # File NET.CFG, an example with two boards
  1630. PB buffers=10
  1631. show dots=on
  1632. # all main sections must start in column 1, indent local material.
  1633.  
  1634. # Protocol "IPX" is for Novell's IPXODI
  1635. Protocol IPX
  1636.     Bind #1
  1637.  
  1638. # Protocol "Kermit" is for MS-DOS Kermit
  1639. Protocol KERMIT
  1640.     Bind EXOS
  1641.  
  1642. Link Support
  1643.     buffers 6 1514
  1644.     MemPool 2048
  1645.  
  1646. Link Driver exos
  1647.     Port  310 20
  1648.     Mem   000D0000 400
  1649.     Int   5
  1650.     frame Ethernet_II
  1651.     Protocol IPX    8137    Ethernet_II
  1652.     Protocol IP    0800    Ethernet_II
  1653.     Protocol ARP    0806    Ethernet_II
  1654.     Protocol RARP    8035    Ethernet_II
  1655.  
  1656. Link Driver SMCPLUS
  1657.     Port  280 20
  1658.     Mem   000CA000 2000/10
  1659.     Int   7
  1660.     frame Ethernet_II
  1661.     frame Ethernet_Snap
  1662.     Protocol IPX    8137    Ethernet_II
  1663.     Protocol IP    0800    Ethernet_II
  1664.     Protocol ARP    0806    Ethernet_II
  1665.     Protocol RARP    8035    Ethernet_II
  1666.  
  1667. # Protocol "TCPIP" is for Novell's Lan WorkPlace for DOS, not Kermit
  1668. Protocol TCPIP
  1669.     ip_address    129.123.1.99
  1670.     ip_router    129.123.1.254
  1671.     ip_netmask    255.255.255.0
  1672.     tcp_sockets    8
  1673.     udp_sockets    8
  1674.     raw_sockets    1
  1675.     nb_sessions    4
  1676.     nb_commands    8
  1677.     nb_adapter    0
  1678.     nb_domain    usu.edu
  1679.  
  1680. Link Driver SLIP_PPP
  1681.     DIRECT    YES
  1682.     BAUD     9600
  1683.     OPEN    ACTIVE
  1684.     PCOMP    YES
  1685.     ACCOMP    YES
  1686.     PORT    3F8
  1687.     INT    4
  1688.     FRAME    SLIP
  1689.     Protocol    IP    0800    SLIP
  1690.  
  1691. MAKING NOVELL SLIP_PPP ODI CONNECTIONS
  1692.  
  1693. Novell's SLIP_PPP ODI driver is a combined serial port SLIP and PPP module
  1694. which is part of the Lan WorkPlace for DOS (LWP) product.  Kermit requires
  1695. the line:
  1696.  
  1697.     Protocol    IP    0800    SLIP
  1698.  
  1699. to be included with the driver.     Note that Kermit can temporarily steal the
  1700. serial port hardware from this driver to dial the telephone and log into a
  1701. host; SLIP/PPP communications should resume normally after Kermit is set to
  1702. the TCP/IP pathway.  Here is a STARTODI.BAT and NET.CFG example with SLIP_PPP
  1703. carrying the TCP/IP traffic.  File STARTODI.BAT:
  1704.  
  1705. @echo off
  1706. REM - Load LSL first
  1707. c:\lsl.com
  1708. REM - Then load your network board driver
  1709. c:\ne2000.com
  1710. REM - Then load the Novell SLIP_PPP driver
  1711. c:\slip_ppp.com
  1712. REM - Then the regular Novell IPX driver and network shell, for example:
  1713. set name=olga
  1714. c:\ipxodi /d
  1715. c:\bnetx.exe ps=name-of-novell-server
  1716. @echo on
  1717.  
  1718. File NET.CFG:
  1719.  
  1720. # File NET.CFG
  1721. PB buffers=6
  1722. show dots=on
  1723. signature level=0
  1724.  
  1725. protocol KERMIT
  1726.     bind SLIP_PPP
  1727. #    bind ne2000
  1728.  
  1729. Link Support
  1730.     Buffers    7 1500
  1731.     MemPool    2048
  1732.  
  1733. Link Driver NE2000
  1734.     Port  360
  1735.     Int   5
  1736.     Frame    Ethernet_II     
  1737.     Protocol    IPX    8137    Ethernet_II     
  1738.     Protocol    IP    0800    Ethernet_II
  1739.     Protocol    ARP    0806    Ethernet_II
  1740.     Protocol    RARP    8035    Ethernet_II
  1741.  
  1742. Link Driver SLIP_PPP
  1743.     DIRECT    YES
  1744.     BAUD     9600
  1745.     OPEN    ACTIVE
  1746. #    TCPIPCOMP    VJ
  1747.     PCOMP    YES
  1748.     ACCOMP    YES
  1749.     PORT    3F8
  1750.     INT    4
  1751.     FRAME    SLIP
  1752. #    FRAME    PPP
  1753.     Protocol    IP    0800    SLIP
  1754.  
  1755. # Below is for Novell's Lan WorkPlace for DOS
  1756. Protocol TCPIP
  1757.     PATH SCRIPT    d:\lwp41\net\SCRIPT
  1758.     PATH PROFILE    d:\lwp41\net\PROFILE
  1759.     PATH LWP_CFG    d:\lwp41\net\HSTACC
  1760.     PATH TCP_CFG    d:\lwp41\net\TCP
  1761.     ip_router    129.123.100.254
  1762.     ip_netmask    255.255.255.0
  1763.     ip_address    129.123.100.5
  1764.     tcp_sockets    16
  1765.     udp_sockets    8
  1766.     raw_sockets    1
  1767. #    nb_sessions    4
  1768. #    nb_commands    8
  1769. #    nb_adapter    0
  1770. #    nb_domain    usu.edu
  1771.     Bind        slip_ppp
  1772.  
  1773. Kermit is told to bind to SLIP_PPP rather than to the active NE2000 board
  1774. because the indented minor clause Bind SLIP_PPP under the Protocol Kermit
  1775. major heading tells Kermit which MLID (board driver) to use.  Link Driver
  1776. SLIP_PPP has indented Kermit line "Protocol IP 0800 SLIP" so Kermit can use
  1777. the driver; ARP and RARP lines could have been added with no effect (no ARP on
  1778. a point-to-point link).     LWP/DOS does not need this protocol line because it
  1779. tends to generate them itself.
  1780.  
  1781. Either SLIP or PPP can be used by setting the Frame Type and using the same
  1782. frame type in the indented protocol line below it.  No NetBios support was
  1783. wanted from LWP/DOS so that section was commented out.
  1784.  
  1785. STARTODI.BAT loads SLIP_PPP but nothing is sent out immediately as there is
  1786. not yet any connection.     To make the connection, start Kermit, SET PORT COM1
  1787. (or whatever), set the desired speed and flow control (but not Xon/Xoff!),
  1788. dial the phone and log into the host or server, then start SLIP or PPP there
  1789. (Novell provides a DIALER program with SLIP_PPP which can set the port speed
  1790. and dial a phone number via rudimentary means; Kermit is much more flexible
  1791. about this).  In all this, Kermit is grabbing the serial port from SLIP_PPP,
  1792. using it, and then returning it when done.  Kermit's TELNET will find an ODI
  1793. driver, SLIP_PPP, adjust itself accordingly, and SLIP-style packets flow back
  1794. and forth.  (If Kermit doesn't find the ODI driver, tell it to SET TCP
  1795. PACKET-DRIVER ODI.)
  1796.  
  1797. ODI-TO-PACKET-DRIVER SHIMS
  1798.  
  1799. Prior to version 3.12, the only way to make TCP/IP connections over ODI with
  1800. MS-DOS Kermit was through the ODIPKT shim, which converts between the ODI
  1801. interface and the packet-driver interface.  ODIPKT is no longer necessary,
  1802. except under Windows (because there is, as yet, no equivalent of WINPKT for
  1803. ODI drivers).
  1804.  
  1805. There is an ODI to Packet Driver shim available for Token Ring cards which can
  1806. work with Kermit (and WINPKT).    The current version is still in Beta as of
  1807. this writing (May 93).    ODITRPKT is available via FTP from Oklahoma State
  1808. University host datacomm.ucc.okstate.edu as pub/oditrpkt/beta9.zip.  A copy is
  1809. also available in packet-drivers/new on watsun.cc.columbia.edu, but it might
  1810. not be as up-to-date as the one at the source.
  1811.  
  1812. Here is a NET.CFG example using ODITRPKT:
  1813.  
  1814. LINK DRIVER TOKEN
  1815.      INT 3
  1816.      FRAME TOKEN-RING
  1817.      FRAME TOKEN-RING_SNAP
  1818.      PROTOCOL IPX  E0    TOKEN-RING
  1819.      Protocol IP   0800 TOKEN-RING_SNAP
  1820.      Protocol ARP  0806 TOKEN-RING_SNAP
  1821.      Protocol RARP 8035 TOKEN-RING_SNAP
  1822.  
  1823. And here is one using Arcnet:
  1824.  
  1825. LINK DRIVER SMCARCWS
  1826.      INT 3
  1827.      PORT 300
  1828.      MEM D0000
  1829.      Frame NOVELL_RX-NET
  1830.      Protocol IPX  FA NOVELL_RX-NET
  1831.      Protocol IP   D4 NOVELL_RX-NET
  1832.      Protocol ARP  D5 NOVELL_RX-NET
  1833.      Protocol RARP D6 NOVELL_RX-NET
  1834.  
  1835. At the moment there is no Windows support for Kermit over ODI.    Instead we
  1836. recommend using shim ODIPKT or ODITRPKT over ODI, followed by WINPKT over that
  1837. to employ a Packet Driver interface into Windows.
  1838.  
  1839. TCP/IP BUGS AND LIMITATIONS
  1840.  
  1841. Domain name resolution might not work when you give a nickname instead of a
  1842. complete host name in the SET PORT TCP/IP command and Kermit transforms the
  1843. nickname into the desired complete host name by combining it with your TCP/IP
  1844. DOMAIN.  Kermit does not use a special Hosts file to relate nicknames to
  1845. complete host names.  Workarounds: use a complete hostname, an IP host number,
  1846. or set your TCP/IP DOMAIN correctly.  It should be obvious that Domain Name
  1847. Servers are specified by their IP number rather than name.
  1848.  
  1849. Version 3.13 supports multiple gateways on the local network.  Choosing the
  1850. incorrect gateway normally results in that gateway sending an ICMP Redirect
  1851. message to Kermit indicating the preferred gateway, and Kermit displays such
  1852. messages.  Version 3.12 and earlier did not implement ICMP Redirect actions.
  1853.  
  1854. For IBM mainframe linemode TELNET connections, automatic appearance of the
  1855. login banner might not work.  Type a carriage return (Enter) to get the login
  1856. banner.     Local-echo and linemode operation are negotiated automatically.
  1857.  
  1858. BOOTP requests are handled correctly within the local network, and have been
  1859. tested successfully through Novell's BOOTP forwarder NLM and through Cisco
  1860. routers with software version 8.2.7.  In the SET TCP/IP ADDRESS command, the
  1861. words BOOTP and RARP must be spelled out in full.  Version 3.11 and 3.12
  1862. support original RFC951 and 1048 BOOTP protocol, and version 3.13 adds support
  1863. for downloading of the PC's full host (domain) name as specified in RFC1395.
  1864. See V9KERMIT.HLP for details.
  1865.  
  1866. EXIT from Kermit closes your TCP/IP session (just like HANGUP).     PUSHing or
  1867. running DOS commands from Kermit keeps it open.     In version 3.12 and later,
  1868. EXITing while a session is active causes a warning / confirmation message to
  1869. appear so you can change your mind.
  1870.  
  1871. Version 3.11 of MS-DOS Kermit uses only the TELNET port (23) for SET PORT TCP
  1872. connections.  Version 3.12 and later allow you to specify any desired port
  1873. (except 25) in the SET PORT TCP command, after the host name or address.
  1874.  
  1875. MS-DOS Kermit honors TELNET protocol negotiations, including terminal type and
  1876. ECHO/SGA.  Version 3.11 always sends "VT100" as its terminal type; later
  1877. versions send MS-DOS Kermit's active terminal type or allows the user to
  1878. create an override string with command SET TCP/IP TELNET-TERM-TYPE.
  1879.  
  1880. Not supported: FTP, TFTP, automatic setting of PC date/time from network, 3270
  1881. emulation (tn3270), etc.  There is no PING command, but MS-DOS Kermit responds
  1882. when PINGed and when probed by Traceoute.  The keyboard verb \Knethold does
  1883. nothing.  Multiple simultaneous TCP/IP sessions are supported in version 3.13;
  1884. see V9KERMIT.HLP for details.
  1885.  
  1886. For TCP/IP connections to IBM mainframes in full screen 3270 mode, you need an
  1887. intermediate host or device to do the 3270/ASCII terminal conversion.  Typical
  1888. setup is a TCP/IP terminal server with its serial lines connected to a protocol
  1889. converter (e.g. IBM 7171), a UNIX host that has tn3270 available, or a terminal
  1890. server (like Cisco) that does 3270 terminal emulation.    To transfer files with
  1891. an IBM mainframe, you might have to tell MS-DOS Kermit to SET PARITY SPACE.
  1892.  
  1893. Version 3.12 and later support inbound connections to MS-DOS Kermit.  Inbound
  1894. TELNET connections do not copy DOS screens, etc, like Carbon Copy and PC
  1895. Anywhere and the free telnetd program of Erick Engelke; a Kermit-to-Kermit
  1896. connection is made instead.  To configure MS-DOS Kermit to be a TCP/IP server,
  1897. give the following command:
  1898.  
  1899.   SET PORT TCP * [ <port> ]
  1900.   SET SERVER LOGIN <username> [ <password> ]  ; (recommended but not required)
  1901.   SERVER
  1902.  
  1903. Use asterisk instead of an IP name or address, followed optionally by a TCP
  1904. port number (the default is 23 = TELNET), and then enter server mode.  Anybody
  1905. who TELNETs to your PC will see a brief screen message telling them to escape
  1906. back to their local Kermit prompt and issue commands from there, for example:
  1907.  
  1908.   REMOTE LOGIN <usename> <password>
  1909.   REMOTE DIRECTORY
  1910.   GET OOFA.TXT
  1911.  
  1912. Kermit's TCP/IP support cannot be used simultaneously with PC NFS because both
  1913. applications want to register use of ARP and IP with the packet driver, but
  1914. each protocol can only be assigned to one application.  This is only one
  1915. particular case of the more general rule:
  1916.  
  1917.     Only one TCP/IP based application can use a LAN adapter at once.
  1918.  
  1919. which also applies to DesqView/X and other TCP/IP products for the PC.
  1920.  
  1921. (There is a program called PKTMUX that, under some conditions, might allow
  1922. coexistence of multiple TCP/IP applications, but it is risky and not
  1923. recommended.)  To make MS-DOS Kermit work simultaneously with PC-NFS, Kermit
  1924. would have to be linked with the proprietary socket-library routines, which we
  1925. cannot do.  If you need to have NFS active simultaneously with an MS-DOS
  1926. Kermit TCP/IP connection, it is best to use a different NFS package that also
  1927. works with Kermit such as FTP Software, Novell LWP, or Beame and Whiteside.
  1928.  
  1929. The SET TCP/IP and SET PORT TCP/IP commands only return failure codes if there
  1930. is a parse error.  The connection is not opened until the first attempt to
  1931. communicate with the remote host: CONNECT, PAUSE, OUTPUT, etc.    While
  1932. connection establishment is in progress, you can't interrupt the program with
  1933. Ctrl-C.     Use IF SUCCESS / FAILURE after PAUSE 0 to check if the connection
  1934. is open, for example:
  1935.  
  1936.   DEFINE TELNET SET PORT TCP \%1 \%2, PAUSE 0, IF SUCCESS CONNECT
  1937.  
  1938. The second variable above is for the optional TCP port number in version 3.12
  1939. and later.
  1940.  
  1941. TCP/IP performance hints: Set your Kermit packet size to 500 or larger to
  1942. achieve most data sent per network packet. A convenient setting is SET 
  1943. RECEIVE PACKET 1000, SET WINDOW 4, resulting in four 1000-byte packets in a 
  1944. window.     SET FLOW NONE lets TCP/IP do the flow control and eliminates Kermit's
  1945. need to check for Xon/Xoff.  In most situations beyond the local network 
  1946. performance will be limited by the long distance lines rather than by the PC.
  1947.  
  1948. End of V9KERMIT.BWR (modified from MSKERMIT.BWR, also known as MSKERM.BWR or
  1949. KERMIT.BWR)
  1950.