home *** CD-ROM | disk | FTP | other *** search
/ Columbia Kermit / kermit.zip / computervision / cvkerhlp.txt < prev    next >
Text File  |  2020-01-01  |  10KB  |  224 lines
  1. <<< KERMIT.SYSNEWS.KERMIT >>>
  2. * 18 aug 85 esj removed get/bye from alais list.  they are server commmands
  3. * 13 aug 85 esj added aliases
  4. * 12 aug 85 esj copied from hp1000 kermit and added cv specific info.
  5. *---------------------------------------------------------------------
  6.                        THE KERMIT FILE TRANSFER PROTOCOL
  7.  
  8. KERMIT is a protocol for transferring sequential files between computers of all
  9. sizes over ordinary asynchronous telecommunication lines using packets,  check-
  10. sums, and retransmission to promote data integrity.  KERMIT is non-proprietary,
  11. thoroughly documented, and in wide use.  The  protocol  and  the  original  im-
  12. plementations  were  developed at Columbia University and have been shared with
  13. many other institutions, some of which have made significant  contributions  of
  14. their  own.  For more information contact:
  15.  
  16.   KERMIT Distribution
  17.   Columbia University Center for Computing Activities
  18.   7th Floor, Watson Laboratory
  19.   612 West 115th Street
  20.   New York, N.Y.  10025
  21.  
  22. This help file contains a brief description of commands available, hardwire
  23. interconnection and connection by a data switch.  To use kermit, look in the
  24. manual located in user-doc.  The manual is the document provided by Columbia
  25. for all kermit sites.
  26.  
  27. Commands available in KERMIT-CV are:
  28.  
  29.  EXIT          - Terminates this KERMIT CV program.
  30.                - alias  e,quit,q
  31.  
  32.  HELP          - Types out the content of this HELP file.
  33.  
  34.  RECEIVE       - Places this KERMIT CV program into a
  35.                - state ready for receiving one or more file(s).
  36.                - If a received file already exists, it will be overwritten.
  37.                - alias  rec,r
  38.  
  39.  SEND FILENAME - Sends the content of the file specified in
  40.                - filename. While the file is being transfered, a dot will
  41.                - appear for every packet sent.
  42.  
  43.  SEND @FILENAME- Send the content of all the files specified
  44.                - in filename.  The content of filename is treated as a
  45.                - list of files to be sent to the other kermit.
  46.  
  47.  SET DELAY N   - Where N is a decimal integer ranging from 0 to 30.
  48.                - Instructs this KERMIT CV program how many
  49.                - seconds to wait before sending out the first
  50.                - packet.  These time delays allows the user time
  51.                - to get back to his/her LOCAL KERMIT program and
  52.                - initiate the RECEIVE command.  Defaulted time
  53.                - delay is 15 seconds.
  54.  
  55.  SET QUOTE N   - Where N is a decimal integer ranging from 33 to 126.
  56.                - Instructs THIS KERMIT program character to be
  57.                - used in QUOTING control characters.  The default
  58.                - QUOTE character is '#' or 35.
  59.  
  60.  SET PACKET N  - Where N is a decimal integer ranging from 31 to 94.
  61.                - It specifies the maximum packet size used
  62.                - for file transfer.  Defaulted packet size is 80.
  63.  
  64.  SET SOH N     - Where N is a decimal integer ranging from 1 to 31.  This
  65.                - is the START OF HEADING found in every KERMIT
  66.                - packet.  Both KERMIT must agree to this value.
  67.                - It need not be change for most types of file
  68.                - transfer.  Defaulted SOH used is CNTR-A (1).
  69.  
  70.  SET LINE <port> Attaches infoton device <port> to the task running
  71.                - KERMIT.  If the port can not be attached, Kermit will
  72.                - print an error message telling why the attach failed.
  73.                - The KERMIT prompt will change to a lower case prompt
  74.                - after a successful attach.  Kermit will disconnect from
  75.                - the infoton device when a normal exit is performed.
  76.  
  77.  STATUS        - Displays the status of user selectable parameters.
  78.  
  79.  CONNECT       - Start up the connect mode of KERMIT.  This mode will let
  80.                - the user connect to the device attached to by the "SET LINE"
  81.                - command.  The current version of KERMIT will have trouble
  82.                - keeping up with the input from the connect device and will
  83.                - drop characters.  This reason for dropping characters will
  84.                - not occur in file transfer.
  85.                - alias  con,c
  86.  
  87. Hung line recovery: If kermit appears to be lost and the other side does not
  88. support timeouts, typing any character on the keyboard of your local
  89. kermit will force a retransmission of your last packet.
  90.  
  91. KERMIT-CV will only transfer text files.
  92.  
  93. Parity is currently ignored when receiving data.  Parity is set to space when
  94. sending data.  The parity settings needed for KERMIT-CV and other
  95. implementations of kermit are tabulated below.
  96.  
  97.          P A R I T Y  S E T T I N G S  F O R  K E R M I T
  98.          ------------------------------------------------
  99.  
  100.          KERMIT-CV      TO       KERMIT-CV      NEEDS DEFAULT PARITY
  101.          KERMIT-CV      TO       VMS KERMIT     NEEDS DEFAULT PARITY
  102.          KERMIT-CV      TO       ULTRIX KERMIT  NEEDS DEFAULT PARITY
  103.          KERMIT-CV      TO       CV3000 KERMIT  NEEDS SPACE   PARITY
  104.  
  105.  
  106.  
  107.                KERMIT and CGOS directories
  108.                ---------------------------
  109.  
  110.    Creative use of directories can be a pleasure and a pain in CGOS.  When used
  111. with kermit, directories are often the only way to make filenames appear in
  112. legal form when sending files to non-CV systems.  Kermit assumes that ALL
  113. systems can accept files in the form of an 8 character name and a 3 character
  114. extention ( <fullname>.<ext> ).  When sending files between systems of the
  115. same type, for example CV to CV, Kermit permits the transfer of native file
  116. names.  With CV kermit the full 80 character file name can be sent when the
  117. kermit packet length is 85 or greater.
  118.    Directories can be used to present a shorter file name to the "other"
  119. kermit or can be used to make the file name received a unique name and keep
  120. other files with the same name intact.
  121.  
  122. Making a file name shorter:
  123. You want to send my.file.long.nam to a CP/M system.  Directories are enabled
  124. as follows:
  125.  
  126. 1>enabdir my.file
  127.  
  128.    When in kermit and ready to send the file, the file is sent by:
  129.  
  130. kermit-cv> send long.nam
  131.  
  132.    kermit will send the file as "long.nam" and it will be created under that
  133.    name on the CP/M system.
  134.  
  135.    Other directories can be included in the enabdir command if you are sending
  136.    files from multiple directories.
  137.  
  138. Making a file name unique:
  139. If you want to receive a file or group of files and want to insure that you
  140. don't overwrite any files that may have the same name, enable directories as
  141. follows before entering KERMIT and receiving any files:
  142.  
  143. 1>enabdir unique.catalog
  144.  
  145. Enabling only one directory will insure that files will go into that
  146. directory. For example when you receive a file named "duplicat.nam", it will
  147. be created in unique.catalog.duplicate.nam .
  148.  
  149.  
  150.                KERMIT and the other system
  151.                ---------------------------
  152.  
  153. The following picture describes the connections between kermit,systems, and
  154. you.  To connect two systems together by their terminal cables, an
  155. interconnect cable needs to be constructed.  The interconnect cable consists
  156. of two DB-25 connectors and 4 wires. The figure below describes the
  157. connections.
  158.  
  159.  
  160.    -----------    ----------            ----------
  161.    |your     |    | system |    +-+     | system |
  162.    |terminal.|----|   A    |----|x|-----|   B    |
  163.    -----------    ----------    +-+     ----------
  164.                                /   \
  165.                               /     \
  166.                              /       \
  167.                             /         \
  168.                            +-----------+
  169.          DB-25 connector   |           |  DB-25 connector
  170.            from system A   |           |  from system B
  171.                     pin 1  |-----------|  pin 1
  172.                     pin 2  |---+   +---|  pin 2
  173.                            |   +---|---|  pin 3
  174.                     pin 3  |-------+   |
  175.                            +-----------+
  176.  
  177.  
  178.                KERMIT and the equinox data switch.
  179.                -----------------------------------
  180.  
  181. The following picture describes the connections between kermit,systems, the
  182. data switch and you.  This description assumes that you know how to use the
  183. equinox data switch.
  184.  
  185. When you first hook up to the data switch, there exists a connection logically
  186. equal to the one pictured below.
  187.             -----------    ---------
  188.             |your     |    | data  |
  189.             |terminal.|----| switch|
  190.             |         |    |   1   |
  191.             -----------    ---------
  192.  
  193. When you command the data switch to connect you to system A, the data switch
  194. creates a connection to a line on system A.
  195.    -----------    ---------   ----------
  196.    |your     |    | data  |   | system |
  197.    |terminal.|----| switch|---|   A    |
  198.    |         |    |   1   |   ----------
  199.    -----------    ---------
  200.  
  201. On system A you invoke the "KERMIT" command and tell KERMIT to select a line
  202. for communication to a second kermit by the "SET LINE" command.  Connect
  203. mode is entered by the "CONNECT" command and the data switch is awakened by
  204. a couple of return characters.  The connections are now as pictured below.
  205.  
  206.    -----------    ---------   ----------   ---------
  207.    |your     |    | data  |   | system |   | data  |
  208.    |terminal.|----| switch|---|   A    |---| switch|
  209.    |         |    |   1   |   ----------   |   2   |
  210.    -----------    ---------                ---------
  211.  
  212. The last connection needed is to system B and it is selected when you are
  213. talking to data switch 2 through KERMIT on system A.  The selection of
  214. system B setup the connections as pictured below.
  215.  
  216.    -----------    ---------   ----------   ---------   ----------
  217.    |your     |    | data  |   | system |   | data  |   | system |
  218.    |terminal.|----| switch|---|   A    |---| switch|---|   B    |
  219.    |         |    |   1   |   ----------   |   2   |   ----------
  220.    -----------    ---------     local      ---------     remote
  221.                                 kermit                   kermit
  222.  
  223.  
  224.