INSTALLATION INSTRUCTIONS

                         DM Version 6.7A

                 (Directory Management Utility)


Installation

     0.  You must select a system default Editor, Viewer, and 
Printer.  (A "Viewer" is something with the functions of an 
editor, but which is read-only [i.e., will not change the file]).

     	  o  You will note that we use a TPU-based editor which 
we call "WPE".

     	  o  The "Viewer" can actually be any editor (thus 
eliminating the difference).  We use a read-only version of WPE 
called "MORE".  TYPE would also work, but isn't too elegant.

     	  o  If "PRINT" works at your site, you won't have to 
change the default printer.

     	  o  There are two ways to change the defaults - you may 
put them in DM.COM or DM.FOR; I recommend putting them in DM.FOR, 
and this is the procedure outlined below.

     1.  Edit the following files:

     	  o  DM.COM - Change the line indicated "LOCAL" to point 
to the directory where you will place these files. 

     	  o  DM.FOR - At the start of the program (there are a 
lot of comments before you get there), edit the information for 
Default_Editor, Default_Viewer, and Default_Print_Command to the 
values you have selected.  Note that you probably have to change 
the sizes of the Character variables with these names, also.

     2.  Do @DM_Install.  This will compile DM.FOR and link a new 
image.

     3.  Place the files in the appropriate place.  The files 
necessary for running DM are:
          DM.COM  
          DM.EXE
          DM$ATPRINT.COM  (Attached Printer Controller)

     4.  Point appropriate system symbols.  Note that these are 
both .COM files.  On our system, we use the following:
          DM :== @Sys$Utils:[Directory_Manager]DM
          DM$ATP :== @Sys$Utils:[Directory_Manager]DM$ATPRINT

     5.  You can check that you did it correctly by typing DM.  
Then, when the DM screen comes up, type <Gold> A (or PF1 followed 
by A).  This should show you the default settings you have made.

     6.  You will probably want to publish the user's guide.  It 
is present in two forms: a .WPL file if you have WPS+, and a .TXT 
file.


Re-Compiling

     There are command procedures for re-compiling and linking 
the whole of DM.  There are separate files for compiling with and 
without the limits-checking.  The version submitted to DECUS was 
compiled without checking:
          CPL and CPL_CHECK         compile/assemble everything.
          DM_LINK                   links DM
          DOALL and DOALL_CHECK     compile and then link.


Additional Information

     See the files DM_USER_DOC and DM_PROGRAMMER_DOC for details 
of usage and adding functions.


Known Bugs

     1.  The program crashes if you try to access a .DIR;n file 
which is not a VMS Directory File.  This is judged to be 
pathological.  A special macro subroutine would have been 
necessary to check for this case.


Attribution

     Directory Manager was initially submitted in January 1983 by 
John C. Hayre, Texas Instruments (later with Veeco Integrated 
Automation, Dallas).

     Additional extensive improvements and submissions were made 
by Rich Gregory, Pharmaceutical Research Associates, 
Charlottesville, VA.

     The version spun-off in 1986 (Version 6.xA), which 
incorporated an All-In-1-like user interface and use of the SMG$ 
utilities for screen management is by Dale E. Coy, Los Alamos 
National Laboratory, Los Alamos, NM.