READ.ME OS/2 C-Kermit 5A(190) October 1994 OS/2 C-Kermit is a powerful, full-function communications software program for your OS/2 system. C-Kermit supports serial communications, automatic dialing, TCP/IP, DECnet/LAT, NETBIOS, and Named Pipes as communication methods, with VT52, VT100, VT102, VT220, and ANSI terminal emulation, key mapping, screen rollback, screen copy and printing, fast and reliable Kermit file transfer, national and international character-set conversion, and includes a powerful, easy-to-use script programming language. C-Kermit Software Copyright (C) 1985, 1994, Trustees of Columbia University in the City of New York. The C-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. The above copyright notice also applies to inclusion of C-Kermit on so-called "freeware" and/or "shareware" CD-ROMs. Numerous improvements have been made to OS/2 C-Kermit since "Using C-Kermit" was published. Be sure to read the CKERMIT.INF file included on the diskette. INSTALLATION INSTRUCTIONS To install C-Kermit 5A(190) on your OS/2 system: 1. Insert the C-Kermit diskette into a diskette drive. 2. Click on the diskette icon for that diskette drive. 3. Click on the INSTALL.CMD file and then answer the questions. Alternatively, from an OS/2 command window, type the command "a:install" (substitute a different disk letter if necessary). After installation, you can use C-Kermit by clicking on its desktop icon or, in a command window, typing "ckermit". If desired, you can skip the automatic installation procedure and follow the instructions on pages 421-423 of "Using C-Kermit" (if you don't have the book, ordering information is given below). This gives you a bit more flexibility, but requires that you edit some files yourself. WHAT IS ON THE OS/2 C-KERMIT DISTRIBUTION DISKETTE READ.ME This file. INSTALL.CMD (or CKOINS.CMD) OS/2 C-Kermit installation procedure (a REXX program). CKOKER16.EXE or CKOKER32.EXE The OS/2 C-Kermit program, either the 16-bit version or the 32-bit version, depending on which one you ordered. It will be installed as CKERMIT.EXE if you use the INSTALL procedure. The 16-bit version should be used on OS/2 1.x. The 32-bit version should be used on OS/2 2.x and Warp. CKO32I20.DLL - IBM TCP/IP 2.0 32-bit interface CKO32I12.DLL - IBM TCP/IP 1.2 32-bit interface CKO16I12.DLL - IBM TCP/IP 1.2 16-bit interface CKO32F13.DLL - FTP PC/TCP 1.3 32-bit interface CKO16F13.DLL - FTP PC/TCP 1.3 16-bit interface Interface between C-Kermit and your installed TCP/IP software, if any: IBM TCP/IP or FTP Software PC/TCP. The FTP DLLs also work with Essex Systems TCP/2 and IP-Switch Vantage IP. The IBM DLLs work with other TCP/IP products that are IBM compatible. The appropriate DLL is loaded automatically at runtime. These files must be in your CKERMIT directory, i.e. the directory from which C-Kermit is started. CKOSYSL.CK1 or CKOSYSL.CK2 SYSLEVEL info for 16-bit and 32-bit versions, respectively. CKERMIT.CMD A sample REXX CMD file for starting OS/2 C-Kermit. Handled automatically by INSTALL.CMD. Or read and modify to suit your requirements. CKERMIT.ICO OS/2 C-Kermit desktop icon. CKERMIT.INI Standard C-Kermit 5A initialization file. Sets up your dialing and services directories, and defines several handy command macros. This is an ordinary text file; it documents itself -- just read it in a text editor, or print it. CKERMOD.INI Sample C-Kermit 5A customization file, edit to suit your needs. NOTE: the INSTALL procedure will modify this file to include your preference for port, modem type, and communication speed. If you are installing over a previous C-Kermit version, the install procedure skips the questions and leaves this file alone; it also leaves your previous dialing and services directory intact rather than replacing them with the sample ones from this diskette. CKERMIT.KDD Sample C-Kermit dialing directory file. Edit this file to include the numbers that you actually call. See pages 50-67 of "Using C-Kermit" for complete instructions on dialing. NOTE: You don't need to use the dialing directory in order to make modem calls; it is merely a convenience that lets you refer to frequently called numbers by name - "dial work" instead of "dial 1 212 555-1234". CKERMIT.KSD Sample C-Kermit services directory file. This lets you establish connections and log in automatically to all sorts of hosts and services in a uniform way, no matter what the connection method. See Chapter 13 of "Using C-Kermit", and the services directory section of CKERMIT.INF. CKERMIT.INF Documentation for the new features added to C-Kermit since "Using C-Kermit" was published. IMPORTANT: the method for key mapping is completely different in version 5A(190) from earlier versions. The information that was formerly scattered among several different files - CKCKER.UPD, CKCKER.BWR, CKOKER.BWR, CKOREXX.DOC, CKOEXP.DOC - has been consolidated into this new file and converted to INFO format for use with the Information Presentation Facility (IPFC) and can be accessed using the OS/2 VIEW command or, equivalently, via C-Kermit's UPDATES macro, which simply runs VIEW on the CKERMIT.INF file. CKOVTK2.INI Sample key settings file to make DEC VT52, VT100, VT102, and VT220 key assignments for the IBM PC extended (101) keyboard, which, among other things, makes the IBM numeric keypad act like the DEC VT terminal numeric keypad, Gold key and all. Tell C-Kermit to TAKE this file to make the key assignments. For a detailed listing of the mapping between DEC keys and PC keys, read the CKOVTK2.INI file itself (it's an ordinary text file). EMACSKEY.INI Sample key mappings for EMACS and Crisp, using Alt key as Meta key. Read this file for further info, edit it to suit your preferences. XSEND.CMD A C-Kermit REXX program to send an entire directory tree from one OS/2 system to another, making an exact copy of the directory structure, and all the files, including all their attributes. It can also be used, with some restrictions, for sending OS/2 directory trees to DOS or UNIX. Read XSEND.CMD for further information. M2ZMODEM.INI, P101.INI, P200.INI, CEXYZ2.INI External XMODEM, YMODEM, YMODEM-G, and ZMODEM protocol definitions for M2ZMODEM, P 1.01, P 2.0x, and CEXYZ/2, respectively. These are C-Kermit command files; use C-Kermit's TAKE command to execute them. To have one of them in effect whenever you use C-Kermit, uncomment the appropriate line in the OS/2 section of your CKERMOD.INI file. CP437.TXT, CP850.TXT, LATIN1.TXT Character-set tables for the two common PC code pages used with OS/2 for representing West European languages, and the corresponding international standard character set. Use these for practice displaying and transferring international text. DOCUMENTATION To get the best use out of C-Kermit, please purchase the manual if you don't already have it. It gives you step-by-step instructions and it's also a comprehensive reference. Manual sales are a primary source of funding for the Kermit effort. Frank da Cruz and Christine M. Gianone, "Using C-Kermit", Digital Press / Butterworth-Heinemann, Woburn, MA, 1993, 514 pages, ISBN 1-55558-108-0 US single-copy price: $39.95; quantity discounts available. Available in computer bookstores or directly from Columbia University: Kermit Development and Distribution Columbia University Academic Information Systems 612 West 115th Street New York NY 10025-7799 USA Telephone: +1 212 854-3703 Fax: +2 212 663-8202 Domestic and overseas orders accepted. Price: US $39.95 (US, Canada, and Mexico), US $50 elsewhere. Orders may be paid by MasterCard or Visa, or prepaid by check in US dollars. Add US $35 bank fee for checks not drawn on a US bank. Price includes shipping. Do not include sales tax. Inquire about quantity discounts. You can also order by phone from the publisher, Digital Press / Butterworth-Heinemann, with MasterCard, Visa, or American Express: +1 800 366-2665 (Woburn, Massachusetts office for USA & Canada) +44 1865 314627 (Oxford, England distribution centre for UK & Europe) +61 03 9245 7111 (Melbourne, Vic, office for Australia & NZ) +65 356-1968 (Singapore office for Asia) +27 (31) 2683111 (Durban office for South Africa) A German-language edition is also available: Frank da Cruz and Christine M. Gianone, "C-Kermit - Einfuehrung und Referenz", Verlag Heinz Heise, Hannover, Germany (1994). ISBN 3-88229-023-4. Deutsch von Gisbert W. Selke. Price: DM 88,00. Verlag Heinz Heise GmbH & Co. KG, Helstorfer Strasse 7, D-30625 Hannover. Tel. +49 (05 11) 53 52-0, Fax. +49 (05 11) 53 52-1 29. Contact Columbia University Kermit Distribution for information about other Kermit software programs, including those for MS-DOS, Windows, UNIX, VMS, IBM mainframes, and hundreds of others. (End of OS/2 C-Kermit READ.ME file)