KERMIT - Send or Receive files using the Kermit protocol. Usage: KERMIT s | r[t] | sv[t] [pathname.. [pathname] ]} Options: s pathname Send file identified by pathnames r Receive file from micro. Pathname is not entered as the micro will send it. rt Receive file from micro as above but create a temporary file as output. sv Server mode svt Server mode creating only temporary files Examples: In this example, the user is sitting at an IBM Personal Computer (PC), which is connected through its serial port to a DPS8 host computer. The IBM PC is local, the DPS8 is remote. This example will also apply almost literally to any other microcomputer implementation of Kermit. You have started up your PC and have the Kermit program on your disk. Begin by running Kermit on the PC. Use Kermit's CONNECT command to become a terminal to the DPS8. The PC emulates the popular Heath-19 (or VT52) terminal. Login on the DPS8 and run Kermit there. Here is an example of this procedure with commands you type in are lower case: 1 A>kermit ! Run Kermit on the PC. Kermit V1.20 Kermit-86> ! This is the Kermit prompt for the PC. Kermit-86>set parity even ! Sets the parity to even Kermit-86>set local on ! Sets local echo on Kermit-86>set baud 1200 ! Sets speed to 1200 baud Kermit-86>set back back ! Sets delete character to backspace Kermit-86>connect ! Connect to the DPS8. [Connecting to host, type control-] to return to PC. Baud rate is 1200, connecting over COM1.] ! Now dial number of the Datanet-8. cr ! Hit return ! You are now connected to the DPS8. $$ 50 DEVICE TYPE IDENTIFER: ! The Datanet requesting terminal type. pctran ! Set your terminal type. USER ID -- ! Login using normal login method. (At this point, the DPS8 prints various messages.) You are now ready to transfer files between the two machines. The following example illustrates how to send files from the to the PC. _______________ 1 Everthing from a "!" mark to the end of line is commentary, not system typeout or part of a command. kermit s foo.ftn ! Send my FORTRAN file. ^]c ! Now return back to the PC by ! typing the escape sequence, in this case ! ^]C (Control-] followed by "C") [Back at PC.] Kermit-86>receive ! Tell the PC files are coming. If you take more than about 5 seconds to get back to Kermit-86 and issue the RECEIVE command, the first packets from Kermit-GCOS may arrive prematurely and appear on your screen, but no harm will be done, just press return on the PC and the packet will be retransmitted by the DPS8. Once the connection is established, the PC will show you what is happening -- it first clears the screen and waits for incoming packets; as packets ar- rive, the current file name and packet number will be continuously displayed on the screen. When the PC's "Kermit-86>" prompt returns to your screen, the transfer is done. During file transfer, the microcomputer screen looks some- thing like this: IBM PC Kermit-86 V1.20 Number of Packets: 294 Receiving... Number of Retries: 2 File Name: FOO.FTN The packet and retry counts are continuously updated, and the word in the upper right tells the status of the transfer -- receiving, sending, complete, inter- rupted, or failed. When the transfer is complete (most versions of KERMIT sound a beep to wake you up), you must CONNECT back to the DPS8 host, EXIT from Kermit there, logout, and "escape back" to the PC as you did previously. Kermit-86>connect ! Get back to the DPS8. [Connecting to host. Type CTRL-]C to return to PC.] OK ! Kermit-GCOS reporting sucess. * ! Here we are. BYE ! Logout from the DPS8. **COST: $ 12.32 TO DATE: $23718.21= 47% **ON AT 13.175 - OFF AT 19.345 ON 02/01/84 $$ 02 YOU ARE DISCONNECTED - NORMAL TERMINATION ^]c ! Now "escape" back to the PC, [Back at PC.] Kermit-86>exit ! and exit from the PC's Kermit. The files you transferred should now be on your PC disk. To send files from the PC to the DPS8, follow a similar procedure. First follow the instructions in the previous section to log in to the DPS8 through the PC. Then enter KERMIT R. Now escape back to the PC and use the SEND command to send the local PC files to DPS8 host. The PC will show you the progress of the transmission on its screen. The SERVER (SV) commands puts KERMIT-GCOS in "server mode" , so that it receives all further commands in packets from the local KERMIT. KERMIT-GCOS is capable of executing the following commands from the local kermit: o SEND filename - Sends filename to kermit o RECEIVE filename - Recieves filename from host using host pathname o FINISH - Terminates KERMIT-GCOS and makes TSS available o BYE - Terminates KERMIT-GCOS and logs off of TSS. Here is an example of this procedure with commands you type in are lower case: A>kermit ! Run Kermit on the PC. Kermit V1.20 Kermit-86> ! This is the Kermit prompt for the PC. Kermit-86>set parity even ! Sets the parity to even Kermit-86>set local on ! Sets local echo on Kermit-86>set baud 1200 ! Sets speed to 1200 baud Kermit-86>set back back ! Sets delete character to backspace Kermit-86>connect ! Connect to the DPS8. [Connecting to host, type control-] to return to PC. Baud rate is 1200, connecting over COM1.] ! Now dial number of the Datanet-8. cr ! Hit return ! You are now connected to the DPS8. $$ 50 DEVICE TYPE IDENTIFER: ! The Datanet requesting terminal type. pctran ! Set your terminal type. USER ID -- ! Login using normal login method. (At this point, the DPS8 prints various messages.) You are now ready to transfer files between the two machines. The following example illustrates how to send files from the to the PC using KERMIT-GCOS server mode. kermit sv ! start up kermit in server mode Kermit-Gcos V3.0 ! start up message printed out Server mode ! just to let you know ^]c ! Now return back to the PC by ! typing the escape sequence, in this case ! ^]C (Control-] followed by "C") [Back at PC.] Kermit-86>receive mycatalog/mysubcat/myfile ! have KERMIT-GCOS send my file over (when file transfer is completed) Kermit-86>exit ! exit out of local kermit (now you can do some work on the micro, edit files, whatever) A>kermit !start up local kermit again and set !up your options, parity etc. Kermit-86>send myfile !send it back to the host (when file transfer completes ) Kermit-86>bye ! Shut dowm kermit server A> ! Back to MSDOS automatically Kermit-GCOS will create quick access files using the first 8 characters of the PC filename. If a temporary file is desired use the 'rt' command and Kermit will create a temporary file in your aft. When the "Kermit-86>" prompt indicates that the transmission is complete you should follow the procedure shown above to logout from the DPS8 host, except that you may first wish to confirm that the files have been stored correctly in your catalog on the DPS8. If the transmissions appears to be stuck, press return to wake the PC up. This should clear up any protocol deadlock. Several returns may be necessary When using the special terminal identifer PCTRAN some basic terminal functions are changed: o The break key on the terminal is disabled. Use Control-Y instead. This may take a few seconds to take effect. o The @ sign will no longer be the character delete. Use backspace (Control-H) instead. Full documentation on Kermit is located under TP-ANL/MICRO/KERMIT.D. The Kermit PROTOCOL MANUAL is located under TP-ANL/MICRO/PROTO.D. Versions of Kermit are available for the IBM-PC and look-alikes, Honeywell L6/10 running MS-DOS, Heath/Zenith H/Z100, H/Z89, Superbrain, Osborn, Kaypro, TRS80 II running CPM, Apple ][ running CPM or DOS and almost any micro running CPM 2.2 or above. Kermit Copyright (C) 1981, 1982, 1983, 1984 Trustees of Columbia University in the City of New York Permission is granted to any individual or institution to copy or use this document and the programs described in it, except for explicitly commercial purposes.