home *** CD-ROM | disk | FTP | other *** search
/ Usenet 1994 January / usenetsourcesnewsgroupsinfomagicjanuary1994.iso / sources / misc / volume1 / 8710 / vms-vi / 1 next >
Encoding:
Internet Message Format  |  1990-07-13  |  6.0 KB
  1. Path: uunet!husc6!necntc!ncoast!allbery
  2. From: gregg@a.cs.okstate.edu@mandrill.CWRU.Edu (Gregg Wonderly)
  3. Newsgroups: comp.sources.misc
  4. Subject: VI in TPU part 1/13
  5. Message-ID: <4850@ncoast.UUCP>
  6. Date: 13 Oct 87 02:48:48 GMT
  7. Sender: allbery@ncoast.UUCP
  8. Organization: Oklahoma State Univ., Stillwater
  9. Lines: 100
  10. Approved: allbery@ncoast.UUCP
  11. X-Archive: comp.sources.misc/8710/vms-vi/1
  12.  
  13. There are 13 parts to the distribution of VI written in TPU.  The first,
  14. this file, is a plain text file.  The remainder, are DCL command files.
  15. Files 2-13 should each be executed as DCL procedures in sequence.  Below
  16. is a sequence of steps that should allow you to get VI up and running.
  17.  
  18.     1)  You should pick a directory to place VI under, and place all 13 files
  19.         in that directory.  Then, you can begin extracting.  Three directories
  20.         will be created, [.SRC], [.EXE], and [.DOC].  The directory names
  21.         should reveal the purposes of these directories. 
  22.  
  23.     2)  Place all 13 of the VI parts into the directory chosen in step 1.
  24.         For each part, 2 through 13, execute the file as a command procedure
  25.         using the command "@<filename>", where <filename> is the name of
  26.         the file to execute (e.g. @VI_2.COM, followed by @VI_3.COM, etc).
  27.  
  28.     3)  After executing the 13th command file, you should set default to the
  29.         [.SRC] directory, and use the commands "$ @make exe", and "$ @make
  30.         tpusubs" to create the VI.EXE executable, and the CALL_USER routines
  31.         for VI to use. 
  32.  
  33.     4)  Next, set default to [-.DOC] (from the SRC directory), and execute
  34.         the command "$ VIDOC", and "$ @VIDOC HELP" to create a printable
  35.         version of the current documentation, as well as a HELP file
  36.         that VI can use.  When asked the question:
  37.  
  38.             Name of library to install HELP files in?
  39.  
  40.         you should probably answer with the full path to the current
  41.         directory.  VI.TPU contains the path VI$ROOT:[DOC]VI.HLB as the place
  42.         where it will work from, so if you do not place the help file in this
  43.         library (It will automatically be created for you), then you must
  44.         edit VI.TPU to contain the proper path.
  45.  
  46.     5)  Here you have a decision to make.  I have written a interface to
  47.         callable TPU, [-.SRC]VI.MAR.  If you wish to use this interface,
  48.         then there must be a CLD definition for it installed in DCLTABLES.
  49.         This is really only necessary for using VI as a SUB-process, but
  50.         I find it conveinent to install the CLD so that I do not have
  51.         to wait for SET COMMAND to complete when I log in.  If do not
  52.         wish to use the callable TPU interface then go to the next step NOW,
  53.         otherwise hang tight.
  54.  
  55.         The CLD definition that needs to be installed is in [-.EXE]VI.CLD.  If
  56.         you do not have sufficient privileges to install a new DCLTABLES you
  57.         should get prepared to do so, or find someone that will do it for you
  58.         (now is not entirely necessary, as you can skip to step 6, and do this
  59.         later). 
  60.  
  61.         a)  Take the time to examine the CLD, and make sure it is ok for
  62.             your installation.  If you are on a cluster, then there is
  63.             some extra work that I won't describe here since I have never
  64.             done it.  Basically you need to do the following set of commands.
  65.             (the dollar signs are provide by DCL in case it wasn't obvious).
  66.  
  67.             $ SET COMMAND [-.EXE]VI.CLD/TABLE=SYS$SHARE:DCLTABLES.EXE/OUT=-
  68.             _$ SYS$SHARE:DCLTABLES.EXE
  69.             $ MCR INSTALL
  70.             INSTALL>SYS$SHARE:DCLTABLES/REPLACE
  71.             INSTALL>EXIT
  72.  
  73.         b)  This should be all that single CPU sites need to do.  If you
  74.             have a different arrangement at your sight that requires
  75.             something different, then you would know that better than I.
  76.             Remeber that you MUST logout and log back in to have the updated
  77.             DCLTABLES available to your process.  Step 8, below, can not be
  78.             done unless you either 1) do not do (c) below, or 2) you logout and
  79.             log back in after reinstalling DCLTABLES.
  80.  
  81.         c)  [-.EXE]VI.COM, and [-.EXE]VISETUP.COM contain uses of the symbol,
  82.             "VI".  This symbol is normally equated to "EDIT/TPU".  Once you
  83.             have made the changes necessary to update DCLTABLES, then these
  84.             references should be changed.  In [-.EXE]VI.COM, change VI to
  85.             be "VI", instead of "EDIT/TPU".  In [-.EXE]VISETUP.COM, delete
  86.             the assignment to the variable VI, as the comment there says
  87.             to.
  88.  
  89.     6)  Next, set default to [-.EXE] (from [.DOC]), and edit the file
  90.         VISETUP.COM.  This file must be executed by each user wishing to
  91.         use VI before they can use it.  You should change the definition of
  92.         VI$ROOT to be the parent directory of the directory you are in NOW.
  93.         E.g. if you are in the directory DUA0:[PUBLIC.VI.DOC], then VI$ROOT
  94.         should be defined to be DUA0:[PUBLIC.VI.].  Note that this file
  95.         potentially defines 3 symbols.  VI allows normal use of VI, VIS
  96.         allows use of the VI.COM procedure to run VI in a subprocess, and
  97.         VIEW allows READONLY editing of a file (as in UNIX).
  98.  
  99.     7)  The command file VI.COM is used to envoke VI in a sub-process
  100.         so that a minimal amount of overhead for image activation will
  101.         be incurred by the system.  In the VI.COM that you have, there
  102.         are invocations of a SUSPEND, and a RESUME command.  I use these
  103.         commands to suspend kept editors while they are not it use so that
  104.         they will be swapped out or trimmed by the SWAPPER in a more timely
  105.         manner.  This will allow their memory to be put to use by other
  106.         processes whenever possible.  If you do not wish to do this and/or
  107.         do not have these facilities available to you, then you should comment
  108.         out these command lines.
  109.  
  110.     8)  Next, you should be ready to give VI a trial run.  Execute the
  111.         VISETUP.COM procedure in [.EXE].  Then type VI, and hit return.
  112.         You should be off and running.
  113.