home *** CD-ROM | disk | FTP | other *** search
/ Columbia Kermit / kermit.zip / b / vmsaaa.hlp < prev    next >
Text File  |  2020-01-01  |  6KB  |  162 lines
  1. HOW TO INSTALL VMS KERMIT-32
  2.  
  3. VAX/VMS Kermit-32 was written by Nick Bush and Bob McQueen of Stevens
  4. Institute of Technology in Hoboken, NJ.  As of April 1987, development of the
  5. program is more or less frozen since Nick and Bob have both changed jobs, but
  6. there have been a couple updates since then from Jonathan Welch at the U of
  7. Massachusetts, and Burt Johnson of Diversified Computer Systems Inc.
  8.  
  9. Bug reports will be accepted with no guarantee that they will be acted upon.
  10. See the file VMSMIT.BWR for a list of known bugs, limitations, or for bug
  11. reports that have not been responded to.  Meanwhile, the C version of Kermit
  12. (C-Kermit) will probably evolve to become the preferred version of Kermit for
  13. VMS.
  14.  
  15. VMS Kermit-32 comes in 3 forms: hex, Macro source, and Bliss source.  Each can
  16. be used as the basis for installation.
  17.  
  18. MAGNETIC TAPE DISTRIBUTION
  19.  
  20. VMS Kermit comes on Columbia University's Kermit Tape B, which you should
  21. normally order in ANSI format for reading on VMS 9-track tape drives.  
  22.  
  23. Before beginning, make a special directory for VMS Kermit and read the files
  24. VMS*.* from the Kermit distribution tape into this directory.  Columbia's
  25. Kermit tapes are written with blocksize 8192, which is 4 times larger than the
  26. default tape blocksize for VMS.  You should mount these tapes on the VMS system
  27. with the following command:
  28.  
  29.   MOUNT/BLOCK=8192/DENSITY=1600 MTA0: KERMIT
  30.  
  31. (or substitute some other tape drive name for MTA0:)  Do NOT use the /FOREIGN
  32. switch.  Once the tape is mounted, you can use normal VMS COPY commands to
  33. copy the files from the tape.  For instance, if you have defined your Kermit
  34. directory to have logical name KER:, you can use the following command to
  35. copy the VMS Kermit files into this directory:
  36.  
  37. $ copy mta0:vms*.* ker:
  38.  
  39. You can also get Kermit on TK50 cartridges.  These are written in VMS BACKUP
  40. format.
  41.  
  42. FILES
  43.  
  44. The VMS Kermit files are the ones whose names start with "VMS".  Most sites
  45. will not want to bother with the source code, and simply want the executable
  46. program, the help files, and the documentation (see METHOD 1 below).  The
  47. minimum collection of files is:
  48.  
  49.   VMSMIT.HEX - The hexadecimal encoding of KERMIT.EXE
  50.   VMSDEH.MAR - A macro program to convert the VMSMIT.HEX file into KERMIT.EXE
  51.   VMSMIT.DOC - The VMS Kermit user manual
  52.   VMSMIT.PS  - A version of the user manual for printing on Postscript printers
  53.   VMSMIT.HLP -
  54.   VMSSYS.HLP - 
  55.   VMSUSR.HLP -
  56.   VMSMIT.BWR - "Beware File" listing known or suspected bugs & limitations.
  57.  
  58.  
  59. METHOD 1: DECODE THE HEX FILE
  60.  
  61. WARNING -- If you are running a pre-4.0 release of VMS, see Method 1.5 below!
  62.  
  63. The easiest way to install VMS Kermit is to "dehexify" the hexadecimal
  64. encoded task image.  Follow these steps:
  65.  
  66. 1. There should be a file VMSDEH.MAR on your disk.  This is a Macro-32 program
  67.    that decodes the hex file of the VMS Kermit task image.  Compile and load
  68.    this program:
  69.  
  70.    $ macro vmsdeh
  71.    $ link vmsdeh
  72.  
  73. 2. Run the VMSDEH program:
  74.  
  75.    $ run vmsdeh
  76.    Please type the file name: vmsmit.hex
  77.  
  78.    The VMSDEH program automatically creates KERMIT.EXE.  Or it might create
  79.    VMSMIT.EXE, which you can rename to KERMIT.EXE.
  80.  
  81. 3. Now you can type "run kermit".  Make sure it works.  If not, try method 2.
  82.  
  83. NOTE: There are some new files available (as of version 3.3.122) to help with
  84. the installation: VMSINS.KIT, VMSMKH.COM, and VMSMKI.COM.  If you can use
  85. these files (DCL procedures) to install Kermit-32 on your system, then you can
  86. skip steps 4 and 5.
  87.  
  88. 4. Install KERMIT.EXE in the appropriate system area.
  89.  
  90. 5. Install the help files, for instance:
  91.  
  92.    $ LIBRARY/HELP/DELETE=KERMIT SYS$HELP:HELPLIB.HLB
  93.    $ LIBRARY/INSERT/HELP SYS$HELP:HELPLIB.HLB VMSSYS.HLP
  94.    $ LIBRARY/CREATE/HELP SYS$HELP:KERMIT.HLB VMSUSR.HLP
  95.  
  96.    See the file VMSINS.HLP for further hints about the help files.
  97.  
  98. Note, the companion program to VMSDEH.MAR is VMSHEX.MAR.  It creates hex
  99. files from binary files.  You can use this program to encode any VMS binary
  100. file into printable form, and VMSDEH to decode it back into its original
  101. form, with all of its directory information intact.
  102.  
  103.  
  104. METHOD 1.5: DEHEXIFY THE OLD KERMIT-32 HEX FILE
  105.  
  106. If you are running a version of VMS before 4.0, then the current release of
  107. Kermit-32 will not work on your system.  If you tried Method 1, and the
  108. resulting Kermit program gave an error message like "invalid image header" when
  109. you tried to run it, this is probably the cause.  In that case, you must use
  110. version 3.1 of VMS Kermit until you upgrade your VMS version.  To use version
  111. 3.1 of VMS Kermit, follow the directions for Method 1, but use VMSDEH to
  112. dehexify the file VMSV31.HEX rather than VMSMIT.HEX.  The result will be called
  113. VMSMIT.EXE rather than KERMIT.EXE.  You can rename this file to KERMIT.EXE and
  114. install it and the help files normally, but note that the help files apply to
  115. the newer releases.
  116.  
  117.  
  118. METHOD 2: ASSEMBLE THE MACRO FILES
  119.  
  120. Only use this method if method 1 fails for some reason.  This method assembles
  121. all the Macro-32 source programs into object files, and then links them
  122. together into KERMIT.EXE, and then installs KERMIT.EXE and the help files in
  123. the system.  NOTE: Kermit-32 is NOT written in Macro-32; it is written in
  124. Bliss-32, and these Macro files are output by the Bliss compiler.  It is not
  125. recommended that changes be made to the Macro source.  To build from the Macro
  126. code, follow these steps:
  127.  
  128. 1. Make sure you have all the VMS*.MAR files on your current disk.
  129.  
  130. 2. There is a DCL procedure to assemble and link all of these files,
  131.    but unfortunately it assumes the files are called KER*.* instead of
  132.    VMS*.*.  There is another DCL procedure, VMSREN.COM, to rename them:
  133.  
  134.    $ @vmsren
  135.  
  136. 3. Now that the files are renamed to KER*.*, you can run the DCL procedure
  137.    VMSINS.COM to assemble and link them into KERMIT.EXE.
  138.  
  139.    $ @vmsins
  140.  
  141.    Kermit-32 Installation Procedure
  142.  
  143.    Rebuild from sources? (YES or NO) yes
  144.  
  145.    Which version? (BLISS or MACRO) macro
  146.  
  147.    Install Kermit-32 on the system? yes
  148.    (note, you have to have write access to the system directories to do this)
  149.  
  150.    This may take some time
  151.    (time passes)
  152.  
  153.    Kermit-32 installation is complete.
  154.  
  155.  
  156. METHOD 3: COMPILE THE BLISS SOURCES
  157.  
  158. You can use this method only if you have a Bliss-32 compiler.  Even then,
  159. there's no reason to do this unless you want to change the sources in some
  160. way.  Follow the steps in Method 2, except reply "bliss" instead of "macro"
  161. to the "Which version?" question.
  162.