% VAX-11 Librarian V04-00^ N^ N5 SWING ^ N1 SWINGG SWING is a VAX/VMS utility for displaying the graphical representationI of directory trees on a VT100 or VT200 type terminal. It can be used toE move to a directory or subdirectory, as is done with the SET DEFAULTG command, and it can rename, move and delete subdirectories. SWING can9 also create hardcopy listings of a directory structure. H SWING takes one optional qualifier - START. This sets the root of the F directory tree to any directory that the us er desires. The directoryE is entered with the square brackets as with the SET DEFAULT command.E START may also be set to CURRENT in which case the default directory is the root directory.7 Simply type SWING[/START=directory] at the VMS prompt.G Limitations: SWING cannot handle directory trees with more than 3500 D directories, more than 8 levels deep, or that require more than 500 lines to display.2 Moving_aroundF Once SWING has drawn a picture of the default directory structu re theB cursor will be positioned at the current directory and it will beG highlighted. The arrow keys can be used to move from one subdirectoryD to another. As you travel around you are "setting default" to thatF directory. To exit simply type X, E, CONTROL-Z or ENTER and you will. return to VMS in the new directory location.  F As you move around with the arrow keys notice that the RIGHT, UP and I DOWN arrows take you to the first directory available in that direction J and that the LEFT arrow takes you to the parent of the current directory.H Typing B will take you to the bottom of the tree and typing T will take! you to the top (root directory).I Other commands can be entered to create, rename and move subdirectories,G as well as delete entire directory trees and get a hardcopy listing ofH the current directory structure. To get help on these various commands, enter the section of help called COMMANDS. 2 Save_fileH Every time SWING displays a directory tree it g ets its information fromG either searching the disk or from a save file called SWING.SAV locatedH in the main directory. If SWING is going to be used on a regular basisF it is advisable that the structure be saved in such a file. The SAVEG command will create a SWING.SAV file and from that point on SWING willG attempt to keep that file up-to-date. Having the save file will speedE up initialization so much that it might be tempting to use SWING for$ "setting default" all of the time.  H If the directory structure is changed in any way by SWING the save fileH will be updated automatically, but if a change has occurred without theA use of SWING it will be necessary to do a manual SAVE on the new directory tree. E NOTE: SWING does purge the save files located in the main directory,9 provided the current process has enough privilege. 2 CommandsB Commands can be entered by either hitting the first letter of theH commands located on the menu at the top of the screen  or by hitting theG CONTROL-P or DO keys and using the menu bar like a pulldown menu. TheG pulldown menu is operated by using the arrow keys to go to a selectionI and then hitting the ENTER key to choose that item. CONTROL-Z will exitI the pulldown menu without making a choice. Although the pulldown menu isB cute, hitting the first letter of the commands is by far a faster method. 3 CreateJ CREATE prompts the user for the name of a new subdirectory to be created.A The display will be  updated and an actual directory is created. 3 RenameJ RENAME prompts for a new name to be given to the current directory. The D display may change since the directories are in alphabetical order.3 MoveG MOVE initiates the move operation by blinking the current subdirectoryH and then the user is asked to move to the a new parent directory. WhenI either RETURN or ENTER is hit the move takes place. Both the new parentH and the directory being moved can have other subdirectories attached toF them as well. While moving to the new parent directory the operationE can be canceled by hitting any key besides the arrow keys, ENTER and RETURN. 3 DeleteH DELETE causes the current directory and all subdirectories below it to F be deleted automatically. The user is asked to enter YES before any C delete operation takes place and the word YES must be spelled out I completely. The deletion starts at the lowest subdirectory in the tree F and works its way back to the current direc tory. As files are being H deleted from a subdirectory that node will blink on the screen. If theJ subdirectory is successfully deleted the node name will blank out, so you9 can watch the directory tree being deleted graphically. F IMPORTANT: IF A FILE DOES NOT HAVE DELETE ACCESS FOR THE USER, SWING F WILL ATTEMPT TO CHANGE THE PROTECTION ON IT SO THAT IT CANB DELETE THE FILE (GIVEN THE PRIVILEGE OF THE USER ONLY)E If a particular subdirectory or file still can't be  deleted then theE deletion process will continue anyway, leaving the protected files. - A message will be given stating the problem.3 PrintG PRINT creates a file for printing that contains a hardcopy version of F the directory structure. One of two file types can be created. The H normal output is for any printer and the LQP input file is for running C through the LQP utility on a laser printer for a clean line drawn I representation of the directory tree. The file is called SWING.L IS and , it will be placed in the current directory.3 SaveG SAVE causes a new save file to be created in the main directory. The D save file is for speeding up the initialization of SWING. See the @ section called SAVE_FILE on the level of help above this level.3 OptionI OPTION lists addition facilities available in SWING. The desired optionI is selected by using the up- and down-arrows to position the cursor over! the option then pressing RETURN. 4 DCL CommandE This option allow s the user to execute any DCL at the prompt. SWINGB WILL NOT reflect changes made to the directory structure by theseE commands. This option is non-interactive and should not be used forE commands that do not return to the DCL prompt after completion. TheF output is printed in the DCL Command window and reverse scrolling is  not possible.B WARNING: THIS OPTION IS PRONE TO RANDOM BUGS. THE OUTPUT MAY NOTD MATCH THE OUTPUT SEEN AT COMMAND LEVEL. THIS OPTION MAY ALSO CAUSEC SWING TO HA NG. THIS CAN BE OVERCOME WITH A CTRL-Y BUT THE SUBPRO-@ CESS 'SWING_DCL_PROC' MUST BE STOPPED FOR FURTHER USE OF SWING.4 Display DirectoryI DISPLAY DIRECTORY causes an optional full directory specification to be I displayed at the top of the screen. The directory name will be modified6 each time the user moves to a new directory location.4 FILERF This is the file-management portion of the SWING utility. It can be C used to delete, edit, move, print, or rename files in the current  directory.B Limitations: The filer can only handle 500 files. If a directoryB contains more than 500 files, the first 500 are displayed and the rest are not available. 5 CommandsB Commands can be entered by either hitting the first letter of theD commands located on the menu at the top of the screen or by hittingF the control-P or DO keys and using the menu bar like a pulldown menu.A The pulldown menu is operated by using the arrow keys to go to a? selection and then hitting the ENTER key to choose that item. @ Control-Z will exit the pulldown menu without making a choice. D Although the pulldown menu is cute, hitting the first letter of the$ commands is by far a faster method.6 DeleteD DELETE causes the current file to be deleted. The user is asked toC enter YES before any delete operation takes place and the word YES must be spelled out completely.6 EditC EDIT invokes an editor with the current file as input. The editorB invoked is that specified in the logical name, SWING$EDIT. SWINGA looks for translations in the following tables, in the followingB order: LNM$PROCESS, LNM$JOB and LNM$SYSTEM. If this logical nameE is not defined, the default is TPU. When the user exits the editor,C control returns to the filer. Any new files created by the editor' will be displayed in the filer window.6 MoveE MOVE allows the user to move the current file to another directory. ? The user is asked to move the cursor to the new host directoryC using the arr ow keys. When either RETURN or ENTER is hit the fileC is moved. The operation may be aborted at any time by hitting any. key besides the arrow keys, RETURN, or ENTER.6 PrintC PRINT causes the current file to be sent to the printer defined byD SWING$PRINT. SWING looks for translations in the following tables,B in the following order: LNM$PROCESS, LNM$JOB, and LNM$SYSTEM. If9 this logical name is not defined, the default is $PRINT.6 RenameB RENAME prompts the user for a new name to b e given to the current> file. The display will reflect the change and keep the files listed in alphabetical order.6 OptionC This command allows for expansion of the filer. Available optionsA are listed in the pulldown menu and a selection is made by usingD the arrow keys to highlight the desired option then hitting RETURN. 7 DCL Command> This option allows the user to execute any DCL at the prompt.< SWING WILL NOT reflect changes made to the directory struc-< ture by these commands. This option is non-interactive and> should not be used for commands that do not return to the DCL; prompt after completion. The output is printed in the DCL6 Command window and reverse scrolling is not possible.> WARNING: THIS OPTION IS PRONE TO RANDOM BUGS. THE OUTPUT MAY= NOT MATCH THE OUTPUT SEEN AT COMMAND LEVEL. THIS OPTION MAY> ALSO CAUSE SWING TO HANG. THIS CAN BE OVERCOME WITH A CTRL-Y8 BUT THE SUBPROCESS 'SWING_DCL_PROC' MUST BE STOPPED FOR FURTHER USE OF SWING.6 QuitK QUIT causes the filer to be stored and returns control to SWING. The keys' Q, control-Z and ENTER quit the filer.3 ExitI EXIT causes the SWING to exit to the currently selected subdirectory or ; directory. The keys E, X, CONTROL-Z and ENTER exit SWING.ww