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, 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. 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 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 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. 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 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. DM 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 to enter the name of another device or directory. 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 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 P. Change the printer parameters by pressing 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 $, Do, or [. An "empty" 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 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 A. The changes you make will remain for the duration of your login session (even if you exit and re-enter DM). The 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 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 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 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, 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. 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 - ( ,) 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 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. 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 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 | +-------------+-------------+-------------+-------------+