DM Users' Guide


Directory Management Utility


DM Version 7.3A


April, 1988




DM is a utility which allows you to more easily manage, clean up, and 
otherwise work with your files and directory structure.

DM works with VT2xx and VT3xx series terminals.  Your VT2xx/VT3xx setup 
must be some variant of VT2xx/VT3xx.  It should also work correctly with 
VT10x terminals.  With terminal emulators on PCs, and with 
VT100-lookalikes, you're on your own.  


Using DM



Running DM:  from the VMS prompt -

     $ DM



Exiting DM:  from any "main" DM menu, just press "Q" (single character).  
[The F10 key, <GOLD> K and <GOLD> F also have the same effect].  You 
will be returned to the directory from which you began DM.  (If you want 
to stay in the presently-displayed directory, press X).



Getting Help:  Run DM.  Press PF2, the Help key, or ?





DM has been improved and submitted to DECUS by a succession of writers 
including John C. Hayre, Rich Gregory, and Dale E. Coy.

Constructive suggestions, "bug reports", etc. should be referred to the 
system manager.




Main Screen

When you access DM, you will see a presentation of the files in your 
current directory.

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.

Most commands work by placing the "highlighted" area on the file of 
interest, and then doing the command.  Some commands also work using 
"tagged" files (described later).


Help

DM may seem complex, but complete help is available.  The "Help" key, 
the PF2 key, the ? key, and <GOLD> H, may be used to access the help 
menus.  There are 4 help screens available for the various functions.  
Press Return to return to the main screen.  [Note: <Gold> means to press 
the <Gold> (PF1) key, and then press another key].

Text descriptions are available for must functions.  While you are in 
one of the 4 help screens, press "Help" or PF2.


Commands

Commands use the normal keys, keypad, and function keys.  Where a normal 
key is specified, you may use either upper or lower case.  Commands are 
usually single-keystroke (you do not have to use the Return key to 
complete the command).


DM Single-Keystroke Commands


Simple Movements Around the Screen

Use the Up and Down Arrow keys to highlight the file names.  There are 
about a dozen more ways to move within the directory, described under 
"Advanced Movements" below.


Movements Between Directories

To move Down in a directory tree, highlight the .DIR file and press 
either Select key (function key or KP.).  The V and E keys will also 
work.

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

You may get information about any file (size, creation date, owner, 
protection).  Since this involves opening the file, operations are 
somewhat slower.  Press I to display information about single files as 
they are highlighted.  Press M to display information about all files.  
From either of these states, press L to get back to the regular display.

You may get "full" (DIR/FU) information on individual highlighted files 
(or "tagged" files) by pressing <Gold> I.


Editing & Viewing Files

To Edit or View a file (Viewing is read-only), use the following 
commands.  Your system manager has selected a default editor and viewer 
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").
     Sel       - to View (this is KP. or "Sel").		 
     F	       - to FMS edit a file (of type FRM, FLG, or FLB).


Tagging and Untagging Files

Files may be "Tagged" so that multiple files may be Deleted, Printed, 
Renamed, or Copied.  To Tag a file, highlight it and press T (the tag 
symbol will appear).  To Untag a file, highlight it and press U.  Tags 
will "disappear" if you do some operation which requires reloading the 
directory (edit, view, $, %, etc.).  Therefore, it is best to do the 
tagging just before you do the associated operation.


Deleting Files & Directories

Single highlighted files may be deleted by pressing D or the Remove key 
or F13.  You will be asked to confirm the deletion.

Tagged files may be deleted in the same way.  You will be given an 
overlay menu with choices for All, Confirm, and Quit.

Single and Tagged directories may be deleted in the same way.  In this 
case, the entire directory tree is handled.

Regardless of whether you have tagged files at the moment, you may 
delete a single file by pressing F6.  You will be asked to confirm the 
deletion.


Copying Files

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.

To copy files into the current directory, press either <Gold> G or 
"Insert Here".  You will be prompted for the source file names.  Any 
legal VMS filenames (including wildcards) will work.


Printing Files

You may print files (highlighted or tagged).  Press P to print files.  
The files will be printed on the default device (see below for how to 
change it).


Printing the DM Directory

Print the DM directory (the screen display) by pressing <Gold> P.


Purging Files

To purge files, press G.  Only the files shown by DM will be purged.  
(See below for how to change your wildcard).


Renaming Files

You may rename single (highlighted) files by pressing R.

You may also rename tagged files.  Any legal VMS "target" name may be 
used.


Finding Files (Searching)

Search for files by any substring of the file name (such as XYZ or 
.TXT).  This is not a wildcard function, so don't use the '*' character.

