home *** CD-ROM | disk | FTP | other *** search
/ Columbia Kermit / kermit.zip / b / vmsins.hlp < prev    next >
Text File  |  2020-01-01  |  7KB  |  215 lines
  1. Before reading this file, which is just a collection of random notes, read the
  2. file VMSAAA.HLP, which tries to give a systematic overview of how to install
  3. VMS Kermit.
  4.  
  5. ------------------  VMSINS.HLP ---------------------------------
  6.  
  7. MOUNT tape specifying the blocksize:
  8.  
  9.     MOUNT dev:/BLOCKSIZE=8192
  10.  
  11.  
  12. ------------------------------
  13.  
  14. Date:               29-AUG-1986 16:58:53
  15. From:               SYSTEM@UK.AC.CRC
  16. Subject:  Help needed on VMS Kermit help files
  17.  
  18.           I have copied over Kermit for the Vax/VMS onto our microVax. It
  19. appears to run, but HELP does not work, it says cannot open !AS as input.
  20. I have copied vmsusr.hlp and vmssys.hlp into the help directory, do you
  21. know what I am doing wrong?
  22.  
  23.           We have only recently got the uVax, and I am not very well up on it,
  24. but we have the coloured books up and running, although we have not yet got
  25. ourselves into the name registration scheme. We are UK.AC.CRC (the Clinical
  26. Research Centre, part of the Medical Research Council) and are on
  27. 000044801000.ftp.mail. I am Eeoff Gibbs, although I am usually logged in as
  28. SYSTEM.
  29.  
  30.           Geoff Gibbs
  31.  
  32.  
  33. ---------------------------------------
  34.  
  35.  
  36. Date:          Sat, 6 Sep 86 02:31 AST
  37. From:          IUS%DACTH51@UK.AC.RL.EARN (Eberhard W. Lisse)
  38. Subject:       Installing VMS Kermit help file
  39.  
  40.  
  41. VMS needs the ASCII files produced by RUNOFF to be installed into special HELP
  42. libraries with the LIBRARIAN utility so the HELP facility
  43. (SYS$SYSTEM:VMSHELP.EXE) can work on them.
  44.  
  45. I have looked up the installation procedure and made up a file to do it for
  46. you.
  47.  
  48. If you have only VMSYS.HLP and VMSUSR.HLP cut the second part, save it to
  49. INS.COM and run it.
  50.  
  51. If you have KERMIT.RNH cut all of it and run it (the second part will not
  52. be executed)
  53.  
  54.  
  55. el
  56.  
  57. (Eberhard W. Lisse)
  58. Technical University Aachen Medical School
  59.  
  60.  
  61.  
  62. $! --------------cut here and save to INS.COM ------------
  63. $!
  64. $! this one calls up from the VMS level
  65. $!
  66. $!        $ @INS
  67. $!
  68. $!
  69. $!
  70. $! you are logged in under SYSTEM anyway, right ?
  71. $!
  72. $ ON ERROR THEN CONTINUE
  73. $! so the next instruction doesn't bomb
  74. $!
  75. $ LIBRARY/HELP/DELETE=KERMIT SYS$HELP:HELPLIB.HLB
  76. $! If there is an error, ignore it.
  77. $! As it is a first time installation there is no Kermit entry
  78. $! in the Help library.
  79. $! This is hust for completeness as one needs to do it like this
  80. $! when installing an upgrade.
  81. $!
  82. $!
  83. $ RUNOFF KERMIT.RNH/VAR=SYSTEM
  84. $! this produces KERMIT.HLP with the SYSTEM option which should
  85. $! be the same as your VMSSYS.HLP
  86. $!
  87. $ LIBRARY/INSERT/HELP SYS$HELP:HELPLIB.HLB KERMIT.HLP
  88. $! this installs it in the system HELP library where one can
  89. $! access it from VMS level
  90. $!
  91. $!       $ HELP KERMIT
  92. $!
  93. $ RUNOFF KERMIT.RNH
  94. $! this produces KERMIT.HLP withOUT the SYSTEM option which
  95. $! should be the same as your VMSUSR.HLP
  96. $!
  97. $ LIBRARY/CREATE/HELP SYS$HELP:KERMIT.HLB KERMIT.HLP
  98. $! this is the HELP file Kermit is looking for (!AS not found ...)
  99. $! One might want to PURGE KERMIT.HLB when installing an upgrade
  100. $!
  101. $!
  102. $ EXIT
  103. $!
  104. $!
  105. $!
  106. $! if you don't have the KERMIT.RNH you do it like this:
  107. $!
  108. $! ------------cut here and save to file INS.COM ------------
  109. $!
  110. $ ON ERROR THEN CONTINUE
  111. $ LIBRARY/HELP/DELETE=KERMIT SYS$HELP:HELPLIB.HLB
  112. $ LIBRARY/INSERT/HELP SYS$HELP:HELPLIB.HLB VMSSYS.HLP
  113. $ LIBRARY/CREATE/HELP SYS$HELP:KERMIT.HLB VMSUSR.HLP
  114. $ EXIT
  115. $!
  116. $!
  117. $! ---------end of INS.COM ------------
  118.  
  119. ----------------------------------------------------------------------------
  120.  
  121. Date:     Mon, 08 Sep 86 14:29:54 BST
  122. From:     Mike_Brudenell  <CLE8 @ UK.AC.NEWCASTLE.MTS>
  123. To:       syskermit @ UK.AC.LANCS.VAX1
  124. Subject:  Installing VAX/VMS Kermit made simple (?)
  125.  
  126.  Installing VMS Kermit (mainly concerned with its Help system)
  127.  ===================== ---------------------------------------
  128.  
  129.  The following gives one possible method of installing VAX/VMS Kermit
  130.  on a system without using System Manager priveliges (spelling?).  As
  131.  such it should be useable by all users.
  132.  
  133.  Unless a clever bit of jiggery pokery is done when calling VAX/VMS
  134.  Kermit, attempting to use HELP *does* resort in the "cannot open !AS
  135.  as input" message.  I enclose some (hopefully reasonably clear, at
  136.  least to VMS people) instructions on how I successfully got Kermit and
  137.  its Help system up and running on our machine.
  138.  
  139.  Firstly, ensure you have the VMSUSR.HLP and VMSSYS.HLP files copied to
  140.  your Kermit directory.  These ".HLP" files are "source text" that must
  141.  be "compiled" into a Help Library file with type ".HLB" using the
  142.  Librarian facility.  This is done as follows:
  143.  
  144.  VMSSYS.HLP
  145.       This file is designed to be included in the system's main Help
  146.       database.  You will need access to this if you wish to insert it
  147.       (eg.  be the SYSTEM manager ...  it is not essential to include
  148.       this Help facility).  Assuming you are on as SYSTEM in the Kermit
  149.       directory, the command you need is along the lines of:
  150.            LIBRARY/HELP SYS$HELP:HELPLIB VMSSYS.HLP
  151.  
  152.  VMSUSR.HLP
  153.       This file is accessed from within Kermit.  The name of the ".HLB"
  154.       file should be the same as that of the Kermit ".EXE" file (eg.
  155.       KERMIT.EXE and KERMIT.HLB).  The ".HLB" file should be placed in
  156.       the same directory as the rest of the Kermit files.  It should be
  157.       "compiled" as follows:
  158.            LIBRARY/HELP/CREATE KERMIT VMSUSR.HLP
  159.  
  160.       Ensure that the resulting ".HLB" file is appropriately permitted
  161.       (eg.  R to Group and World).
  162.  
  163.  This has now compiled and installed the two Help libraries.  The
  164.  ".HLP" files are no longer needed.  Now you have to ensure Kermit
  165.  knows about them.  You will need a "symbol definition" which can
  166.  either be placed in the main system Login command procedure, or users
  167.  can place it in their own individual LOGIN.COM files.  You will also
  168.  need a command procedure.
  169.  
  170.  In the following, I make the following assumptions:
  171.  
  172.  *    The Kermit directory is on a device called "USER1" and called
  173.       "[KERMIT]"
  174.  *    The executable file is held in KERMIT.EXE
  175.       and hence (see above) the help library file is in KERMIT.HLB
  176.  *    The start-up command procedure is called KERMIT.COM
  177.  *    A Kermit initialisation file is held in KERMIT.INI
  178.  
  179.  Change any of these to the values appropriate to your system.
  180.  
  181.  
  182.  Symbol definition  (in either the main system Login file,
  183.  -----------------   or a user's own LOGIN.COM)
  184.  
  185.       KERMIT == "@UQER1:[KERMIT]KERMIT"
  186.  
  187.  
  188.  Command procedure  (permitted at least Execute to Group and World!)
  189.  -----------------  (Ensure the "$"s have no spaces before them!!)
  190.  
  191. $ !
  192. $ !   Command file to call Kermit on a VAX/VMS system.
  193. $ !
  194. $ !   Author: Mike Brudenell
  195. $ !   Site:   University of Newcastle upon Tyne
  196. $ !   Date:   June 24, 1986
  197. $ !
  198. $   set noverify
  199. $   set noon
  200. $ !
  201. $   on control_y then goto FINISH
  202. $   set terminal tt /nowrap/nomodem/noeight ! "Magic" for (only?) our network
  203. $   define/u kermdir   USER1:[KERMIT]       ! Directory holding Kermit files
  204. $ !     Delete the following line (and this comment) if you
  205. $ !     do not have/need a system Kermit initialisation file.
  206. $   define/u vmskermit kermdir:KERMIT.INI   ! Kermit initialisation file
  207. $   define/u kermit    kermdir:KERMIT       ! "Magic" to access Help library
  208. $   define/u sys$input sys$command:         ! Take input from keyboard
  209. $   run KERMIT                              ! Run Kermit (defaults to ".EXE")
  210. $ !
  211. $ FINISH:
  212. $   set on
  213. $   exit
  214.  
  215.