


                          User's Guide


                         DM Version 6.7A


                 (Directory Management Utility)

                         September, 1986




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 series terminals.  Your VT2xx setup must be 
some variant of VT2xx.  It should also work correctly with VT10x 
terminals.  With terminal emulators on PCs, and with 
VT100-lookalikes, you're on your own.  



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).













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].


COMMANDS

     Commands use the normal keys, keypad, and function keys.  
Where a normal key is specified, you may use either upper or 
lower case.


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 appropriate type).


TAGGING AND UNTAGGING FILES

     Files may be "Tagged" so that multiple files may be Deleted, 
Printed, 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.


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.


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> . 
or PF3.


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.

     If you get a single prompt character, you may usually use 
the Up Arrow to recall your last response to a question, and then 
edit it.

     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.


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 ready the [000000] level (if you have "read" access to the 
directory file).  After you reach the top level, DM will ask you 
for the name of another device.  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 of a new device.  This 
is also a quick way to get to the top level on the current 
device.

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


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.


EXECUTING .COM FILES

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


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> $ or <Gold> [.  An "empty" <CR> will return you 
to DM.


MESSAGES AND MAIL

     If you are sent a message by the system (e.g., mail 
notification), the message will appear at the bottom of the 
screen.  Only the last line of the message is shown.

     You may run VMS Mail (VaxMail) by pressing <Gold> M.  If you 
want to send mail, you will be using the EDT editor (limitation 
of VMS Mail).


CHANGING DEFAULTS

     When you enter DM, you will be given default values for DM's 
Editor, Viewer, and Print Command.  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).

     If the system defaults are not the ones you would like, the 
system manager can tell you how to re-define them in your 
LOGIN.COM file.


ATTACHED PRINTERS

     If you have an LA50 or LA100 (or equivalent) attached to 
your terminal, you can define DM's Print Command to use the 
attached printer.  Using the <Gold> A menu, set 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.  The applicable symbols are:

     DM$EDITOR
     DM$VIEWER
     DM$PRINT_COMMAND

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

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

     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.

                SUMMARY OF DM KEYS AND FUNCTIONS


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, Line, and Enter - Go one line in current
     		direction.
     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 F10 thru F16 have functions as follows:

    F6      F7      F8      F9      F10
 +-------+-------+-------+-------+-------+
 |       |       |       |       |       |
 |       |       |       |       | EXIT  |
 |       |       |       |       |       |
 +-------+-------+-------+-------+-------+

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

                                     F15         F16
                                  +-------+---------------+
                                  |       |               |
                                  | HELP  |      DO       |
                                  |       |               |
                                  +-------+---------------+
                                             DO = 1 DCL Command
                    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.
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, $, and % commands.
U   - Untag a file.
Q   - Quit (Returning to starting directory).
X   - Exit (In currently-shown directory).
R   - Rename current file.
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)


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.
GOLD I - DIR/FU on files.
GOLD M - VMS Mail




                 KEY LABELS FOR VT2xx TERMINALS

The existing WPE labels are reproduced here - applicable 
functions also work for DM.

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

+-----------+-----------+-----------+-----------+-----------+
|           |   Quote   | Cap Word  |           |           |
|  Cancel   +-----------+-----------+           |    Exit   |    F6 -F10
|           |   Escape  |Upper Word |           |           |
+-----------+-----------+-----------+-----------+-----------+

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

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