For the first search, press <Gold> , (yes, the comma key) or the "Find" 
key.  You will be prompted for the search string.

For subsequent searches on the same string, press <Gold> . (Cont Srch) 
or PF3.  You may also press Find twice to search for the same string.


Executing .COM Files

.COM files may be executed by pressing @.  The .COM file is executed in 
a subprocess.


General Rules for Functions

If you are prompted for an answer, DM will either give you a single 
prompt character ($ or >), or will supply the present setting for a 
variable.

You may usually use the Up Arrow to recall your previous responses to a 
question, and then edit the response.  This function is similar to the 
VMS command recall function.

If you are prompted to edit the present entry, you may do so or may use 
<Ctl> U to erase it and start over.

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

Press W.  You will be prompted to edit the current wildcard used for 
files display (Default for "all" is '*').  You may use any legal VMS 
wildcard string.


DM Advanced Movements

Because movements on the screen are the most frequent operations, there 
are many functions to simplify this job. (NOTE: <Gold> in the following 
commands indicates that you should press the <Gold> (or PF1) key, and 
then press another key).

      A		 - Moves the cursor to the top of the screen.
      Z		 - Moves the cursor to the bottom of the screen.
      <Gold> T	 - Moves to the Top (first screen of files).
      <Gold> B	 - Moves to the Bottom (last screen of files).
      Prev	 - Moves "Up" one screen.
      Next	 - Moves "Down" one screen.
      F11        - Toggles the direction of movement (Fwd/Rev).
      Backup	 - Sets movement to Reverse & moves 1 line Up.
      Advance	 - Sets movement to Forward & moves 1 line Down.
      <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.


Advanced Directory/Device Movements

You may move upward in the directory tree structure until you reach the 
[000000] level (if you have "read" access to the directory file).  After 
you reach the top level, DM will ask you to enter the name of another 
device or directory.  A <CR> will leave you in the current device.

You may change disk devices at any time by using <Gold> D.  You will 
always be placed at the top level if you specify only a new device.  
This is also a quick way to get to the top level on the current device.

You may also specify a directory (on the current device), or a complete 
device and directory.  If you make an error in specification, you will 
usually be placed in the top level of the device.

If you have a "Rooted Directory" structure, DM will handle upward 
movements.


Displaying the Subdirectory Structure

You may display a schematic map of the subdirectories below your current 
level by pressing *.  Move around the display by using the arrow keys, 
and use 'Sel' or Return to change your current directory.  This function 
has it's own help - accessed by pressing PF2.

Print the subdirectory tree (the screen display) by pressing <Gold> P.

Change the printer parameters by pressing <Gold> A.


Advanced DM Functions


Wildcard File Deletes

If the Wildcard is set to something other than '*', the delete-directory 
function will delete only files.  Therefore, to delete all .LIS files, 
set the wildcard to '*.LIS', go to the appropriate .DIR file, and press 
D.


Single DCL Commands

There are two environments for doing DCL commands from DM; in a 
subprocess, and in the main process (outside DM).  Using the subprocess 
is more efficient, but you can't respond to a question from DCL (e.g., 
COPY where you want to supply a file name to the prompt).

To use the subprocess, press $ or the "Do" key.  You will be prompted 
for the DCL command.  You may include the highlighted file in your DCL 
command by entering \ at the appropriate spot in the command.  You may 
include tagged files by entering \\.

To do the DCL command in the main process, type %.  Note that your 
context is the current DM directory, and you may only do a single 
command.


Multiple DCL Commands

