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:
A>kermit
Kermit V1.20
1
! Run Kermit on the PC.
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
USER ID --
! Set your terminal type.
! 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
system
typeout or part of a command.
kermit s foo.ftn
^]c
!
!
!
!
[Back at PC.]
Kermit-86>receive
of
line
is
commentary,
not
Send my FORTRAN file.
Now return back to the PC by
typing the escape sequence, in this case
^]C (Control-] followed by "C")
! 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 arrive, 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
something like this:
IBM PC Kermit-86 V1.20
Number of Packets: 294
Number of Retries:
2
File Name:
FOO.FTN
Receiving...
The packet and retry counts are continuously updated, and the word in the
upper
right tells the status of the transfer -- receiving, sending, complete,
interrupted, 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
[Back at PC.]
Kermit-86>exit
! Now "escape" back to the PC,
! 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. KERMITGCOS
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
Kermit V1.20
! Run Kermit on the PC.
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
Kermit-Gcos V3.0
Server mode
^]c
!
!
!
!
!
!
start up kermit in server mode
start up message printed out
just to let you know
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.
backspace (Control-H) instead.
Use
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.