home *** CD-ROM | disk | FTP | other *** search
/ kermit.columbia.edu / kermit.columbia.edu.tar / kermit.columbia.edu / vmspascal / vxread.me < prev    next >
Text File  |  1988-08-15  |  7KB  |  209 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.                    VMS Kermit Distribution Document
  7.  
  8. Introduction :
  9.  
  10.      This directory contains a VMS version of the Kermit protocol.  Kermit,
  11. "KL-10 Error-free Reciprocal Microcomputer InterChange over TTY-Lines", as 
  12. the acronym implies, is a means for allowing errorfree transfer of files 
  13. between computers over normal terminal communication lines.  The protocol
  14. was originally designed for Digital Equipment's DECSYSTEM-20 KL 10 machines,
  15. but within recent years has been extended to work on a variety of other
  16. processors;  both mainframes (Vax, IBM/VM, etc.), and micros (CP/M systems,
  17. Apples, ...).  The Kermit distribution is currently maintained by Columbia
  18. University, the original implementors of the TOPS-20 Kermit.
  19.  
  20.  
  21. Implementation Differences (VMS Kermit .vs. TOPS-10):
  22.  
  23.      The Vax/VMS Kermit with a few minor exceptions is a full working Kermit.
  24. It has been tested against the TOPS-10/TOPS-20 implementations with complete
  25. success.  VMS kermit was implemented in two languages;  pascal, and fortran.
  26.  
  27.  
  28.  
  29. ***************************************************************************
  30.  
  31. Use @VXREN to rename files 
  32.  
  33. ***************************************************************************
  34.  
  35. The pascal code implemented
  36.     i) the Kermit protocol            (file(s) KERMIT.PAS,
  37.                              VERSION.PAS)
  38.        ii) the Kermit command parser        (file(s) PARSER.PAS,
  39.                              PGLOBAL.PAS)
  40.  
  41. The fortran code implemented
  42.     i) VMS virtual terminal support        (file(s) VTERM.FOR,
  43.                              VTGLOBAL.FOR, 
  44.                              BOOLEANS.FOR,
  45.                               SSDEF.FOR, 
  46.                              TTDEF.FOR,
  47.                               IODEF.FOR)
  48.  
  49.      As mentioned earlier, there are a few minor differences between the
  50. VMS Kermit, and the standard TOPS-20 Kermit.
  51.  
  52.     1.  VMS Kermit does not allow the user to specify the virtual
  53.         terminal escape character sequence.  VMS Kermit uses cntrl-P
  54.         as its escape character.
  55.     2.  VMS Kermit does not allow the user to specify the out-going
  56.         vterm line from within the command parser.
  57.     3.  VMS Kermit does not allow the user to specify a new file name
  58.         when a file name collision occurs (simply generates new name).
  59.     4.  VMS Kermit handles a variety of different input/output file
  60.         types.
  61.     5.  VMS Kermit handles VMS wildcard names (ie. *.for for all
  62.         fortran files in a directory).
  63.     6.  VMS Kermit gives better file transfer statistics.
  64.     7.  VMS Kermit allows the user to specify vterm line parity, and
  65.         line speed (300, 600, 1200, 2400, 4800, 9600).
  66.  
  67. Building VMS Kermit :
  68.  
  69.     (NOTE: you no longer need PASCAL to use this version of KERMIT - 
  70. just FORTRAN is needed to convert from a "HEX" file)  
  71. In order to build the VMS Kermit you must perform the following steps :
  72.  
  73.  
  74.  
  75.  
  76.  
  77.                         - 2 -
  78.  
  79.  
  80.     a)  place the Kermit distribution in a secure directory with the
  81.         following protection on all files
  82.         /owner=[1,4]/prot=(s:rwe,o:rwed,g:re,w:re)
  83.     b)  log on to a priviledged account (ie. SYSTEM)
  84.     c)  set default to Kermit directory.
  85.     d)  Read INSTALL.COM, and make appropriate changes to it.
  86.     e)  run the command file (ie. @INSTALL.COM)
  87.     f)  hopefully there should be no errors.  If there are then
  88.         attempt to resolve them.  Re-do step e).
  89.     g)  place the following lines in your system startup file 
  90.         (ie. SYSTARTUP.COM)
  91.         $  assign/system  "{terminal list}" kermit$rem0
  92.         $  assign/system  {kermit directory} kermdir:
  93.             where {kermit directory} is the directory that the
  94.                           kermit source is stored in.
  95.         $  assign/system  kermdir:kermit.hlp kermithlp:
  96.             where {terminal list} is a list of out going vterm
  97.                           ports separated by spaces.
  98.                           There must be a least one port.
  99.         (ie. assign/system "_TTA0: _TTA1:" kermit$rem0: )
  100.     h)  place the following lines in your system login file
  101.         (ie. SYLOGIN.COM)
  102.         $  assign 'f$logical("SYS$OUTPUT")' kermit$local
  103.         $  kermit := @kermdir:kermit.com
  104.  
  105. Running Kermit :
  106.  
  107.      An example run of VMS kermit would be as follows (assuming we are
  108. establishing a VMS to DEC-10 Kermit through a Gandalf PACX front end
  109. switching unit) :
  110.  
  111. Note :    1.  the responses generated by the system are in braces.
  112.     2.  many kermit commands allow for abbreviations.
  113.     3.  assumes your in a directory with files ending in .FOR .
  114.  
  115.      Sending a File(s) to DEC-10 :
  116.     $ kermit <return>
  117.     {Kermit-VMS> } set parity none <return>
  118.     {Kermit-VMS> } set send packet 60 <return>
  119.     {Kermit-VMS> } set receive packet 60 <return>
  120.     {Kermit-VMS> } connect <return>
  121.     {Proceed... }
  122.     <return>
  123.     <return>
  124.     {Enter Class } 10 <return>
  125.     <return>
  126.     {Dec 10 login information } login 356,13536,abcde <return>
  127.     {More Dec-10 login information }
  128.     r kermit <return>
  129.     {Kermit-10> } receive <return>
  130.     cntl-P {Kermit-VMS> } <return>
  131.  
  132.  
  133.  
  134.  
  135.  
  136.                         - 3 -
  137.  
  138.  
  139.     {Kermit-VMS> } send*.for <return>
  140.     {Sending File... {a}.FOR}
  141.     {etc... one line for each .FOR file sent }
  142.     {Kermit-VMS> } status <return>
  143.     {status of send ... }
  144.     {Kermit-VMS> } connect <return>
  145.     <return>
  146.     {Kermit-10> } exit <return>
  147.     {examine the transferred files and then ... }
  148.     cntl-P {Kermit-VMS> } exit <return>
  149.  
  150.  
  151.      Receiving a File(s) from DEC-10 :
  152.     { in receiving a file simply get on to the DEC-10 in same manner
  153.       as before, and replace the DEC-10 receive, with a send <filename>.
  154.       Return to Vax and type receive.  The following message
  155.         Receiving File... {filename} will appear for each file
  156.       received. }
  157.  
  158.  
  159.      For more details regarding the function of all the Kermit commands
  160. examine the document KERMIT.DOC provided with the distribution.
  161.  
  162. Bugs or, "If I only had more time":
  163.  
  164.      1.  A friend of mine informed me that he does not appreciate my
  165.      virtual terminal program (ie. lumpy response at low baud rates).
  166.      I make no apologies; the program is tuned for 4800 baud, something
  167.      which most virtual terminal programs will not allow.  If you desire
  168.      to use it `constantly' at a slower speed, remove the buffering code
  169.      from the program.
  170.  
  171.      2.  Obviously (unfortunately), there are bugs lurking in the uncharted
  172.      corners of this code.  Please drop me a line if you find it (them).
  173.  
  174. Recent changes and/or Bug fixes:
  175.         
  176. (The one for version 1.1D is important -- the rest are less important)
  177.  
  178.     22-MAY-84      Add error messages for file opens and add
  179.             flush of TypeAhead in SendInit.
  180.             Add message for non-ascii send in Text file.
  181.             (Version 1.1A)
  182.  
  183.     23-JUL-84      On unsucessful receive delete file.
  184.             Modify ErrorPack 
  185.             (Version 1.1B)                  
  186.  
  187.     26-JUL-84      Increase line length for Text file to 255
  188.             on write.
  189.             Fix DataToFile for <CR><CR><LF> sequence.
  190.             (Version 1.1C)                  
  191.  
  192. !!    10-AUG-84      GetData does not quote properly !!
  193.             (Version 1.1D)                  
  194.  
  195.     22-AUG-84      Fix GetData for DEL.
  196.             Modify ErrorPack.
  197.             (Version 1.1E)                  
  198.  
  199.  
  200.     Address:    University of Toronto
  201.                 Computing Services
  202.             Attention:  Bruce W. Pinn
  203.             255 Huron Street
  204.             TORONTO, Ontario
  205.             Canada
  206.             M5S 1A1
  207.  
  208.     Telephone:  (416) 978-7063
  209.