You may execute multiple commands (in the subprocess) by pressing <Gold> 
$, <Gold> Do, or <Gold> [.  An "empty" <CR> will return you to DM.


Messages and Mail

Messages from the system (broadcasts) are automatically saved by DM, and 
are displayed for you when you exit.  You may choose to read them 
without leaving DM.

If you are sent a message by the system (e.g., mail notification), a 
notification will appear at the bottom of the screen.  You will be 
notified of the first message to arrive, and every 20th message 
thereafter.  If you want to read your messages without leaving DM, press 
the ! key.  NOTE: All of your messages will be scrolled; if you have 
lots of messages, be ready with the "hold screen" key.

You may run VMS Mail (VaxMail) by pressing <Gold> M.  If you want to 
send mail, you will normally be using the mail editor you use outside of 
DM.  If this is not the case, see the system manager for help.


Changing Defaults

When you enter DM, you will be given default values for DM's Editor, 
Viewer, Print Command, and Printer Type.  You can change these by 
pressing <Gold> A.  The changes you make will remain for the duration of 
your login session (even if you exit and re-enter DM).

The <Gold> A menu also provides an option for saving your own preferred 
default values.  Your saved defaults will be retained for future login 
sessions.


Attached Printers

If you have an LA50 or LA100 (or more recent DEC printer) attached to 
your terminal, you can define DM's Print Command to use the attached 
printer.  Using the <Gold> A menu, set the Print Command to (spaces are 
important):

     DM$ATP		   - to print using the printer's normal 
                           mode.
     DM$ATP DM$LQ	   - to print in "Letter Quality" mode.
     DM$ATP DM$COMPRESSED  - to print in compressed mode.
     DM$ATP DM$12	   - to print at 12 characters per inch.


Re-Defining Symbols in your LOGIN.COM

Normally, when you enter DM, you will be given system default values for 
DM's Editor, Viewer, and Print Command.  If you always want to use 
something different from the system defaults, you can establish your own 
defaults by creating symbols in your LOGIN.COM file.  Unless you need 
the special capabilities provided by defining symbols in your LOGIN.COM 
file, it is preferable to use the Save option on the <Gold> A menu to 
preserve your defaults.  The Save function provides the same effect, and 
is more efficient.

The applicable symbols are:

     DM$EDITOR
     DM$VIEWER
     DM$PRINT_COMMAND
     DM$PRINTER_TYPE

For instance, you might put the following lines in your LOGIN.COM file:

     DM$EDITOR :== EDIT/TPU/SECTION=ABC.TPU$SECTION
     DM$VIEWER :== @SYS$LOGIN:MYEDITOR FOO BAR
     DM$PRINT_COMMAND :== PRINT/QUEUE=MY_PRINTER/FORM=PAYCHECK
     DM$PRINTER_TYPE :== LN03

Note that blanks are permitted; DM will add one space and the selected 
file name(s) to the end of your defined symbol, and pass this to a 
subprocess.

There is one more "trick" to this: If you use :==, DM will save any 
changes you make with the <Gold> A menu for the duration of your login 
session.  If you use :=, DM will re-initialize to your defaults each 
time you re-enter DM.


Using a TPU-Based Editor

If the DM$Editor symbol is 'WPE' (or the DM$Viewer symbol is 'MORE'), DM 
expects to use a tpu-based editor.  This is very efficient (callable TPU 
is used, and no subprocess is involved).  You can control which edit 
interface (TPU Section File) is used by defining TPUSECINI in your 
LOGIN.COM file.

If you want to use the EVE interface, which is the default, you should 
make sure that TPUSECINI is not defined.

If you want to use the EDT interface;
     DEFINE TPUSECINI EDTSECINI

Consult the system manager if you want to use the WPE interface.

If you use a TPU-based editor other than EVE, EDT, or WPE, you may 
simply:
     DEFINE TPUSECINI disk:[directory]YOUR.TPU$SECTION
This definition you need may already have been made by your system 
manager.  In any case, the system manager can provide advice.


Highlighting

The DM Main and Tree displays normally highlight (bold) entries as your 
cursor moves through the display.  In certain circumstances, you may 
wish to disable this feature.  You might want to do this if your 
terminal does not support highlighting, or if you are using a slow 
communication rate (highlighting does take time).  To eliminate dynamic 
highlighting, set a symbol:

     $ DM$HIGHLIGHT :== N


Command String Options

If the SD (set/show default) utility is available on your system, SD 
commands may be included as parameters when DM is invoked.  For 
example:

     $ DM ^ ^
     $ DM .SUB1.SUB2

If this option is used, you will be returned to the original directory 
when you exit from DM.


Summary of DM Keys and Functions


Regular Keyboard Commands


(Listed in the order they appear on the "menu")
              
$	  -   Do a single DCL command (using Spawn).
%	  -   Do a single DCL command (in the context of the 
              current directory).
@	  -   Execute the selected .COM file.
*	  -   Show (and select from) SubDirectory Tree.
A/Z 	  -   Go to Top/Bottom of screen.
W	  -   Select a new wild-card for display of files.
T	  -   Tag a file - Used in D, C, P, R, <Gold> I, $, and %
U	  -   Untag a file.
Q	  -   Quit (Returning to starting directory).
X	  -   Exit (In currently-shown directory).
R	  -   Rename current file or tagged files.
V	  -   View current file, or GoTo .DIR
E	  -   Edit current file, or GoTo .DIR
F	  -   FMS
M	  -   Show all file information.
I	  -   Show information for selected files only.
L	  -   Show less information (file names only).
D	  -   Delete file(s)
C	  -   Copy file(s) [to another name or another directory].
G	  -   Purge the current files.
P	  -   Print file(s) on default printer.

<CTL> W	  -   Refresh screen.
S	  -   View.
?	  -   Help (on the normal keys)
!	  -   Read all saved messages.





Gold Commands

GOLD T - Go to the Top of the Directory.
GOLD B - Go to the Bottom of the Directory.
GOLD F, GOLD K - Quit.
GOLD G - Get file(s) [from another Directory].
GOLD H - Help.
GOLD SEARCH - (<Gold> ,) Find text string in file names.
GOLD CONTINUE SEARCH -  (<Gold> ,) Find previous string.
GOLD $ or [ - Go out to DCL for commands.
GOLD W - Copy files from this directory (write).
GOLD P - Print the DM Directory.
GOLD A - Change default editor, viewer, or printer.
GOLD D - Change to another disk device and/or directory.
GOLD I - DIR/FU on files.
GOLD M - VMS Mail




Keypad Functions

1) The inner keypad (with the arrow keys) works as it is labeled:

       Up and Down Arrows  Move the highlighted area. (Left and Right 
                           arrows do nothing)

       Find		   Search file names for a text string.

       Insert Here	   Copy files into this directory.

       Remove		   Delete file(s).

       Select		   Either Edit for a regular file, or "Go to 
                           this directory" for a .DIR file.

       Prev Screen	   Up a screen.

       Next Screen	   Down a screen.
 
2) The right keypad works a little like WPS+

       PF1		   Gold

       PF2		   Help

       PF3		   Find Next (Search)

       Upper Case (PF3)	   Go UP one directory in the tree. 

       Sel		   Either View (More) for a regular file, or "Go 
                           to this directory" for a .DIR file.

       Sent, Tab Pos,	   Go one line in current direction.
       Line, and Enter	    

       Para		   Go one screen in current direction.

       Backup, Advance	   Set direction and/or move one line.

       <Gold> PF3	   Find

       <Gold> Backup	   Go to top screen.

       <Gold> Advance	   Go to bottom screen.

