home *** CD-ROM | disk | FTP | other *** search
/ Columbia Kermit / kermit.zip / honeywellgcosc / hgkerdoc.txt < prev    next >
Text File  |  2020-01-01  |  9KB  |  237 lines
  1. KERMIT - Send or Receive files using the Kermit protocol.
  2.  
  3. Usage:     KERMIT s | r[t] | sv[t] [pathname.. [pathname] ]}
  4.  
  5.  Options:
  6.  
  7.         s pathname    Send file identified by pathnames
  8.  
  9.         r             Receive file from micro.  Pathname is
  10.                       not entered as the micro will send it.
  11.  
  12.         rt            Receive file from micro as above but
  13.                       create a temporary file as output.
  14.  
  15.         sv            Server mode
  16.  
  17.         svt           Server mode creating only temporary files
  18.  
  19.  
  20. Examples:
  21.  
  22.  
  23. In this example, the user is sitting at an IBM Personal Computer (PC), which is
  24. connected  through its serial port to a DPS8 host computer.  The IBM PC
  25. is local, the DPS8 is remote.  This example will also apply almost  literally
  26. to any other microcomputer implementation of Kermit.
  27.  
  28. You have started up your PC and have the Kermit program on your disk.  Begin by
  29. running Kermit on the PC.  Use Kermit's CONNECT command to become a terminal to
  30. the  DPS8.  The PC emulates the popular Heath-19 (or VT52) terminal.
  31. Login on the DPS8 and run Kermit there.  Here is an example of this procedure
  32. with commands you type in are lower case:
  33.  
  34.                                                   1
  35.   A>kermit                  ! Run Kermit on the PC. 
  36.   Kermit V1.20
  37.  
  38.   Kermit-86>                ! This is the Kermit prompt for the PC.
  39.   Kermit-86>set parity even ! Sets the parity to even
  40.   Kermit-86>set local on    ! Sets local echo on
  41.   Kermit-86>set baud 1200   ! Sets speed to 1200 baud
  42.   Kermit-86>set back back   ! Sets delete character to backspace
  43.   Kermit-86>connect         ! Connect to the DPS8.
  44.   [Connecting to host, type control-] to return to PC.
  45.   Baud rate is 1200, connecting over COM1.]
  46.                             ! Now dial number of the Datanet-8.
  47.   cr                        ! Hit return
  48.                             ! You are now connected to the DPS8.
  49.   $$ 50 DEVICE TYPE IDENTIFER:    ! The Datanet requesting terminal type.
  50.   pctran                          ! Set your terminal type.
  51.   USER ID --                      ! Login using normal login method.
  52.  
  53.   (At this point, the DPS8 prints various messages.)
  54.  
  55. You are now ready to transfer files between the two machines.
  56.  
  57. The  following example illustrates how to send files from the to the PC.
  58.  
  59. _______________
  60.  
  61.   1
  62.    Everthing from a "!" mark to the end  of  line  is  commentary,  not  system
  63. typeout or part of a command.
  64.  
  65.  
  66.  
  67.  
  68.   kermit s foo.ftn         ! Send  my FORTRAN file.
  69.   ^]c                      ! Now return back to the PC by
  70.                            ! typing the escape sequence, in this case
  71.                            ! ^]C (Control-] followed by "C")
  72.   [Back at PC.]
  73.   Kermit-86>receive        ! Tell the PC files are coming.
  74.  
  75. If  you  take  more than about 5 seconds to get back to Kermit-86 and issue the
  76. RECEIVE command, the first packets from Kermit-GCOS may arrive  prematurely and
  77. appear  on  your  screen,  but  no harm will be done, just press return on the
  78. PC and the packet will be retransmitted by the DPS8.
  79.  
  80. Once the connection is established, the PC will  show  you  what  is  happening
  81. --  it  first  clears the screen and waits for incoming packets; as packets ar-
  82. rive, the current file name and packet number will be continuously displayed on
  83. the screen.  When the PC's "Kermit-86>" prompt  returns  to  your  screen,  the
  84. transfer  is  done.  During file transfer, the microcomputer screen looks some-
  85. thing like this:
  86.  
  87.  
  88.  
  89.                   IBM PC Kermit-86 V1.20
  90.  
  91.   Number of Packets:  294                       Receiving...
  92.   Number of Retries:    2
  93.   File Name:   FOO.FTN
  94.  
  95.  
  96.  
  97. The packet and retry counts are continuously updated, and the word in the upper
  98. right tells the status of the transfer -- receiving, sending, complete,  inter-
  99. rupted, or failed.
  100.  
  101. When the transfer is complete (most versions of KERMIT sound a beep to wake you
  102. up),  you must CONNECT back to the DPS8 host, EXIT from Kermit there, logout,
  103. and "escape back" to the PC as you did previously.
  104.  
  105.   Kermit-86>connect        ! Get back to the DPS8.
  106.   [Connecting to host. Type CTRL-]C to return to PC.]
  107.   OK                       ! Kermit-GCOS reporting sucess.
  108.   *                        ! Here we are.
  109.   BYE                      ! Logout from the DPS8.
  110.  
  111.  **COST:  $  12.32 TO DATE:  $23718.21= 47%
  112.  **ON AT 13.175 - OFF AT 19.345 ON 02/01/84
  113.  $$ 02 YOU ARE DISCONNECTED - NORMAL TERMINATION
  114.  
  115.   ^]c                      ! Now "escape" back to the PC,
  116.   [Back at PC.]
  117.   Kermit-86>exit           ! and exit from the PC's Kermit.
  118.  
  119. The files you transferred should now be on your PC disk.
  120.  
  121. To send files from the PC to the DPS8, follow a  similar  procedure.    First
  122. follow the instructions in the previous section to log in to the DPS8 through
  123. the  PC.    Then  enter KERMIT R.
  124. Now escape back to the PC and use the SEND  command to  send  the local PC 
  125. files to DPS8 host. The PC will show you the progress of the transmission
  126. on its screen.
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135. The SERVER (SV) commands puts KERMIT-GCOS in "server mode" , so that it
  136. receives all further commands in packets from the local KERMIT.  KERMIT-GCOS
  137. is capable of executing the following commands from the local kermit:
  138.  
  139.      o  SEND filename - Sends filename to kermit
  140.      o  RECEIVE filename - Recieves filename from host using host pathname
  141.      o  FINISH  -  Terminates KERMIT-GCOS and makes TSS available
  142.      o  BYE     -  Terminates KERMIT-GCOS and logs off of TSS.
  143.  
  144.  Here is an example of this procedure with commands you type in are lower case:
  145.  
  146.   A>kermit                  ! Run Kermit on the PC. 
  147.   Kermit V1.20
  148.  
  149.   Kermit-86>                ! This is the Kermit prompt for the PC.
  150.   Kermit-86>set parity even ! Sets the parity to even
  151.   Kermit-86>set local on    ! Sets local echo on
  152.   Kermit-86>set baud 1200   ! Sets speed to 1200 baud
  153.   Kermit-86>set back back   ! Sets delete character to backspace
  154.   Kermit-86>connect         ! Connect to the DPS8.
  155.   [Connecting to host, type control-] to return to PC.
  156.   Baud rate is 1200, connecting over COM1.]
  157.                             ! Now dial number of the Datanet-8.
  158.   cr                        ! Hit return
  159.                             ! You are now connected to the DPS8.
  160.   $$ 50 DEVICE TYPE IDENTIFER:    ! The Datanet requesting terminal type.
  161.   pctran                          ! Set your terminal type.
  162.   USER ID --                      ! Login using normal login method.
  163.  
  164.   (At this point, the DPS8 prints various messages.)
  165.  
  166. You are now ready to transfer files between the two machines.
  167.  
  168. The  following example illustrates how to send files from the to the PC
  169. using KERMIT-GCOS server mode.
  170.  
  171.   kermit sv                ! start up kermit in server mode
  172.   Kermit-Gcos V3.0         ! start up message printed out
  173.   Server mode              ! just to let you know
  174.   ^]c                      ! Now return back to the PC by
  175.                            ! typing the escape sequence, in this case
  176.                            ! ^]C (Control-] followed by "C")
  177.   [Back at PC.]
  178.   Kermit-86>receive mycatalog/mysubcat/myfile
  179.                            ! have KERMIT-GCOS send my file over
  180. (when file transfer is completed)
  181.    Kermit-86>exit          ! exit out of local kermit
  182. (now you can do some work on the micro, edit files, whatever)
  183.   A>kermit                 !start up local kermit again and set
  184.                            !up your options, parity etc.
  185.   Kermit-86>send myfile    !send it back to the host
  186. (when file transfer completes )
  187.   Kermit-86>bye            ! Shut dowm kermit server
  188.   A>                       ! Back to MSDOS automatically
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199. Kermit-GCOS will create quick access files using the first 8 characters of
  200. the PC filename.  If a temporary file is desired use the 'rt' command and
  201. Kermit will create a temporary file in your aft.
  202.  
  203. When the "Kermit-86>" prompt indicates that the transmission  is  complete  you
  204. should  follow the procedure shown above to logout from the DPS8 host, except
  205. that you may first wish to confirm that the files have been stored correctly in
  206. your catalog on the DPS8.
  207.  
  208. If the transmissions appears to be stuck, press return to wake the 
  209. PC up.  This should clear up any protocol deadlock.  Several returns
  210. may be necessary
  211.  
  212. When using the special terminal identifer PCTRAN some basic terminal 
  213. functions are changed:
  214.  
  215.           o  The break key on the terminal is disabled.  Use Control-Y
  216.              instead.  This may take a few seconds to take effect.
  217.  
  218.           o  The @ sign will no longer be the character delete.  Use
  219.              backspace (Control-H) instead.
  220.  
  221. Full documentation on Kermit is located under TP-ANL/MICRO/KERMIT.D.
  222. The Kermit PROTOCOL MANUAL is located under TP-ANL/MICRO/PROTO.D.
  223.  
  224. Versions of Kermit are available for the IBM-PC and look-alikes,
  225. Honeywell L6/10 running MS-DOS, Heath/Zenith H/Z100, H/Z89, Superbrain,
  226. Osborn, Kaypro, TRS80 II running CPM, Apple ][ running CPM or DOS
  227. and almost any micro running CPM 2.2 or above.
  228.  
  229.  
  230.  
  231.           Kermit Copyright (C) 1981, 1982, 1983, 1984
  232.    Trustees of Columbia University in the City of New York
  233.  
  234.  Permission is granted to any individual or institution to copy or
  235.   use this document and the programs described in it, except for
  236.               explicitly commercial purposes.
  237.