home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload / ShartewareOverload.cdr / comm / kermit23.zip / MSKERM.BWR < prev    next >
Text File  |  1990-02-06  |  30KB  |  559 lines

  1. File KERMIT.BWR        MS-DOS KERMIT 3.0 "BEWARE FILE"           January 1990
  2.  
  3. Last update: Wed Jan 24 11:55:33 1990
  4.  
  5. This file lists limitations, restrictions, and known bugs in MS-DOS Kermit
  6. version 3.0.  Also see KERMIT.UPD for a list of new features of version 3.0
  7. and incompatibilities with older releases.
  8.  
  9. The user manual for MS-DOS Kermit 3.0 is "Using MS-DOS Kermit", by Christine
  10. M. Gianone, published by Digital Press, Bedford, MA, 1990, order number
  11. EY-C204E-DP.  Call 1-800-343-8321 (toll free, USA) to order.  The technical
  12. reference by Professor Joe R. Doupnik is in preparation.
  13.  
  14. MS-DOS Kermit 3.0 has been successfully tested with PC-DOS 2.0, 3.0, 3.30, and
  15. 4.0 on a wide variety of IBM PCs, XTs, PC/ATs, Portable PCs, PS/2s, and
  16. compatibles.  DOS 2.0 or later is required, plus at least 130-140K of free
  17. memory.
  18.  
  19. LIMITATIONS AND RESTRICTIONS OF MS-DOS KERMIT
  20.  
  21. On IBM PCs and PS/2s with IBM asynchronous adapters, Kermit can be used at
  22. speeds up to 57600 bps.  For 115200 bps to work, a very short shielded cable is
  23. required, and the async adapters of the two machines must be in perfect tune.
  24. It's an electrical affair, not one of programming.
  25.  
  26. Although high speeds can be used for file transfer, the maximum speed for VT
  27. and Tektronix terminal emulation depends upon the model of your PC.  For
  28. original PCs and PC/XTs, it is 9600 bps.  For PC/ATs and PS/2s, it is
  29. generally 19200, perhaps 38400 for the faster 386-based models.  If your speed
  30. is set too high for your PC model, the symptom will be lost or garbled
  31. characters (or graphics images) on the screen.
  32.  
  33. MS-DOS Kermit does not attempt to monitor the communication line for carrier
  34. loss during terminal emulation or file transfer (but you can SHOW MODEM or
  35. SHOW COMMUNICATIONS to inquire about CD, DSR, and CTS).  The absence of
  36. carrier monitoring is a design decision.  Interactive users will notice when
  37. carrier drops, and timeouts will catch the situation during file transfer or
  38. script execution.  The script command WAIT permits sensing carrier presence
  39. while doing scripts or macros. The benefits are not having to wire a direct
  40. RS-232 connection to simulate a modem's carrier being present, and being able
  41. to talk to the local modem before carrier is detected from the other modem.
  42.  
  43. The SHOW MODEM and WAIT commands will work right only if your modem or other
  44. communication device is configured to raise and lower the DSR, CTS, and CD
  45. signals appropriately, and the cable that connects your PC to the modem passes
  46. these signals through.  For some modems, the factory setting is to always keep
  47. CD on, even if there is no connection.  Consult your modem manual.
  48.  
  49. For RS-232 devices, the HANGUP command (and Ctrl-σH in CONNECT mode) will work
  50. only if the cable that connects your PC to the communication device passes the
  51. DTR signal through, and if the communication device itself is configured to
  52. hang up or otherwise terminate the connection when the DTR signal is lowered
  53. by the PC.  For some modems, the factory setting is to ignore DTR transitions.
  54. Consult your modem manual.
  55.  
  56. MS-DOS Kermit will not necessarily work with all brands of internal modems,
  57. particularly some of the built-in ones that come with laptop PCs from various
  58. makers.  If you cannot communicate satisfactorily through such a modem, give
  59. the command SET PORT BIOSx (where x is 1, 2, 3, or 4, corresponding to whether
  60. the modem is COM1, COM2, COM3, or COM4) and try again.  Kermit does work with
  61. most popular brands of internal modem (such as the Hayes Smartmodem 1200B and
  62. 2400B), and with all known external modems, both direct-connect and acoustic.
  63.  
  64. Kermit does not work properly with revision C of the built-in modem in the
  65. Toshiba T1600 laptop computer, due to an idiosyncracy of this modem.  The
  66. symptom is that the connection drops when you escape back from connect mode,
  67. at which point Kermit turns off interrupts.  The modem misinterprets this as a
  68. command to hang up the phone and turn itself off.  Revision F of this modem
  69. does not have this problem.  Note: This problem occurs with the "built-in"
  70. modem, not the "internal" modem (these are two different devices).
  71.  
  72. The IBM PC implementation of VT300/100 emulation has several restrictions: no
  73. smooth scroll, no ENQ/Answerback, no setup screen (use SET TERMINAL commands
  74. instead), no split speeds.  Double height/width characters are simulated.
  75.  
  76. In addition, the VT320/340 emulator lacks the following functions of the
  77. corresponding real terminals:
  78.  
  79.  . Down loadable soft fonts
  80.  . ReGis graphics (VT340/330)
  81.  . Dual sessions in split screens (VT340/330)
  82.  . Local screen editing and block transmission (for security reasons)
  83.  . Answerback (also for security reasons)
  84.  . Selective erasure (as a character attribute, a formatted screen item)
  85.  . And many of the exotic and rarely known features of the DEC VT340/330
  86.    series: mostly formatted screen and graphics operations highly specialized
  87.    to DEC hardware.
  88.  
  89. When you type the escape character (normally Ctrl-σ) while in Tektronix
  90. graphics mode, the screen goes back to text memory.  Then when you type the
  91. argument character, the graphics screen reappears (unless the argument was C
  92. or P).  Ctrl-σF will not file the graphics screen, but rather the text screen,
  93. because that's the screen that's showing after type the Ctrl-σ key.  To file
  94. the graphics screen (in TIFF format), use Ctrl-End (which has the Kermit verb
  95. \Kdump assigned to it by default).
  96.  
  97. When printing a graphics screen to a black-and-white printer, make sure
  98. your graphics image has a black background.  Otherwise you are likely to
  99. get a solid black printout, since most graphics printer drivers print a
  100. black dot for every dot that's illuminated on the screen.
  101.  
  102. If your display adapter lacks sufficient memory (as do CGA and the early 64K
  103. EGA boards), then when you toggle away from a graphics screen, or type the
  104. connect-mode escape character (Ctrl-σ), the graphics image will be lost.
  105. Furthermore, certain graphics images may be overlaid with vertical stripes on
  106. small (64K) EGA systems.
  107.  
  108. In VT100/300 emulation on the IBM family, receipt of the ESC ╒ 4 m (turn on
  109. underscore) command results in reverse video rather than underscore on IBM CGA,
  110. EGA and other color monitors.  This was done to avoid showing underscoring
  111. as the IBM specification of non-bold blue on black.
  112.  
  113. If a file is sent to the PC, and MS-DOS Kermit has SET FILE WARNING OFF
  114. (meaning, overwrite existing files when incoming files arrive with the same
  115. name), and the sender reports the file size in an Attribute packet, and this
  116. size is larger than the available disk space on the PC, then MS-DOS Kermit
  117. will properly refuse the file, but will also destroy any previously existing
  118. file of the same name.
  119.  
  120. SET DEST DISK does not redirect output of REMOTE commands to disk -- they come
  121. to the screen, by design.  Use the ">" output redirection symbol for this, for
  122. example: "remote dir > files.dir".
  123.  
  124. The name and password that you specify in SET SERVER LOGIN must be matched
  125. exactly by the ones in REMOTE LOGIN.  Alphabetic case matters.
  126.  
  127. It can be very difficult sometimes to interrupt execution of a script from the
  128. keyboard by typing Ctrl-C.  Particularly scripts with INPUT commands that have
  129. long timeouts, within loops, etc.  If you think your script needs to be
  130. manually interrupted at critical points, you can use the following trick:
  131.  
  132.     SET ALARM 3
  133.     ECHO Type something now if you want to quit...\13
  134.     PAUSE 3
  135.     IF NOT ALARM STOP
  136.  
  137. This works because PAUSE is interruptable by any keyboard input.
  138.  
  139. The last line of a TAKE command file (or MSKERMIT.INI) must end with a
  140. carriage-return/linefeed sequence (like all the other lines in the file), or
  141. it might not be processed by the program.
  142.  
  143. Commands in TAKE-files or MSKERMIT.INI can be continued by including "-" as
  144. the last character on the line, but NOT if the line ends with a trailing
  145. comment.  In other words, you can't have a trailing comment on a continued
  146. line.  If you need to end a line with a dash, but this dash is to be part of
  147. the command rather than a continuation symbol, then use \45 instead or put a
  148. comment AFTER the dash.
  149.  
  150. Trailing comments can be used only in command files.  All text starting with
  151. the first semicolon through the end of line is ignored.  If you need to include
  152. an actual semicolon in a command, precede with a backslash (\;).
  153.  
  154. If you need to include a question mark in a command file, use \63.  A literal
  155. question mark will cause a help message to appear on your screen.
  156.  
  157. There may be translation errors in the VT320 emulator for international
  158. characters entered at the keyboard or received from the host when the terminal
  159. character set is LATIN1 (none are currently known).  If you encounter a
  160. mistranslated character, or you want to change one of Kermit's proper
  161. translations, use the SET KEY and SET TRANSLATE INPUT commands.  For example:
  162.  
  163.   SET KEY \199 \195         ; Make key scan code 199 send code 195
  164.   SET TRANSL INP \195 \199  ; Translate arriving 195 code to 199
  165.  
  166. REMOTE TYPE and other REMOTE commands may result in an error "Unable to open
  167. CON".  This can result from insufficient FILES= in CONFIG.SYS or systems with
  168. all file handles used by, say, a network shell.  FILES= should be at least 20.
  169.  
  170. Other errors may be introduced by your DOS Environment line COMSPEC=, which
  171. Kermit uses to find COMMAND.COM in order to execute PUSH, RUN, and other
  172. commands.  This line is set by the SHELL= line in your CONFIG.SYS file.  If
  173. you have a COMSPEC= line, make sure it designates the location and name of
  174. your DOS command processor.  Furthermore, if you have a SHELL= line in your
  175. AUTOEXEC.BAT, it will result in a SHELL= line in your DOS environment, and
  176. this will take precedence over your COMSPEC= line, so if you use one of these,
  177. make sure it is correct too.  To examine your DOS environment for COMSPEC=
  178. and SHELL= lines, type the DOS command SET by itself with no arguments.
  179.  
  180. Printer support...  Transparent printing is started when the host sends the
  181. sequence ESC ╒ 4 i, and stops when the host sends ESC ╒ 5 i.  Transparent
  182. printing passes all characters, including escape sequences, that arrive at the
  183. port directly to the printer without translation (but strips off the parity
  184. bit if Kermit's parity is not NONE).  Character translation for printing --
  185. whether done by transparent print, PrintScreen key, logging to PRN, etc -- if
  186. needed, must be done by the DOS printer driver or other utility outside of
  187. Kermit.
  188.  
  189. When using Kermit through a terminal server (particularly those that execute
  190. the TCP/IP Telnet protocol), it is often necessary to SET PARITY EVEN in order
  191. to transfer files.  It is also often impossible to use very long packets.
  192. Try SET RECEIVE PACKET-LENGTH 80, working up or down to the longest length
  193. that works.
  194.  
  195. MS-DOS Kermit must be assembled with MASM (Microsoft Assembler) 5.0 or later
  196. (and linked with the accompanying LINK), because the symbol tables are too big
  197. for earlier MASM versions.  (In fact, all modules but MSZIBM.ASM can also be
  198. assembled by MASM 4.0.)  Reportedly, the program can also be built using
  199. Borland TASM (although several harmless warning messages appear) and TLINK, as
  200. well as Xenix MASM/DOSLD, and Intel ASM86, but MS-DOS Kermit is designed to be
  201. built by Microsoft MASM and LINK.
  202.  
  203. On early (original motherboard & BIOS) PCs, and on systems that mimic them
  204. (e.g. early Compaqs), the cursor may assume a strange shape upon return from
  205. CONNECT mode.  This is caused by a bug in the early BIOS, which stored cursor
  206. attributes incorrectly.  The PC Tech Journal article discussing the problem is
  207. "The Dashed Cursor", by Paul Pierce, PC Tech J., Dec. 1985, page 47.  He
  208. suggests the following fix:
  209. ;
  210. ; Program FIXCURS.ASM by Paul Pierce, PC Tech Journal, Dec 1985, page 47.
  211. ;
  212. code    segment public 'code'
  213.         assume cs:code, ds:code, es:nothing
  214. ;
  215. ;       This program is set up to be made into a COM file
  216. ;
  217.         org     100H
  218. ;
  219. ; First check for the monochrome adapter.
  220. ;
  221. start:  int     11H             ; set ax = equipment flag
  222.         and     al,30H          ; mask off all but video bits
  223.         cmp     al,30H          ; test for monochrome adapter
  224.         jne     exit            ; jump if not monochrome
  225. ;
  226. ; Now check for incorrect cursor mode returned from the Bios
  227. ;
  228.         mov     ah,3            ; call bios to get cursor type
  229.         int     10H             ;
  230.         cmp     cx,0607H        ; check for invalid (color) type
  231.         jne     exit            ; jump if not a bad value
  232. ;
  233. ; At this point we know that the monochrome adapter is in use and that
  234. ; the bios cursor mode is incorrect.
  235. ; Call the bios to set the cursor type correctly.
  236. ;
  237.         mov     cx,080cH        ; use correct cursor type
  238.         mov     ah,1            ; call bios to set cursor type
  239.         int     10H
  240.  
  241. exit:   mov     ah,0            ; exit back to DOS
  242.         int     21H
  243.  
  244. code    ends
  245.         end     start
  246.  
  247.  
  248. GENERAL WORDS ON DOS VERSUS ANY COMMUNICATIONS PROGRAM
  249.  
  250. Shift-Printscreen can cause the PC to hang if there is no attached printer.
  251. This is a BIOS feature, Kermit never receives the command.  It occurs most
  252. frequently with a printer interface that has nothing plugged into it.  If this
  253. happens during terminal emulation, try pressing Alt-= several times to reset
  254. the terminal.
  255.  
  256. When used in remote mode, e.g. as a server, a REMOTE HOST command can invoke
  257. the DOS critical error handler, which issues its familiar "Abort, Ignore,
  258. Retry?" message on its real screen, and is waiting for a response from its own
  259. real keyboard, and so the server will no longer respond.  Kermit attempts to
  260. catch many of these errors before DOS learns learns about them, but some
  261. cannot be avoided (like disk i/o errors).
  262.  
  263. Interaction between MS-DOS Kermit and various terminate-and-stay-resident
  264. (TSR) programs is necessarily unpredictable, depending upon how "well behaved"
  265. they are.  Certain console, mouse, or graphics drivers might interfere with
  266. file transfer, etc.  Caution should be used when invoking certain TSR programs
  267. while PUSHed from Kermit (e.g. using the PRINT command for the first time), as
  268. not all of these programs observe proper etiquette for allocating and freeing
  269. memory, and more importantly the TSRs will be loaded above Kermit into the
  270. middle of memory where they may prevent large programs from loading later.
  271.  
  272. As a concrete example of the above, certain mouse drivers may prevent Kermit
  273. from transferring files, and possibly also from recovering from timeouts
  274. during script execution, or even from XOFF deadlocks during terminal emulation.
  275. This is because Kermit and the mouse driver are competing for the same
  276. interrupt, and the mouse driver might not be playing by the rules.  Possible
  277. workarounds include:  (1) remove the mouse driver from your CONFIG.SYS file;
  278. (2) if your mouse driver can be turned off and on (e.g. if you have MOUSE
  279. OFF and MOUSE ON commands), turn the mouse off during Kermit execution; (3)
  280. give the MS-DOS Kermit command SET TIMER OFF.
  281.  
  282. If TSR programs are interfering with Kermit (by taking over the timer or
  283. serial port interrupts), you should remove them all from your AUTOEXEC.BAT
  284. or CONFIG.SYS files, and then put them back one by one until you have
  285. identified the one that's causing the problem.  Don't run this one while
  286. running Kermit.
  287.  
  288. MS-DOS Kermit may be run as an external protocol by other programs, such as
  289. BBS systems.  Kermit restores the interrupt vectors properly, and leaves
  290. communication port interrupts turned off, as it should.  It is the
  291. responsibility of the invoking program to turn them back on if necessary.
  292.  
  293. Some PCs have more than two serial ports, but until recently there has been no
  294. standard about addresses for COM3 and COM4.  PC DOS 3.30 does not assign them
  295. either because it is really a problem of the system ROM Bios boot code run
  296. when the power is turned on.  However, Kermit will use COM3 and/or COM4 if the
  297. base address of a port is placed in low memory words 40:4H (COM3) or 40:6H
  298. (COM4); the tests described above are then carried out.  One restriction is
  299. that the Interrupt ReQuest number (IRQ in the serial port board manual) must
  300. be either IRQ4 or IRQ3.  Kermit attempts to locate which line is correct with
  301. a short test.  If the test is not successful it uses the IRQ4 for COM3 (and
  302. for COM1) and IRQ3 for COM4 (and for COM2) on the PC/AT, and on the PS/2 it
  303. uses IRQ3 for COM2, COM3, and COM4.  Check your communication board and its
  304. manual.  The DOS utility DEBUG can be used to create a short program to insert
  305. the board's addresses into the segment 40H memory locations; a sample program
  306. is given below.
  307.  
  308. IBM PC/XT/AT and PS/2 Serial Port Numbers:
  309.  
  310.   Serial Port    Address     IRQ Line         Conventions
  311.   COM1           03F8H       4                IBM standard
  312.   COM2           02F8H       3                IBM standard
  313.   COM3           ?           4 (3 for PS/2)   Board
  314.   COM4           ?           3                Board
  315.  
  316. The addresses shown as query marks are to be found in the board's reference
  317. manual; values such as 2E8H and 2E0H would be common.  However, there is no
  318. standard for anything to do with COM3 and COM4 on non-PS/2's.
  319.  
  320. Assuming that you have selected an address in harmony with the rest of the
  321. system, set the board's switches or jumpers, and use DEBUG to insert the
  322. address(es) in segment 40H memory.  The example below creates a small program
  323. named SETCOM3.COM to put address 02E8H into the memory word 40:04H for COM3
  324. and writes the program to drive A.  Substitute the desired drive letter for
  325. "a:" in the second line below.  The dash (-) is DEBUG's command prompt,
  326. and the xxxx:nnnn lines are addresses for which DEBUG prompts you to type
  327. an instruction, such as "mov ax, 40".
  328.  
  329.   A> DEBUG                   don't type these comments
  330.   -n a:setcom3.com           sets name of output file
  331.   -a                         assemble command
  332.   xxxx:0100 mov ax,40        value 40h
  333.   xxxx:0103 mov es,ax        put it into register es
  334.   xxxx:0105 mov ah,02        the 02 part of 02E8H
  335.   xxxx:0107 mov al,e8        the E8 part of same
  336.   xxxx:0109 es:
  337.   xxxx:010A mov ╒4σ,ax       store in 40:4 for com3 (╒6σ for com4)
  338.   xxxx:010D int 20           return to DOS
  339.   xxxx:010F                  blank line to end assemble mode
  340.   -r cx                      show contents of register cx
  341.   CX 0000
  342.   : 0f                       set register cx to write 0fh bytes
  343.   -w                         write material to the disk file
  344.   -q                         quit debug
  345.   A> DEBUG setcom3.com
  346.   -u                         unassemble to see if all is well
  347.   -q                         quit debug
  348.  
  349. Note, for COM4, use ╒6σ above rather than ╒4σ, and of course employ your
  350. board's port address in place of 02E8H (check the manual).  Finally, try it:
  351.  
  352.   A> setcom3                 run the program
  353.   A> DEBUG                   now see what's down there
  354.   -d 40:00                   display bytes in seg 40H
  355.      ( Shows many bytes.  See yours?  Good. )
  356.   -q
  357.   A>
  358.  
  359. A small side effect noted in practice is the first time the extra port is used
  360. there may be garbage from it.  Just return to the Kermit prompt and try again,
  361. if necessary SET PORT to the other COM lines momentarily, all should be well
  362. the second time.
  363.  
  364.  
  365. KNOWN BUGS IN MS-DOS KERMIT VERSION 3.0
  366.  
  367. SET EOF CTRL-Z, when used to upload text files which actually contain Ctrl-Zs,
  368. might result in gaps or truncation in the vicinity of the Ctrl-Z.  This is
  369. an artifact of DOS file i/o.
  370.  
  371. The graphics display on the PS/2 Model 30, whose graphics adapter is neither
  372. a real EGA nor a real VGA, is elongated vertically so that certain normal
  373. Tektronix graphics images might not fit on the screen.
  374.  
  375. Reportedly, MS-DOS Kermit 3.0 sometimes loses certain terminal settings, such
  376. as WRAP or tab settings.  This might be caused by Kermit's new ability to
  377. accept VT300 8-bit control sequences when connected to a system that sends
  378. parity, and you have given the command SET DISPLAY 8 (which should not
  379. normally be done).  To restore default tab settings quickly, use the command
  380. SET TERM TABS AT 1:8.
  381.  
  382. Some users have reported extended waits if they use a network connection and
  383. have said MODE COM1:speed,n,8,1,P.  The trailing P means "Printer", telling
  384. DOS to do very lengthy retries, and if DOS gets control of the port it may do
  385. just that.  Suggested alternative is to remove the ",P" above.  Recall, SHOW
  386. commands that need information about a serial port may activate COMx unless
  387. another port has been selected.
  388.  
  389. Reportedly, Kermit does not operate properly on a PS/2 Model 25 under DesqView.
  390. Further reports welcome.
  391.  
  392. Reportedly, Kermit receives a file access error when attempting to write files
  393. on a PC-NFS file server.  Further information is needed.
  394.  
  395. -------------------------------------------------------------------------
  396. ADDITIONS TO THIS FILE AFTER VERSION 3.0 WAS RELEASED ON JANUARY 16, 1990:
  397.  
  398. The non-IBM-compatible versions of MS-DOS Kermit 3.0 are not done yet.  Some
  399. (DEC Rainbow, Heath/Zenith-100, HP, GRiD) are currently in preparation and
  400. will be announced when they are ready.  Volunteers are needed for the others
  401. (Victor, Sanyo, TI, NEC, etc).  In the meantime, the new mss*.* source files
  402. are incompatible with the old msu, msg, msx, msy, and msz system-dependent
  403. source files for the non-IBM systems.
  404.  
  405. Characters that arrive during terminal emulation that are translated by the
  406. SET TRANSLATE INPUT mechanism bypass the current shift-in/shift-out state.
  407. This means that SET TRANSLATE INPUT cannot be used successfully with an
  408. 8-bit terminal character set in a 7-bit communication environment.
  409.  
  410. The MSKERMIT.INI file on the distribution diskette contains two errors:
  411.  1. In ERRSTP definition, "\%\13" should be changed to "\%1\13".
  412.  2. In COPY definition, second "if < argc 2" should be "if < argc 3".
  413. These errors are fixed in the online copy.
  414.  
  415. When using version 3.0 in terminal mode with a DEC operating system (like
  416. VAX/VMS) that knows your terminal type is VT320, you should SET DISPLAY 8 in
  417. order for Kermit to properly process 8-bit graphic and control characters
  418. which certain applications (such as Word-11 and EVE) will send.
  419.  
  420. RTS/CTS half-duplex hardware handshaking does not work in all circumstances.
  421.  
  422. Reportedly, Wyse big screens have problems in Tek mode.
  423.  
  424. Reportedly, Version 3.0 hangs when run on certain AT&T 6300 but not others.
  425. Users of this PC are urged to report the behavior of 3.0 on their systems.
  426. Specify the version of DOS you are running, and whether it is IBM PC-DOS or
  427. AT&T MS-DOS.
  428.  
  429. Reportedly the "LEDs" in the mode line don't work during VT320 emulation,
  430. but they continue to work in VT102 emulation.
  431.  
  432. Orchid Designer Professional VGA board doesn't work in 132-column mode.  This
  433. is because this board has the same signature (video mode) as the earlier,
  434. incompatible model (Orchid Designer), and Kermit can't tell the difference
  435. between the two.
  436.  
  437. Although Kermit does not handle REGIS graphics, there is reportedly at least
  438. one REGIS-to-sixel converter on the market: RETOS, a DEC product for VAX/VMS.
  439.  
  440. So that key translation and macros can work on both IBM and non-IBM compatible
  441. PCs, Kermit uses the system BIOS to obtain key scan codes.  But the IBM BIOS
  442. does not produce scan codes for certain keys, notably Num Lock.
  443. Unfortunately, Num Lock happens to be exactly where you would want to put the
  444. DEC PF1 (Gold) key for DEC VT keypad-oriented applications.
  445.  
  446. SET LO is no longer a sufficient abbreviation for SET LOCAL-ECHO.  Use SET LOC.
  447.  
  448. Reportedly, scrolling does not work correctly on the Zenith 386SX PC (also
  449. said to be true of earlier versions of Kermit).  Most likely a problem with
  450. this machine's video BIOS.
  451.  
  452. ------------------------------
  453.  
  454. PATCH TO ADD THE VT100 TERMINAL TYPE TO MS-DOS KERMIT 3.0
  455.  
  456. This procedure modifies MS-DOS Kermit v3.00 for IBM PCs to change the terminal
  457. identification response for the VT102 kind from a VT102 (ESC ╒ ? 6 c) to a
  458. plain VT100 (ESC ╒ ? 1 c). This change requires the DOS DEBUG program. The
  459. effect will be to inform hosts to not use character insert and deletion and
  460. thus avoiding a part of Kermit which does operations directly on screen memory
  461. rather than operating through the Bios, which may interfere with voice
  462. synthesizers, screen readers, and similar utilities:
  463.  
  464. Assuming that your MS-DOS Kermit v3.00 is named MSVIBM.EXE on drive C:, do the
  465. following:
  466.  
  467. C>copy msvibm.exe msvibm.tmp    change the name so DEBUG will not be confused
  468. C>debug msvibm.tmp              Below, the minus sign is DEBUG's prompt.
  469.                                 You type the material shown after that prompt.
  470. -r                              Show registers (just type "r")
  471.                                 Find the CS=value and add 1000h to that value;
  472.                                 i.e, add 1 to the leftmost digit, in hex.
  473.                                 Example if CS=31C6, the result is 41C6.
  474. -rds                            Prepare to change DS register.
  475.  
  476. See old value yyyy and then the colon on the next line.  After the colon,
  477. type the new computed value xxxx.
  478.  
  479. yyyy:xxxx                       <- Type number computed above, after the colon.
  480. -d ds:fb30                      Display a block of hex values.
  481.                                 Half way across the first line see "╒?6c".
  482. -e ds:fb38                      Edit byte at address DS:FB38.
  483. xxxx:fb38 36:                   <- type 31, after the last colon (or dot).
  484. -d ds:fb30                      display the block again. ╒?6c should now
  485.                                 be ╒?1c. If not, skip the w commmand below
  486.                                 and enter q to quit, then start over.
  487. -w                              Write the changed file.
  488. Writing 20140 bytes             A status message from Debug.
  489. -q                              quit Debug
  490.  
  491. C>ren msvibm.tmp kerv100.exe    Make the new file have an executable name.
  492. C>kerv100                       Try it (note: msvibm.exe is still original).
  493. MS-Kermit>set term vt102        Should respond to queries as a vanilla VT100.
  494.  
  495. This patch from Joe Doupnik
  496. jrd@usu.Bitnet, jrd@watsun.cc.columbia.edu
  497.  
  498. This patch does not change Kermit's behavior in any way, except the later the
  499. terminal ID sequence it sends when you have set Kermit's terminal type to
  500. VT102.  The effect should be to trick host software into thinking you really
  501. do have a VT100, and therefore not to send any character insert/delete escape
  502. sequences that would cause Kermit to do direct screen writes.  Tested with
  503. VAX/VMS SET TERM/INQUIRE, and VMS EDT was verified to not send insert/delete
  504. character sequences when it believes the terminal is a VT100.
  505.  
  506. A future release of MS-DOS Kermit may add VT100 as a formal terminal type, and
  507. may (repeat, may) have a SET option to let the user decide whether Kermit
  508. should use direct screen writes or Bios operations for character insertion
  509. and deletion in VT102 and VT320 modes.
  510.  
  511. -----------------------------------------------------------------------------
  512.  
  513. More bugs...
  514.  
  515. Defining a session log using a macro does not work properly: if you
  516. DEFINE XXX LOG SESSION X.LOG, then XXX results in a transaction log rather
  517. than a session log, and to add to the confusion, SHOW LOG reports that a
  518. packet log named X.LOG is in use.  The same bug happens with LOG PACKETS.
  519.  
  520. A real VT300 series terminal prints received Ctrl-Z characters as big reversed
  521. question marks, but Kermit does not print anything for this character.  This
  522. can cause alignment problems when editing files using TPU on VAX/VMS, etc.
  523.  
  524. CD command displays the new directory.  Version 2.32/A didn't do this.  This
  525. behavior can be annoying in script or TAKE file execution.
  526.  
  527. Reportedly, the Norwegian/Danish NRC terminal character set mistranslates
  528. capital O-slash (the replacement for ASCII \) as small o-slash (ASCII ]) under
  529. code page 865.
  530.  
  531. If you SET PORT DECNET, the maximum length of a Kermit command is reduced to
  532. seventeen characters.  Temporary workaround: After giving the command SET
  533. PORT DECNET, make sure the next command is 17 characters or less.  After that,
  534. everything is back to normal.
  535.  
  536. Reportedly on the NESS-286, NESS-88, and Olivetti M24 PCs, it is necessary to
  537. type Ctrl-Break after escaping back from terminal mode with Alt-X in order to
  538. get the MS-Kermit> prompt.  Furthermore, the NESS-88 cannot reconnect after
  539. escaping back (this is said to be caused by a BIOS bug).
  540.  
  541. Reportedly, version 3.00 with SET PORT BIOS1 causes Rainbow Software's
  542. (Edinburgh) PADPORT TSR program to go into a endless loop, whereas 2.32/A and
  543. earlier did not.
  544.  
  545. Reportedly, in order for version 3.0 to work properly under DESQview, it must
  546. be given at least 160K, even with only one screen of rollback memory.  If
  547. insufficient memory is allocated for Kermit under DESQview, garbage will
  548. appear at the MS-Kermit> prompt upon escaping back from a terminal connection,
  549. and then Kermit hangs.
  550.  
  551. Reportedly, Kermit does not work well with the IBM EBIOS Async server.  Many
  552. characters are lost.
  553.  
  554. Limitation (not bug): SET TERMINAL CHARACTER SET is effective only for text
  555. screens, not for graphics screens.  This is because the fonts for all the
  556. special characters have not been designed yet.
  557.  
  558. End of file KERMIT.BWR.
  559.