Category : Recently Uploaded Files
Archive   : MSVIBM.ZIP
Filename : READ.ME

USING CYRILLIC CHARACTER SETS WITH MS-DOS KERMIT

MS-DOS Kermit 3.14 lets you access Cyrillic text applications and files on
host computers, services, and newsgroups, by (a) loading a Cyrillic font based
on PC Code Page 866, and (b) translating between CP866 and any of three
different host Cyrillic character sets -- KOI8, Short KOI, and ISO
Latin/Cyrillic -- in both directions: PC to host, host to PC.

Cyrillic file transfer capability is built into MS-DOS Kermit via the
commands SET FILE CHARACTER-SET CP866 and SET TRANSFER CHARACTER-SET CYRILLIC.

For terminal emulation, use the CYRILLIC macro, defined in the standard
MSKERMIT.INI file, which loads the Cyrillic code page for you and also sets up
the appropriate character-set mapping:

CYRILLIC ; Loads Cyrillic font, sets up KOI8 mapping
CYRILLIC KOI8 ; Ditto
CYRILLIC LATINC ; Loads Cyrillic font, sets up ISO Latin/Cyrillic mapping
CYRILLIC SHORTKOI ; Loads Cyrillic font, sets up Short KOI mapping

Thus, to access a KOI8 host or application (such as the "relcom" newsgroups,
the Russian Web via Lynx, etc), just type "cyrillic" or "cyrillic koi8" at the
MS-Kermit> prompt. To read e-mail coded in Short KOI, type "cyrillic
shortkoi". And so on. Then CONNECT to the host and you will be able to see
Cyrillic characters.

NOTE: These macros work best when used on a normal 25x80 screen.
See PCFONTS\READ.ME for further information.

The character-set mappings are accomplished by the following command files,
which supply translations between the PC's Cyrillic code page, CP866, and
three popular host-based Cyrillic character sets. These files handle both the
screen display and the keyboard translation.

LATINC.INI: ISO 8859-5 Latin/Cyrillic
KOI8.INI: KOI ("Old KOI-8")
SHORTKOI.INI: Short (7-bit) KOI

The CYRILLIC macro executes the desired file automatically (KOI8.INI by
default). You can also TAKE any of these files explicitly, e.g.:

TAKE C:\KERMIT\CYRILLIC\LATINC.INI

The key mappings used by these INI files assume a Cyrillic keyboard and
driver. That is, they expect CP866 scan codes to be generated by keys that
have Cyrillic letters on their keytops. Then Kermit translates the CP866
codes to KOI8, Latin/Cyrillic, or Short KOI before sending the characters.

If you do not have a Cyrillic keyboard and driver, you can use one of the
public-domain Russian keyboard drivers provided in this directory (detailed
key assignments are listed below):

KEYBRU3.COM (Russian layout)
KEYBRU4.COM ("Phonetic" layout)

You should run the keyboard driver from the DOS prompt, before you start
Kermit, to avoid memory fragmentation.

To undo the effects of the Cyrillic mappings:

SET TRANSLATE INPUT OFF
SET KEY CLEAR

or simply give the command, ROMAN (a macro defined in MSKERMIT.INI), which
issues the two commands above and also loads the Roman font back into your PC
(but does not remove the Cyrillic keyboard driver; see below).

For tables of Cyrillic character sets, see pp.281-284 of "Using MS-DOS Kermit".

KEYBOARD DRIVER KEY ASSIGNMENTS (relative to American keyboard):

Each of these drivers produces scan codes that conform to the CP866 encoding.
KEYBRU3 approximates the Russian (GOST) keyboard layout; KEYBRU4 is an
approximately "phonetic" layout for English (QWERTY) typists. Choose the
keyboard driver you want and run it. Now you can switch your keyboard between
English mode (the startup mode) and Russian mode by pressing the Scroll Lock
key. Refer to Table I-8 in "Using MS-DOS Kermit", pages 281-284, to see the
actual characters. The names given here correspond to those used in Table
I-8. Once you load one of these drivers, it stays loaded. You can toggle it
back into English mode, but you can't remove it except by rebooting.

