home *** CD-ROM | disk | FTP | other *** search
/ High Voltage Shareware / high1.zip / high1 / DIR31 / KERM313.ZIP / KERMIT.UPD < prev    next >
Text File  |  1993-07-12  |  57KB  |  1,261 lines

  1. File KERMIT.UPD (MSKERM.UPD)                          June 1993
  2.  
  3.  
  4.              SUPPLEMENT TO "USING MS-DOS KERMIT":
  5.          CHANGES AND NEW FEATURES SINCE VERSION 3.11
  6.  
  7.  
  8. Most recent update: Mon Jul 12 09:41:41 1993
  9.  
  10.   Copyright (C) 1985, 1993, Trustees of Columbia University in the City of New
  11.   York.     The MS-DOS Kermit software may be reproduced and shared without
  12.   restriction as long as this copyright notice is retained, except that it may
  13.   not be licensed or sold for profit as a software product itself, and it may
  14.   not be included in or distributed with commercial products or otherwise
  15.   distributed by commercial concerns to their clients or customers without
  16.   written permission of the Office of Kermit Development and Distribution,
  17.   Columbia University.
  18.  
  19. MS-DOS Kermit is a product of Kermit Distribution, Columbia University Center
  20. for Computing Activities.  The principal author of the program is Professor
  21. Joe R. Doupnik of Utah State University, with help from other volunteer
  22. programmers all over the world.     The software is copyright by the Trustees of
  23. Columbia University in the City of New York, with portions of the source code
  24. also copyright by other institutions including Waterloo University (Ontario,
  25. Canada) and the (US) National Center for Supercomputing Applications (NCSA).
  26.  
  27. Kermit software is written by volunteer programmers as a public service, and
  28. is furnished without warranty of any kind.  Neither Columbia University, nor
  29. the individual authors, nor Digital Equipment Corporation, nor Digital Press,
  30. nor Data General Corporation, nor any other institution or individual that has
  31. contributed to the development and documentation warrant the software in any
  32. way.
  33.  
  34. See the file KERMIT.HLP (MSKERM.HLP) for contact information.
  35.  
  36.  
  37. UPDATES
  38.  
  39. MS-DOS Kermit 3.11 was released September, 1991, and is fully described in
  40. "Using MS-DOS Kermit", second edition. MS-DOS Kermit 3.13 has several features
  41. not described in the book.  This file describes these new features.
  42.  
  43. MS-DOS Kermit 3.12 was released in September, 1992.  It is a maintenance
  44. release, but with several new features added, including:
  45.  
  46.  . Networking and communications improvements, including ODI support.
  47.  . Japanese Kanji text-file transfer translation.
  48.  . Locking-shift protocol for file transfer.
  49.  . A new method for transferring files with IBM mainframes.
  50.  . Ability to SET PORT TCP/IP to non-TELNET ports.
  51.  
  52. MS-DOS Kermit 3.13 was released in July 1993 with the following new features:
  53.  
  54.  . A new faster method for transferring binary and precompressed files
  55.  . Larger packets and windows allowed, up to 9024 x 31.
  56.  . Switching among multiple simultaneous TCP/IP sessions
  57.  . Data General DASHER terminal emulation
  58.  . Graphics-mode support for 132-column operation on EGA and VGA video adapters
  59.  . Text-mode support for 132-column operation on ET4000 and other VESA adapters
  60.  . Horizontal scrolling
  61.  . Expanded-memory option for screen rollback and graphics image retention
  62.  . Hebrew character-set translation and Hebrew terminal emulation
  63.  . East European character-set translation
  64.  . Icelandic CP861 code page support
  65.  . Separate code page selection for terminal emulation and file transfer
  66.  . Compose-key sequences for entering accented characters
  67.  . New KERMIT PATH environment variable
  68.  . Support for Novell SLIP_PPP ODI driver and other networking improvements
  69.  . BOOTP improvements
  70.  . TELNET improvements, including option negotiation display
  71.  . DIAL-command support for additional modem types
  72.  
  73. UPDATE: KERMIT ENVIRONMENT VARIABLE
  74.  
  75.   The DOS environment variable KERMIT may be used for setting certain
  76.   parameters, even if Kermit doesn't read its initialization file.
  77.   Set this environment variable in your AUTOEXEC.BAT file:
  78.  
  79.     SET KERMIT=text
  80.  
  81.   <text> can be one or more MS-DOS Kermit startup parameters of the form
  82.   <name> <value>, separated by semicolons.  Startup parameters include:
  83.  
  84.     INPBUT <number>         (allocates storage for INPUT command buffer)
  85.     ROLLBACK <number>         (allocates storage for <number> rollback screens)
  86.     WIDTH <number>         (allocates sorage for given screen width, 80-207)
  87.     COMn <address> <irq>     (sets COM1, COM2, COM3, or COM4 address and IRQ)
  88.     PATH <path>             (where Kermit looks for TAKE files)
  89.  
  90.   PATH and WIDTH are new to version 3.13.  WIDTH defines the width of the
  91.   terminal-screen rollback memory.  If you want to roll back wide screens,
  92.   you should specify the width, e.g. 132.  AUTOEXEC.BAT Example:
  93.  
  94.     SET KERMIT=ROLLBACK 50;WIDTH 132;PATH C:\KERMIT  
  95.  
  96.   PATH affects the initialization-file search, the TAKE command, and
  97.   the IF INPATH command.
  98.  
  99. UPDATE: DIALING AND THE DIALING DIRECTORY
  100.  
  101. MS-DOS Kermit does not have a built-in DIAL command, but if you installed
  102. Kermit from the distribution disk according to instructions, you'll be able to
  103. use the DIAL macro defined in Kermit's initialization file, MSKERMIT.INI.
  104. DIAL uses two additional files: xxxxx.SCR, a script program for dialing your
  105. modem ("xxxxx" is HAYES, T3000, ROLM, etc, see below for a list), and
  106. DIALUPS.TXT, your dialing directory (see MODEMS.HLP).
  107.  
  108. If you do not have a modem for which a dialing script is provided, you can
  109. write a new script program for dialing, modelled after one of the other
  110. dialing scripts (see Chapter 14 of "Using MS-DOS Kermit) and set a DOS
  111. environment variable, MODEM, to be the name of your modem; the dialing script
  112. should have the same name, with a filetype of .SCR.  For example, for dialing
  113. an XYZV32 modem, put the following line your AUTOEXEC.BAT file:
  114.  
  115.   SET MODEM=XYZV32
  116.  
  117. and install a XYZV32.SCR file in the same directory as your MSKERMIT.INI file.
  118.  
  119. If you don't have a dialing script for your type of modem, you can also dial
  120. it "manually" in CONNECT mode.
  121.  
  122. To use a dialing directory, create a plain text file called DIALUPS.TXT.  The
  123. file contains one line per entry:
  124.  
  125.   name     number      speed       parity   comments
  126.  
  127. The "name" is the name you want to use for this entry in your DIAL commands.
  128. "number" is the telephone number; "speed" is the dialing speed in bits per
  129. second, "parity" is the parity to use (even, odd, mark, space, or none).  The
  130. name, number, speed, and parity are separated from each other by one or more
  131. spaces.     Any words after the parity are ignored, so you can use them for
  132. comments.  If trailing fields (speed, parity) are omitted, Kermit's current
  133. values are used (but then you can't have a comment).  If you want to tell
  134. Kermit explicitly to use its current value for speed or parity, use an equal
  135. sign (=).  Examples:
  136.  
  137.   sprintnet  7654321      2400     mark
  138.   oofanet    6543210      1200     odd    This entry has a comment.
  139.   tymnet     93,876-5432  2400     even    You can put punctuation in the phone #.
  140.   hometone   T5551212      1200     none    T in number forces tone dialing
  141.   homepulse  P5551212      1200     none    P in number forces pulse dialing
  142.   anyspeed   999-9999      =     none    Use current speed, whatever it is.
  143.   anyparity  888-8888      9600     =    Use current parity, whatever it is.
  144.   whocares   777-7777      =     =    Use current speed and parity.
  145.   defaults   987-6543
  146.  
  147. To use the dialing directory, just type DIAL followed by the name, spelled out
  148. in full (case doesn't matter), for example:
  149.  
  150.   MS-Kermit>dial tymnet
  151.  
  152. If you type a name or number that is not in the directory, Kermit dials exactly
  153. the characters you type, for example DIAL 5552370 dials the number 5552370.
  154. DIAL FRED (if FRED is not in the directory) tells Kermit to dial the letters
  155. FRED, which won't accomplish anything useful with most modems.
  156.  
  157. To view your dialing directory, type LIST.  To view particular entries in your
  158. dialing directory, type LIST XXX, where XXX is a sequence of characters that
  159. appears in the desired entries (usually the name).  In the LIST command, case
  160. is important because it uses the DOS FIND program to list the entries:
  161.  
  162.   MS-Kermit>list tymnet
  163.   tymnet     93,876-5432  2400     even    You can put punctuation in the phone #.
  164.  
  165. In your dialing directory, you can include spaces in the name or number by
  166. enclosing it in braces, as in these examples:
  167.  
  168.   {my computer}     555-4321         2400   none
  169.   your-computer     {9 1 800 555 1234}  1200   odd
  170.   {our computer} {212 701 0000}        19200   space
  171.  
  172. Now you can type commands like DIAL MY COMPUTER, DIAL OUR COMPUTER.
  173.  
  174. The DIAL command assumes your dialing directory is stored on your PC as
  175. C:\KERMIT\DIALUPS.TXT.    If you want to keep it someplace else or you need to
  176. use some other name, create a DOS environment variable in your AUTOEXEC.BAT
  177. file:
  178.  
  179.   SET DIALFILE=C:\PHONES\DIALING.DIR
  180.  
  181. If you want to use the directory sometimes but not others, define a separate
  182. macro for dialing without it:
  183.  
  184.   define call take \m(_modem).SCR
  185.  
  186. (where _modem is defined as your modem type, e.g. HAYES, and you have an
  187. appropriate dialing script file in your PATH, e.g. HAYES.SCR).    The _modem
  188. variable is set automatically from your DOS environment variable, MODEM, and
  189. is HAYES by default (i.e. if there is no MODEM environment variable).
  190.  
  191. As of MS-DOS Kermit 3.13, the DIAL command now supports the following modems:
  192.  
  193.    Hayes 1200 and 2400 
  194.    Hayes ULTRA 14400
  195.    Penril Alliance V.32 
  196.    Practical Peripherals 14400
  197.    Rolm CBX DCM 
  198.    SupraFAXmodem V.32bis 
  199.    Telebit QBlazer V.32 
  200.    Telebit T3000 V.32bis 
  201.    Vadic VA2400PA 
  202.  
  203. See MODEMS.DOS (MSMAAA.DOC) for further information.
  204.  
  205.  
  206. UPDATE: NEW FASTER METHOD FOR TRANSFERRING BINARY FILES
  207.  
  208. This feature allows you to improve MS-DOS Kermit's file transfer performance
  209. on connections that you know are transparent to a certain set of control
  210. characters.  It lets you tell MS-DOS Kermit exactly which control characters
  211. need to be prefixed and which ones do not when it is sending files.
  212.  
  213. SET CONTROL-CHARACTER UNPREFIXED { <code>..., ALL }
  214.   Says that you think it is safe to include the control character represented
  215.   by <code> without prefixing in packets which MS-DOS Kermit sends.  The
  216.   <code> is the numeric ASCII code for a control character, 0-31, 127-159, or
  217.   255.    For example, linefeed (code 10) is normally sent as two printable
  218.   characters, #J.  SET CONTROL UNPREFIXED 10 lets linefeed be sent literally.
  219.   You can include the word ALL to unprefix all control characters, or you can
  220.   specify a list of one or more numeric values, separated by spaces.  Examples:
  221.  
  222.      SET CONTROL UNPREFIXED 31         ; A single control character
  223.      SET CONTROL UNPREFIXED 2 4 5 18 20     ; A list of control characters
  224.      SET CONTROL UNPREFIXED ALL         ; All control characters
  225.  
  226.   If you can safely declare a lot of control characters to be UNPREFIXED, you
  227.   can send binary files (particularly precompressed ones) up to about 20-25
  228.   percent faster.  If you include a control character in this category that
  229.   causes trouble, however, the transfer will fail, so experimentation is
  230.   necessary.  NOTE: This command will not allow you to "unprefix" the
  231.   following characters if MS-DOS Kermit's current FLOW-CONTROL setting is
  232.   XON/XOFF: 17, 19, 145, 147; nor will it let you unprefix characters 127 or
  233.   255 on a TELNET (SET PORT TCP/IP) connection.
  234.  
  235. SET CONTROL-CHARACTER PREFIXED { <code>..., ALL }
  236.   Says that the given control character(s) must be prefixed in Kermit packets.
  237.   By default, all control characters, 0-31, 127-159, and 255, are prefixed.
  238.   NOTE: when sending files *to* MS-DOS Kermit, you must SET CONTROL
  239.   PREFIXED (at least) 1 129 (assuming the start-of-packet character is
  240.   Ctrl-A).
  241.  
  242. SHOW CONTROL-PREFIXING
  243.   Displays the code values of the control characters that are currently
  244.   UNPREFIXED.
  245.  
  246. The purpose of the SET CONTROL UNPREFIX command is to UNILATERALLY configure
  247. MS-DOS Kermit to skip prefixing and printable encoding of selected control
  248. characters to achieve higher performance when sending files.  This feature
  249. takes advantage of the fact that most (not all) Kermit programs will accept
  250. control characters within packet data-fields literally, provided they get
  251. through at all, and provided they do not have a special meaning to the
  252. receiving Kermit program (such as, in many cases, the packet-start and
  253. packet-end characters).
  254.  
  255. There is no protocol negotiation between the two Kermit programs to determine
  256. a "safe set" of control characters, and in fact any such negotiation would be
  257. largely meaningless, because in most cases the two Kermit programs don't have
  258. all the needed information.  For example, there might be a terminal server or
  259. PAD between them that is sensitive to a particular control character, even
  260. though the two Kermit programs are not.
  261.  
  262. If you include in your SET CONTROL UNPREFIXED list one or more control
  263. characters that are unsafe, any of several things might happen:
  264.  
  265.  1. Transfer of any file containing these characters will fail.
  266.  
  267.  2. The receiving Kermit program might be interrupted or halted.
  268.  
  269.  3. Your connection might become hung, stuck, or broken.  This includes the
  270.     situation where a control character causes a PAD, terminal server, or
  271.     similar device to change modes -- e.g. to go from online mode to command
  272.     mode.
  273.  
  274. The set of safe control characters depends on the two Kermit programs, their
  275. settings, the host operating systems and their settings, the communication and
  276. flow control methods, and all the devices, drivers, and protocols that lie
  277. between the two Kermit programs.  You must be willing to experiment in order
  278. to achieve the optimal safe set.
  279.  
  280. Under ideal conditions (totally transparent and clean serial connection, no
  281. Xon/Xoff, MS-DOS Kermit is not in SERVER mode, and C-Kermit has been told to
  282. SET TRANSFER CANCELLATION OFF), the minimum set of control characters that
  283. needs to be prefixed is:
  284.  
  285.   SENDER      RECEIVER       PREFIXED CONTROLS
  286.    MS-DOS Kermit   MS-DOS Kermit    1, 129
  287.    MS-DOS Kermit   C-Kermit        0
  288.    C-Kermit       MS-DOS Kermit    0, 1, 129
  289.    C-Kermit       C-Kermit        0
  290.  
  291. For example, to set up C-Kermit to unprefix the minimum set of prefixed
  292. control characters for sending files to MS-DOS Kermit, tell C-Kermit to:
  293.  
  294.   SET FLOW NONE           ; Or SET FLOW RTS/CTS
  295.   SET CONTROL UNPREFIX ALL
  296.   SET CONTROL PREFIX 1 129 ; C-Kermit always prefixes character 0
  297.  
  298. When the mininum set doesn't work, use the SET CONTROL PREFIX command to
  299. prefix additional control characters.  Some experimentation will be required.
  300. Here is the list of control characters that are apt to cause trouble and
  301. therefore likely candidates for prefixing:
  302.  
  303. set con p 0   ; Ctrl-@ = NUL, internal string terminator in C-Kermit.
  304.           ;         Also, often discarded as padding.
  305. set con p 1   ; Ctrl-A = Packet-start character.
  306. set con p 3   ; Ctrl-C = Packet breakout for remote-mode C-Kermit,
  307.           ;         packet breakout for server-mode MS-DOS Kermit,
  308.           ;         likely to cause interruptions on other systems.
  309. set con p 13  ; Ctrl-M = Carriage return, always prefix on TELNET connections.
  310. set con p 14  ; Ctrl-N = Shift Out
  311. set con p 15  ; Ctrl-O = Shift In
  312. set con p 16  ; Ctrl-P = Commonly-used X.25/X.3 PAD escape character
  313. set con p 17  ; Ctrl-Q = XON, must be prefixed with Xon/Xoff flow control
  314. set con p 19  ; Ctrl-S = XOFF, must be prefixed with Xon/Xoff flow control
  315. set con p 27  ; Ctrl-[ = ESC, prefix if going through some kind of ANSI device
  316. set con p 28  ; Ctrl-\ = CONNECT-mode escape for C-Kermit
  317. set con p 29  ; Ctrl-] = CONNECT-mode escape for TELNET
  318. set con p 30  ; Ctrl-^ = Cisco terminal server escape.
  319. set con p 127 ; Ctrl-? = DEL, often discarded as padding.
  320.           ;         Also becomes TELNET IAC if parity bit is added.
  321. set con p 128 ; = NUL     + 128
  322. set con p 129 ; = Ctrl-A + 128
  323. set con p 131 ; = Ctrl-C + 128
  324. set con p 141 ; = CR + 128
  325. set con p 145 ; = XON + 128
  326. set con p 147 ; = XOFF + 128
  327. set con p 255 ; 255 = TELNET IAC, use P on TCP/IP TELNET connections
  328.  
  329. Notes:
  330.  
  331.  . If MS-DOS Kermit has initiated a TCP/IP connection, prefixing of 255
  332.    (TELNET IAC) is forced automatically.
  333.  
  334.  . Kermit will not let you unprefix XON (17), XOFF (19), XON+128 (145), or
  335.    XOFF+128 (147) if its FLOW-CONTROL setting is XON/XOFF.  If you want to
  336.    unprefix these, make sure *both* Kermits have been told to SET FLOW NONE
  337.    (or RTS/CTS), and that XON/XOFF flow control is not in effect anywhere
  338.    along the communication path between the two Kermits.
  339.  
  340.  . When sending files to C-Kermit, you should normally SET CONTROL PREFIX 3
  341.    and SET CONTROL PREFIX 131, because C-Kermit (by default) takes two
  342.    Ctrl-C's (3 or 131) in a row as cancellation of packet-mode.     However, you
  343.    can UNPREFIX these characters if you know your file does not contain two
  344.    Ctrl-C's in a row, or if you tell C-Kermit to SET TRANSFER CANCELLATION
  345.    OFF, or SET TRANSFER CANCELLATION ON <code> <number> when you know that
  346.    <number> copies of <code> do not occur in a row in the data.
  347.  
  348. UPDATE: OTHER FILE TRANSFER IMPROVEMENTS
  349.  
  350.  . Bigger file transfer window sizes and packet buffers, depending on
  351.    available memory.  Packets may be up to 9024 bytes in length, and the
  352.    window can contain up to 31 packets of the maximum length.  Use the 
  353.    regular commands to select these sizes: SET RECEIVE PACKET-LENGTH and
  354.    SET WINDOW.    Also see the Memory Management section of KERMIT.BWR
  355.    (MSKERM.BWR). 
  356.  
  357.  . Locking shifts for more efficient transfer of 8-bit text on 7-bit
  358.    connections (important for Cyrillic, Hebrew, and Japanese text).  New
  359.    command:
  360.  
  361.    SET TRANSFER LOCKING-SHIFT { OFF, ON, FORCED }
  362.      The default setting is ON, meaning that MS-DOS Kermit will attempt to
  363.      negotiate use of this feature with the other Kermit if the parity is not
  364.      NONE, in which case locking shifts will be used if the other Kermit
  365.      agrees (C-Kermit 5A and IBM Mainframe Kermit 4.2.4 will agree, others
  366.      will not).     OFF means don't negotiate locking shifts, and FORCED means to
  367.      use them regardless of negotiations.
  368.  
  369.  . Dynamically variable packet length to adapt automatically to changing noise
  370.    conditions.    This happens automatically when MS-DOS Kermit is sending
  371.    files.  No commands are needed.  If packets are damaged by noise or
  372.    timeouts occur, MS-DOS Kermit cuts the packet length in half and then
  373.    gradually grows it back to the maximum negotiated size as (and if)
  374.    transmission errors subside.
  375.  
  376.  . A new file transfer "thermometer", improved statistics reporting including,
  377.    for serial connections only, the efficiency of the transfer expressed as a
  378.    percent.  This is the ratio of actual file characters transferred per
  379.    second to the connection speed.
  380.  
  381.  
  382. UPDATE: NEW CHARACTER-SET SUPPORT
  383.  
  384. A new command is available to tell MS-DOS Kermit what your actual code page
  385. is, for purposes of character-set translation during terminal emulation:
  386.  
  387.   SET TERMINAL CODE-PAGE CPnnn
  388.  
  389. where nnn are digits.  This command is necessary because most PCs fail to
  390. report active code pages other than CP437 and CP850 correctly, and so Kermit
  391. generally has no way to find out when you have some other code page loaded.
  392. This command is distinct from SET FILE CHARACTER-SET, so you can select
  393. translations for terminal emulation and file transfer separately if you want
  394. to.  MS-DOS Kermit knows about the following code pages:
  395.  
  396.  Code Page  File-Xfer  Term-Emul  Comments
  397.    CP437    Y       Y      Original PC, and usually hardware, code page
  398.    CP850    Y       Y      Multilingual West European code page
  399.    CP852*    Y       Y      Multilingual East European code page
  400.    CP860    Y       Y      Portuguese code page
  401.    CP861*    Y       Y      Icelandic code page
  402.    CP862*    Y       Y      Hebrew code page
  403.    CP863    Y       Y      Canadian-French code page
  404.    CP865    Y       Y      Norwegian/Danish code page
  405.    CP866    Y       N      Cyrillic code page
  406.  Shift-JIS**    Y       N      Japanese Kanji multibyte code page = CP982
  407.  
  408. ** New to version 3.12
  409. *  New to version 3.13
  410.  
  411. Roman character sets for East European languages (Czech, Polish, Hungarian,
  412. Romanian, etc) (version 3.13).    Commands:
  413.  
  414.    SET TERMINAL CHARACTER-SET LATIN2 ; ISO 8859-2 Latin Alphabet 2
  415.    SET TRANSFER CHARACTER-SET LATIN2 ; ISO 8859-2 Latin Alphabet 2
  416.    SET TERMINAL CODE-PAGE CP852         ; Code page 852
  417.    SET FILE CHARACTER-SET CP852         ; Code page 852
  418.  
  419.    MS-DOS 5.0 and later include the East European Code Page, CP852.
  420.    To use this code page:
  421.  
  422.    1. Add the following lines to your AUTOEXEC.BAT file and then reboot:
  423.  
  424.       C:\DOS\MODE CON: CP PREPARE=((850,,437,852) C:\DOS\EGA.CPI)
  425.  
  426.    4. To load the East European code page, use this DOS command:
  427.  
  428.       C:\DOS\MODE CON: CP SELECT=852
  429.  
  430. New Icelandic code page support (version 3.13).     Commands:
  431.  
  432.    SET TERMINAL CHARACTER-SET LATIN1 (or DEC-MCS, or whatever)
  433.    SET TRANSFER CHARACTER-SET LATIN1
  434.    SET TERMINAL CODE-PAGE CP861
  435.    SET FILE CHARACTER-SET CP861
  436.  
  437.    Use MODE CON CP PREPARE, if necessary, to install this code page.
  438.    Use MODE CON CP SELECT=861 to load it.
  439.  
  440. Cyrillic terminal emulation and file transfer (version 3.11):
  441.  
  442.   For Cyrillic terminal emulation, use the initialization files supplied on
  443.   the distribution diskette in CYRILLIC.INI.  This is a "text archive of
  444.   several different files; use a text editor to pick out the ones you need.
  445.  
  446.   A public-domain Cyrillic code page, constructed by Dimitri Vulis of D&M
  447.   Consulting in New York City, is supplied in the file CP866.CPI.  Let's
  448.   assume your Kermit installation diskette is in drive A:.  To install the
  449.   Cyrillic Code page:
  450.  
  451.   1. MKDIR C:\CYRILLIC
  452.   2. COPY A:\CYRILLIC\CP866.CPI C:\CYRILLIC
  453.   3. Add the following lines to your AUTOEXEC.BAT file and then reboot:
  454.  
  455.        C:\DOS\MODE CON: CP PREPARE=((850,,437) C:\DOS\EGA.CPI)
  456.        C:\DOS\MODE CON: CP PREPARE=((,866,,) C:\CYRILLIC\CP866.CPI)
  457.  
  458.      Note: If you also want to use the East European Code Page, substitute:
  459.  
  460.        C:\DOS\MODE CON: CP PREPARE=((850,,437,852) C:\DOS\EGA.CPI)
  461.  
  462.   4. To load the Cyrillic code page, use this DOS command:
  463.  
  464.        C:\DOS\MODE CON: CP SELECT=866
  465.  
  466.   5. Then start Kermit, TAKE the desired .INI files from CYRILLIC.INI for
  467.      Cyrillic terminal emulation.  For file transfer use these commands:
  468.  
  469.        SET FILE CHARACTER-SET CP866
  470.        SET TRANSFER CHARACTER-SET CYRILLIC
  471.  
  472. Japanese Kanji file transfer (version 3.12).  Commands:
  473.  
  474.   SET TRANSFER CHARACTER-SET JAPANESE-EUC
  475.   SET FILE CHARACTER-SET SHIFT-JIS
  476.  
  477.   Kanji character-set translation during terminal emulation is not yet
  478.   available, but Kermit CONNECT mode works in Kanji mode on Japanese DOS/V
  479.   computers, which is useful if the remote host uses the same Shift-JIS
  480.   character set as MS-DOS Kermit. 
  481.  
  482. Hebrew terminal emulation and file transfer (version 3.13).  Commands:
  483.  
  484.   SET TRANSFER CHARACTER-SET HEBREW-ISO
  485.   SET FILE CHARACTER-SET CP862
  486.   SET TERMINAL CHARACTER-SET { HEBREW-ISO, HEBREW-7 }
  487.   SET TERMINAL DIRECTION { RIGHT-TO-LEFT, LEFT-TO-RIGHT }
  488.   SET TERMINAL CODE-PAGE CP862
  489.  
  490.   Terminal direction is controlled in two different ways: (1) by
  491.   host-generated escape sequences (automatic, see below) and (2) by the
  492.   SET TERMINAL DIRECTION command.  When the writing direction is changed by
  493.   escape sequences from the host, the cursor-positioning coordinate system
  494.   is not changed.  For example, if Kermit was in left-to-right mode and the
  495.   host send ESC [ ? 34 h, position (1,1) would still be in the upper left.
  496.   This is how a real Hebrew-model VT terminal works.  If, however, you command
  497.   Kermit into RIGHT-TO-LEFT mode, the coordinate system flips right to left
  498.   so the origin (1,1) is at the upper right corner, which is useful for 
  499.   viewing and composing some right to left text. The host can override the 
  500.   user setting, and the user can later override the host setting.
  501.  
  502.   Hebrew character sets:
  503.  
  504.   . CP862 is the PC Hebrew code page, available from IBM as EGAHE.COM, or
  505.     perhaps as a hardware code page on Hebrew-model PCs.  We cannot distribute
  506.     this code page because it is proprietary.  You must have this code page
  507.     loaded in order to see Hebrew characters on your screen.
  508.  
  509.   . HEBREW-ISO is the 8-bit standard ISO 8859-8 Latin/Hebrew alphabet.
  510.  
  511.   . HEBREW-7 is the 7-bit Hebrew "National Replacement Character Set" (NRC),
  512.     ASCII with the lowercase Roman letters replaced by Hebrew letters,
  513.     often used in e-mail.
  514.  
  515.   MS-DOS Kermit 3.13 supports:
  516.  
  517.   . Automatic selection of writing direction by host escape sequence.
  518.   . ISO 2022-compliant terminal character-set designation and invocation.
  519.   . Hebrew keyboard mode.
  520.  
  521.   Hebrew-specific escape sequences recognized by the VT220 and 320 terminal
  522.   emulators: 
  523.  
  524.     ESC ) H        Designates right half of Latin/Hebrew to G1   
  525.     ESC * H        Designates right half of Latin/Hebrew to G2   
  526.     ESC + H        Designates right half of Latin/Hebrew to G3   
  527.     ESC ( % =        Designates 7-bit Hebrew NRC to G0-G3          
  528.     ESC ) " 4        Designates DEC supplement Hebrew letters to G1
  529.     ESC * " 4        Designates DEC supplement Hebrew letters to G2
  530.     ESC + " 4        Designates DEC supplement Hebrew letters to G3
  531.     DCS 0 ! u " 4 ST    Assigns DEC supplement Hebrew as UPSS
  532.     DCS 0 ! u H ST    Assigns Latin/Hebrew as UPSS
  533.     CSI ? 34 h        Sets right-to-left screen-writing mode
  534.     CSI ? 34 l        Sets left-to-right screen-writing mode
  535.     CSI ? 35 h        Sets Hebrew keyboard mapping via Kermit macros
  536.     CSI ? 35 l        Sets Roman (North American) keyboard mapping, ditto
  537.     CSI ? 36 h        Hebrew encoding mode is 7-bit Hebrew-7 "National mode"
  538.     CSI ? 36 l        Hebrew encoding mode is 8-bit ISO Latin/Hebrew
  539.  
  540.   Hebrew keyboard mapping:
  541.  
  542.     CSI ? 35 h invokes the macro KEYBOARDS, which you must define to set up
  543.     your keyboard for entering Hebrew characters.  If this macro is not
  544.     defined, nothing happens.
  545.  
  546.     CSI ? 35 l invokes the macro KEYBOARDR, which you must define to set up
  547.     your keyboard for entering Roman (North American) characters.  If this
  548.     macro is not defined, nothing happens.
  549.  
  550.     Note: do not define KEYBOARDS without also defining KEYBOARDR to undo
  551.     its effects!
  552.  
  553.   The various reports furnished by MS-DOS Kermit also include Hebrew-
  554.   specific information, and the following host-initiated operations work
  555.   in both left-to-right and right-to-left mode: Insert/Replace Mode, Autowrap,
  556.   Backspace, Carriage Return, Linefeed, Formfeed, Vertical Tab, Horizontal Tab.
  557.  
  558.   The keyboard mapping sequences invoke the user-defined macros KEYBOARDS (h)
  559.   and KEYBOARDR (l).  Users should define these macros to accomplish the
  560.   desired keyboard mappings with SET KEY commands.
  561.  
  562.   In VT100 and VT102 mode, the following functions are supported:
  563.  
  564.     ESC ) 1        Enter Hebrew mode
  565.     ESC ) B        Exit Hebrew mode
  566.  
  567. West European (including Icelandic), East European, Cyrillic, Hebrew, and
  568. Kanji file transfer work in conjunction with C-Kermit 5A(189) and IBM
  569. Mainframe Kermit 4.2.4.     Hebrew file transfer is not available in C-Kermit
  570. 5A(188) or earlier.
  571.  
  572. Character-set translation goal selection:
  573.  
  574. SET TRANSLATION CHARACTER-SET { READABLE, INVERTIBLE }
  575.   Default is READABLE. INVERTIBLE attempts to use code points as much in
  576.   common between the transfer and file character sets as possible, with the
  577.   transfer character set having priority.  Thus INVERTIBLE can create code
  578.   points which do not display correctly on the destination machine but yield
  579.   the closest match when a file is sent back to the originator.
  580.  
  581. Terminal-to-host keyboard character shifting:
  582.  
  583. SET TERMINAL OUTPUT-SHIFT { NONE, AUTOMATIC, SI/SO, SS2, SS3 }
  584.   Allows you to type 8-bit characters on a 7-bit terminal connection.
  585.   MS-DOS Kermit supplies the selected type of shifting:
  586.  
  587.     NONE  - (Default) No shifting
  588.     SI/SO - Shift-In Shift-Out around each 8-bit character (GR = G1)
  589.     SS2      - Single-Shift 2 before each 8-bit character (GR = G2)
  590.     SS3      - Single-Shift 3 before each 8-bit character (GR = G3)
  591.     AUTO  - Shift type depends on current character set GR assignment     
  592.  
  593.  
  594. UPDATE: IBM MAINFRAME FILE TRANSFER
  595.  
  596. Correct implementation of "Doomsday Kermit" (DDK) techniques for transferring
  597. files with IBM mainframes through 3270 protocol converters that do NOT support
  598. transparent mode, to be used in conjunction with IBM Mainframe Kermit's SET
  599. CONTROLLER FULLSCREEN command on VM/CMS, MVS/TSO, or CICS.  IBM Mainframe
  600. Kermit 4.2.3 or later required.     Commands:
  601.     
  602.   SET PARITY EVEN     ; Or whatever
  603.   SET FLOW XON/XOFF     ; Or whatever
  604.   SET SEND START 62     ; Greater-than sign
  605.   SET RECEIVE START 62     ; Ditto
  606.   SET BLOCK BLANK-FREE-2 ; New block-check type
  607.   SET HANDSHAKE NONE
  608.  
  609. BLANK-FREE-2 is a new block-check type, exactly like type 2, except encoded
  610. to never contains blanks.  Give IBM Mainframe Kermit the following commands:
  611.  
  612.   SET CONTROLLER FULL
  613.   SET SEND START 62
  614.   SET RECEIVE START 62
  615.   SET BLOCK BLANK-FREE-2
  616.   SET HANDSHAKE 0
  617.  
  618. Doomsday Kermit file transfers are not as reliable as regular Kermit protocol
  619. transfers, and they are much slower.  Use this method only as a last resort.
  620.  
  621.  
  622. UPDATE: THE APC ESCAPE SEQUENCE
  623.  
  624. The handling of the CSI ? 34 h / l escape sequences by the VT220 and VT320
  625. terminal emulators changed between versions 3.12 and 3.13 in order to support
  626. Hebrew VT220/320/420 terminal emulation, and because DEC software such as
  627. DECforms expects to use these sequences to control screen-writing direction.
  628.  
  629. Old way (described on pages 180-181 of "Using MS-DOS Kermit"): CSI ? 34 h / l
  630. invoked the TERMINALR and TERMINALS macros, if you had them defined.  This
  631. required each Kermit user to define them, for example in their MSCUSTOM.INI
  632. files, a big management problem for large user communities.
  633.  
  634. New way: CSI ? 34 h / l controls screen-writing direction, left-to-right or
  635. right-to-left (for Hebrew and Arabic), as it does on real Hebrew-model VT
  636. terminals (see Hebrew section above).
  637.  
  638. To replace the TERMINALR/TERMINALS function, MS-DOS Kermit 3.13 now supports
  639. the Application Program Command (APC) escape sequence, which is accepted by
  640. MS-DOS Kermit 3.13's VT emulators, VT100 and above:
  641.  
  642.   APC <string> ST
  643.  
  644. In the 7-bit environment, APC is ESC _ and ST (string terminator) is ESC \.
  645. In the 8-bit environment, APC is decimal 159 and ST is 156 decimal.  The
  646. <string> can be any MS-DOS Kermit command or list of commands, separated by
  647. commas, and can be up to 1024 bytes in length.    Upon receipt of this escape
  648. sequence, MS-DOS Kermit executes the command(s) in the string and then
  649. automatically resumes CONNECT mode.
  650.  
  651.   NOTE: In this respect, APC differs from the old TERMINALR/TERMINALS
  652.   mechanism, which did NOT automatically re-enter CONNECT mode.  Thus, if
  653.   you are recycling your TERMINALR/TERMINALS macros for APC use, be sure
  654.   to remove the ", connect" from the end of their definitions, or else you
  655.   will have to escape back twice the next time you want the MS-Kermit> prompt.
  656.  
  657. For safety, the APC mechanism cannot be used to invoke certain MS-DOS Kermit
  658. commands that might do damage, like deleting your files.  Included in this
  659. category is the RUN command, which provides access to DOS and to other
  660. applications.  This new MS-DOS Kermit command regulates the APC mechanism:
  661.  
  662.   SET TERMINAL APC { ON, OFF, UNCHECKED }
  663.  
  664. ON (the default) means that Kermit will execute only safe commands.  OFF means
  665. Kermit will not execute any commands and will ignore APCs.  UNCHECKED means
  666. Kermit will execute ANY commands sent via APC.    Use UNCHECKED at your own risk.
  667.  
  668. APC is much more flexible than the old TERMINALS/TERMINALR mechanism, and can
  669. be used for any purpose at all.     For example, it can be used to configure
  670. MS-DOS Kermit for use with a particular host or application by sending the
  671. appropriate list of SET commands: communication parameters like parity,
  672. protocol parameters like packet-length and window size, key mappings, etc.
  673.  
  674. It can also be used to initiate file transfers automatically from the host
  675. without having to escape back to MS-DOS Kermit.     Here's an example you can use
  676. with C-Kermit 5A.  In your C-Kermit 5A customization file (.mykermrc or
  677. CKERMOD.INI), add commands like this:
  678.  
  679.   define autosend set delay 0, apc receive, send \%1 \%2, statistics
  680.   define autoreceive apc {send \%1 \%2}, statistics
  681.  
  682. Try it!     Nothing special is required on the PC side.  Note: The APC command is
  683. new to C-Kermit 5A(189); if you have an earlier release you can define APC as
  684. a macro:
  685.  
  686.   define apc output \27_\%1\27\92
  687.  
  688. You can set up similar procedures with IBM mainframe Kermit, e.g. in VM/CMS by
  689. stacking commands and using XECHO to emit the escape sequences.
  690.  
  691. You can expand these commands to handle text and binary mode if you want to:
  692.  
  693.   ; Text transfers
  694.   define tsend set del 0, set file type text, apc receive, send \%1, stat
  695.   define treceive apc {set fil typ text, send \%1 \%2}, stat
  696.   ;
  697.   ; Binary transfers
  698.   define bsend set del 0, set file type binary, apc receive, send \%1, stat
  699.   define breceive apc {set fil typ binary, send \%1 \%2}, stat
  700.  
  701. Use your imagination, the possibilities are endless!
  702.  
  703.  
  704. UPDATE: DATA GENERAL DASHER TERMINAL EMULATION
  705.  
  706. MS-DOS Kermit 3.13 includes built-in emulation of the Data General DASHER
  707. D463 (monochrome) and D470 (color) text/graphics terminals:
  708.  
  709.   SET TERMINAL TYPE { D463, D470 }
  710.  
  711. Because DASHER escape sequences can include XON and XOFF characters, you must
  712. also tell MS-DOS Kermit not to use regular bidirectional Xon/Xoff flow
  713. control.  Instead, on network connections, SET FLOW NONE; on serial
  714. connections, SET FLOW RTS/CTS if available, or else use unidirectional
  715. Xon/Xoff with the new command:
  716.  
  717.   SET FLOW OUTGOING-XON/XOFF
  718.  
  719. If the remote host echos these characters Kermit will accept them as data
  720. instead and that will confuse interpretation of following control sequences.
  721.  
  722. For using Western European languages on a Data General host:
  723.  
  724.   SET TERMINAL CHARACTER-SET DG-INTERNATIONAL
  725.  
  726. DG function and special keys are supported via new keyboard verbs, which can
  727. be assigned as desired with SET KEY: \KdgF1..F15, \KdgC1..C4, arrow keys,
  728. Home, \KdgPoint, \KdgSPCL, \KdgNC.  These verbs are not assigned
  729. automatically, you must assign them yourself.  Here, for example, is a sample
  730. macro that assigns the DG F1-F12 keys to the PC's F1-F12 keys:
  731.  
  732. define dasher set key cle,set flow outgoing-xon/xoff,set term type d463,-
  733.   set ke \315 \kdgf1,set ke \316 \kdgf2,set ke \317 \kdgf3,-
  734.   set ke \318 \kdgf4,set ke \319 \kdgf5,set ke \320 \kdgf6,-
  735.   set ke \321 \kdgf7,set ke \322 \kdgf8,set ke \323 \kdgf9,-
  736.   set ke \324 \kdgf10,set ke \389 \kdgf11,set ke \390 \kdgf12
  737.  
  738. Arrow-key codes (\Klfarr, etc) are adjusted automatically according to the
  739. terminal type (VT52/Heath, VT100/102, VT220/320, or Data General).
  740.  
  741. For SPCL key operation, see the next section.
  742.  
  743. A comprehensive set of DG DASHER key assignments is given in the DASHER.INI
  744. (MSIDASH.INI) file, supplied by a volunteer at Data General Corporation.  This
  745. mapping follows that used in DG's CEO Connection product.
  746.  
  747. Compressed text (see section on compressed text below) is supported in either
  748. text or graphics mode, depending on your video adapter and preferences; in
  749. graphics mode, regular and compressed text can be mixed on the same screen.
  750. Full-color DG graphics are also supported including polygon fill, and the
  751. mouse (Microsoft or compatible) is supported for CEO Drawing Board and other
  752. graphics applications; mouse movements control the crosshair cursor and the
  753. left mouse button sends \KdgF1.
  754.  
  755. The DG International Character Set (DGI) is supported during terminal
  756. emulation, with conversion to CP437 if CP437 is active, otherwise to CP850.
  757. CP850 is recommended, since it is the closest match to DGI.  Other code
  758. pages are not supported in DG terminal emulation.  Hebrew, Latin/2, and Kanji
  759. terminal emulation are not supported in DG terminal emulation.
  760.  
  761. Also not supported for DG terminal emulation: downloadable
  762. fonts/character-sets; retention of graphics screens after escaping back or
  763. switching to text mode; compressed fornts for monochrome, CGA, or Hercules
  764. video adapters.
  765.  
  766.  
  767. UPDATE: COMPOSE-KEY SEQUENCES FOR ENTERING SPECIAL CHARACTERS
  768.  
  769. Special characters (accented letters, etc) may be entered in the normal ways
  770. described in "Using MS-DOS Kermit", second edition, Chapter 13, and now also
  771. as compose-key sequences.  There are two new compose-key verbs:
  772.  
  773.   \Kcompose ; DEC Compose key
  774.   \KdgSPCL  ; Data General SPCL ("special") key
  775.  
  776. In fact, these two verbs are identical.     Neither one of them is assigned to
  777. any key by default, so to use compose-key sequences, you must first make the
  778. appropriate assigment, for example:
  779.  
  780.   SET KEY \2334 \KdgSPCL ; Make Alt-a the SPCL / Compose key
  781.  
  782. Now to enter a special character, press this key followed by two more keys.
  783. For example, you can enter A-acute like this:
  784.  
  785.   Alt-a ' A
  786.  
  787. That is, press Alt-a (or whichever key or key combination you have assigned
  788. \Kcompose or \KdgSPCL to), then acute accent (apostrophe), then capital A.
  789. See below for a complete listing of compose-key combinations.  In general,
  790. however, they are intuitive: letter + grave accent ("backquote"), letter +
  791. acute accent (apostrophe), letter + doublequote (for umlaut or diaeresis),
  792. letter + asterisk (ring above), etc.
  793.  
  794. When you press the compose key, the letter C appears at the right of the
  795. terminal-emulation status line and remains there until you type the next two
  796. keys.  If the two keys form a valid compose sequence, the corresponding
  797. character is sent to the host.    If not, Kermit beeps.  In both cases, the C
  798. disappears from the status line at the end of the compose sequence.  To cancel
  799. a compose sequence in progress, just type one or two Ctrl-C characters (or, in
  800. fact, any two characters that are not a legal compose sequence).
  801.  
  802. Compose sequences are available only for those 8-bit Latin1-class (i.e.
  803. Western European) terminal character-sets that are valid for Kermit's current
  804. terminal emulation:
  805.  
  806. Terminal Type:     Character Sets:
  807.  VT220 or 320      LATIN1, DEC-MCS
  808.  D463 or D470      LATIN1, DG-INTERNATIONAL
  809.  
  810. Compose sequences are entirely independent of your PC's current code page.
  811.  
  812. Here is the complete table of MS-DOS Kermit's compose-key sequences:
  813.  
  814. Case and order insensitive:
  815.   Input pair        DG Int    Latin1    Graphic            
  816.   ++            23h    n/a    #            
  817.   AA            40h    n/a    @            
  818.   ((            5Bh    n/a    [            
  819.   // or /<        5Ch    n/a    \            
  820.   ))            5Dh    n/a    ]            
  821.   ^<space>        7Eh    n/a    ^            
  822.   (-            7Bh    n/a    {            
  823.   /^            7Ch    n/a    |            
  824.   )-            7Dh    n/a    }
  825.   <<            B1h    ABh    << (Left guillemot)
  826.   0^ or *<space>    BCh    B0h    Degree, ring above
  827.   +-            B6h    B1h    +-
  828.   >>            B0h    BBh    >> (Right guillemot)
  829.   SS            FCh    DFh    German double s (Ess-Zet)
  830.   /U            A3h    B5h    Greek mu
  831.   2^            A4h    B2h    2 superscript
  832.   3^            A5h    B3h    3 superscript
  833.   C/ or C|        A7h    A2h    Cent sign
  834.   L- or L=        A8h    A3h    Pound Sterling
  835.   Y- or Y=        B5h    A5h    Yen sign
  836.   SO or S! or S0    BBh    A7h    Paragraph sign
  837.   XO or X0        A6h    A5h    Currency sign
  838.   A-            A9h    A4h    Feminine ordinal
  839.   CO or C0        ADh    A9h    Copyright sign
  840.   PP or P!        B2h    B6h    Pilcrow sign
  841.   .^            B9h    B7h    Middle dot
  842.   O-            AAh    BAh    Masculine ordinal
  843.   12            A2h    BDh    Fraction one-half
  844.   !!            ABh    A1h    Inverted exclamation
  845.   ??            ACh    BFh    Inverted query mark
  846.   T-            AFh    n/a    Not equals sign
  847.   TM            B3h    AEh    Trademark sign
  848.   FF            B4h    n/a    Florin sign (DGI only)
  849.   <=            B7h    n/a    Less than or equals sign (DGI only)
  850.   >=            B8h    n/a    Greater than or equals sign (DGI only)
  851.   ,-            A1h    ACh    Not sign
  852.   ""            BDh    A8h    Diaeresis
  853.   ''            BEh    B4h    Accent acute
  854.   RO            AEh    AEh    Registered sign
  855.   ||            n/a    A6h    Vertical broken bar
  856.   --            n/a    ADh    Soft hyphen
  857.   -^            n/a    AFh    Macron
  858.   ,,            n/a    B8h    Cedilla
  859.   34            n/a    BEh    Fraction three-fourths
  860.   XX            n/a    D7h    Multiplication sign
  861.   -:            n/a    F7h    Division sign
  862.   1^            n/a    B9h    Superscript 1
  863.   14            n/a    BCh    Fraction one-fourth
  864.  
  865. Case and order sensitive:
  866.   Input pair        DG Int    Latin1    Graphic            
  867.   EO            D7h    n/a    OE digraph
  868.   AE            C6h    C6h    AE digraph
  869.   ae            E6h    E6h    ae digraph
  870.   ,C            C7h    C7h    Cedilla
  871.   ,c            E7h    E7h    cedilla
  872.   /O            D6h    D8h    O oblique stroke
  873.   /o            F6h    F8h    o oblique stroke
  874.   HT            n/a    DEh    Icelandic Thorn (yes, HT, not TH)
  875.   ht            n/a    FEh    Icelandic thorn (ht, not th)
  876.   -D            n/a    D0h    Icelandic Eth
  877.   -d            n/a    F0h    Icelandic eth
  878.  
  879. Case sensitive, order insensitive:
  880.   Input pair        DG Int    Latin1    Graphic            
  881.   'A            C0h    C1h    A-acute
  882.   'a            E0h    E1h    a-acute
  883.   `A            C1h    C0h    A-grave
  884.   `a            E1h    E0h    a-grave
  885.   ^A            C2h    C2h    A-circumflex
  886.   ^a            E2h    E2h    a-circumflex
  887.   "A            C3h    C4h    A-diaeresis
  888.   "a            E3h    E4h    a-diaeresis
  889.   ~A            C4h    C3h    A-tilde
  890.   ~a            E4h    E3h    a-tilde
  891.   *A            C5h    C5h    A-ring
  892.   *a            E5h    E5h    a-ring
  893.   'E            C8h    C9h    E-acute
  894.   'e            E8h    E9h    e-acute
  895.   `E            C9h    C8h    E-grave
  896.   `e            E9h    E8h    e-grave
  897.   ^E            CAh    CAh    E-circumflex
  898.   ^e            EAh    EAh    e-circumflex
  899.   "E            CBh    CBh    E-diaeresis
  900.   "e            EBh    EBh    e-diaeresis
  901.   'I            CCh    CDh    I-acute
  902.   'i            ECh    EDh    i-acute
  903.   `I            CDh    CCh    I-grave
  904.   `i            EDh    ECh    i-grave
  905.   ^I            CEh    CEh    I-circumflex
  906.   ^i            EEh    EEh    i-circumflex
  907.   "I            CFh    CFh    I-diaeresis
  908.   "i            EFh    EFh    i-diaeresis
  909.   ~N            D0h    D1h    N-tilde
  910.   ~n            F0h    F1h    n-tilde
  911.   'O            D1h    D3h    O-acute
  912.   'o            F1h    F3h    o-acute
  913.   `O            D2h    D2h    O-grave
  914.   `o            F2h    F2h    o-grave
  915.   ^O            D3h    D4h    O-circumflex
  916.   ^o            F3h    F4h    o-circumflex
  917.   "O            D4h    D6h    O-diaeresis
  918.   "o            F4h    F6h    o-diaeresis
  919.   ~O            D5h    D5h    O-tilde
  920.   ~o            F5h    F5h    o-tilde
  921.   'U            D8h    DAh    U-acute
  922.   'u            F8h    FAh    u-acute
  923.   `U            D9h    D9h    U-grave
  924.   `u            F9h    F9h    u-grave
  925.   ^U            DAh    D8h    U-circumflex
  926.   ^u            FAh    F8h    u-circumflex
  927.   "U            DBh    DCh    U-diaeresis
  928.   "u            FBh    FCh    u-diaeresis
  929.   "Y            DDh    n/a    Y-diaeresis
  930.   "y            FDh    FFh    y-diaeresis
  931.   'Y            n/a    DDh    Y-acute
  932.   'y            n/a    FDh    y-acute
  933.   
  934.  
  935. UPDATE: WIDE SCREENS AND HORIZONTAL SCROLLING
  936.  
  937. As explained in "Using MS-DOS Kermit", Kermit changes between 80 and 132
  938. column mode upon host request (CSI ? 3 h / l) or when you give an explicit SET
  939. TERMINAL WIDTH { 80, 132 } command.  Until now, 132-column screens were
  940. possible only on PCs with video adapters that provide a 132-column text mode.
  941. As of version 3.13, MS-DOS Kermit also includes support for DEC VT 132-column
  942. mode and Data General compressed text on EGA and VGA video adapters, which do
  943. not provide 132 columns in text mode, by entering graphics mode and writing
  944. the characters dot-by-dot. 128 columns are displayed rather than 132 due to
  945. the PC's screen geometry but you can use MS-DOS Kermit 3.13's new horizontal
  946. scrolling feature to see the rightmost 4 columns (see below).
  947.  
  948. Normally, Kermit only keeps 80 columns in its screen-rollback memory.  If you
  949. want to be able to roll back screens of 132 (or, for DG terminal emulation,
  950. up to 207) columns, you must set the KERMIT environment variable WIDTH to 132
  951. (or the desired number) in your AUTOEXEC.BAT file, for example:
  952.  
  953.   SET KERMIT=WIDTH 132
  954.  
  955. The KERMIT environment variable must contain a WIDTH definition before you
  956. start MS-DOS Kermit in order for it to take effect.
  957.  
  958. NOTE: The KERMIT=WIDTH value and SET TERMINAL WIDTH value are two different
  959. things.     The former controls memory allocation in the rollback buffer, the
  960. latter controls the actual display width (virtual or real) of your screen.
  961.  
  962. You can specify whether Kermit should use text (fast) or graphics (slow) mode
  963. for compressed text with the new command:
  964.  
  965.   SET TERMINAL COMPRESSED-TEXT { GRAPHICS, TEXT }
  966.  
  967. Text mode will not actually display compressed text unless your video adapter
  968. supports this function (see below), but Kermit's virtual screen is adjusted to
  969. the terminal-emulation width.  For example, if your screen shows 80 characters
  970. per line, but your terminal width is 132, then wrapping occurs at column 132
  971. (perhaps off the screen) rather than column 80, and Kermit reports its screen
  972. width as 132 (e.g. in response to a report-request escape sequence).
  973.  
  974. If your logical screen width is greater than the physical screen width, MS-DOS
  975. Kermit 3.13 lets you scroll the screen horizontally by pushing keys.  The new
  976. keyboard verbs are:
  977.  
  978.   \Klfpage    Scroll left one "page" (= 20 columns) (screen moves right)
  979.   \Klfone     Scroll left one column
  980.   \Krtpage    Scroll right one page (screen moves left)
  981.   \Krtone     Scroll right one column
  982.  
  983. These verbs are unassigned by default.    Here are the commands you could add to
  984. your MSCUSTOM.INI file if you wanted to assign them to the gray (T-pad) arrow
  985. keys on the extended (101) PC keyboard:
  986.  
  987.   SET KEY \4427 \Krtpage  ; Left arrow makes screen move left on page
  988.   SET KEY \5491 \Krtone      ; Ctrl-Left arrow moves screen one column to left
  989.   SET KEY \4429 \Klfpage  ; Right arrow makes screen move right one page  
  990.   SET KEY \5492 \Klfone      ; Ctrl-Right arrow moves screen one column right
  991.  
  992. When these keys are used in combination with the PageUp/Down keys, your screen
  993. becomes a "virtual window" on your session, which you can move around in
  994. arbitrary directions.
  995.  
  996. By analogy with SET TERMINAL ROLLBACK { ON, OFF }, which tells Kermit whether
  997. to move a rolled-back screen automatically to the bottom when new characters
  998. arrive from the host, the new command:
  999.  
  1000.   SET TERMINAL HORIZONTAL-SCROLL { AUTOMATIC, MANUAL }
  1001.  
  1002. tells Kermit whether to scroll horizontally when a character arrives that
  1003. would be displayed to the left or right of the visible screen.    By default,
  1004. horizontal scrolling is MANUAL during VT terminal emulation, and AUTOMATIC
  1005. during DASHER emulation.  MANUAL means you have to push keys to scroll the
  1006. screen horizontally, AUTOMATIC means that Kermit moves the screen to "catch"
  1007. incoming characters.
  1008.  
  1009. Of course, for 132-column operation, it is always better if your video adapter
  1010. supports 132 columns directly -- the video board does all the work, which is
  1011. much faster than writing screen dots in software!  This works if Kermit knows
  1012. which kind of video adapter you have (Kermit determines this from a hopefully
  1013. unique "signature" in the video BIOS) and it knows how to set the desired
  1014. video modes.  Here is a list of such boards:
  1015.  
  1016.   ATI EGA and VGA Wonder
  1017.   AST, Dell, and other boards based on Western Digital VGA boards
  1018.   AT&T / Olivetti
  1019.   Everex Viewpoint EV-659, FVGA-673, EV-678, Micro Enhancer Deluxe
  1020.   IBM SVGA (= Tseng ET4000, e.g. on PS/ValuePoint)
  1021.   IBM XGA
  1022.   Paradise AutoSwitch EGA Mono
  1023.   Paradise Professional
  1024.   Paradise VGA Plus 16 (ROM BIOS 003056-xxx firmware)
  1025.   Paradise VGA Plus (ROM BIOS 003056-xxx firmware)
  1026.   Paradise VGA Professional (ROM BIOS 003056-xxx firmware)
  1027.   Paradise VGA1024
  1028.   STB VGA/EM (Tseng TVGA)
  1029.   STB VGA/EM Plus (Tseng 4000), VGA/EM-16, VGA/EM-16 Plus
  1030.   Tseng Labs EVA board with 132-column kit installed
  1031.   Tseng Labs UltraPAK mono/Hercules with 132 column modes
  1032.   Tseng Labs ET4000 SVGA
  1033.   VESA-compatible video BIOS
  1034.   Video 7 Vega Deluxe with 132X25.COM driver installed and Video 7 VGA
  1035.  
  1036. If you have an adapter capable of 132-column operation, but Kermit does not
  1037. know how to activate it, set up your COLS132.BAT and COLS80.BAT files to do
  1038. the switching, as described in "Using MS-DOS Kermit".
  1039.  
  1040. For Data General DASHER terminal emulation, screen widths up to 207 are
  1041. supported for purposes of horizontal scrolling, but no more than 128 can be
  1042. shown across the screen at a time.  DG terminal emulation is in text mode by
  1043. default.  As soon as the host commands the terminal to display compressed
  1044. text, Kermit switches the entire screen to 132-column text mode if your video
  1045. adapter supports it, and otherwise switches to (slower) graphics mode.    As in
  1046. VT terminal emulation, this behavior is controlled by the SET TERMINAL
  1047. COMPRESSED-TEXT command.  Unlike VT terminals, DASHER terminals (and MS-DOS
  1048. Kermit, when in graphics mode) can display compressed and regular text on the
  1049. screen at the same time.
  1050.  
  1051.  
  1052. UPDATE: EXPANDED MEMORY
  1053.  
  1054. Graphics screens and terminal rollback screens can now be kept in expanded
  1055. memory (EMS), and the size of the screen rollback buffer can selected and
  1056. changed at runtime.  When sufficient expanded memory is available, you can
  1057. have up to 8000 rollback screens.
  1058.  
  1059. SET ROLLBACK <number>
  1060.   Specifies the number of text screens to be kept in the rollback buffer.
  1061.   Each 24x80 screen occupies about 4K; bigger screens need more space.    Don't
  1062.   confuse this command with SET TERMINAL ROLLBACK, which tells what to do when
  1063.   characters arrive for the screen while it is rolled back.
  1064.  
  1065. SET TERMINAL EXPANDED-MEMORY { ON, OFF }
  1066.   Whether to use expanded memory for retention of graphics screens and for
  1067.   text terminal-emulation rollback screens.  The default is OFF, to use
  1068.   conventional memory.    ON leaves extra room in conventional memory for
  1069.   running other programs, does not rely on your video adapter's memory for
  1070.   storing graphics images, and allows more rollback screens, limited only by
  1071.   the size of your PC's available physical memory.  ON requires that an
  1072.   expanded memory manager, such as EMM386 or QEMM, be correctly installed.
  1073.   Also see SET ROLLBACK, which tells how many screens are to be saved in the
  1074.   rollback buffer.
  1075.  
  1076. See the Memory Management section of KERMIT.BWR (MSKERM.BWR) for further
  1077. information.
  1078.  
  1079.  
  1080. UPDATE: NEW SCRIPT PROGRAMMING COMMANDS AND FEATURES
  1081.  
  1082. IF [ NOT ] EXIST <filename>
  1083.   Succeeds if the given file exists, fails otherwise.
  1084.  
  1085. IF [ NOT ] INPATH <filename>
  1086.   Succeeds if the given file can be found by normal DOS search rules,
  1087.   i.e. if it is in the current disk/directory, or in the DOS PATH.
  1088.  
  1089. INCREMENT <variable> [ <value> ]
  1090.   Adds the <value>, which must be a positive number (or a variable that
  1091.   evaluates to a positive number), to the value of the given variable.    If the
  1092.   <value> is not specified, then 1 is added.  If the <variable> is not defined
  1093.   or has a non numeric value, the command fails and the value of the variable
  1094.   is not altered.
  1095.  
  1096. DECREMENT <variablename> [ <value> ]
  1097.   Subtracts the <value>, which must be a positive number (or a variable that
  1098.   evaluates to a positive number), from the value of the given variable.  If
  1099.   the <value> is not specified, then 1 is subtracted.  If the <variable> is
  1100.   not defined or has a non numeric value, the command fails and the value of
  1101.   the variable is not altered.
  1102.  
  1103. STOP [ <number> [ <text> ] ]
  1104.   Stops execution of the current macro or TAKE file and returns immediately
  1105.   to top command level.      The <number> and <text> operands are new.  <number>
  1106.   is a return code that can be tested by IF SUCCESS.  It is also assigned to
  1107.   \v(status).  Text is an optional message to be printed.
  1108.  
  1109. END [ <number> [ <text> ] ]
  1110.   Stops execution of the current macro or TAKE file and returns immediately to
  1111.   the level which invoked it, i.e. the next higher level.  <number> and <text>
  1112.   are used as in the STOP command.  POP is a synonym for END.
  1113.  
  1114. \L in an OUTPUT string sends a Long (1.5 second) BREAK.     On a network
  1115. connection, it sends the same thing that \B (regular BREAK) would send, such
  1116. as a TELNET BREAK command.
  1117.  
  1118. New variables:
  1119.  
  1120.   \v(dosversion) - MS-DOS version, e.g. 500 for DOS 5.00.
  1121.   \v(line)     - Current SET PORT value: COM1, COM2, TCP/IP, etc.
  1122.   \v(ntime)     - Numeric representation of current clock time: hhmmss
  1123.   \v(port)     - Same as \v(line)
  1124.   \v(session)     - Current TCP/IP session number
  1125.   \v(terminal)     - Current terminal emulation type
  1126.  
  1127. Note: \v(ndate) and \v(ntime) are suitable for construction of filenames.
  1128.  
  1129.  
  1130. UPDATE: TCP/IP NETWORKING
  1131.  
  1132. See the networks sections in MSKERM.HLP (KERMIT.HLP) and MSKERM.BWR
  1133. (KERMIT.BWR) for additional information.  New networking features since
  1134. "Using MS-DOS Kermit", second edition, was published include:
  1135.  
  1136.  . Support for ODI, SLIP, and Novell SLIP_PPP drivers.
  1137.  
  1138.  . Up to six simultaneous TCP/IP sessions.  See below.
  1139.  
  1140.  . TCP/IP network connections thru Beame & Whiteside TCP/IP, via SET PORT
  1141.    BWTCP <ip-address>.    IP host names are not supported.
  1142.  
  1143.  . Ability to specify a particular packet-driver interrupt:
  1144.  
  1145.    SET TCP/IP PACKET-DRIVER-INTERRUPT { <number>, ODI }
  1146.      Normally Kermit searches from 0x60 to 0x7e for a packet driver.
  1147.      This command allows you to (a) specify a particular interrupt,
  1148.      in case you have more than one packet driver loaded, or (b) tell
  1149.      Kermit to skip the packet-driver interrupt search and use the ODI
  1150.      interface.     Note: the ODI interface is used by default for TCP/IP
  1151.      connections if a packet driver cannot be found.
  1152.  
  1153.  . The ability to select a particular TCP port when making a connection:
  1154.  
  1155.    SET PORT TCP/IP <ip-name-or-address> [ <tcp-port-number> ]
  1156.      The default TCP port number is 23, which is the TELNET protocol socket.
  1157.      You can specify any other port number except 25.
  1158.  
  1159.  . New TCP/IP server mode accepts incoming TCP/IP connections:
  1160.  
  1161.    SET PORT TCP/IP * [ <tcp-port-number> ]
  1162.      If you specify asterisk (*) instead of an IP host name or address,
  1163.      MS-DOS Kermit waits for an incoming connection on the specified TCP
  1164.      port (23 by default).  This connection is useful only when MS-DOS Kermit
  1165.      is in SERVER mode or, for chatting, CONNECT mode.    It does not give
  1166.      clients a DOS command processor.
  1167.  
  1168.  . RFC 1395 BOOTP compliance allows MS-DOS Kermit to receive its fully
  1169.    qualified domain name from a BOOTP server.  Also, MS-DOS Kermit's SHOW
  1170.    COMMUNICATIONS command now displays the IP address of the BOOTP server
  1171.    from which its TCP/IP parameters were received.
  1172.  
  1173.  . New commands to govern TELNET protocol:
  1174.  
  1175.    SET TCP/IP TELNET-TERM-TYPE <text>
  1176.      Normally, MS-DOS Kermit sends its actual terminal-emulation type when
  1177.      the remote TELNET server asks for a terminal type report.    But the
  1178.      remote host computer might not support your current terminal type, or
  1179.      might know it by a different name.     This command lets you specify a
  1180.      terminal-type name for Kermit to send instead of the default name.
  1181.  
  1182.    SET TCP/IP NEWLINE-MODE {OFF, ON}
  1183.      During terminal emulation on a TCP/IP connection, MS-DOS Kermit follows
  1184.      the TELNET specification and transmits carriage and line feed (CRLF)
  1185.      whenever you type carriage return (the Enter key).     If the remote TELNET
  1186.      server is confused by this (i.e. it does not follow the TELNET
  1187.      specification), use SET TCP/IP NEWLINE-MODE OFF to make Kermit omit the
  1188.      line feed.
  1189.  
  1190.    SET TCP/IP DEBUG-OPTIONS { ON, OFF } 
  1191.      Whether to display TELNET options negotiation on the screen.  Default is
  1192.      OFF, don't display them.  When ON, you can view the negotiations on the
  1193.      screen, and you can capture them in screen dump or session log files, or
  1194.      print them, just like any other CONNECT-mode screen text.    DEBUG-OPTIONS
  1195.      is useful for debugging misbehaving TELNET sessions.  Refer to the
  1196.      TELNET RFCs, or a TCP/IP book, for an explanation of what they mean.
  1197.  
  1198.  . MS-DOS Kermit now replies to traceroute requests, handles ICMP redirects.
  1199.  
  1200.  . TELNET window (i.e. screen) size (NAWS) negotiation.
  1201.  
  1202.  
  1203. UPDATE: MULTIPLE TCP/IP SESSIONS -- KERMIT'S TCP/IP SESSION MANAGER
  1204.  
  1205. MS-DOS Kermit 3.13 supports up to six simultaneous TCP/IP sessions.  Each
  1206. session is identified by a digit, 1 to 6.  The new commands (or new features
  1207. of old commands) are:
  1208.  
  1209. SET PORT TCP <ip-hostname-or-address> [ <tcp-port-number> ]
  1210.   Starts a new session and assigns it a session number, 1 to 6.
  1211.    
  1212. \v(session)
  1213.   This new variable contains the current TCP/IP session number, 1 to 6.
  1214.  
  1215. \KnextSession
  1216.   New keyboard verb to toggle instantaneously among active TCP/IP sessions,
  1217.   round-robin style. 
  1218.  
  1219. Alt-n
  1220.   This is the default key assignment for the \KnextSession verb.
  1221.  
  1222. SHOW SESSIONS
  1223.   Displays current sessions.
  1224.  
  1225. SET PORT TCP <digit>
  1226.   Switches to a specific session, 1 to 6.
  1227.  
  1228. DEFINE SESSION1 <text>
  1229.   Defines a macro to be executed when switching to session 1.
  1230.  
  1231. DEFINE SESSION2 <text>
  1232.   Defines a macro to be executed when switching to session 2.
  1233.   And so on, through SESSION6.
  1234.  
  1235. The terminal-emulation mode line shows current session number and name.
  1236. Most communication- and terminal-related settings are preserved for each
  1237. session, including the last terminal screen, the key map, the terminal type,
  1238. echoing, etc.  Use the SESSIONn macros to take care of any items that are not
  1239. preserved.  The screen rollback buffer is common to all sessions.
  1240.  
  1241. Suppose you normally access two TCP/IP hosts, a DEC VAX and a Data General
  1242. AOS/VS system, and you would like to keep sessions to both alive at once.
  1243. Alt-n switches between them instantaneously, and you can also define
  1244. convenient macros for use at the command prompt or in script programs, such as
  1245. the following, which make the initial connection to each host, and then
  1246. redefine themselves to continue the same session thereafter:
  1247.  
  1248. define vax -
  1249.   telnet vax 23 vt320,-
  1250.   if success assign vax telnet \v(session)
  1251.  
  1252. define dg -
  1253.   telnet dg 23 d463,-
  1254.   if success assign dg telnet \v(session)
  1255.  
  1256. Note: TELNET is a macro defined in the MS-DOS Kermit 3.13 MSCUSTOM.INI file.
  1257. See MSKERM.HLP (KERMIT.HLP) for more information.
  1258.  
  1259.  
  1260. ( End of MSKERM.UPD / KERMIT.UPD )
  1261.