CKOAAA.DSK (READ.ME) OS/2 C-Kermit 5A(189) July 1993 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 networking, DECnet/LAT networking, VT102 terminal emulation, key mapping, screen rollback, screen copy and printing, fast and reliable Kermit file transfer, national and international character-set conversion, and a powerful, easy-to-use script programming language. C-Kermit Software Copyright (C) 1985, 1993, 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. GUIDE TO THE OS/2 C-KERMIT DISTRIBUTION DISKETTE READ.ME (or CKOAAA.HLP) This file. INSTALL.CMD (or CKOINS.CMD) OS/2 C-Kermit installation procedure. Click on it to begin installation or, in a command window, just type "a:install". After installation, you can use C-Kermit by clicking on its desktop icon or, in a command window, typing "ckermit". See below for further instructions. 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. The 16-bit version will also work on OS/2 2.x, but the 32-bit version will not work on OS/2 1.x. CKOTCP16.DLL or CKOTCP32.DLL Dummy TCP/IP library for OS/2 systems that do not have TCP/IP installed, either the 32- or 16-bit version. 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. Read and modify to suit your requirements. CKERMIT.ICO OS/2 C-Kermit desktop icon. CKERMIT.INI Standard C-Kermit 5A initialization file. 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. CKERMIT.KDD Sample C-Kermit dialing directory file. See pages 50-67 of "Using C-Kermit" for complete instructions on dialing. CKERMIT.KSD Sample C-Kermit services directory file. See Chapter 13 of "Using C-Kermit" CKCKER.UPD ("update file") New feature in C-Kermit since "Using C-Kermit" was published. CKCKER.BWR C-Kermit "beware file": restrictions, limitations, hints & tips. CKOKER.BWR OS/2-specific C-Kermit "beware file". Read in conjunction with the general C-Kermit beware file, CKCKER.BWR. CKOVTK.INI Sample key settings file to make DEC VT100 and VT220 key assignments for the IBM PC extended (101) keyboard. Tell C-Kermit to TAKE this file to make the VT100 assignments. For further information, read this file. CKOEXP.DOC ("external protocols") Hints and tips for using C-Kermit with other communication software programs. 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. INSTALLATION INSTRUCTIONS To install C-Kermit 5A(189) 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). Or, 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. If you are NOT using the automatic installation procedure, then you must also take an additional step, not listed in the book, to account for OS/2 C-Kermit's new support for TCP/IP networking: OS/2 C-Kermit version 5A(189), which was released after publication of "Using C-Kermit", supports TCP/IP connections if you have TCP/IP installed on your OS/2 system. Please read the following VERY CAREFULLY: If you do NOT have IBM TCP/IP installed on your OS/2 system, you must install a dummy TCP/IP DLL (dynamically linked library) in your OS/2 system or else C-Kermit 5A(189) will not be able to run. If you DO have IBM TCP/IP installed, do NOT install this dummy library! Assuming you have the OS/2 C-Kermit distribution diskette in drive A: and your OS/2 system is installed on drive C:, and you have an active OS/2 command processor (CMD) window, follow this procedure: 1. Type the following command: DIR C:\TCPIP\DLL\TCPIPDLL.DLL If OS/2 lists the file, then STOP RIGHT NOW -- your OS/2 system already has TCP/IP installed. WARNING: TCP/IP need not be installed on your boot drive. If you have other hard drives or network drive letters available, check them too. If OS/2 says "SYS0002: The system cannot find the file specified", then go on to the next step. 2. Type the following command: COPY A:CKOTCP16.DLL C:\OS2\DLL\TCPIPDLL.DLL or: COPY A:CKOTCP32.DLL C:\OS2\DLL\TCPIPDLL.DLL depending on whether you are installing the 16-bit or 32-bit version of C-Kermit. You must install the dummy DLL before you first try to run C-Kermit, or else OS/2 will not be able to start C-Kermit, and will give a message to the effect that "file TCPIPDLL not found". IMPORTANT WARNING: If you have installed the dummy DLL, be sure to remove it if you ever install IBM TCP/IP on your OS/2 system. Since C:\OS2\DLL is ahead of C:\TCPIP\DLL in your LIBPATH, TCP/IP will never find its real library, and will therefore not work! ANOTHER IMPORTANT WARNING: If you install a new version of OS/2, it will remove the dummy TCPIPDLL.DLL file from the OS2\DLL directory. To guard against the above two happenstances, it is better if you put the dummy DLL in C-Kermit's directory, and then (if you know how to edit files) edit your CONFIG.SYS file to add the C-Kermit directory to your LOADPATH. NOTE: The INSTALL.CMD procedure takes care of all the above automatically. DOCUMENTATION (including OS/2 C-Kermit installation instructions): Frank da Cruz and Christine M. Gianone, "Using C-Kermit", Digital Press, Burlington, MA, 1993, approx. 500 pages. Order Number: EY-J896E-DP Digital Press ISBN: 1-55558-108-0 Prentice Hall ISBN: 0-13-037490-3 US single-copy price: $34.95; quantity discounts available. Available in computer bookstores or directly from Digital Press. In the USA, call DECdirect toll-free 1-800-344-4825 to order; major credit cards accepted. Overseas, order through your bookstore or your local Digital Equipment Corporation branch. Can also be ordered from: Kermit Development and Distribution Columbia University Academic Information Systems 612 West 115th Street New York, NY 10025 USA Telephone: (USA) 212 854-3703 Domestic and overseas orders accepted. Price: $34.95 (US, Canada, and Mexico), $45 elsewhere. Orders may be paid by MasterCard or Visa, or prepaid by check in US dollars. Add $35 bank fee for checks not drawn on a US bank. Price includes shipping. Do not include sales tax. Contact 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)