Key KEYBRU3 KEYBRU4
Alt-1 Number Number
Alt-3 / /
Alt-4 " "
Alt-5 : :
Alt-6 , ,
Alt-7 . .
Alt-8 ; ;
Alt-9 ? ?
Alt-0 Currency Currency
Alt-- < <
Alt-= > >
Q Short I Ya
W Ts Ve
E U Ie
R Ka Er
T Ie Te
Y En Yu
I Sha I
O Shcha O
P Ze Pe
[,{ Ha Sha
],} Hard sign Shcha
A Ef A
S Yu Es
D Ve De
F A Ef
G Pe Ghe
H Er H
J O Short I
K El Ka
L De El
;,: Zhe Che
'," e,E Hard sign
`,~ Yu
Z Ya Ze
X Cha Soft sign
C Es Tse
V Em Zhe
B I Be
N Te En
M Soft sign Em
,,< Be
.,> Yu
/,? Yo

Note that KOI8 and Short KOI do not have Number (No) or Yo (E with
diaeresis) characters.

ACKNOWLEDGEMENTS:

The Cyrillic *.INI files were contributed by Konstantin Vinogradov,
International Centre for Scientific and Technical Information (ICSTI), Moscow,
USSR, 1989. The Cyrillic font is from the public domain font collection of
Joseph (Yossi) Gil at the Technion, Haifa, Israel. The Russian keyboard
drivers are from Dimitri Vulis, D&M Consulting, Brooklyn, New York.

(End of CYRILLIC\READ.ME)
USING MS-DOS KERMIT WITH THE HEBREW ALPHABET

This directory contains the supplementary Hebrew files for MS-DOS Kermit:

READ.ME - This file
HEBREW.DOC - Documentation of Kermit's Hebrew features
HEBREW.INI - Hebrew initialization file for Kermit
HEBREW.HLP - Short explanation of HEBREW.INI
CP862.TBL - IBM PC Hebrew code page table
ISO88598.TBL - ISO 8859-8 Latin/Hebrew alphabet table
HEBREW7.TBL - Hebrew-7 table
KEYMAP.PS - PostScript picture of Hebrew keyboard layout

For details, read the HEBREW.DOC file. The associated Hebrew font is
in the PCFONTS directory, and the HFONT macro loads the Hebrew font.
The font requires EGA, VGA, or higher graphics adapter.

NOTE: Hebrew support works best when used on a normal 25x80 screen.
See PCFONTS\READ.ME for further information.

(End of READ.ME)
MS-DOS KERMIT KEYBOARD MAPS AND UTILITIES

VT300.INI, VT300.DOC
A sample VT220/VT320 key mapping for the PC keyboard, to be used with VT220
or VT320 terminal emulation. Read VT300.DOC for details; edit the VT300.INI
to make changes.

GOLD.COM, GOLD.DOC
A TSR (Terminate-and-Stay-Resident) program that makes your Num Lock key act
as if it were the F1 key, thus making it accessible to SET KEY commands, and
allowing it to be used (for example) as a VT terminal Gold key. Bug
Warning: GOLD.COM seems to disable soft boot via Ctrl-Alt-Del.

WPGGOLD.COM, WPGGOLD.DOC
Like GOLD.COM, but assigns a unique scan code to the Num Lock key, separate
from the F1 scan code. Bug Warning: WPGGOLD.COM seems to cause a "301
Keyboard Error" while coming up after soft boot via Ctrl-Alt-Del, which can
be ignored (press Esc, F1, or whatever it asks you to do if this happens).

DASHER.INI
A full Data General DASHER key mapping to be used with D463 or D470
emulation.

DGKEY.COM, DGKEY.DOC
A TSR for use on the Data General DASHER/286 PC, to make the SPCL and HOME
keys visible to Kermit.

EMACS.INI
Key mappings for using the EMACS editor, in particular for making the
PC Alt key function as the EMACS Meta key.

MUSLK2.COM, MSULKV.COM, MSULK2.DOC
Keyboard drivers for the DEC LK250 and compatible keyboards (DEC keyboards
that are used on IBM and compatible PCs). MSULKV.COM is for the VAXmate.

CAPSCTRL.COM
A tiny TSR that turns the Caps Lock key into a Ctrl key, and also swaps the
Esc and Accent grave keys, on IBM and compatible PCs. The original Caps Lock
function is available on Alt-Caps Lock. These mappings operate at all
times, not only in Kermit. They are not needed by Kermit -- they are
provided only for those who like this arrangement better than the standard
PC placement of Ctrl, Esc, and grave accent.

KANJI106.INI
Key mappings for the special keys of the Japanese DOS/V Kanji 106 keyboard.

(End of KEYBOARD\READ.ME)
MS-DOS KERMIT MODEM DIALING SCRIPTS

Christine M. Gianone and Frank da Cruz, Columbia University
John Klensin, United Nations University
December 1994

The following modem dialing scripts are available for use with the DIAL
command in MS-DOS Kermit. Store these files in the MODEMS subdirectory of
your KERMIT directory, where Kermit expects to find them.

The DIAL command is a macro defined in the standard MSKERMIT.INI file on the
MS-DOS Kermit diskette. It looks up the number (or name) in your dialing
directory, if any, making the appropriate substitution, and passes the phone
number to your dialing script in a variable. See "Using MS-DOS Kermit" and
KERMIT.HLP (MSKERM.HLP) for details about the DIAL command and the dialing
directory.

If you lack the DIAL macro definition, you can define your own simple DIAL
macro (which does not use the dialing directory) as follows:

DEFINE DIAL TAKE \v(inidir)MODEMS\xxx.SCR

where xxx is the modem type, one of those listed below.

The default modem type (if you are using the standard MSKERMIT.INI file) is
HAYES (i.e. Hayes 1200 or 2400). To select a different type of modem for
dialing, do any one of the following:

1. Type SET MODEM=xxx at the DOS prompt before starting MS-DOS Kermit, or
2. Add SET MODEM=xxx to your AUTOEXEC.BAT file and reboot your PC, or
3. Type SET MODEM xxx at the MS-DOS Kermit prompt, or
4. Type DEFINE _MODEM xxx at the MS-DOS Kermit prompt, or
5. Add SET MODEM xxx to your MSCUSTOM.INI file, or
6. Add DEFINE _MODEM xxx to your MSCUSTOM.INI file.

xxx is name of the modem, corresponding to the part of the dialing script
filename before ".SCR". For Telebit T3000 modems, for example, the script
file is called T3000.SCR, and "xxx" would be "T3000". If you obtain these
files over the network, you should rename as shown in the DOS Filename column
below. Here are the dialing scripts that are supplied with MS-DOS Kermit:

Modem Type DOS Filename
----------------------------------------- ------------
* Best Data 1442xxx V.32bis Faxmodem BESTDATA.SCR
* AT&T DataPort 14400 or Express DATAPORT.SCR
* Boca 14.4 Faxmodem BOCA.SCR
* Digicom Connection144+ CONN144P.SCR
* Dynalink 1414VE DYNA1414.SCR
Hayes 1200 or 2400 HAYES.SCR
* Hayes Ultra 144 (or Accura or Optima) ULTRA144.SCR
* Intel 14400 Faxmodem INTEL14.SCR
* Microcom QX/4232hs QX4232.SCR
* Motorola UDS FasTalk II FASTALK2.SCR
* Multitech MT1432 MT1432.SCR
* Penril Alliance V.32 PENRIL.SCR
* Practical Peripherals, all models PPI.SCR
Rolm CBX DCM ROLM.SCR
* SupraFAXmodem V.32bis SUPRA.SCR
* Telebit QBlazer V.32 QBLAZER.SCR
* Telebit T3000 V.32bis T3000.SCR
* MegaHertz / Telepath Xjack PCMCIA V.32bis TELEPCMC.SCR
* US Robotics Sportster 14400 or 28800 SPORT.SCR
** VIVA 2442ef FAX/MODEM VIVA.SCR
* Zoltrix Platinum 14400 PPI.SCR or DYNA1414.SCR
* Zoom Telephonics 14400 ZOOM.SCR
* ZyXEL 1496 ZYXEL.SCR

NOTE: The PPI.SCR file should be usable with any Practical Peripherals
model, V.22bis through V.34. Reportedly it is also compatible with the
Zoltrix Platinum 14400.

If your modem does not appear in this list, feel free to adapt one of these
scripts to work with your modem (and send your new script back to Columbia so
others can use it too).

WHAT THE DIALING SCRIPTS HAVE IN COMMON

These scripts use your modem's default dialing method, pulse or tone; they do
not specify one or the other, since neither method is supported by all
telephones everywhere. To force Tone dialing, begin your phone number with T,
for example:

DIAL T7654321

Similarly, to force pulse dialing, start the phone number with P.

If you give a DIAL command whose telephone number is simply = (equal sign),
the modem will be initialized, but no call will be placed. In some cases,
the dialing script will also ask the modem to display its configuration.

When dialing a real phone number, you can include special characters in the
phone number to accomplish pauses, wait for secondary dialtone, etc. See your
modem manual.

If you dial a number that is busy, most of these scripts will wait 30 seconds
and then redial automatically, up to 5 times. You can cancel the redial
operation by pressing any key after you see the message:

Line is busy, will dial again in 30 seconds.
Press any key to cancel...

Each dialing script returns SUCCESS if dialing succeeds and FAILURE if it
doesn't, so you can use an IF FAIL or IF SUCCESS statement after a DIAL
command in a script.

THE ROLM DIALING SCRIPT

ROLM.SCR is for the Rolm/Siemens (formerly IBM) Computerized Branch Exchange
(CBX) data communications module (DCM). It dials at your current speed, and
does not change speeds since the DCM is speed-sensitive. It does not attempt
to redial if the line is busy. For Rolm 244PCs, use HAYES.SCR, and always use
Tone dialing.

THE HAYES 1200/2400 DIALING SCRIPT

The Hayes 2400 script, HAYES.SCR, should work on any Hayes-1200, Hayes-2400,
or compatible modem. It does not change any modem settings (S registers). It
assumes that the modem changes its interface speed to match the negotiated
modulation speed, if the modulation speed is reported as 1200 or 2400;
otherwise, Kermit does not change its interface speed.

HIGH-SPEED MODEM SCRIPTS

The entries marked with "*" above are for high-speed modems that include
error-correction and data-compression features. (Exception: the Viva modem is
a 2400 bps modem that does error correction, compression, and speed
buffering). These scripts attempt to use these modems at a fixed interface
speed of 57600 bps (or 38400 bps, if that is the highest speed supported by
the modem), to allow the modem's data compression to operate at its full
effectiveness, and they enable hardware flow control (RTS/CTS) to prevent loss
of data. Note that flow control will be fully effective only if the answering
modem and computer also have an effective flow control method between them.

The high-speed modem scripts:

. Configure the modem to echo commands, issue verbose result codes, and
hang up upon loss of DTR from the PC (as when you tell Kermit to HANGUP).
(If Kermit's HANGUP command doesn't work with your modem, you can find
a workaround in the KERMIT.BWR (MSKERM.BWR) file.)

. Start out at the highest supported modulation, V.32bis, with downwards
negotiation enabled (V.32, V.22bis, etc.) If a lower modulation technique
is negotiated, the interface speed remains fixed and the modem does "speed
buffering", for which effective flow control is an absolute requirement.

. Enable error correction and compression, starting out at the highest
supported levels (V.42 and V.42bis) and falling back to lower levels
(usually MNP), or to none at all.

. Configure to modem to pass BREAK signals through transparently when you
type Alt-B.

Dialing Interface Highest Error Data
Script Speed Modulation Correction Compression Remarks

BESTDATA.SCR 57600 V.32bis V.42->MNP V.42bis->MNP Beware of RPI
BOCA.SCR 57600 V.32bis V.42->MNP V.42bis->MNP
DATAPORT.SCR 57600 V.32bis V.42->MNP V.42bis->MNP
DYNA1414.SCR 57600 V.32bis V.42->MNP V.42bis->MNP
FASTALK2.SCR 57600 V.32bis V.42->MNP V.42bis->MNP
INTEL14.SCR 57600 V.32bis V.42->MNP V.42bis->MNP
PENRIL.SCR 38400 V.32(bis?) V.42->MNP V.42bis->MNP
PPI.SCR 57600 V.32bis V.42->MNP V.42bis->MNP PM14400 models
PPI.SCR 57600 V.32bis V.42->MNP V.42bis->MNP Zoltrix
PPI.SCR 57600 V.32 V.42->MNP V.42bis->MNP PM9600FXMT
PPI.SCR 38400 V.32 V.42->MNP V.42bis->MNP PM9600/9600SA
PPI.SCR 9600 V.22bis V.42->MNP V.42bis->MNP PM2400
QBLAZER.SCR 38400 V.32 V.42->MNP V.42bis->MNP
QX4232.SCR 38400 V.32bis V.42->MNP V.42bis->MNP
SPORT.SCR 57600 V.34 V.42->MNP V.42bis->MNP
SUPRA.SCR 57600 V.32bis V.42->MNP V.42bis->MNP
T3000.SCR 57600 V.32bis V.42->MNP V.42bis->MNP
ULTRA144.SCR 38400 V.32bis V.42->MNP V.42bis->MNP
VIVA.SCR 19200 V.24 V.42->MNP V.42bis->MNP
ZOOM.SCR 57600 V.32bis V.42->MNP V.42bis->MNP Beware of RPI

RPI = Rockwell Protocol Interface. Most modem manufacturers are now selling
modems that claim to include error correction and data compression, but which
only work with special software (not Kermit). Some Kermit dialing scripts
(the ones marked "Beware of RPI") will notice this and print a message.
Others will simply fail with a message like "Error enabling error correction".

The Telebit T3000 script should also work on the Telebit WorldBlazer.

The Telebit QBlazer script should also work on the Telebit Qblazer+ and T1600.

The Hayes Ultra 144 and Telepath PCMCIA modems give you a failure code if a
call fails:

0 Normal hangup
4 Physical carrier loss
5 Error control was required but was not negotiated
6 Other error-control modem did not respond to feature negotiation
7 Other modem is synchronous-only
8 Modems could not find a common framing technique
9 Modems could not find a protocol in common
10 Incorrect feature negotiation message sent by other modem
11 Timed out waiting for synchronous data
12 Normal disconnect initiated by other modem
13 Other modem did not respond after many retransmissions
14 Protocol violation
15 Compression failure

The PPI script attempts to identify the modem model and set the interface
and connection speeds accordingly. If it tells you "Unknown Practical

Peripherals Modem model", you'll have to add your model identification to
the script; the required changes should be self-evident.

For further information, read the script files themselves. They are ordinary
text files that you can TYPE, PRINT, or view with a text editor such as DOS
5.0 EDIT.

(End of MODEMS.DOC)
MS-DOS KERMIT 3.14 NETWORK SUPPORT

This directory contains several supplementary files for network users:

SETUP.DOC (text)
Detailed information about setting up your PC for networking: boards,
interface standards, drivers and shims, interrupts, memory management,
Windows, etc.

PKTADDR.COM, PKTADDR.DOC
From the Crynwr packet-driver collection. Tells you the hardware address of
your network adapter if you have an Ethernet-class packet driver loaded for
it. Read PKTADDR.DOC for details.

SLIP8250.COM, SLIP8250.DOC
SLIP (serial-line IP) packet driver that works with Kermit and most other
TCP/IP applications that support a SLIP-class packet driver. Read
SLIP8250.DOC for details. Obtain other packet drivers separately from
your network board vendor, from Cyrnwr Software, or from Columbia University.

WINPKT.COM, WINPKT9.COM, WINPKT.DOC
A shim to allow packet-driver applications (such as MS-DOS Kermit, when its
TCP/IP stack is active) to run under Windows and still use the network.

DIS_PKT9.DOS, DIS_PKT9.DOC
A shim to allow packet-driver applications to run over an NDIS network
board driver.

ODIPKT.COM, ODIPKTPN.COM, ODIPKT.DOC
A shim to make an ODI driver look like a packet driver, for when Kermit
is running under Windows and needs to make ODI connection, to be used
in conjunction with WINPKT.

Also see the Networks Appendix of "Using MS-DOS Kermit" plus supplementary
information in KERMIT.HLP, KERMIT.BWR, and KERMIT.UPD.

(End of NETWORKS\READ.ME)
PC FONTS FOR MS-DOS KERMIT

This directory contains public domain "fonts" that are equivalent to the code
pages used by IBM and compatible PCs (with 256K EGA or better), but which can
be loaded any time you want, without having to edit your AUTOEXEC.BAT file and
reboot your PC. These fonts, and the accompanying utility programs, are from
Joseph (Yossi) Gil (Yogi) at the Technion in Haifa, Israel, host
ssl.cs.technion.ac.il, directory /pub/DOS/Yogi. Many others are also
available from the same source.

This directory contains the following font utilities:

LOADFONT.COM, LOADFONT.HLP
The utility that loads a font.

WITHFONT.COM
TSR that loads a font and runs a program in such a way that the program
will use the font, even if the video mode changes (e.g. between 80 and
132 columns).

CHARSET.COM
A utility that displays all the characters in the current font.

The following fonts are included. The filetype (.F16 or .F08) tells how many
vertical dots the font contains. The .F16 files are suitable for the normal
25-row by 80-column screen, and the .F08 files are suitable for most of the
larger screen dimensions, such as 53x80.

CP437.F16 and .F08
A font for IBM Code Page 437, the default (hardware) code page on all PCs.

CP850.F16 and .F08
A font for IBM Code Page 850, the "multilingual code page" that can
represent most Western European languages.

CP852.F16 and .F08
A font for IBM Code Page 852, for Eastern European languages that are
written in the Roman Alphabet.

CP861.F16 and .F08
A font for IBM Code Page 861, Icelandic. CP850 can also be used for
Icelandic, but CP861 predates CP850 and is still in wide use in Iceland.

CP862.F16 and .F08
A font for IBM Code Page 862, containing the Hebrew alphabet, used by
Kermit's Hebrew support (see the HEBREW subdirectory).

CP866.F16 and .F08
A font for IBM Code Page 866, containing the Cyrillic alphabet, used by
Kermit's Cyrillic support (see the CYRILLIC subdirectory).

SCRAWL.F16
Just for fun 🙂

The standard MS-DOS Kermit 3.14 MSKERMIT.INI file includes the following
macros that load the .F16 versions of these fonts:

AFONT - Default (CP437)
CFONT - Cyrillic
EFONT - East European
HFONT - Hebrew
IFONT - Icelandic (CP861)
MFONT - Mutlilingual (West European)
SCRAWL - ???

The CHARSET macro runs the CHARSET program.

These macro names can be given as commands at the MS-Kermit> prompt if you
have installed MS-DOS Kermit in the normal way. If you are not using a long
screen length, like 43 or 55 lines, you will have to modify the macros to use
the .F08 fonts instead of the .F16 ones. If you will be switching between
80 and 132 columns, you should start Kermit like this:

c:\kermit\pcfonts\withfont c:\kermit\pcfonts\cpxxx.f16 kermit

(where xxx is the code page number) or, equivalently:

c:
cd \kermit\pcfonts
withfont cpxxx kermit

Other fonts and sizes are available from the Technion FTP site.

(End of PCFONTS\READ.ME)
THE MS-DOS KERMIT VERSION 3.14 DISTRIBUTION DISKETTE May 21, 1995

Copyright (C) 1982, 1995, Trustees of Columbia University in the City of New
York. The MS-DOS Kermit software may not be, in whole or in part, licensed
or sold for profit as a software product itself, nor may it be included in
or distributed with commercial products or otherwise distributed by
commercial concerns to their clients or customers without written permission
of the Office of Kermit Development and Distribution, Columbia University.
This copyright notice must not be removed, altered, or obscured.

Welcome to MS-DOS Kermit 3.14: high-quality, full-function communication
software for IBM and compatible PCs with DOS or Windows.

The documentation for MS-DOS Kermit is "Using MS-DOS Kermit", second edition,
by Christine M. Gianone, published by Digital Press / Butterworth-Heinemann,
Woburn, MA, 1992, 345 pages, ISBN 1-55558-082-3. To order, call Columbia
University at +1 212 854-3703 or Digital Press at:

+1 800 366-2665 (Woburn, MA office for USA & Canada)
+1 416 598-0045 (Toronto, ON office for Canada)
+44 1933 414414 (Rushden, England office for UK & Europe)
+61 2 372-5511 (Chatswood, NSW office for Australia & NZ)
+65 356-1925 (Singapore office for Asia)

The KERMIT.UPD file on your diskette describes features added since
publication of "Using MS-DOS Kermit".

If you are installing MS-DOS Kermit for the first time:

1. Place the Kermit diskette in drive A: (or B:).
2. Create a KERMIT directory on your hard disk, e.g. MKDIR C:\KERMIT.
3. XCOPY A:*.* C:\KERMIT /S (substitute B: for A: if necessary).
4. Edit the MSCUSTOM.INI file to suit your needs and preferences.
5. Edit your AUTOEXEC.BAT file to insert the Kermit directory in your PATH.

See the APPENDIX at the end of this file about how to edit files.

If you are replacing an older version of MS-DOS Kermit (this illustration
assumes it is in C:\KERMIT):

1. Place the Kermit diskette in drive A: (or B:).
2. Copy your old MSCUSTOM.INI and DIALUPS.TXT to a safe place.
3. XCOPY A:*.* C:\KERMIT /S (substitute B: for A: if necessary).
4. Copy your old MSCUSTOM.INI and DIALUPS.TXT files back to C:\KERMIT.

If you want to run MS-DOS Kermit from a RAM disk (to save startup time), you
may copy KERMIT.EXE to the RAM disk, but please do not copy MSKERMIT.INI or
the other Kermit files to the RAM disk, because (as of version 3.14), MS-DOS
Kermit expects to find its subdirectories in the same directory where the
MSKERMIT.INI file was found.

To use Kermit in Microsoft Windows, also perform the following steps in
Windows:

1. Open the group window for the group you want to add Kermit to.
2. Choose New from the File menu. The New Program dialog box appears.
3. Select Program Item and choose OK.
4. Type "MS-DOS Kermit 3.14" in the Description text box.
5. Type the pathname of the KERMIT.PIF file in the Command Line box,
e.g. "C:\KERMIT\WINDOWS\KERMIT.PIF" (without the quotes).
6. Choose OK, and now you should have an MS-DOS icon that starts Kermit with
the right PIF settings.
7. If you want to assign a special icon to Kermit, click on the "generic
MS-DOS" Kermit icon, then click on File, then Properties, then Change Icon,
and then pick a new one (like the VT or satellite dish from MORICONS.DLL).
8. The PIF file assumes that KERMIT.EXE is in your PATH. If you did not
store the KERMIT.EXE file in a directory that is in your PATH, you will
have to use the PIFEDIT program on the KERMIT.PIF file to specify the
full path name.
9. If you plan to use networks, read about WINPKT in NETWORKS\SETUP.DOC.

If you don't have a hard disk: (a) make a backup copy of the original Kermit
diskette, (b) put the original aside, (c) remove unneeded files and directories
from your backup copy (e.g. NETWORKS, CYRILLIC, HEBREW, etc) to make space for
downloading files, etc, and (d) edit the MSCUSTOM.INI file to suit your
requirements.

For network installation, see "Using MS-DOS Kermit" Chapter 16 plus the
supplementary material in NETWORKS\SETUP.DOC.

The MS-DOS Kermit distribution diskette contains the following files in its
top-level directory, plus several subdirectories that contain more files.
Files marked as "(text)" are simple, plain, ordinary ASCII text. You may view
these files with the DOS or Kermit TYPE command, the DOS MORE command, a text
editor (such as the DOS EDIT program) or word processing program in plain-text
(ASCII) mode, or print them on your printer. Files marked as "(binary)" can
not be viewed or displayed.

------------------------------
Files in the TOP-LEVEL DIRECTORY:

READ.ME (text)
This file.

KERMIT.EXE (binary)
The MS-DOS Kermit program for the IBM PC family, the IBM PS/2, and
compatibles, full-featured, ready to run.

KERMITE.EXE (binary)
A smaller version of MS-DOS Kermit, with networking and graphics terminal
capabilities removed, to be used on PCs with small memories if KERMIT.EXE
won't fit.

KERLITE.EXE (binary)
A very small version of MS-DOS Kermit, with no networking and no terminal
emulator (and no CONNECT command), but including full file transfer and
scripting capabilities to be used as an external protocol and/or
script-execution engine.

MSR314.PCH, MSRM314.PCH, MSRL314.PCH (text)
Patches, if any, for KERMIT.EXE, KERMITE.EXE, KERLITE.EXE, respectively.
Read the file for a description of each patch.

MSKERMIT.INI (text)
The standard initialization file for MS-DOS Kermit. Includes many of the
macro definitions from Chapter 14 of "Using MS-DOS Kermit", e.g. for setting
up your modem-dialing environment. You should not make any changes to this
file. If you want to override or undo any definitions made here, please do
it in MSCUSTOM.INI.

MSCUSTOM.INI (text)
A SAMPLE customization file. Read, then edit this file to suit your needs
and preferences. Be sure to save it in text (ASCII) mode, and not in any
kind of word-processing format. In particular, use this file to set your
modem type, startup communications parameters, preferred colors, any special
key mappings you might want, and so on.

DIALUPS.TXT (text)
A sample dialing directory, for use with the DIAL command. This file
does not contain any real phone numbers. If you want to have a dialing
directory, edit this file to contain entries for the computers or services
that you actually use. Read KERMIT.UPD for further information.

KERMIT.UPD (text)
A supplement to "Using MS-DOS Kermit", describing the features that have
been added since MS-DOS Kermit version 3.11 was released.

KERMIT.HLP (text)
A brief summary of the commands and functions of MS-DOS Kermit.

KERMIT.BWR (text)
The MS-DOS Kermit 3.14 "Beware File". Frequently asked questions, hints and
tips, limitations, problems, workarounds. If you are having trouble using
MS-DOS Kermit, read this file. You might find a solution or workaround.

COLS132.BAT (text)
A DOS Batch file invoked automatically by Kermit if the host sends a "switch
to 132-column mode" escape sequence or if you give the SET TERMINAL WIDTH
132 command to MS-DOS Kermit, but only if Kermit does not already have
built-in knowledge of your video adapter. As supplied, this batch file only
prints a message. You must fill it in with the appropriate DOS commands to
put your screen into 132-column mode (as supplied by the manufacturer of
your video adapter).

COLS80.BAT (text)
Like COLS132.BAT, but for changing from 132-column mode to 80-column mode.

--------------
SUBDIRECTORIES
--------------
PERFORM
An article, PERFORM.DOC, from Kermit News #5, June 1993, discussing Kermit
file transfer performance and benchmarking it against other popular protocols
and software.
--------------
MODEMS
Dialing scripts and information for various types of modems. If you are using
one of these modems rather than the default Hayes 1200 or 2400, follow the
directions to use it for dialing. All files in this subdirectory are text
files. Read the MODEMS\READ.ME file to get started.
--------------
NETWORKS
Drivers and information that are useful with Kermit's built-in networking.
See the NETWORKS\READ.ME file for further information.
--------------
KEYBOARD
Keymaps and keyboard-related utilities. See the KEYBOARD\READ.ME file for
details.
--------------
UTILS
General utility programs to be used with MS-DOS Kermit. See UTILS\READ.ME.
--------------
WINDOWS
Stuff for Windows: KERMIT.PIF file, icon, etc.
--------------
PCFONTS
Different character sets for your PC -- Hebrew, Russian, etc. See
PCFONTS\READ.ME for details.
--------------
CYRILLIC
Cyrillic character-set support and tables for MS-DOS Kermit. See
CYRILLIC\READ.ME for further information.
--------------
HEBREW
Hebrew character-set support and tables for MS-DOS Kermit. See
HEBREW\READ.ME for further information.
--------------
ROMAN
Roman-alphabet character-set tables. See ROMAN\READ.ME for details.
--------------

Kermit software programs for hundreds of other kinds of computers are
available on diskette or magnetic tape or cartridge from Kermit Distribution
at Columbia University. Contact:

Kermit Distribution
Columbia University Academic Information Systems
612 West 115th Street
New York, NY 10025-7721
USA
Phone: +1 212 854-3703
Fax: +1 212 663-8202
Email: [email protected]
Web: http://www.columbia.edu/kermit/

APPENDIX: EDITING FILES ON THE PC

Your AUTOEXEC.BAT and CONFIG.SYS are "plain text" files. The same is true of
all Kermit command and initialization files. You can modify such files using
the DOS EDLIN or EDIT programs. EDLIN and EDIT are documented in your DOS
manual. The recommended method for editing these files is to use the DOS EDIT
program. Let's suppose you want to modify your AUTOEXEC.BAT file. First,
make a backup copy in case something goes wrong:

cd c:\
copy autoexec.bat autoexec.bak

And then start the editor:

edit autoexec.bat

This brings up a screen showing the file. You can move through the file with
the arrow keys until you find the line you want to change, in our case the
line that starts with "PATH=". Use the End key to position the cursor at the
end of the "PATH=" line, then type the text you want to add, such as
";C:\KERMIT".

To save the file, press Alt-f (hold down Alt, press f) to activate the File
menu. Then use the down-arrow key to highlight the Save item, and then press
the Enter key.

To exit from EDIT, press Alt-f again, use the arrow key to highlight Exit, and
press Enter.

If you are using a word processing program to create or modify a DOS or Kermit
command file, do not include any special effects (bold, underline, italics),
and be sure to save the file in text mode. The method for doing this depends
on the word processor.

In Microsoft Word 5.0, for example, press the Esc key to get to the menu,
press T to choose Transfer, press S to choose Save, type the filename, use the
arrow keys to get to the "format" line, choose Text-Only, press Enter to save
the file, and then leave the program by pressing the Esc key and then Q.

In WordPerfect 5.1, use Ctrl-F5 (hold down the Ctrl key and press the F5 key)
to save the file, press T to select DOS Text, 1 to Save, type the filename and
press Enter, and quit from WordPerfect by pressing the F7 key.

(End of MS-DOS Kermit 3.14 READ.ME)
ROMAN-ALPHABET CHARACTER-SET TABLES

These are to illustrate and document the encodings used by various
Roman-alphabet character sets that are understood by MS-DOS Kermit, and also
to be used for practice in transferring files with simultaneous character-set
conversion, as documented in Chapter 13 of "Using MS-DOS Kermit".

CP852.TBL, CP861.TBL
Code page tables.

LATIN2.TBL
Table for ISO 8859-2, Latin Alphabet 2 (Eastern Europe).

For Latin-1, CP437, and CP850, see pp.277-280 of "Using MS-DOS Kermit".

(End of ROMAN\READ.ME)
MS-DOS KERMIT UTILITIES

XONXOFF.COM, XONXOFF.HLP
Serial printer driver that provides Xon/Xoff flow control.

XSEND.EXE, XSEND.HLP
A utility for building an MS-DOS Kermit command file that transfers
an entire directory tree from one PC to another.

PCPRINT.SH, PCPRINT.MAN
A UNIX shell script to print files on the PC's locally attached printer,
using Kermit's Transparent Print feature. Works when Kermit is in
CONNECT mode. PCPRINT.MAN is the "man page".

PCPRINT.COM
A VMS DCL command file, equivalent to UNIX PCPRINT.SH.

RECOVER.SCR
A copy of the RESEND script program from Kermit News #6.

UPLOAD.SCR
A file-uploading script designed to be used with screen readers,
discussed in Kermit News #6.

(End of UTILS\READ.ME)
MS-DOS KERMIT 3.14 WINDOWS STUFF

See the main READ.ME file for installation instructions.

Contents of this directory:

READ.ME
This file.

KERMIT.PIF
Program Information File for Kermit. If you have not installed Kermit as
C:\KERMIT\KERMIT.EXE, then use the PIF editor to change the program filename.

If you will be making network connections from MS-DOS Kermit in Windows,
also be sure to either Lock Application Memory in the PIF file, or else load
WINPKT appropriately, over your packet driver, to provide the needed
coordination between your packet driver and Windows.

To use Kermit in Windows over an ODI driver, you can't use Kermit's built-in
ODI support -- instead, you must run ODIPKT over the ODI driver, and then
WINPKT over ODIPKT. Or else (maybe) lock Kermit in memory and skip ODIPKT
and WINPKT.

For detailed information on all the above, as well as for information about
Windows for Workgroups, please read NETWORKS\SETUP.DOC.

And no, MS-DOS Kermit can't be used with Winsock. Winsock can only be used
by 100% pure Windows applications, which MS-DOS Kermit is not.

(End of WINDOWS\READ.ME)