       User's Guide     DM Version 7.1A      (Directory Management Utility)     April, 1987         F DM is a utility which allows you to more easily manage, clean up, and 7 otherwise work with your files and directory structure.   E DM works with VT2xx series terminals.  Your VT2xx setup must be some  H variant of VT2xx.  It should also work correctly with VT10x terminals.  E With terminal emulators on PCs, and with VT100-lookalikes, you're on   your own.         " RUNNING DM:  from the VMS prompt--  	      $ DM   J EXITING DM:  from any "main" DM menu, just press "Q" (single character).  E [The F10 key, <GOLD> K and <GOLD> F also have the same effect].  You  I will be returned to the directory from which you began DM.  (If you want  7 to stay in the presently-displayed directory, press X).   5 GETTING HELP:  Run DM.  Press PF2, the Help key, or ?                     G DM has been improved and submitted to DECUS by a succession of writers  7 including John C. Hayre, Rich Gregory, and Dale E. Coy.   H Constructive suggestions, "bug reports", etc. should be referred to the  system manager.          MAIN SCREEN   E When you access DM, you will see a presentation of the files in your   current directory.  D On line 23 is a reminder of your current direction of movement, the - current directory, and the current wild-card.   < On line 24 is a brief list of the single-character commands.  D Most commands work by placing the "highlighted" area on the file of E interest, and then doing the command.  Some commands also work using  ! "tagged" files (described later).      HELP  F DM may seem complex, but complete help is available.  The "Help" key, E the PF2 key, the ? key, and <GOLD> H, may be used to access the help  G menus.  There are 4 help screens available for the various functions.   I Press Return to return to the main screen.  [Note: <Gold> means to press  2 the <Gold> (PF1) key, and then press another key].  F Text descriptions are available for must functions.  While you are in / one of the 4 help screens, press "Help" or PF2.      COMMANDS  I Commands use the normal keys, keypad, and function keys.  Where a normal  9 key is specified, you may use either upper or lower case.     " SIMPLE MOVEMENTS AROUND THE SCREEN  G Use the Up and Down Arrow keys to highlight the file names.  There are  F about a dozen more ways to move within the directory, described under  "Advanced Movements" below.      MOVEMENTS BETWEEN DIRECTORIES   D To move Down in a directory tree, highlight the .DIR file and press E either Select key (function key or KP.).  The V and E keys will also   work.   H To move Up in a directory tree, press the "Upper Case" (KP3) key on the ? keypad.  In this case the highlighted file makes no difference.      INFORMATION ABOUT FILES   D You may get information about any file (size, creation date, owner, C protection).  Since this involves opening the file, operations are  G somewhat slower.  Press I to display information about single files as  H they are highlighted.  Press M to display information about all files.  H From either of these states, press L to get back to the regular display.  H You may get "full" (DIR/FU) information on individual highlighted files ) (or "tagged" files) by pressing <Gold> I.c     EDITING & VIEWING FILESw  A To Edit or View a file (Viewing is read-only), use the following  H commands.  Your system manager has selected a default editor and viewer F for your use.  Note that the highlighted file must not be a .DIR file:        E	       - to Edit.      V	       - to View.=      Select    - to Edit (this is the function key "Select").(3      Sel       - to View (this is KP. or "Sel").		 D9      F	       - to FMS edit a file (of appropriate type).      TAGGING AND UNTAGGING FILESn  F Files may be "Tagged" so that multiple files may be Deleted, Printed, F Renamed, or Copied.  To Tag a file, highlight it and press T (the tag G symbol will appear).  To Untag a file, highlight it and press U.  Tags fG will "disappear" if you do some operation which requires reloading the oE directory (edit, view, $, %, etc.).  Therefore, it is best to do the  4 tagging just before you do the associated operation.     DELETING FILES & DIRECTORIES  H Single highlighted files may be deleted by pressing D or the Remove key 3 or F13.  You will be asked to confirm the deletion.i  C Tagged files may be deleted in the same way.  You will be given an h5 overlay menu with choices for All, Confirm, and Quit.l  G Single and Tagged directories may be deleted in the same way.  In this c+ case, the entire directory tree is handled.g  C Regardless of whether you have tagged files at the moment, you may mG delete a single file by pressing F6.  You will be asked to confirm the G	 deletion.     
 COPYING FILESh  H You may copy files (highlighted or tagged) from the current directory.  ? Press either C or <Gold> W.  You will be prompted for the file   destination.  C To copy files into the current directory, press either <Gold> G or iE "Insert Here".  You will be prompted for the source file names.  Any h4 legal VMS filenames (including wildcards) will work.     PRINTING FILES  G You may print files (highlighted or tagged).  Press P to print files.   F The files will be printed on the default device (see below for how to  change it).h     PRINTING THE DM DIRECTORYh  A Print the DM directory (the screen display) by pressing <Gold> P.i    
 PURGING FILES   F To purge files, press G.  Only the files shown by DM will be purged.  , (See below for how to change your wildcard).     RENAMING FILES  8 You may rename single (highlighted) files by pressing R.  F You may also rename tagged files.  Any legal VMS "target" name may be  used.U     FINDING FILES (SEARCHING)e  C Search for files by any substring of the file name (such as XYZ or OH .TXT).  This is not a wildcard function, so don't use the '*' character.  H For the first search, press <Gold> , (yes, the comma key) or the "Find" 1 key.  You will be prompted for the search string.i  G For subsequent searches on the same string, press <Gold> . (Cont Srch) aE or PF3.  You may also press Find twice to search for the same string.t     GENERAL RULES FOR FUNCTIONS.  D If you are prompted for an answer, DM will either give you a single D prompt character ($ or >), or will supply the present setting for a 	 variable.   G If you get a single prompt character, you may usually use the Up Arrow s= to recall your last response to a question, and then edit it.   H If you are prompted to edit the present entry, you may do so or may use # <Ctl> U to erase it and start over.   F In some menus, you are not told how to exit the menu.  Almost any key & will get you out (for instance, <CR>).     CHANGING THE WILDCARD   E Press W.  You will be prompted to edit the current wildcard used for NE files display (Default for "all" is '*').  You may use any legal VMS , wildcard string.     ADVANCED MOVEMENTS  H Because movements on the screen are the most frequent operations, there H are many functions to simplify this job. (NOTE: <Gold> in the following F commands indicates that you should press the <Gold> (or PF1) key, and  then press another key).  6       A		 - Moves the cursor to the top of the screen.9       Z		 - Moves the cursor to the bottom of the screen.g;       <Gold> T	 - Moves to the Top (first screen of files).r=       <Gold> B	 - Moves to the Bottom (last screen of files).l$       Prev	 - Moves "Up" one screen.&       Next	 - Moves "Down" one screen.?       F11        - Toggles the direction of movement (Fwd/Rev).r;       Backup	 - Sets movement to Reverse & moves 1 line Up.i>       Advance	 - Sets movement to Forward & moves 1 line Down.6       <CR>	 - Moves one line in the present direction.>       Para	 - (KP5) Moves one screen in the present direction.  ? There are a few more movement functions - see the Help screens.e    # ADVANCED DIRECTORY/DEVICE MOVEMENTSi  H You may move upward in the directory tree structure until you reach the I [000000] level (if you have "read" access to the directory file).  After  J you reach the top level, DM will ask you for the name of another device.  , A <CR> will leave you in the current device.  E You may change disk devices at any time by using <Gold> D.  You will oI always be placed at the top level of a new device.  This is also a quick w2 way to get to the top level on the current device.  B If you have a "Rooted Directory" structure, DM will handle upward 
 movements.    % DISPLAYING THE SUBDIRECTORY STRUCTURE   I You may display a schematic map of the subdirectories below your current uG level by pressing *.  Move around the display by using the arrow keys, iI and use 'Sel' or Return to change your current directory.  This function g- has it's own help - accessed by pressing PF2.A  F Print the subdirectory tree (the screen display) by pressing <Gold> P.     WILDCARD FILE DELETES   I If the Wildcard is set to something other than '*', the delete-directory  G function will delete only files.  Therefore, to delete all .LIS files, mH set the wildcard to '*.LIS', go to the appropriate .DIR file, and press  D.     EXECUTING .COM FILES  H .COM files may be executed by pressing @.  The .COM file is executed in 
 a subprocess.      SINGLE DCL COMMANDSa  @ There are two environments for doing DCL commands from DM; in a H subprocess, and in the main process (outside DM).  Using the subprocess G is more efficient, but you can't respond to a question from DCL (e.g., w9 COPY where you want to supply a file name to the prompt).i  F To use the subprocess, press $ or the "Do" key.  You will be prompted G for the DCL command.  You may include the highlighted file in your DCL nG command by entering \ at the appropriate spot in the command.  You may t$ include tagged files by entering \\.  C To do the DCL command in the main process, type %.  Note that your fB context is the current DM directory, and you may only do a single  command.     MULTIPLE DCL COMMANDSC  I You may execute multiple commands (in the subprocess) by pressing <Gold> oB $, <Gold> Do, or <Gold> [.  An "empty" <CR> will return you to DM.     MESSAGES AND MAILn  G If you are sent a message by the system (e.g., mail notification), the sH message will appear at the bottom of the screen.  Only the last line of  the message is shown.u  E You may run VMS Mail (VaxMail) by pressing <Gold> M.  If you want to iI send mail, you will normally be using the mail editor you use outside of o> DM.  If this is not the case, see the system manager for help.     CHANGING DEFAULTS.  E When you enter DM, you will be given default values for DM's Editor,  H Viewer, and Print Command.  You can change these by pressing <Gold> A.  H The changes you make will remain for the duration of your login session # (even if you exit and re-enter DM).a  C If the system defaults are not the ones you would like, the system  B manager can tell you how to re-define them in your LOGIN.COM file.     ATTACHED PRINTERS   H If you have an LA50 or LA100 (or equivalent) attached to your terminal, F you can define DM's Print Command to use the attached printer.  Using C the <Gold> A menu, set the Print Command to (spaces are important):d  6      DM$ATP		   - to print using the printer's normal                              mode.9      DM$ATP DM$LQ	   - to print in "Letter Quality" mode.h9      DM$ATP DM$COMPRESSED  - to print in compressed mode.o:      DM$ATP DM$12	   - to print at 12 characters per inch.    % RE-DEFINING SYMBOLS IN YOUR LOGIN.COMd  I Normally, when you enter DM, you will be given system default values for  C DM's Editor, Viewer, and Print Command.  If you always want to use eI something different from the system defaults, you can establish your own  E defaults by creating symbols in your LOGIN.COM file.  The applicable   symbols are:        DM$EDITOR      DM$VIEWER      DM$PRINT_COMMANDy  G For instance, you might put the following lines in your LOGIN.COM file:   3      DM$EDITOR :== EDIT/TPU/SECTION=ABC.TPU$SECTION .      DM$VIEWER :== @SYS$LOGIN:MYEDITOR FOO BAR>      DM$PRINT_COMMAND :== PRINT/QUEUE=MY_PRINTER/FORM=PAYCHECK  G Note that blanks are permitted; DM will add one space and the selected NC file name(s) to the end of your defined symbol, and pass this to a i subprocess.d  D There is one more "trick" to this: If you use :==, DM will save any G changes you make with the <Gold> A menu for the duration of your login rE session.  If you use :=, DM will re-initialize to your defaults each c time you re-enter DM.i     Using a TPU-based Editor  I If the DM$Editor symbol is 'WPE' (or the DM$Viewer symbol is 'MORE'), DM pI expects to use a tpu-based editor.  This is very efficient (callable TPU aE is used, and no subprocess is involved).  You can control which edit tC interface (TPU Section File) is used by defining TPUSECINI in your b LOGIN.COM file.   G If you want to use the EVE interface, which is the default, you should x( make sure that TPUSECINI is not defined.  % If you want to use the EDT interface;E      DEFINE TPUSECINI EDTSECINI   @ Consult the system manager if you want to use the WPE interface.  C If you use a TPU-based editor other than EVE, EDT, or WPE, you may S simply:n6      DEFINE TPUSECINI disk:[directory]YOUR.TPU$SECTIONC This definition you need may already have been made by your system .= manager.  In any case, the system manager can provide advice.           SUMMARY OF DM KEYS AND FUNCTIONS     REGULAR KEYBOARD COMMANDSw    / (Listed in the order they appear on the "menu") 
              h- $	 -   Do a single DCL command (using Spawn).h6 %	 -   Do a single DCL command (in the context of the                current directory).& @	 -   Execute the selected .COM file.0 *	 -   Show (and select from) SubDirectory Tree.% A/Z 	 -   Go to Top/Bottom of screen.d3 W	 -   Select a new wild-card for display of files. ; T	 -   Tag a file - Used in D, C, P, R, <Gold> I, $, and %                commands. U	 -   Untag a file.. Q	 -   Quit (Returning to starting directory).+ X	 -   Exit (In currently-shown directory). + R	 -   Rename current file or tagged files.m& V	 -   View current file, or GoTo .DIR& E	 -   Edit current file, or GoTo .DIR
 F	 -   FMS! M	 -   Show all file information.a0 I	 -   Show information for selected files only./ L	 -   Show less information (file names only).  D	 -   Delete file(s)T; C	 -   Copy file(s) [to another name or another directory].  G	 -   Purge the current files.r( P	 -   Print file(s) on default printer.   <CTL> W	 -   Refresh screen  S	 -   ViewN  ?	 -   Help (on the normal keys)    
 GOLD COMMANDSt  ( GOLD T - Go to the Top of the Directory.+ GOLD B - Go to the Bottom of the Directory.a GOLD F, GOLD K - Quit.. GOLD G - Get file(s) [from another Directory]. GOLD H - Help.8 GOLD SEARCH - (<Gold> ,) Find text string in file names.8 GOLD CONTINUE SEARCH -  (<Gold> ,) Find previous string.) GOLD $ or [ - Go out to DCL for commands.M0 GOLD W - Copy files from this directory (write).  GOLD P - Print the DM Directory.3 GOLD A - Change default editor, viewer, or printer. ' GOLD D - Change to another disk device.O GOLD I - DIR/FU on files.  GOLD M - VMS MailP T       KEYPAD FUNCTIONS  A 1) The inner keypad (with the arrow keys) works as it is labeled:   F        Up and Down Arrows  Move the highlighted area. (Left and Right -                            arrows do nothing)I  4        Find		   Search file names for a text string.  5        Insert Here	   Copy files into this directory.o  !        Remove		   Delete file(s).i  <        Select		   Either Edit for a regular file, or "Go to ;                            this directory" for a .DIR file.D  "        Prev Screen	   Up a screen.  $        Next Screen	   Down a screen.  y, 2) The right keypad works a little like WPS+          PF1		   Gold           PF2		   Helpd  !        PF3		   Find Next (Search)   <        Upper Case (PF3)	   Go UP one directory in the tree.   =        Sel		   Either View (More) for a regular file, or "Go x>                            to this directory" for a .DIR file.  :        Sent, Tab Pos,	   Go one line in current direction.        Line, and Enter	       3        Para		   Go one screen in current direction.d  =        Backup, Advance	   Set direction and/or move one line.F          <Gold> PF3	   Find]  )        <Gold> Backup	   Go to top screen.y  -        <Gold> Advance	   Go to bottom screen..  7 3) Function keys F6 thru F16 have functions as follows:   '     F6      F7      F8      F9      F10 *  +-------+-------+-------+-------+-------+*  |DELETE |       |       |       |       |*  | THIS  |       |       |       | EXIT  |*  | FILE  |       |       |       |       |*  +-------+-------+-------+-------+-------+  .                    F11     F12     F13     F141                 +-------+-------+-------+-------+e1                 |FORWARD| MOVE  |DELETE |       |S1                 |REVERSE|  UP   | FILE  |       | 1                 | TOGGLE|1 LINE |       |       |%1                 +-------+-------+-------+-------+	  4                                      F15         F16;                                   +-------+---------------+e;                                   |       |               |	;                                   | HELP  |      DO       | ;                                   |       |               |f;                                   +-------+---------------+ ?                                              DO = 1 DCL Commandn       e       KEY LABELS FOR VT2xx TERMINALS  I The WPE labels are reproduced here.  Some of the functions (F6, F10-F13)  $ labeled are similar to DM functions.  E Reduce this page to about 74% to properly fit the key strip on VT2xx .
 terminals.  = +-----------+-----------+-----------+-----------+-----------+G= |Delete Line|   Quote   | Cap Word  |           |           |SH +-----------+-----------+-----------+           |    Exit   |    F6 -F10= |Undelete Ln|   Escape  |Upper Word |           |           | = +-----------+-----------+-----------+-----------+-----------+.  1 +-----------+-----------+-----------+-----------+e1 |  Forward  |   Move    |Erase Word |  Insert/  | H |  Reverse  |    by     +-----------+Overstrike |                F11-F141 |  Toggle   |   Line    | Rub Sent. |  Toggle   |w1 +-----------+-----------+-----------+-----------+   1 +-----------+-----------+-----------+-----------+fD |           | 2 Windows | Other Buf.|  Delete   | (Normal Functions)H | 1 Window  +-----------+-----------+    to     | -------------- F17-F20B |           | Get File  |  Buffer   |End of Line| (Gold Functions)1 +-----------+-----------+-----------+-----------+e  