% VAX-11 Librarian V04-00(@C7@\A5 DM@C71 DM Version 8.0A!=  Directory Management Utility  Version 8.0A? DM is a utility which allows you to more easily manage,; clean up, and otherwise work with your files and directory structure. , RUNNING DM: from the VMS prompt --  $ DM ? EXITING DM: from any "main" DM menu, just pressB  Q  (single character). [The F10 key, K and ; F also have the same effect]. You will b e returned to the@ directory from which you began DM. (If you want to stay: in the presently-displayed directory, press  X ). [ ON-LINE HELP: Run DM. Press  PF2 , the  Help  key, or  ?  !  2 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 of8 movement, the current directory, and the current wildcard . > On line 24 is a brief list of the single-character commands. ? Most commands work by placing the "highlighted" area onA the file of interest, and then doing the command. Some commands* also work using "# tagged" files.  !3 Answering_Questions!B 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. A If you get a single prompt character, you may usually u se the Up@ Arrow to recall your last response to a question, and then editC it. Recall and editing work similarly to the DCL recall function.@ If you are prompted to edit the present entry, you may do so or6 may use  U  to erase it and start over. A In some menus, you are not told how to exit the menu. Almost any, key will get you out (for instance, ).  !2 HelpA DM may seem complex, but complete help is available. TheA  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. 5 Press  Return  to return to the main screen. > [Note:   means to press the  PF1 # key, and then press another key]. 2 Commands! A Commands use the normal keys, keypad, and function keys. Where aB normal key is specified, you may use either upper or lower case. > [Note:    means to press the  PF1 # key, and then press another key].  ! 3 File_Information !  = 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.  A From either of these states, press  L  to get back to the regular display. B You may get "full" (DIR/FU) information on individual highlighted: files (or "tagged" files) by pressing  I .  !3 Editing_&_Viewing_FilesA To Edit or View a file (Viewing is read-only), use the followingA commands. Your system manager has selected a default editor and> viewer for your use. Note that you can't edit or view a .DIR file: !  E  - to Edit.!  V  - to View.M  Select  - to Edit (this is the function key "Select").I  Sel  - to View (this is KP. or "Sel"). G  F  - to FMS edit a file (of type FRM, FLG, or FLB).3 Tagging_And_Untagging_Files! = Files may be "Tagged" so that multiple files may be Deleted, Printed, or Copied. 6 To Tag a file, highlight it and press  T  6 (the # tag symbol will appear). : To Untag a file, highlight it and press  U . > Tags will "disappear" if you do some operation which requiresA reloading the directory (edit, view, $, %, etc.). Therefore, it< is best to do the tagging just before you do the associated operation.  !3 Deleting_Files_&_DirectoriesB Single highlighted files may be deleted by pressing  D  orL the  Remove  key or  F6  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. B Single and Tagged directories may be deleted in the same way. In1 this case, the entire directory tree is handled. : If you have already tagged some files, and wish to delete, a single file, press or  F6 .4 Wildcard_File_Deletes8 If the Wildcard is set to something other than '*', theA delete-directory function will delete only files. Therefore, to> delete all .LIS files, set the wildcard to '*.LIS', go to the. a ppropriate .DIR file, and press  D . @ To set 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. 3 Copying_Files? You may copy files (highlighted or tagged) from theB current directory. Press either  C  or  W .0 You will be prompted for the file destination. B To copy files into the current directory, press eitherA  G  or  Insert Here . You will be prompted? for the source file names. Any legal VMS filenames (including wildcards) will work. 3 Printing_FilesB You may print files (highlighted or tagged). Press  P  to> print files. The files will be printed on the default device& (see Defaults for how to change it). 3 Printing_The_DM_Directory? Print the DM directory (the screen display) by pressing  P . 3 Purging_Files; To purge files, press  G . Only the files shown byA DM will be purged. (See Functions for how to change your wildcard). 3 Renaming_FilesB You may rename single (highlighted) files by pressing  R .& You will be prompted for a new name. # You may also rename tagged files. * Any legal VMS "target" name may be used. 3 Executing_COM_FilesB .COM files may be executed by pressing  @ . The .COM file is executed in a subprocess. 3 Single_DCL_C ommands! B There are two environments for doing DCL commands from DM;> in a subprocess, and in the main process (outside DM).A 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 theA highlighted file in your DCL command by entering \ at the@ appropriate spot in the command. You may include tagged files by entering \\. B To do the DCL command in the main process, type  % . NoteB that your context is the current DM directory, and you may only do a single command.  !3 Multiple_DCL_CommandsB You may execute multiple commands (in the subprocess) by pressing>  $ ,  Do , or  [ . @ After you finish your commands, an "empty"  Return  will return you to DM. 3 Answering_Questions! B 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. A If you get a single prompt character, you may usually use the UpC Arrow to recall your last response(s) to a question, and then editC it. Recall and editing work similarly to the DCL recall function.@ If you are prompted to edit the present entry, you may do so or6 may use [7m U  to erase it and start over. A In some menus, you are not told how to exit the menu. Almost any, key will get you out (for instance, ).  ! 2 Movements < Use the Up and Down Arrow keys to highlight the file< names. There are about a dozen more ways to move within the8 directory, described under "Advanced_Movements" below. 7 To change directories, see the Between_Directories and$ Tree_Structure descriptions below. 3 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 B (KP3) key on the keypad. In this case the highlighted file makes no difference. 3 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 fir st 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  Find1  twice to search for the same string. 3 Advanced_MovementsB Because movements on the screen are the most frequent operations,@ there are many functions to simplify this job. (NOTE: inB the following commands in dicates that you should press the , (or PF1) key, and then press another key). C  A  - Moves the cursor to the top of the screen.F  Z  - Moves the cursor to the bottom of the screen.C  T  - Moves to the Top (first screen of files).E  B  - Moves to the Bottom (last screen of files).0  Prev  - Moves "Up" one screen.2  Next  - Moves "Down" one screen.F  F11  - Togg les the direction of movement (Fwd/Rev).E  Backup  - Sets movement to Reverse & moves 1 line Up.G  Advance  - Sets movement to Forward & moves 1 line Down.B  Return  - Moves one line in the present direction.J  Para  - (KP5) Moves one screen in the present direction.? There are a few more movement functions - see the on-line Help screens. 3 Tree_Structure! A You may display a schematic map of the subdirectories below your' current level by pressing  * . G Move around the display by using the arrow keys, and use  Sel  6 or  Return  to change your current directory. = This function has it's own help - accessed by pressing PF2.  !4 Help_For_Tree!- Arrow Keys - Move around in the tree.> Next Screen (VT2xx/3xx) - Move DOWN in Current Column.< Prev Screen (VT2xx/3xx) - Move UP in Current Column.Q Return/Select/Enter/Do - Select directory to "GoTo"./  Gold T  - Go to TOP of Current Column.2  Gold B  - Go to BOTTOM of Current Column.0  Gold Left-Arrow  - Go to First Column.7  Gold Right-Arrow  - Go to Last (right) Column.D  Gold P  - Print the Tree display (on your default printer)./  Gold A  - Change your default printer.3 Press any other key to exit from the Tree Display.! 3 Devices!> 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  Return  will" leave you in the current device. E 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. B If you have a "Rooted Directory" structure, DM will handle u pward movements. !3 Gold_D!= Pressing  Gold D  will present the "Enter New Device"2 menu. You may take any of the following actions: F Press Return - To move to the [000000] level of the current device.7 Edit the Device Name - To move to the [000000] level of the new device.< Enter a Directory [in brackets] - To move directly to the directory entered.; Press U, and then enter @USERNAME - To move to the login directory of a USER. 8 NOTE: E!ntering @USERNAME will fail if you do not have sufficient privilege.! 2 Functions! B 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. A If you get a single prompt character, you may usually use the Up@ Arrow to recall your last response to a question, and then editC it. Recall and editing work similarly to the DCL recall function.@ If you are prompted to edit the p"resent entry, you may do so or6 may use  U  to erase it and start over. A In some menus, you are not told how to exit the menu. Almost any, key will get you out (for instance, ).  ! 3 Wildcard@ To set 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. 3 Tree_Structure! A You may display a schematic map of the subdirectories below# your' current level by pressing  * . G Move around the display by using the arrow keys, and use  Sel  6 or  Return  to change your current directory. = This function has it's own help - accessed by pressing PF2.  !4 Help_For_Tree!- Arrow Keys - Move around in the tree.> Next Screen (VT2xx/3xx) - Move DOWN in Current Column.< Prev Screen (VT2xx/3xx) - Move UP in Current Column.R Return/Select/Enter/Do -$ Select directory to "GoTo"./  Gold T  - Go to TOP of Current Column.2  Gold B  - Go to BOTTOM of Current Column.0  Gold Left-Arrow  - Go to First Column.7  Gold Right-Arrow  - Go to Last (right) Column.D  Gold P  - Print the Tree display (on your default printer)./  Gold A  - Change your default printer.3 Press any other key to exit from the Tree Display.!3 Messages_And_Mail4 If you are sent a message by the system (e.g., mail< notif%ication), the message will appear at the bottom of theC screen. Only the last line of the notification message is shown. > You may run VMS Mail (VaxMail) by pressing  M . B If you send mail, you will normally be using the same mail editor? you usually use. If this is not the case, contact your system manager for help.2 Keys ! ; The regular keyboard is used for many DM functions.? Keypads and keys F10 thru F16 have functions which help you to use [1&mDM.  !3 Main_Keyboard4 REGULAR KEYBOARD COMMANDS8 (Listed in the order they appear on the "menu")4 $ - Do a single DCL command (using Spawn).P % - Do a single DCL command (in the context of the current directory).- @ - Execute the selected .COM file.7 * - Show (and select from) SubDirectory Tree.0 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.5 Q - Quit (Returning to starting directory).2 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.7 I - Show information for selected files only.6 L - Show less information (file names only(). D - Delete file(s)B 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 any saved messages.3 Inner_Keypad!? The inner keypad (with the arrow keys) works as it is labeled:D  Up  and  Down  Arrows move the highlighted area.) (Left ) and Right arrows do nothing)9  Find  - search file names for a text string.;  Insert Here  - Copy files into this directory.&  Remove  - Delete file(s).9  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.+ lqqqqqqqwqqqqqqqwqqqqqqqk+ x x COPY xDELETE x+ * x FIND x FILES xFILE(S)x+ x x IN x x+ tqqqqqqqnqqqqqqqnqqqqqqqu+ x EDIT x UP x DOWN x+ x OR x A x A x+ x GO TO xSCREEN xSCREEN x+ mqqqqqqqnqqqqqqqnqqqqqqqj# x x# x UP x# x x+ lqqqqqqqnqqqqqqqnqqqqqqqk+ x x + x x+ x x DOWN x x+ x x x x+ mqqqqqqqvqqqqqqqvqqqqqqqj!3 Right_Keypad!* The right keypad works a little like WPS+  PF1  - Gold  PF2  - Help&  PF3  - Find Next (Search)B  Upper Case  (KP3) - Go UP one directory in the tree. =  Sel  - Either View (More) for a regular file, or3 "Go to this directory" for a .DIR file.` ,[7m Sent ,  Tab Pos ,  Line , and  Enter  - Go one line in current direction.8  Para  - Go one screen in current direction.L  Backup ,  Advance  - Set direction and/or move one line.  PF3  - Find/  Backup  - Go to top screen.3  Advance  - Go to bottom screen.! 4 Diagram!3 lqqqqqqqwqqqqqqqwqqqqqqqwqqqqqqqk: x x x -FIND x x: x GOLD x HELP x NEXT x xA x x x FIND x x3 tqqqqqqqnqqqqqqqnqqqqqqqnqqqqqqqu3 x 1 x 1 x x x3 x LINE x LINE x x x3 x x x x x3 tqqqqqqqnqqqqqqqnqqqqqqqnqqqqqqqu3 x x 1 x x x3 x xSCREEN x . x x3 x x x x x3 tqqqqqqqnqqqqqqqnqqqqqqqnqqqqqqqu3 xBACKUP x 1 x GO UP x x3 x x LINE x ONE x x: x TOP x x DIR x 1 x3 tqqqqqqqvqqqqqqqnqqqqqqqu x3 x ADVANCE x VIEW x LINE x3 x x OR x x: x BOTTOM x GO TO x / x3 mqqqqqqqqqqqqqqqvqqqqqqqvqqqqqqqj!3 Function_Keys!6 Function keys F10 thru F20 have functions as follows:' F6 F7 F8 F9 F10, lqqqqqqqwqqqqqqqwqqqqqqqwqqqqqqqwqqqqqqqk, xDELETE x x x x x, x THIS x x x x EXIT x, x FILE x x x x x, mqqqqqqqvqqqqqqqvqqqqqqqvqqqqqqqvqqqqqqqj* F11 F12 F13 F14/ lqqqqqqqwqqqqqqqwqq 0qqqqqwqqqqqqqk/ xFORWARDx MOVE xDELETE x x/ xREVERSEx UP x FILE x x/ x TOGGLEx1 LINE x x x/ mqqqqqqqvqqqqqqqvqqqqqqqvqqqqqqqj* F15 F163 lqqqqqqqwqqqqqqqqqqqqqqqk3 x x DO x3 x HELP x (DCL) x: x x MULTIPLE DO x3 1 mqqqqqqqvqqqqqqqqqqqqqqqjB F17 F18 F19 F20G lqqqqqqqwqqqqqqqwqqqqqqqwqqqqqqqkG x x x x xN x x GET x x xN x x FILE x x xG mqqqqqqqvqqqqqqqvqqqqqqqvqqqqqqqj!3 GOLD_Commands 27 Press GOLD (PF1) and then another key...0 GOLD T - Go to the Top of the Directory.3 GOLD B - Go to the Bottom of the Directory.% GOLD F, GOLD K - Quit.6 GOLD G - Get file(s) [from another Directory]. GOLD H - Help.G GOLD SEARCH - ( ,) Find text string in file names.G GOLD CONTINUE SEARCH - ( .) Find previous string.8 GOLD $ or [ - Go out to DCL for commands.8 GOLD W3[m - Copy files from this directory (write).0 GOLD P - Print the DM Directory. ; GOLD A - Change default editor, viewer, or printer.< GOLD D - Change to another disk device or directory.! GOLD I - DIR/FU on files. GOLD M - VMS Mail! 3 Key_LabelsB Key strip labels for using DM with your VT2xx/3xx terminal/ should be available from your system manager. 2 Defaults? When you enter DM, you will be given default values for@  4[1mDM's Editor, Viewer, and Print Commands. 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, you may< re-define them in your LOGIN.COM file, or by using the Save option on the A menu. @ Defaults TPU, WPE, and MORE (Editor and Viewer) are "special" -? they should give you the system default ASCII edi 5tor. If not,> see your system manager for assistance. These defaults use a) callable editor and are most efficient. 3 HighlightingN The DM Main and Tree displays normally highlight (bold) entries6 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,A or if you are using a slow communication rate (highlighting does? take time). To eliminate6 dynamic highlighting, set a symbol:  $ DM$HIGHLIGHT :== N3 Saving_From_Gold_A = The  A  menu has an option which allows saving: the current settings for your Editor, Viewer, and Printer= parameters. If you use this option, a file is created which- saves the parameters between login sessions. > When you use DM, definitions are taken from this saved: file (if it exists). If not, the symbols defined in your> LOGIN.COM are used (if any), or the system 7defaults are used. '3 Re-Defining_Symbols_In_Your_LOGIN.COM= Normally, when you enter DM, you will be given systemB default values for DM's Editor, Viewer, and Print Command.> If you always want to use something different from the systemB defaults, you can establish your own defaults by creating symbols6 in your LOGIN.COM file. The applicable symbols are:  DM$EDITOR DM$VIEWER DM$PRINT_COMMAND DM$PRINTER_TYPE 4 ExamplesB For instance, you m8ight 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 DM$PRINTER_TYPE :== LN03 A Note that blanks are permitted; DM will add one space andA the selected file name(s) to the end of your defined symbol, and pass this to a subprocess. 4 Tricks: There is one more "trick" to this: If you use :==,@ DM w 9ill 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. 4 Attached_PrintersC If you have an LA50 or LA100 (or more recent DEC printer) attachedF to your terminal, you can define DM's Print Command to use theC attached printer. Using the  A  menu, set the Print$ Command to (spaces are important): A 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.2 Attached_PrintersC If you have an LA50 or LA100 (or more recent DEC printer) attachedF to your terminal, you can define DM's Print Command to use the? attached printer. Using the  A  menu, set Print$ Command to (spaces are impo;rtant): @ 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. 2 Wildcard@ To set 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. 2 Tree_Structure!< A You may display a schematic map of the subdirectories below your' current level by pressing  * . G Move around the display by using the arrow keys, and use  Sel  6 or  Return  to change your current directory. = This function has it's own help - accessed by pressing PF2.  !3 Help_For_Tree!- Arrow Keys - Move around in the tree.> Next Screen (VT2xx/3xx) - Move DOWN in Current Column.< Prev Screen (VT2xx/3xx) - Move UP in Current= Column.Q Return/Select/Enter/Do - Select directory to "GoTo"./  Gold T  - Go to TOP of Current Column.2  Gold B  - Go to BOTTOM of Current Column.0  Gold Left-Arrow  - Go to First Column.7  Gold Right-Arrow  - Go to Last (right) Column.D  Gold P  - Print the Tree display (on your default printer)./  Gold A  - Change your default printer.3 Press any other key to exit from the Tree Display.! 2 MessagesA Messa >ges 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. 4 If you are sent a message by the system (e.g., mailA notification), a notice 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 messagesA without leaving DM, press the ! key. NOTE: All of your messagesB will be scrolled; if yo?u have lots of messages, be ready with the "hold screen" key. 2 Mail> You may run VMS Mail (VaxMail) by pressing  M . B If you send mail, you will normally be using the same mail editor? you usually use. If this is not the case, contact your system manager for help. 2 Document!A For a hard-copy listing of the HELP text for DM, print the file: SYS$HELP:DM_USER_DOC.TXT C If you have access to an LN03 printer, you may use print the file:  SYS$HELP:D@M_USER_DOC.LN03 3 If you use WPS-PLUS (TM), you may import the file:  SYS$HELP:DM_USER_DOC.WPL! 2 SD_Commands!A If SD is installed on the system, you may enter any SD parameter$ after the DM command. For example:  $ DM ^ .SUB1 / Consult the SD documentation for instructions. 2 Credits? DM has been improved and submitted to DECUS by aA succession of writers including John C. Hayre, Rich Gregory, and Dale E. Coy. 3 Version < You can find out what version of DM you are using by pressing  ~ww