User's Guide DM Version 7.1A (Directory Management Utility) April, 1987 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, K and 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 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: means to press the (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. 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 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, 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 W. You will be prompted for the file destination. To copy files into the current directory, press either 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 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 , (yes, the comma key) or the "Find" key. You will be prompted for the search string. For subsequent searches on the same string, press . (Cont Srch) or PF3. You may also press Find twice to search for the same string. 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 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, ). 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: in the following commands indicates that you should press the (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. T - Moves to the Top (first screen of files). 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. - 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 for the name of another device. A will leave you in the current device. You may change disk devices at any time by using 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. 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 P. 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 $, Do, or [. An "empty" 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 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, and Print Command. You can change these by pressing 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 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. 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.TPU$SECTION 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 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. 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, 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. 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. 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 - ( ,) Find text string in file names. GOLD CONTINUE SEARCH - ( ,) 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 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. PF3 Find Backup Go to top screen. 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 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) +-----------+-----------+-----------+-----------+