3) Function keys F6 thru F16 have functions as follows:

    F6      F7      F8      F9      F10
 +-------+-------+-------+-------+-------+
 |DELETE |       |       |       |       |
 | THIS  |       |       |       | EXIT  |
 | FILE  |       |       |       |       |
 +-------+-------+-------+-------+-------+

                   F11     F12     F13     F14
                +-------+-------+-------+-------+
                |FORWARD| MOVE  |DELETE |       |
                |REVERSE|  UP   | FILE  |       |
                | TOGGLE|1 LINE |       |       |
                +-------+-------+-------+-------+

                                     F15         F16
                                  +-------+---------------+
                                  |       |               |
                                  | HELP  |      DO       |
                                  |       |               |
                                  +-------+---------------+
                                             DO = 1 DCL Command







KEY LABELS FOR VT2xx and VT3xx TERMINALS

The WPE labels are reproduced here.  Some of the functions (F6, F10-F13) 
labeled are similar to DM functions.

Reduce this page to about 74% to properly fit the key strip on VT2xx 
terminals.


+-----------+-----------+-----------+-----------+-----------+
|Delete Line|   Quote   | Cap Word  |           |           |
+-----------+-----------+-----------+           |    Exit   |    F6 -F10
|Undelete Ln|   Escape  |Upper Word |           |           |
+-----------+-----------+-----------+-----------+-----------+

+-----------+-----------+-----------+-----------+
|  Forward  |   Move    |Erase Word |  Insert/  |
|  Reverse  |    by     +-----------+Overstrike |                F11-F14
|  Toggle   |   Line    | Rub Sent. |  Toggle   |
+-----------+-----------+-----------+-----------+

+-----------+-----------+-----------+-----------+
|           | 2 Windows | Other Buf.|  Delete   | (Normal Functions)
| 1 Window  +-----------+-----------+    to     | -------------- F17-F20
|           | Get File  |  Buffer   |End of Line| (Gold Functions)
+-----------+-----------+-----------+-----------+

For VT300s and LK250 keyboards: (reduce to 65%)
+-------------+-------------+-------------+-------------+-------------+
| Delete Line |    Quote    |  Cap Word   |             |             |
+-------------+-------------+-------------+             |     Exit    |
|Undelete Line|    Escape   | Upper Word  |             |             |
+-------------+-------------+-------------+-------------+-------------+

+-------------+-------------+-------------+-------------+
|   Forward   |    Move     | Erase Word  |   Insert/   |
|   Reverse   |     by      +-------------+ Overstrike  |
|   Toggle    |    Line     |Rub Sentence |   Toggle    |
+-------------+-------------+-------------+-------------+

+-------------+-------------+-------------+-------------+
|             |  2 Windows  |Other Buffer |   Delete    |
|  1 Window   +-------------+-------------+     to      |
|             |  Get File   |   Buffer    | End of Line |
+-------------+-------------+-------------+-------------+