SWING USER GUIDE SWING USER GUIDE SWING USER GUIDE SWING USER GUIDE 17 March 1997 SWING USER GUIDE SWING USER GUIDE SWING USER GUIDE SWING USER GUIDE S.J.Brown S.J.Brown S.J.Brown S.J.Brown Riverside Glen Auldyn Ramsey Isle Of Man British Isles Version 3.7.6 Version 3.7.6 Version 3.7.6 Version 3.7.6 Copyright 1994, Harry Flowers and Foteos Macrides. It is free, and may be distributed as desired. SWING may not be sold. This manual was updated through v3.6 by: Chris Butler Chris Butler Chris Butler Chris Butler (C.Butler@MoF.Govt.NZ) Forest Research Institute Rotorua NEW ZEALAND It has been updated for later versions by: Foteos Macrides Foteos Macrides Foteos Macrides Foteos Macrides (MACRIDES@SCI.WFEB.EDU) Harry Flowers Harry Flowers Harry Flowers Harry Flowers (FLOWERS@NARNIA.MEMPHIS.EDU) SWING USER GUIDE SWING USER GUIDE SWING USER GUIDE SWING USER GUIDE Page I 17 March 1997 CONTENTS 1 INTRODUCTION . . . . . . . . . . . . . . . . . . . . 1 1.1 CAPTIVE ACCOUNTS . . . . . . . . . . . . . . . . . 1 1.2 MAINTAINERS . . . . . . . . . . . . . . . . . . . 2 1.3 WORKSTATIONS . . . . . . . . . . . . . . . . . . . 3 2 GETTING GOING . . . . . . . . . . . . . . . . . . . 4 2.1 SETTING UP LOGIN.COM . . . . . . . . . . . . . . . 4 2.2 USING SWING . . . . . . . . . . . . . . . . . . . 4 2.3 COMMAND QUALIFIERS . . . . . . . . . . . . . . . . 5 2.3.1 /HELP (or -H) . . . . . . . . . . . . . . . . . . 5 2.3.2 /VERSION (or -V) . . . . . . . . . . . . . . . . . 5 2.3.3 /FILEMANAGER (or -F) . . . . . . . . . . . . . . . 6 2.3.4 /0 (or -0) . . . . . . . . . . . . . . . . . . . . 6 2.3.5 /C (or -C) . . . . . . . . . . . . . . . . . . . . 6 2.3.6 /S (or -S) . . . . . . . . . . . . . . . . . . . . 7 2.4 DIRECTORY MANAGER . . . . . . . . . . . . . . . . 7 2.5 FILE MANAGER . . . . . . . . . . . . . . . . . . . 7 2.6 ANOTHER DIRECTORY STRUCTURE . . . . . . . . . . . 8 2.7 DEFINING AN EDITOR . . . . . . . . . . . . . . . . 8 2.8 CUSTOMISING KEYS . . . . . . . . . . . . . . . . . 9 2.9 THE DIRECTORY STACK . . . . . . . . . . . . . . . 9 2.10 NOW READ THE MANUAL . . . . . . . . . . . . . . 10 3 GENERAL INFORMATION . . . . . . . . . . . . . . . 11 3.1 USER DEFINABLE OPTIONS . . . . . . . . . . . . . 11 3.2 LOGICAL NAMES . . . . . . . . . . . . . . . . . 12 3.3 MOVING AROUND . . . . . . . . . . . . . . . . . 12 3.4 PANIC . . . . . . . . . . . . . . . . . . . . . 13 3.5 QUICK MENUS . . . . . . . . . . . . . . . . . . 13 3.6 SAVE FILE . . . . . . . . . . . . . . . . . . . 13 3.7 SNAPSHOTS . . . . . . . . . . . . . . . . . . . 14 3.8 VERSION . . . . . . . . . . . . . . . . . . . . 14 4 DIRECTORY MANAGER . . . . . . . . . . . . . . . . 15 4.1 BROADCAST MESSAGES . . . . . . . . . . . . . . . 15 4.2 CHANGE FILE OWNERSHIP . . . . . . . . . . . . . 15 4.3 CHANGE FILE PROTECTION . . . . . . . . . . . . . 15 4.4 CREATE . . . . . . . . . . . . . . . . . . . . . 15 4.5 DCL($) . . . . . . . . . . . . . . . . . . . . . 16 4.6 DEFRAGMENT FILES . . . . . . . . . . . . . . . . 16 4.7 DELETE . . . . . . . . . . . . . . . . . . . . . 16 4.8 DIRECTORY STATISTICS . . . . . . . . . . . . . . 17 4.9 EDIT NEW FILE . . . . . . . . . . . . . . . . . 18 4.10 HELP . . . . . . . . . . . . . . . . . . . . . . 18 4.11 IMPORT . . . . . . . . . . . . . . . . . . . . . 18 4.12 INSERT DIRECTORY STRUCTURE . . . . . . . . . . . 18 4.13 LIST DIRECTORY STRUCTURE . . . . . . . . . . . . 19 4.14 LOCATE FILE . . . . . . . . . . . . . . . . . . 19 4.15 MENU . . . . . . . . . . . . . . . . . . . . . . 19 4.16 MOVE . . . . . . . . . . . . . . . . . . . . . . 20 4.17 PURGE . . . . . . . . . . . . . . . . . . . . . 20 4.18 QUIT . . . . . . . . . . . . . . . . . . . . . . 20 4.19 REMOVE DIRECTORY STRUCTURE . . . . . . . . . . . 20 4.20 RENAME . . . . . . . . . . . . . . . . . . . . . 21 4.21 REPAINT (REFRESH) THE SCREEN . . . . . . . . . . 21 SWING USER GUIDE SWING USER GUIDE SWING USER GUIDE SWING USER GUIDE Page II 17 March 1997 4.22 RETURN TO MARK . . . . . . . . . . . . . . . . . 21 4.23 RE-SEARCH - REBUILD DIRECTORY STRUCTURE . . . . 21 4.24 SET MARK . . . . . . . . . . . . . . . . . . . . 22 4.25 SHOW DISK QUOTA . . . . . . . . . . . . . . . . 22 4.26 SNAPSHOT THE SCREEN . . . . . . . . . . . . . . 22 4.27 USER DEFINABLE OPTIONS . . . . . . . . . . . . . 23 4.28 WHERE - SHOW CURRENT DEFAULT DIRECTORY . . . . . 23 5 FILE MANAGER . . . . . . . . . . . . . . . . . . . 24 5.1 BROADCAST MESSAGES . . . . . . . . . . . . . . . 25 5.2 CHANGE FILE OWNERSHIP . . . . . . . . . . . . . 26 5.3 CHANGE FILE PROTECTION . . . . . . . . . . . . . 26 5.4 COPY . . . . . . . . . . . . . . . . . . . . . . 26 5.5 DCL($) . . . . . . . . . . . . . . . . . . . . . 26 5.6 DEFRAGMENT FILES . . . . . . . . . . . . . . . . 27 5.7 DELETE . . . . . . . . . . . . . . . . . . . . . 27 5.8 DIRECTORY DISPLAY FORMAT . . . . . . . . . . . . 27 5.9 EDIT A FILE . . . . . . . . . . . . . . . . . . 28 5.9.1 EDT . . . . . . . . . . . . . . . . . . . . . . 28 5.9.2 OTHER . . . . . . . . . . . . . . . . . . . . . 28 5.9.3 TPU . . . . . . . . . . . . . . . . . . . . . . 29 5.10 EDIT NEW FILE . . . . . . . . . . . . . . . . . 29 5.11 EXECUTE A FILE . . . . . . . . . . . . . . . . . 29 5.12 EXPORT . . . . . . . . . . . . . . . . . . . . . 30 5.13 HELP . . . . . . . . . . . . . . . . . . . . . . 30 5.14 IMPORT . . . . . . . . . . . . . . . . . . . . . 30 5.15 LIST (or PRINT) . . . . . . . . . . . . . . . . 30 5.16 MENU . . . . . . . . . . . . . . . . . . . . . . 31 5.17 MOVE . . . . . . . . . . . . . . . . . . . . . . 31 5.18 MOVING AROUND . . . . . . . . . . . . . . . . . 31 5.19 PRINT . . . . . . . . . . . . . . . . . . . . . 32 5.20 PURGE . . . . . . . . . . . . . . . . . . . . . 32 5.21 QUIT AND RETURN TO DIRECTORY MANAGER . . . . . . 32 5.22 RENAME . . . . . . . . . . . . . . . . . . . . . 32 5.23 REPAINT (REFRESH) THE SCREEN . . . . . . . . . . 33 5.24 RE-SEARCH - REBUILD FILE LIST . . . . . . . . . 33 5.25 SELECT FILES . . . . . . . . . . . . . . . . . . 33 5.26 SHOW DISK QUOTA . . . . . . . . . . . . . . . . 34 5.27 SNAPSHOT THE SCREEN . . . . . . . . . . . . . . 34 5.28 SUBMIT FILES TO BATCH . . . . . . . . . . . . . 34 5.29 TYPE . . . . . . . . . . . . . . . . . . . . . . 35 5.30 USER DEFINABLE OPTIONS . . . . . . . . . . . . . 35 6 RELEASE NOTES . . . . . . . . . . . . . . . . . . 35 6.1 Version 3.7.6 . . . . . . . . . . . . . . . . . 35 6.2 Version 3.7.5 . . . . . . . . . . . . . . . . . 36 6.3 Version 3.7.4 . . . . . . . . . . . . . . . . . 36 6.4 Version 3.7.3 . . . . . . . . . . . . . . . . . 37 6.5 Version 3.7.2 . . . . . . . . . . . . . . . . . 37 6.6 Version 3.7.1 . . . . . . . . . . . . . . . . . 37 6.7 Version 3.7.0 . . . . . . . . . . . . . . . . . 39 6.8 Version 3.6.5 . . . . . . . . . . . . . . . . . 39 6.9 Version 3.6.4 . . . . . . . . . . . . . . . . . 40 6.10 Version 3.6.3 . . . . . . . . . . . . . . . . . 40 6.11 Version 3.6.2 . . . . . . . . . . . . . . . . . 41 6.12 Version 3.6.1 . . . . . . . . . . . . . . . . . 42 SWING USER GUIDE SWING USER GUIDE SWING USER GUIDE SWING USER GUIDE Page III 17 March 1997 6.13 Version 3.6.0 . . . . . . . . . . . . . . . . . 42 6.14 Version 3.5.4 . . . . . . . . . . . . . . . . . 43 6.15 Version 3.5.3 . . . . . . . . . . . . . . . . . 43 6.16 Version 3.5.2 . . . . . . . . . . . . . . . . . 44 6.17 Version 3.5.1 . . . . . . . . . . . . . . . . . 45 6.18 Version 3.5.0 . . . . . . . . . . . . . . . . . 45 6.19 Version 3.4.0 . . . . . . . . . . . . . . . . . 46 6.20 Version 3.2.1 . . . . . . . . . . . . . . . . . 46 SWING USER GUIDE SWING USER GUIDE SWING USER GUIDE SWING USER GUIDE Page 1 INTRODUCTION 17 March 1997 INTRODUCTION INTRODUCTION INTRODUCTION ____________ ____________ ____________ ____________ 1 INTRODUCTION SWING is a powerful utility for the graphic display and manipulation of VMS directory structures on any terminal which supports the SMG (Screen Management) routines, e.g., the VTxxx series of terminals or any PC terminal emulation of a VTxxx. SWING is designed to make life easy for a user who frequently performs file or directory operations. It is designed with the philosophy of PC file management packages such as XTREE-GOLD and PCTOOLS, where the user need not know operating system commands to manage directories and files. SWING displays the top eight directory levels of the user's directory structure. If there are more than eight levels a diamond is displayed in the right-most column indicating that there are non-displayed directories. You can optionally specify the starting directories. These are the directory structures you wish to display and manipulate. The specifications may be separated by commas or spaces. e.g. $ Swing or $ Swing [.subdir] or $ Swing SYS$LOGIN or $ Swing SYS$LOGIN,SYS$EXAMPLES,SYS$LIBRARY or $ Swing SYS$LOGIN SYS$EXAMPLES SYS$LIBRARY There is a two level help facility within SWING. Quick menus are available via the ? option. Standard VMS help is available via hitting H (or the [Help] key on LK201 keyboards). Each SWING command description will have its equivalent DCL command (ie. the command you type at the '$' prompt), so that any existing VAX users can identify with the SWING command set. This is identified in the text as a line starting with 'DCL equiv:'. CAPTIVE ACCOUNTS CAPTIVE ACCOUNTS CAPTIVE ACCOUNTS ________________ ________________ ________________ ________________ 1.1 CAPTIVE ACCOUNTS If you are using Swing from a Captive Account, then a number of functions are disabled for security reasons. In particular, the goal was to prevent doing anything outside the current directory structure and disable execution of arbitrary DCL commands. If you see the following message, then this means that you are in a captive environment: The following functions have been disabled for Captive Accounts: Opt Description DirMgr FilMgr --- ----------- ------ ------ I Introduce dir structure Yes N/A SWING USER GUIDE SWING USER GUIDE SWING USER GUIDE SWING USER GUIDE Page 2 INTRODUCTION 17 March 1997 ^D User-defined Options Yes Yes (See note) $ Spawn Yes Yes S Submit to batch N/A Yes < Import files Yes Yes > Export files N/A Yes X Execute file N/A Yes Note that SWING$SAVE should point to a writable directory outside the user's directory structure. This allows the system administrator to configure the user's options file for choice of editor, queues, and key definitions. The user could change them if SWING$SAVE is accessible under their structure and compromise the setup by editing in key definitions. Disabling ^D while retaining the ability for the administrator to customize the key definitions is seen as a feature that must be used carefully. MAINTAINERS MAINTAINERS MAINTAINERS ___________ ___________ ___________ ___________ 1.2 MAINTAINERS CSwing was originally developed by Simon Brown from the British Isles during late 1989 from a previous FORTRAN version. He made substantial changes and produced about 95% of the C version. Since then, it has been maintained by a small group of people, scattered from one end of the earth to the other. If you have any bug reports, new feature requests, or have made changes to the software and wish it to be added into the next release, then please contact one of the following people: Harry Flowers Memphis State University Memphis, Tennessee Phone: +1 (901)678-2663 email: FLOWERS@MSUVX2.MEMST.EDU (on INTERNET) FLOWERS@MEMSTVX1 (on BITNET) Foteos Macrides Worcester Foundation for Experimental Biology Shrewsbury, Massachussetts Phone: +1 (508)842-8921 email: MACRIDES@SCI.WFEB.EDU (on INTERNET) MACRIDES@WFEB2 (on BITNET) Acknowledgements to the following people who developed and maintained the FORTRAN-version (from which intellectual content of the C-version was gained): Eric Andresen of General Research Corporation Craig Young of Hughes Aircraft Company Frank Nagy of Fermilab Walter Lamia of DIGITAL Equipment Corporation SWING USER GUIDE SWING USER GUIDE SWING USER GUIDE SWING USER GUIDE Page 3 INTRODUCTION 17 March 1997 Thanks also to the following people who have contributed to the development of the C-version over the last few years: Mats Akerberg (mats@exodata.se) Chris Butler (butlerc@fri.cri.nz) Charles Bailey (BAILEY@HMIVAX.HUMGEN.UPENN.EDU) Peter Chen (PETECHEN@CS.RUTGERS.EDU) Bill Forbes (BFORBES@MR4DEC.ENET.DEC.COM) Carl Karcher (KARCHER@WAISMAN.WISC.EDU) Mark London (MRL@NERUS.PFC.MIT.EDU) Tony McGrath (TMCG@PHYSICS.MONASH.EDU.AU) Bernd Onasch (ONASCH@IRA.UKA.DE) V. Phaniraj (PHANIRAJ@VTVM1.CC.VT.EDU) Terry Poot (TP@MCCALL.COM) Holger Teutsch (TEUTSCH@FFM-IW.DEGUSSA.DE) Butch Walker (Butch-Walker@uokhsc.edu) Nissim Etrog (ETROG1@vms.huji.ac.il) Richard Hardy (hardy@spike.wcc.govt.nz) Lars Bruun Hansen (Handelr@post3.tele.dk) and finally, to John E. Davis (DAVIS@PACIFIC.MS.OHIO-STATE.EDU), the author of MOST (from which our TYPE utility is derived). WORKSTATIONS WORKSTATIONS WORKSTATIONS ____________ ____________ ____________ ____________ 1.3 WORKSTATIONS SWING supports workstations to a limited extent. On a workstation it is possible to have windows with up to 64 lines. This is set via $ set term/page=64 SWING will support terminals of any size with the proviso that the terminal is set to at least 24 lines (the default for a VT100, VT200 ...). SWING USER GUIDE SWING USER GUIDE SWING USER GUIDE SWING USER GUIDE Page 4 GETTING GOING 17 March 1997 GETTING GOING GETTING GOING GETTING GOING _____________ _____________ _____________ _____________ 2 GETTING GOING Getting going with SWING is a painless exercise. Follow the steps below and you'll soon learn how to use the major features. SETTING UP LOGIN.COM SETTING UP LOGIN.COM SETTING UP LOGIN.COM ____________________ ____________________ ____________________ ____________________ 2.1 SETTING UP LOGIN.COM SWING ideally needs a directory in which it can keep its own data files. The default directory is SYS$LOGIN (your login directory), but the logical SWING$SAVE can be set to a different directory if desired. It is better to use SWING$SAVE than have your SYS$LOGIN directory cluttered with seemingly unintelligible files with weird filenames. If your default device and directory were MY_DISK:[MY_DEVICE], create a new directory MY_DISK:[MY_DEVICE.SWSAVE] via the DCL command $ create/dir MY_DISK:[MY_DEVICE.SWSAVE] Then put the following line in you login.com file: $ define/process/nolog SWING$SAVE MY_DISK:[MY_DEVICE.SWSAVE] Remember to change MY_DISK and MY_DEVICE to your actual default device and directory. Now you've done the hard work. Just invoke login.com (@SYS$LOGIN:LOGIN) or logout and login again to define the new SWING$SAVE logical. USING SWING USING SWING USING SWING ___________ ___________ ___________ ___________ 2.2 USING SWING Start swing by typing: $ SWING [Return] or SW, SWI or SWIN and SWING will start up. First of all SWING will create a user-defined options file in SWING$SAVE (or SYS$LOGIN if you decided not to define SWING$SAVE). Then SWING will search your current directory structure, make a record of it in SWING$SAVE, and display your structure on the screen. You'll immediately see the difference between SWING and DCL - your directory structure is shown in 1990s' fashion for the first time! You are now using the DIRECTORY MANAGER. SWING USER GUIDE SWING USER GUIDE SWING USER GUIDE SWING USER GUIDE Page 5 GETTING GOING 17 March 1997 COMMAND QUALIFIERS COMMAND QUALIFIERS COMMAND QUALIFIERS __________________ __________________ __________________ __________________ 2.3 COMMAND QUALIFIERS The following Swing qualifiers (or switches) can be used at DCL: /HELP (or -H) /HELP (or -H) /HELP (or -H) _____________ _____________ _____________ _____________ 2.3.1 /HELP (or -H) This qualifier displays help for the Swing command line (from DCL) and then returns the user back to DCL. e.g. $ SW /H or $ SW -H It may return the following information. Usage: swing -h Show this Help. swing -v Show Version of this program. swing[ -f][ -0][ -s][ -c][ dir][,dir...] -f Start up directly in the File manager. -0 Look for and use a device_000000_SWSVE.DAT file if a device_directory_SWSVE.DAT file is not found in the SWING$SAVE directory. -s Exits in SYS$SPECIFIC restore SYS$SYSROOT as the default dir. -c Exits in SYS$COMMON restore SYS$SYSROOT as the default dir. dir Use VMS syntax including brackets (e.g., [topdir.subdir] or device:[topdir.subdir] or [.subdir]). You can also use logical dir names (e.g., SYS$EXAMPLES). If a dir is not specified, your current default is assumed. However, if any of the command line qualifiers have been installed as defaults for Swing, they are not included in the help display. /VERSION (or -V) /VERSION (or -V) /VERSION (or -V) ________________ ________________ ________________ ________________ 2.3.2 /VERSION (or -V) This qualifier displays the current version of Swing, and then returns the user to DCL. e.g. $ SW /V or $ SW -V It returns the following string: C SWING v3.7.6 (S.J.Brown, M.Akerberg, H.Flowers, F.Macrides & others) SWING USER GUIDE SWING USER GUIDE SWING USER GUIDE SWING USER GUIDE Page 6 GETTING GOING 17 March 1997 /FILEMANAGER (or -F) /FILEMANAGER (or -F) /FILEMANAGER (or -F) ____________________ ____________________ ____________________ ____________________ 2.3.3 /FILEMANAGER (or -F) This command qualifier takes the user directly into the File Manager Screen and bypasses the Directory Manager. e.g. $ SW /F or $ SW -F /0 (or -0) /0 (or -0) /0 (or -0) __________ __________ __________ __________ 2.3.4 /0 (or -0) This command qualifier directs Swing to look for a master (total device) SAVE_FILE if it does not find an SWSVE.DAT file for the root directory structure. e.g. $ SW /0 or $ SW -0 It is of relevance only to system managers, who would have the privileges required to access a total device tree. /C (or -C) /C (or -C) /C (or -C) __________ __________ __________ __________ 2.3.5 /C (or -C) This command qualifier directs Swing to make SYS$SYSROOT the default device if you exit in a SYS$COMMON tree, and such a tree has been put up via an argument or logical translation that had SYS$SYSROOT as the device. e.g. $ SW /C or $ SW -C When you use a logical such as SYS$EXAMPLES as a directory specification on the DCL command line, it is translated to: $ SW SYS$SYSROOT:[SYSHLP.EXAMPLES] The SYS$SYSROOT device name is, in turn, a logical for two devices, SYS$SPECIFIC and SYS$COMMON. In effect, you have entered a command equivalent to: $ SW SYS$SPECIFIC:[SYSHLP.EXAMPLES],SYS$COMMON:[SYSHLP.EXAMPLES] so that two directory trees are created. The files of interest to general users are in the SYS$COMMON tree, whereas most of those in the SYS$SPECIFIC tree are privileged, for use by the system manager. If you enter the SYS$COMMON tree to examine or use its files, and subsequently exit from Swing in that tree, your default device normally would become SYS$COMMON. SWING USER GUIDE SWING USER GUIDE SWING USER GUIDE SWING USER GUIDE Page 7 GETTING GOING 17 March 1997 Note that the /C or -C qualifier will apply for all SYS$COMMON trees if any have been put up via a SYS$$SYSROOT argument or translation, but not if all were put up via explicit SYS$COMMON:[directory] arguments. /S (or -S) /S (or -S) /S (or -S) __________ __________ __________ __________ 2.3.6 /S (or -S) This command qualifier directs Swing to make SYS$SYSROOT the default device when you exit in a SYS$SPECIFIC tree, and such a tree had been put up via an argument or logical translation that had SYS$SYSROOT as the device. e.g. $ SW /S or $ SW -S See the description of the /C or -C qualifier for more information. Note that the /S or -S qualifier will apply for all SYS$SPECIFIC trees if any have been put up via a SYS$$SYSROOT argument or translation, but not if all were put up via explicit SYS$SPECIFIC:[directory] arguments. DIRECTORY MANAGER DIRECTORY MANAGER DIRECTORY MANAGER _________________ _________________ _________________ _________________ 2.4 DIRECTORY MANAGER Try the cursor keys. You will find that you can move around your structure as easily as you can edit a file. Good-bye SET DEFAULT. Try typing T, B, N (or press [Next Screen]), P (or press [Prev Screen]) as you wish - see how you move around the structure. See Section 3.3 "Moving Around" for more info. Although this part of the manual will not describe all the features of SWING, we'll run through a few of them here. Move to your top directory (that's where we started all this). Type F. The display changes... FILE MANAGER FILE MANAGER FILE MANAGER ____________ ____________ ____________ ____________ 2.5 FILE MANAGER You are now in the FILE MANAGER - you now see all the files in your top directory. You can also navigate around the FILE MANAGER with up-arrow, down-arrow, T, B, N (or press [Next Screen]), P (or press [Prev Screen]) as you wish - see how you move around the file list. You can change the format of the directory information on display by using the left- and right-arrows or typing in directly the format you desire - in the range 0 to 9. Try it and see. SWING USER GUIDE SWING USER GUIDE SWING USER GUIDE SWING USER GUIDE Page 8 GETTING GOING 17 March 1997 Now we'll leave the FILE MANAGER and return to the DIRECTORY MANAGER by typing Q (for quit). ANOTHER DIRECTORY STRUCTURE ANOTHER DIRECTORY STRUCTURE ANOTHER DIRECTORY STRUCTURE ___________________________ ___________________________ ___________________________ ___________________________ 2.6 ANOTHER DIRECTORY STRUCTURE You can see more than just your own directory structure - you can add directory structures for other users in your group to the display. The way to do this is by typing I (or press [Insert Here]) to insert another structure. You'll be prompted for a directory specification. For example, type SYS$EXAMPLES and you will see the directory structures of [SYSHLP.EXAMPLES] for the SYS$SPECIFIC device (which general users should avoid), and for SYS$COMMON, which is where many general user help and example files for VMS and layered products live. You are also able to do the same to your application directories or other users directories who you are able to share data with. File security is always maintained through normal UIC or identifier protections. You now have three structures on display. You can move among them as you wish. A quick inter-structure hop can be made by moving to the left-most column and pressing the up- and down-arrow keys to move up and down the display. When you've had enough of (say the) SYS$EXAMPLES structures, you can remove them from your display. To do this, for each of those structures move to any directory in it and press the [Remove] key (also above the cursor keys) (or type k). You'll be prompted to check that you wish to remove this structure from the display - type Y, and the structure will disappear. When both of those structures are removed you'll be back in your own directories. DEFINING AN EDITOR DEFINING AN EDITOR DEFINING AN EDITOR __________________ __________________ __________________ __________________ 2.7 DEFINING AN EDITOR You can edit files with SWING when you're in the FILE MANAGER. Before you do so it's best to define the editor you wish to use. It's not essential that you define your editor first, as SWING will prompt you for the name of the editor you wish to use. Type ^D (Ctrl/D). The USER-OPTIONS window appears. A few lines down there is an entry for the editor that will be invoked whenever you decide to edit a file. Use the down-arrow key to move to this line, and press the [Space Bar]. You'll now be prompted for the editor you prefer. If you prefer the EDT editor enter EDT, if you prefer the Text Processing Utility (EVE, or your personal or site-specific flavour) enter TPU. Now type E to return to the DIRECTORY MANAGER and then F to enter FILE MANAGER. You're now ready to edit your first file with SWING. SWING USER GUIDE SWING USER GUIDE SWING USER GUIDE SWING USER GUIDE Page 9 GETTING GOING 17 March 1997 Move the cursor ('->' on the left-hand side of the screen) so that it appears by the file you wish to edit, type E and you'll be in the editor. Exit from the editor as you would normally do and you're back at the file manager screen. CUSTOMISING KEYS CUSTOMISING KEYS CUSTOMISING KEYS ________________ ________________ ________________ ________________ 2.8 CUSTOMISING KEYS You can define any of the grey keys on the top of the keyboard (F6 - F20) and the numeric keypad on the right of the keyboard (PF1 - PF4, 0 - 9, the MINUS, COMMA and ENTER keys) as you wish. Here we will define F11 to perform a SHOW USERS. Type ^D (Ctrl/D) by holding down the 'Ctrl' key (on the left hand side of the keyboard, and while holding it down, hit the letter D). The USER-OPTIONS window appears. Move down the window, and you'll come to the entry "func. key F11". Press the [Space Bar], and enter: SHOW USERS ! [Return] The ! is explained later in this manual. Then type E to leave the USER-OPTIONS. Press F11, and you'll be prompted to confirm a SHOW USERS command. Type Y, and you'll see that a new window appears in which your SHOW USERS command executes. Press any key to return to the File Manager screen. THE DIRECTORY STACK THE DIRECTORY STACK THE DIRECTORY STACK ___________________ ___________________ ___________________ ___________________ 2.9 THE DIRECTORY STACK SWING maintains a stack of directories as they are `visited'. A directory is said to be `visited' when the File Manager is invoked in that directory. It is possible to cycle through these directories in both the Directory Manager and the File Manager using the [Select] and [Find] keys (on LK201 keyboards) thus reducing keystrokes to move between your favourite directories. SELECT moves you to the directory `visited' prior to the currently displayed directory, FIND moves you to the directory you `visited' prior to the currently displayed directory (i.e. undoes the last SELECT). The directory you are in goes to the top of the stack when you perform any operation in the FILE MANAGER other than SELECT or FIND. A directory disappears from the stack either when the FILE MANAGER detects that there are no files in the directory or when a more recently accessed directory pushes this directory off the stack. SWING USER GUIDE SWING USER GUIDE SWING USER GUIDE SWING USER GUIDE Page 10 GETTING GOING 17 March 1997 Thus the stack is ordered with the most recently used directories at the top. Pressing [Select] when at the bottom of the stack takes you to the top of the stack, similarly pressing [Find] when at the top of the stack takes you to the bottom of the stack. NOTE The stack is not saved between invocations of SWING. NOW READ THE MANUAL NOW READ THE MANUAL NOW READ THE MANUAL ___________________ ___________________ ___________________ ___________________ 2.10 NOW READ THE MANUAL You're under way. Now read the rest of this manual, trying the commands as they are described. I hope you find SWING a labour-saving utility. Don't forget the ? quick menus and the help file which is invoked by pressing the [Help] key. SWING USER GUIDE SWING USER GUIDE SWING USER GUIDE SWING USER GUIDE Page 11 GENERAL INFORMATION 17 March 1997 GENERAL INFORMATION GENERAL INFORMATION GENERAL INFORMATION ___________________ ___________________ ___________________ ___________________ 3 GENERAL INFORMATION Commands are invoked by entering the single keystroke associated with the command. Some of the commands use the LK201 keyboard keys found above the `arrow keys' on the LK201 keyboard. Typical examples are PREV SCREEN and NEXT SCREEN. USER DEFINABLE OPTIONS USER DEFINABLE OPTIONS USER DEFINABLE OPTIONS ______________________ ______________________ ______________________ ______________________ 3.1 USER DEFINABLE OPTIONS Enter ^D (Ctrl/D) This will display the USER-OPTIONS window. The user is able to define: 1. The initial display format when the FILE MANAGER is invoked for the first time. 2. The default printer queue for files printed via SWING. 3. The default batch queue for files submitted by SWING. 4. The editor used by SWING when editing files. 5. The LK201 function keys F7 through F20 (top of the keyboard) and all the keys on the LK201 numeric keypad (right-hand side). To change an entry in the USER-OPTIONS window move the cursor opposite the entry to be changed and press the [Space Bar]. The entry being changed is highlighted. When the next definition is complete press [Return]. The original value can be restored by using the R option. When a user-definable key is entered in the File Manager the name of the current file will be added to the command to be executed. If this is not desirable for the specific command (e.g. the key has been defined as SHOW USERS, and no filename is required) the definition of the key should terminate with an ! (exclamation mark). NOTE No file name is added when a user-definable key is entered in the Directory Manager. Normally, the user will be prompted to confirm that the command is to be processed. If this extra confirmation is not felt necessary a ^ ([Shift] 6) can be appended to the key definition. When a key defined in this manner is pressed the command will execute IMMEDIATELY. So be careful with this option. SWING USER GUIDE SWING USER GUIDE SWING USER GUIDE SWING USER GUIDE Page 12 GENERAL INFORMATION 17 March 1997 NOTE The ! and ^ should not be used with the editor or queue definitions. The settings are saved in either SYS$LOGIN:SWING_OPTIONS.INITIAL or SWING$SAVE:SWING_OPTIONS.INITIAL if SWING$SAVE is defined. LOGICAL NAMES LOGICAL NAMES LOGICAL NAMES _____________ _____________ _____________ _____________ 3.2 LOGICAL NAMES The following logical names are used by SWING SWING$SAVE - see also SWING SAVE_FILE. This specifies the destination for the files created by SWING. It is recommended you define this logical if you want SWING's working files kept in a separate directory to your login directory. See the manual's section 2.1 (Setting up LOGIN.COM) for more details. SWING$HLP - defined when the system boots to point to the SWING help files. Do not change this. MOST_HELP - defined when the system boots to point to the MOST Full Help file. Do not change this. CSWING$USERCOMMAND - can be predefined as a setup option. If it is defined, then the command G (or g) in the file manager will cause a scratch file to be written and to have all selected filenames written to it, one per line with newline between, and the user command defined in the logical will be executed via a system() call with the filename of the scratch file passed as an argument on the command line. Thus it can be picked up by a DCL script or by a program. This is provided so that Swing can be used as a file selector front end for pretty much anything you like. It is of course up to the application to ensure that the selected file or directory names (or both) are passed to any images called in pieces that can be used. After the user application is done, the scratch file is deleted. MOVING AROUND MOVING AROUND MOVING AROUND _____________ _____________ _____________ _____________ 3.3 MOVING AROUND The user may move around the displayed directory structure using the four `arrow-keys', or: ^J to move up, SWING USER GUIDE SWING USER GUIDE SWING USER GUIDE SWING USER GUIDE Page 13 GENERAL INFORMATION 17 March 1997 ^K to move down, ^H to move left, ^L to move right, N, n or [Next Screen] to advance by one screen, P, p or [Prev Screen] to move back by one screen, T, t to move to Top of the current structure, or if already at the top then to the top of the previous structure (if there is one), B, b to move to Bottom of the current structure, or if already at the bottom then to the bottom of the next structure (if there is one) and [Select] and [Find] (LK201 keyboard) can be used to move around an internally held stack of `visited' directories. A directory becomes `visited' when the user invokes the FILE MANAGER in this directory. SELECT moves forward, FIND backward. PANIC PANIC PANIC _____ _____ _____ _____ 3.4 PANIC PANIC - Control-C or Control-Y gets you out of SWING in a hurry, saving the current directory structure if necessary as it does so. QUICK MENUS QUICK MENUS QUICK MENUS ___________ ___________ ___________ ___________ 3.5 QUICK MENUS Enter ? Quick menus are available throughout SWING whenever the top line of the display shows a ?. The user can select the required option directly from this menu. SAVE FILE SAVE FILE SAVE FILE _________ _________ _________ _________ 3.6 SAVE FILE SWING only searches the directory structure if a save file cannot be found. SWING looks 1) first in SWING$SAVE:, 2) second in the top directory of the structure being examined, 3) third in SYS$LOGIN:. If no save file is found SWING searches the directory structure and creates a save file, attempting to store the save file as above. SWING automatically attempts to purge old save files. All save file names end in SWSVE.DAT. SWING USER GUIDE SWING USER GUIDE SWING USER GUIDE SWING USER GUIDE Page 14 GENERAL INFORMATION 17 March 1997 NOTE It is recommended that you make use of SWING$SAVE, as this way you can keep all the files created by SWING in one place. SNAPSHOTS SNAPSHOTS SNAPSHOTS _________ _________ _________ _________ 3.7 SNAPSHOTS Enter * Throughout SWING a snapshot of the screen may be taken. The resulting file is written to SWING$SAVE if this is defined. If not, then it is written to SYS$LOGIN. Screen snapshot filenames are of the form: SNAPSHOT_xxxxxx.LIS, where xxxxxx is a selection of unique letters and numbers chosen by SWING, to make the snapshot file unique. Since the special characters used to draw lines cannot always be displayed in a file, the device-independent characters (+,-,|) are used to draw lines. VERSION VERSION VERSION _______ _______ _______ _______ 3.8 VERSION Enter V or v Entering V causes the current version of SWING to be displayed on the bottom line of the display. SWING USER GUIDE SWING USER GUIDE SWING USER GUIDE SWING USER GUIDE Page 15 DIRECTORY MANAGER 17 March 1997 DIRECTORY MANAGER DIRECTORY MANAGER DIRECTORY MANAGER _________________ _________________ _________________ _________________ 4 DIRECTORY MANAGER BROADCAST MESSAGES BROADCAST MESSAGES BROADCAST MESSAGES __________________ __________________ __________________ __________________ 4.1 BROADCAST MESSAGES Enter O or o (Old Broadcast Messages) BROADCAST MESSAGES are trapped by SWING and displayed in a separate window. This window can be recalled at any time if required. Broadcast messages are issued when new mail is received (for example). This window is automatically displayed when there are outstanding messages and the user is in the directory manager or file manager and is also currently being prompted for input. CHANGE FILE OWNERSHIP CHANGE FILE OWNERSHIP CHANGE FILE OWNERSHIP _____________________ _____________________ _____________________ _____________________ 4.2 CHANGE FILE OWNERSHIP Enter ~ (Tilde) This option allows the user to change the ownership of the files contained in the selected directories. Sub-directories are also changed. The user is able specify the new file owner. DCL equiv: SET FILE/OWNER=new-owner [...]*.*;* CHANGE FILE PROTECTION CHANGE FILE PROTECTION CHANGE FILE PROTECTION ______________________ ______________________ ______________________ ______________________ 4.3 CHANGE FILE PROTECTION Enter @ This option allows the user to change the protection on the files contained in the selected directories. Sub-directories are also changed. The user is able specify the new file protection, being initially prompted with the current default file protection. DCL equiv: SET PROTECTION=(protection-mask) [...]*.*;* CREATE CREATE CREATE ______ ______ ______ ______ 4.4 CREATE Enter C or c Create allows the user to create a new sub-directory. The user is prompted for the new directory name. It is not possible to create more than eight directory levels. The name of the directory must be valid. Invalid names are automatically rejected by SWING. DCL equiv: CREATE/DIRECTORY [.directory-name] SWING USER GUIDE SWING USER GUIDE SWING USER GUIDE SWING USER GUIDE Page 16 DIRECTORY MANAGER 17 March 1997 DCL($) DCL($) DCL($) ______ ______ ______ ______ 4.5 DCL($) Enter $ DCL spawns a sub-process in the user's current directory (as shown by the main SWING display). All symbols are inherited from the parent process, however the DCL tables will be taken from sys$system, hence any additions made to the DCL tables will not be present in this sub-process. LOGOUT when finished. DEFRAGMENT FILES DEFRAGMENT FILES DEFRAGMENT FILES ________________ ________________ ________________ ________________ 4.6 DEFRAGMENT FILES Enter % Defragmentation allows the user to defragment the files in a directory structure. The directories that will be (potentially) defragmented are displayed with a different rendition. The user is twice prompted to confirm that the directories selected and their contents are to be defragmented. The contents of the files that are processed will be made as contiguous as possible. No header information (other than the pointers in the header) will be changed. The file fragmentation is shown in the FILE MANAGER via directory format 8. If pointers are greater than 1 then the file is unnecessarily fragmented, and potentially degrading the system performance when accessed. DCL equiv: COPY/CONTIGUOUS/REPLACE [...]*.*;* [...]*.*;* DELETE DELETE DELETE ______ ______ ______ ______ 4.7 DELETE Enter D or d Delete allows the user to delete a directory structure. The directories that will be (potentially) deleted are displayed with a different rendition. The user is twice prompted to confirm that the directories selected and their contents are to be deleted. This command may not be entered from the top (root) directory. DCL equiv: DELETE/LOG [...]*.*;* repeatedly until all files and subdirectories are removed. SWING USER GUIDE SWING USER GUIDE SWING USER GUIDE SWING USER GUIDE Page 17 DIRECTORY MANAGER 17 March 1997 NOTE SWING will only delete files that the user could otherwise delete via the DCL commands SET PROTECTION and DELETE. DIRECTORY STATISTICS DIRECTORY STATISTICS DIRECTORY STATISTICS ____________________ ____________________ ____________________ ____________________ 4.8 DIRECTORY STATISTICS Enter ! SWING can display statistics relating to the contents of files in a series of directories. The statistical information available is 1. Count of the blocks allocated to files in a directory (option A). 2. Count of the blocks used by files in a directory (option U). 3. Count of the number of files in a directory (option C). 4. Maximum file-size of the files in a directory (option M). 5. Fragmentation index for a directory (option I). This is the ratio of fragments to files. A ratio of 1.0 is perfect - only one fragment per file. A grand statistical total can be shown by using option G. This information is shown at the bottom of the screen. The statistics can be updated via the S option. This is necessary after new files have been added to directories, for example. The statistical display can be printed via the L option. All statistics are grouped together with the directory name. This is an extremely useful option if you want to manage directories. The resulting file is written to SWING$SAVE if this is defined. If not, then it is written to SYS$LOGIN. Screen snapshot filenames are of the form: SWING_LISTING_FILE_xxxxxx.LIS, where xxxxxx is a selection of unique letters and numbers chosen by SWING to make the snapshot file unique. The user can select between a Narrow (80 columns) or Wide (132 columns) report. DCL equiv: DIRECTORY/SIZE=ALL [...]*.*;* and a number of other qualifiers SWING USER GUIDE SWING USER GUIDE SWING USER GUIDE SWING USER GUIDE Page 18 DIRECTORY MANAGER 17 March 1997 EDIT NEW FILE EDIT NEW FILE EDIT NEW FILE _____________ _____________ _____________ _____________ 4.9 EDIT NEW FILE Enter ^E (Ctrl/E) This allows the user to edit a new file. The user may define the default editor as per the EDIT option. DCL equiv: EDIT HELP HELP HELP ____ ____ ____ ____ 4.10 HELP Enter H, h (or [Help] on LK201 keyboards) Help allows the user access to this information. The full VAX help features are available. IMPORT IMPORT IMPORT ______ ______ ______ ______ 4.11 IMPORT Enter < Import is like copy, except that the user is able to specify a full DECnet file specification for the file to be copied into the current directory, e.g. NODE"user password"::filespec The percentage file transfer is displayed while the transfer is in progress to bolster the confidence of the user. DCL equiv: COPY/LOG full-filespec 4 INSERT DIRECTORY STRUCTURE 4 INSERT DIRECTORY STRUCTURE 4 INSERT DIRECTORY STRUCTURE __________________________ __________________________ __________________________ __________________________ 4.12 INSERT DIRECTORY STRUCTURE E E E Enter I, i or [Insert Here] (LK201 keyboard) The user can add another structure to the display. The user is prompted for the device and directory specification of the structure to be added. There is no restriction to the number of structures that may be displayed at the same time. Each structure may only be displayed once. SWING USER GUIDE SWING USER GUIDE SWING USER GUIDE SWING USER GUIDE Page 19 DIRECTORY MANAGER 17 March 1997 LIST DIRECTORY STRUCTURE LIST DIRECTORY STRUCTURE LIST DIRECTORY STRUCTURE ________________________ ________________________ ________________________ ________________________ 4.13 LIST DIRECTORY STRUCTURE Enter ^G (Ctrl/G) This creates a file which graphically displays the directory structure as you see it on the DIRECTORY MANAGER screen. The resulting file is written to SWING$SAVE if this is defined. If not, then it is written to SYS$LOGIN. Screen snapshot filenames are of the form: SWING_LISTING_FILE_xxxxxx.LIS, where xxxxxx is a selection of unique letters and numbers chosen by SWING to make the snapshot file unique. The user can select between a Narrow (80 columns) or Wide (132 columns) report. Since the special characters used to draw lines cannot always be displayed in a file, the device-independent characters (+,-,|) are used to draw lines. The files may subsequently be printed via the list files option in the file manager. DCL equiv: none really (perhaps a DIRECTORY/LIST [...]) LOCATE FILE LOCATE FILE LOCATE FILE ___________ ___________ ___________ ___________ 4.14 LOCATE FILE Enter L This allows the user to find a file based on a partial file specification. The current structure is searched from the current directory downwards. When a match has been found the user is prompted for further action - for example it is possible to enter the file manager, find the next file or quit from this option. The option is designed to make finding of files as painless as possible. DCL equiv: DIRECTORY [...]filename MENU MENU MENU ____ ____ ____ ____ 4.15 MENU Enter ? A quick one page menu is displayed. The user may make a selection from this menu if required or press [Return] if no option is desired. SWING USER GUIDE SWING USER GUIDE SWING USER GUIDE SWING USER GUIDE Page 20 DIRECTORY MANAGER 17 March 1997 MOVE MOVE MOVE ____ ____ ____ ____ 4.16 MOVE Enter M or m Move allows the user to move part of a directory structure to a new parent directory. Move initiates the move operation by asking the user to move to the a new parent directory. When [Return] is pressed the move takes place. Both the new parent and the directory being moved can have other sub-directories attached to them as well. While moving to the new parent directory the operation can be cancelled by entering any key other than those used for moving around. You cannot move a directory to another physical disk. DCL equiv: RENAME directory.dir [new-directory-path] PURGE PURGE PURGE _____ _____ _____ _____ 4.17 PURGE Enter U or u Purge allows the user to purge the current directory and all sub-directories. DCL equiv: PURGE/LOG [...]*.*;* QUIT QUIT QUIT ____ ____ ____ ____ 4.18 QUIT Enter Q, q, E, e, ^Z, ^C or ^Y (Ctrl/Z, Ctrl/C or Ctrl/Y) Quit allows the user to exit from SWING and return to DCL. Your system manager may have also enabled [Return] to quit SWING. Hit '?' to see if it is allowed. See item 3 of the v3.5.1 release notes for more info. Your system manager may have also enabled Q and q to return to the original directory instead of the current one. See item 3 of the v3.5.3 release notes for more info. The save file is updated if changes have been made to the directory structure. REMOVE DIRECTORY STRUCTURE REMOVE DIRECTORY STRUCTURE REMOVE DIRECTORY STRUCTURE __________________________ __________________________ __________________________ __________________________ 4.19 REMOVE DIRECTORY STRUCTURE Enter K, k or [Remove] (LK201 keyboards) SWING USER GUIDE SWING USER GUIDE SWING USER GUIDE SWING USER GUIDE Page 21 DIRECTORY MANAGER 17 March 1997 This option allows the user to remove the current structure from the display. NOTE There must be at least two structures on display, otherwise an error message will be displayed - if there's only one structure then it can't be removed. RENAME RENAME RENAME ______ ______ ______ ______ 4.20 RENAME Enter R or r Rename allows the user to change the name of a directory. DCL equiv: RENAME directory.dir new-directory.dir REPAINT (REFRESH) THE SCREEN REPAINT (REFRESH) THE SCREEN REPAINT (REFRESH) THE SCREEN ____________________________ ____________________________ ____________________________ ____________________________ 4.21 REPAINT (REFRESH) THE SCREEN Enter ^W or ^R (Ctrl/W or Ctrl/R) Refreshes the screen. RETURN TO MARK RETURN TO MARK RETURN TO MARK ______________ ______________ ______________ ______________ 4.22 RETURN TO MARK Enter \, ], } or ) The user can return to a marked directory with \, ], } or ). e.g. \ returns to the directory marked by /, ] returns to the directory marked by [, ) returns to the directory marked by (, and } returns to the directory marked by {. RE-SEARCH - REBUILD DIRECTORY STRUCTURE RE-SEARCH - REBUILD DIRECTORY STRUCTURE RE-SEARCH - REBUILD DIRECTORY STRUCTURE _______________________________________ _______________________________________ _______________________________________ _______________________________________ 4.23 RE-SEARCH - REBUILD DIRECTORY STRUCTURE Enter S SWING USER GUIDE SWING USER GUIDE SWING USER GUIDE SWING USER GUIDE Page 22 DIRECTORY MANAGER 17 March 1997 SEARCH re-searches the directory structure, builds a new save file and updates the display accordingly. It is necessary to use this feature if the directory structure has been changed other than by SWING. (e.g. via the BACKUP utility, or DCL commands which create, delete or rename directories) If there are more than one structure on display then the user is prompted to re-search either all structures or just the current structure. It is recommended that you use swing for creating, deleting, renaming and moving directories. If this is not possible (eg. when using the BACKUP utility) then hit 'S' immediately after starting SWING, to bring SWING's understanding of your structure up-to-date. SET MARK SET MARK SET MARK ________ ________ ________ ________ 4.24 SET MARK Enter /, [, { or (. The user can mark a directory with /, [, { or (. Each of these four keys marks an individual directory, so up to four directories may be marked at any one time. It is possible to return to the respective marked directory with \, ], } or ). SHOW DISK QUOTA SHOW DISK QUOTA SHOW DISK QUOTA _______________ _______________ _______________ _______________ 4.25 SHOW DISK QUOTA Enter & This will show the current device usage - device size, space used, and free space in megabytes. Additionally the user's quota on that device is displayed. DCL equiv: SHOW QUOTA SNAPSHOT THE SCREEN SNAPSHOT THE SCREEN SNAPSHOT THE SCREEN ___________________ ___________________ ___________________ ___________________ 4.26 SNAPSHOT THE SCREEN Enter * Throughout SWING a snapshot of the screen may be taken. The resulting file is written to SWING$SAVE if this is defined. If not, then it is written to SYS$LOGIN. Screen snapshot filenames are of the form: SNAPSHOT_xxxxxx.LIS, where xxxxxx is a selection of unique letters and numbers chosen by SWING, to make the snapshot file unique. SWING USER GUIDE SWING USER GUIDE SWING USER GUIDE SWING USER GUIDE Page 23 DIRECTORY MANAGER 17 March 1997 Since the special characters used to draw lines cannot always be displayed in a file, the device-independent characters (+,-,|) are used to draw lines. USER DEFINABLE OPTIONS USER DEFINABLE OPTIONS USER DEFINABLE OPTIONS ______________________ ______________________ ______________________ ______________________ 4.27 USER DEFINABLE OPTIONS Enter ^D (Ctrl/D) This will display the USER-OPTIONS window. See Section 3.1 for a full description. WHERE - SHOW CURRENT DEFAULT DIRECTORY WHERE - SHOW CURRENT DEFAULT DIRECTORY WHERE - SHOW CURRENT DEFAULT DIRECTORY ______________________________________ ______________________________________ ______________________________________ ______________________________________ 4.28 WHERE - SHOW CURRENT DEFAULT DIRECTORY Enter W or w WHERE switches on or off the dynamic display of the current default device and directory on top of the display. If it is switched on, the full directory name is displayed on the left-hand side of the 2nd row, and changes each time you move to a different directory. SWING USER GUIDE SWING USER GUIDE SWING USER GUIDE SWING USER GUIDE Page 24 FILE MANAGER 17 March 1997 FILE MANAGER FILE MANAGER FILE MANAGER ____________ ____________ ____________ ____________ 5 FILE MANAGER Enter F or f, (^F (Ctrl/F) to see ONLY the directory files via the FILE_MANAGER). Your system manager may have also enabled [Return] to move from Directory to File manager. Hit '?' to see if it is allowed. See the Release Notes for v3.5.1 for more info. FILES allows the user to manipulate the files in the selected directory. Only non-directory files are shown. The user selects / deselects files by pressing the [Space Bar]. The status of the file next to the cursor will be toggled between selected and deselected. The user can SELECT ALL the files via 'A' (all), and DESELECT ALL files via 'Z' (zap). Also the user can SELECT SPECIFIC files based on a (partial) file specification via '+', and DESELECT in a similar way via '-', using wildcards. At least one file must be selected for the Copy, Delete, Move, Rename and List options. If you select a series of files before entering the tYpe option, their names will all be passed to MOST. You can then use its multiple windowing feature to examine the files simultaneously. Use MOST's Full Help for information on its multiple windowing feature. The logical CSWING$USERCOMMAND can be predefined as a setup option. If it is defined, then the command G (or g) in the file manager will cause a scratch file to be written and to have all selected filenames written to it, one per line with newline between, and the user command defined in the logical will be executed via a system() call with the filename of the scratch file passed as an argument on the command line. Thus it can be picked up by a DCL script or by a program. This is provided so that Swing can be used as a file selector front end for pretty much anything you like, without particularly touching the Swing program itself (apart from the additions to the source made to support this primitive by Glenn Everhart). It is of course up to the application to ensure that the selected file or directory names (or both) are passed to any images called in pieces that can be used. There are no limits on how large the scratch file may become; it just walks the tree of selected filenames and writes them to the scratch file. After the user application is done, the scratch file is deleted. If the user entered ^F a subset of the FILE MANAGER functionality is invoked. Only the SUB-DIRECTORIES are displayed. This option is included to allow the user to obtain directory information for the SWING USER GUIDE SWING USER GUIDE SWING USER GUIDE SWING USER GUIDE Page 25 FILE MANAGER 17 March 1997 sub-directories. NOTE SWING reads the list of files in a directory by actually opening the directory file. This approach has been taken to improve the performance in situations where there may be many thousands of files in a directory. SWING allows the use of the = key (EQUALS) to specify a search criteria for files in the file manager. This key may be used in both the directory manager and the file manager. When = is pressed SWING prompts for the search specification the response to which is a file specification (name.type) including wildcards as required. This specification becomes the basis of the search by the file manager when building up lists of files. This is similar to the DCL command DIR *.C (for example). Conversely, files can be excluded from the display by hitting the # key (HASH). A logical SWING_EXCLUDE_FILES can also be defined in your LOGIN.COM to permanently exclude files. The = and # keys are mutually exclusive, so one cancels the actions of the other. NOTE These operations (= and #) may also be performed in the directory manager as an alternative to entering F or f to invoke the file manager. e.g. of responses are *.c, *.exe, test.*, *junk*.*, etc.. NOTE Any version number specified is ignored. BROADCAST MESSAGES BROADCAST MESSAGES BROADCAST MESSAGES __________________ __________________ __________________ __________________ 5.1 BROADCAST MESSAGES Enter O or o (Old Broadcast Messages) BROADCAST MESSAGES are trapped by SWING and displayed in a separate window. This window can be recalled at any time if required. Broadcast messages are issued when new mail is received (for example). This window is automatically displayed when there are outstanding messages and the user is in the directory manager or file manager and is also currently being prompted for input. SWING USER GUIDE SWING USER GUIDE SWING USER GUIDE SWING USER GUIDE Page 26 FILE MANAGER 17 March 1997 CHANGE FILE OWNERSHIP CHANGE FILE OWNERSHIP CHANGE FILE OWNERSHIP _____________________ _____________________ _____________________ _____________________ 5.2 CHANGE FILE OWNERSHIP Enter ~ This option allows the user to change the ownership of the selected files or directories as desired. The user is able specify the new file owner. DCL equiv: SET FILE/OWNER=new-owner filespec(s) CHANGE FILE PROTECTION CHANGE FILE PROTECTION CHANGE FILE PROTECTION ______________________ ______________________ ______________________ ______________________ 5.3 CHANGE FILE PROTECTION Enter @ This option allows the user to change the protection on the selected files and / or directories as desired. The user is able specify the new file protection. DCL equiv: SET PROT=(protection-mask) filespec(s) COPY COPY COPY ____ ____ ____ ____ 5.4 COPY Enter C or c Copy allows the selected files to be copied to a new directory, which may be the current directory, in which case duplicate copies of these files are made. This option ensures that the new file always has the higher version number in the situation where a file with the same name and version number already exists. Additionally, files are copied in reverse order to ensure that lower versions of the same file are copied before higher versions, and hence these higher versions still have the higher version number. If desired the user can enter the EXPORT option by typing > instead of [Return] when selecting the destination directory. Copy is thus being used as a way of specifying the destination directory for EXPORT prior to actually entering export. This can be very useful when copying files into a directory for which the user must specify a user name and password. DCL equiv: COPY/LOG filespec(s) [new-directory] DCL($) DCL($) DCL($) ______ ______ ______ ______ 5.5 DCL($) Enter $ SWING USER GUIDE SWING USER GUIDE SWING USER GUIDE SWING USER GUIDE Page 27 FILE MANAGER 17 March 1997 DCL spawns a sub-process in the user's current directory (as shown by the main SWING display). All symbols are inherited from the parent process, however the DCL tables will be taken from sys$system, hence any additions made to the DCL tables will not be present in this sub-process. LOGOUT when finished. DEFRAGMENT FILES DEFRAGMENT FILES DEFRAGMENT FILES ________________ ________________ ________________ ________________ 5.6 DEFRAGMENT FILES Enter % Defragmentation allows the user to defragment the selected files. The user is twice prompted to confirm that the files selected and their contents are to be defragmented. The contents of the the files that are processed will be made as contiguous as possible. No header information (other than the pointers in the header) will be changed. The file fragmentation is shown in the FILE MANAGER via directory format 8. If pointers is greater than 1 then the file is unnecessarily fragmented, and potentially degrading the system performance when accessed. DCL equiv: COPY/CONTIGUOUS/REPLACE filespec(s) filespec(s) DELETE DELETE DELETE ______ ______ ______ ______ 5.7 DELETE Enter D or d Delete allows the user to delete the selected files. The user is prompted twice to confirm the intent to delete. NOTE SWING will only delete files that the user could otherwise delete via the DCL commands SET FILE /PROTECTION and DELETE. DCL equiv: DELETE/LOG filespec(s) DIRECTORY DISPLAY FORMAT DIRECTORY DISPLAY FORMAT DIRECTORY DISPLAY FORMAT ________________________ ________________________ ________________________ ________________________ 5.8 DIRECTORY DISPLAY FORMAT There are ten (yes, ten!) different formats of directory information display within the file manager. SWING USER GUIDE SWING USER GUIDE SWING USER GUIDE SWING USER GUIDE Page 28 FILE MANAGER 17 March 1997 To select the desired format just press any key 0 through key 9. The selected format is shown on the bottom right-hand side of the display. You can permanently set the preferred display format in the first line of the USER DEFINED OPTIONS screen (Ctrl/D). Also, the left-arrow and right-arrow keys allow the user to cycle through the displays. (Just keep pressing left-arrow or right-arrow). The display formats should be self-explanatory. DCL equiv: DIRECTORY/all-sorts-of-qualifiers [current-directory] EDIT A FILE EDIT A FILE EDIT A FILE ___________ ___________ ___________ ___________ 5.9 EDIT A FILE Enter E or e Edit allows the user to edit the current file (indicated by the cursors). The user may define the default editor via the user defined options (Ctrl/D). If the user selects EDT or TPU the activation of the editor will be much faster as SWING uses the EDT and TPU shareable libraries. EDT EDT EDT ___ ___ ___ ___ 5.9.1 EDT This is DEC's EDT, invoked via the EDT$EDIT interface. SWING will use SYS$LOGIN:EDTINI.EDT as a startup file if accessible - for further information see "VAX/VMS Utility Routines Reference Manual, section EDT". Set the default editor to EDT for the most efficient startup of EDT. NOTE There is a problem with this approach - If the user is in a directory to which he doesn't have write access, the EDT editor will not start up. A solution is to define a key as "EDIT/EDT/READONLY". This problem only affects EDT. OTHER OTHER OTHER _____ _____ _____ _____ 5.9.2 OTHER This is any other editor of the user's choice. For example, if the user has defined a symbol `MYED' to invoke their personal editor, then it is necessary only to enter `MYED' as the required editor. SWING USER GUIDE SWING USER GUIDE SWING USER GUIDE SWING USER GUIDE Page 29 FILE MANAGER 17 March 1997 This will be somewhat slower than using EDT or TPU, as SWING will set up a sub-process in which to do the editing. TPU TPU TPU ___ ___ ___ ___ 5.9.3 TPU This is DEC's TPU, invoked via the TPU$TPU interface - for further information see "VAX/VMS Utility Routines Reference Manual, section TPU, subsection TPU$TPU". The EVE editor will be used by default, unless you (or your system manager) have defined a personal (or site-specific) TPU$SECTION logical name. This then tells SWING to use a "different flavour" of TPU. If you want to use a tailored version of TPU, then add the following to your LOGIN.COM: $ define/nolog TPU$SECTION my-tpu-initialisation-file EDIT NEW FILE EDIT NEW FILE EDIT NEW FILE _____________ _____________ _____________ _____________ 5.10 EDIT NEW FILE Enter ^E (Ctrl/E) This allows the user to edit a new file. The user may define the default editor as per the EDIT option. DCL equiv: EDIT EXECUTE A FILE EXECUTE A FILE EXECUTE A FILE ______________ ______________ ______________ ______________ 5.11 EXECUTE A FILE Enter X or x Execute allows the user to execute the current file either as a command file (.COM) or as a executable (.EXE) file. If the file has a filetype of .COM, then it will be automatically executed as a DCL command procedure. DCL equiv: @filename.COM If the file has a filetype of .EXE, then it will be automatically executed as an executable image. DCL equiv: RUN filename.EXE If the file is neither of the above, the the user is asked if the file is a DCL command file. If the user answers 'Y', then it is executed as such. If the response is 'N', then the file is not executed at all and the user is returned to the File Manager screen. SWING USER GUIDE SWING USER GUIDE SWING USER GUIDE SWING USER GUIDE Page 30 FILE MANAGER 17 March 1997 EXPORT EXPORT EXPORT ______ ______ ______ ______ 5.12 EXPORT Enter > Export is like copy, except that the user is able to specify a full DECnet path for the selected files, e.g. NODE"user password":: The percentage file transfer is displayed while the transfer is in progress to bolster the confidence of the user. DCL equiv: COPY/LOG filename(s) remote-filespec(s) HELP HELP HELP ____ ____ ____ ____ 5.13 HELP Enter H, h (or [Help] on LK201 keyboards) Help allows the user access to this information. The full VAX help features are available. IMPORT IMPORT IMPORT ______ ______ ______ ______ 5.14 IMPORT Enter < Import is like copy, except that the user is able to specify a full DECnet file specification for the file to be copied into the current directory, e.g. NODE"user password"::filespec The percentage file transfer is displayed while the transfer is in progress to bolster the confidence of the user. DCL equiv: COPY/LOG full-filespec 5 LIST (or PRINT) 5 LIST (or PRINT) 5 LIST (or PRINT) _______________ _______________ _______________ _______________ 5.15 LIST (or PRINT) E E E Enter L or l List allows the user to print the selected files to the printer queue defined by the user defined options (Ctrl/D) The user may, if desired, change the printer queue for the duration of the current session. SWING USER GUIDE SWING USER GUIDE SWING USER GUIDE SWING USER GUIDE Page 31 FILE MANAGER 17 March 1997 MENU MENU MENU ____ ____ ____ ____ 5.16 MENU Enter ? A quick one page menu is displayed. The user may make a selection from this menu if required or press [Return] if no option is desired. MOVE MOVE MOVE ____ ____ ____ ____ 5.17 MOVE Enter M or m Move allows the user to move the selected files to a new directory on the same device. The files are moved in such a way that the new file always has the higher version number in the situation where a file with the same name and version number already exists. NOTE Files can only be moved on the same physical device. DCL equiv: RENAME filespec(s) [new-directory] MOVING AROUND MOVING AROUND MOVING AROUND _____________ _____________ _____________ _____________ 5.18 MOVING AROUND The user may move around the displayed directory structure using the four `arrow-keys', or: ^J to move up, ^K to move down, ^H to move left, ^L to move right, N, n or [Next Screen] to advance by one screen, P, p or [Prev Screen] to move back by one screen, T, t to move to Top of the current structure, or if already at the top then to the top of the previous structure (if there is one), B, b to move to Bottom of the current structure, or if already at the bottom then to the bottom of the next structure (if there is one) and [Select] and [Find] (LK201 keyboard) can be used to move around an internally held stack of `visited' directories. A directory becomes `visited' when the user invokes the FILE MANAGER in this directory. SELECT moves forward, FIND backward. SWING USER GUIDE SWING USER GUIDE SWING USER GUIDE SWING USER GUIDE Page 32 FILE MANAGER 17 March 1997 PRINT PRINT PRINT _____ _____ _____ _____ 5.19 PRINT Enter L or l Print (or List) allows the user to print the selected files to the printer queue defined by user defined options (Ctrl/D). The user may, if desired, change the printer queue for the duration of the current session. This command is the same as LIST. DCL equiv: PRINT filename(s) PURGE PURGE PURGE _____ _____ _____ _____ 5.20 PURGE Enter U or u Purge allows the user to purge the current directory. NOTE Sub-directories are not purged. DCL equiv: PURGE/LOG *.* QUIT AND RETURN TO DIRECTORY MANAGER QUIT AND RETURN TO DIRECTORY MANAGER QUIT AND RETURN TO DIRECTORY MANAGER ____________________________________ ____________________________________ ____________________________________ ____________________________________ 5.21 QUIT AND RETURN TO DIRECTORY MANAGER Enter Q, q or ^Z (Ctrl/Z) Quit will leave the file manager option and return to the directory manager screen. Your system manager may have also enabled [Return] to move from File back to Directory manager. Hit '?' to see if it is allowed. See item 2 of the Release Notes for v3.5.3 for more info. RENAME RENAME RENAME ______ ______ ______ ______ 5.22 RENAME Enter R or r Rename allows the user to rename the selected files one at a time. DCL equiv: RENAME filename(s) new-filename(s) SWING USER GUIDE SWING USER GUIDE SWING USER GUIDE SWING USER GUIDE Page 33 FILE MANAGER 17 March 1997 REPAINT (REFRESH) THE SCREEN REPAINT (REFRESH) THE SCREEN REPAINT (REFRESH) THE SCREEN ____________________________ ____________________________ ____________________________ ____________________________ 5.23 REPAINT (REFRESH) THE SCREEN Enter ^W or ^R (Ctrl/W or Ctrl/R) Refreshes the screen. RE-SEARCH - REBUILD FILE LIST RE-SEARCH - REBUILD FILE LIST RE-SEARCH - REBUILD FILE LIST _____________________________ _____________________________ _____________________________ _____________________________ 5.24 RE-SEARCH - REBUILD FILE LIST Enter F, f or = The files in the current directory are re-searched. The display is updated accordingly. If '=' is entered, then a search specification can be entered, using Wildcards. e.g. *.C . SELECT FILES SELECT FILES SELECT FILES ____________ ____________ ____________ ____________ 5.25 SELECT FILES The user selects / deselects files by pressing the [Space Bar]. The status of the file next to the cursor will be toggled between selected and deselected. The user can SELECT ALL the files via 'A' (all), and DESELECT ALL files via 'Z' (zap). Also the user can SELECT SPECIFIC files based on a (partial) file specification via '+', and DESELECT in a similar way via '-', using wildcards. At least one file must be selected for the Copy, Delete, Move, Rename and List options. If you select a series of files before entering the tYpe option, their names will all be passed to MOST. You can then use its multiple windowing feature to examine the files simultaneously. Use MOST's Full Help for information on its multiple windowing feature. The logical CSWING$USERCOMMAND can be predefined as a setup option. If it is defined, then the command G (or g) in the file manager will cause a scratch file to be written and to have all selected filenames written to it, one per line with newline between, and the user command defined in the logical will be executed via a system() call with the filename of the scratch file passed as an argument on the command line. Thus it can be picked up by a DCL script or by a program. This is provided so that Swing can be used as a file selector front end for pretty much anything you like, without particularly touching the Swing program itself (apart from the additions to the source made SWING USER GUIDE SWING USER GUIDE SWING USER GUIDE SWING USER GUIDE Page 34 FILE MANAGER 17 March 1997 to support this primitive by Glenn Everhart). It is of course up to the application to ensure that the selected file or directory names (or both) are passed to any images called in pieces that can be used. There are no limits on how large the scratch file may become; it just walks the tree of selected filenames and writes them to the scratch file. After the user application is done, the scratch file is deleted. SHOW DISK QUOTA SHOW DISK QUOTA SHOW DISK QUOTA _______________ _______________ _______________ _______________ 5.26 SHOW DISK QUOTA Enter & This will show the current device usage - device size, space used, and free space in megabytes. Additionally the user's quota on that device is displayed. DCL equiv: SHOW QUOTA SNAPSHOT THE SCREEN SNAPSHOT THE SCREEN SNAPSHOT THE SCREEN ___________________ ___________________ ___________________ ___________________ 5.27 SNAPSHOT THE SCREEN Enter * Throughout SWING a snapshot of the screen may be taken. The resulting file is written to SWING$SAVE if this is defined. If not, then it is written to SYS$LOGIN. Screen snapshot filenames are of the form: SNAPSHOT_xxxxxx.LIS, where xxxxxx is a selection of unique letters and numbers chosen by SWING, to make the snapshot file unique. Since the special characters used to draw lines cannot always be displayed in a file, the device-independent characters (+,-,|) are used to draw lines. SUBMIT FILES TO BATCH SUBMIT FILES TO BATCH SUBMIT FILES TO BATCH _____________________ _____________________ _____________________ _____________________ 5.28 SUBMIT FILES TO BATCH Enter S or s Submit allows the user to submit the selected files to the batch queue defined by the "User Defined Options" (Ctrl/D) The user may, if desired, change the batch queue for the duration of the current session. SWING USER GUIDE SWING USER GUIDE SWING USER GUIDE SWING USER GUIDE Page 35 FILE MANAGER 17 March 1997 TYPE TYPE TYPE ____ ____ ____ ____ 5.29 TYPE Enter Y or y. Your system manager may have also allowed [Return]. Type allows the user to display the current file or a selected set of files on the terminal via a modified version of the freely-available "MOST" Utility. Its version number is shown when it displays its first screen. At the end of each screen, it displays (in reverse video) the filename, percentage of the file displayed so far, line number at the top of the screen and total number of lines in the file. To get a Quick Help summary of commands while using the MOST utility, hit [Help], 'H' or 'h', '?' or PF2. To access its Full Help (documentation file), hit GOLD PF2 or GOLD H, where GOLD is PF1 or CTRL-X. To quit from MOST, hit 'Q' or 'q', 'X' or 'x', or CTRL-Z. NOTE If the standalone version of MOST supplied with SWING has been installed on your system, you also can access its Full Help at the system prompt via the command: $ most -h USER DEFINABLE OPTIONS USER DEFINABLE OPTIONS USER DEFINABLE OPTIONS ______________________ ______________________ ______________________ ______________________ 5.30 USER DEFINABLE OPTIONS Enter ^D (Ctrl/D) This will display the USER-OPTIONS window. See Section 3.1 for a full description. RELEASE NOTES RELEASE NOTES RELEASE NOTES _____________ _____________ _____________ _____________ 6 RELEASE NOTES Version 3.7.6 Version 3.7.6 Version 3.7.6 _____________ _____________ _____________ _____________ 6.1 Version 3.7.6 This release of Swing implemented the following new features and bug fixes: 1. Fixed a few build bugs on the Alpha platform. (Harry Flowers) 2. Added CHANGEPROTTODELETE (defined by default to retain the old behavior) which governs whether C Swing will change the protection on a file it failed to delete to try deleting it again. Some sites have gone to some trouble to remove user SWING USER GUIDE SWING USER GUIDE SWING USER GUIDE SWING USER GUIDE Page 36 RELEASE NOTES 17 March 1997 delete access from some files, and the default behavior makes it too easy to delete these files. (Harry Flowers) 3. Added support for server queues when printing. Print queues served by Digital TCP/IP Services for OpenVMS (aka UCX) are of this type. (Lars Bruun Hansen) Version 3.7.5 Version 3.7.5 Version 3.7.5 _____________ _____________ _____________ _____________ 6.2 Version 3.7.5 This release of Swing implemented the following new features and bug fixes: 1. Added the optional logical CSWING$USERCOMMAND. If defined, the command "G" in the file manager will cause a scratch file to be written and to have all selected filenames written to it, one per line with newline between, and the user command defined in the logical will be executed via a system() call with the filename of the scratch file passed as an argument on the command line. Thus it can be picked up by a DCL script or by a program. This is provided so that Swing can be used as a file selector front end for pretty much anything you like, without particularly touching the Swing program itself. After the user application is done, the scratch file is deleted. (Glenn Everhart) 2. Fixed a bug with a routine not returning a successful status when it should. Caused problems with DEC C V4 on AXP. (Jesper Partoft) 3. Several reports of A, B, C, or D being entered when a user pressed arrow keys, etc. led to turning on hostsync while Swing is running. It should probably be on all the time for these users, but Swing restores the original setting on exit. (Harry Flowers) 4. Checked for and disallowed a directory to be moved under itself. (Harry Flowers) 5. Use different check for presence of DEC C compiler during a build so that it will work using DEC C on a VAX. (Harry Flowers) Version 3.7.4 Version 3.7.4 Version 3.7.4 _____________ _____________ _____________ _____________ 6.3 Version 3.7.4 This release of Swing implemented the following new features and bug fixes: SWING USER GUIDE SWING USER GUIDE SWING USER GUIDE SWING USER GUIDE Page 37 RELEASE NOTES 17 March 1997 1. Fixed problem where Swing wouldn't purge a large number of files. (Harry Flowers) 2. Fixed problem where sometimes a renamed file didn't show being renamed in the file manager window. (Harry Flowers) 3. Fixed problem with DEC C where some versions can't find fcbdef.h by defining DECC$TEXT_LIBRARY to point to the lib definitions. (Harry Flowers) Version 3.7.3 Version 3.7.3 Version 3.7.3 _____________ _____________ _____________ _____________ 6.4 Version 3.7.3 This release of Swing implemented the following new features and bug fixes: 1. Replaced SWING-STARTUP.COM with a totally new SWING_STARTUP.COM. [Actually, this made it out in some of the V3.7.2 releases.] (Harry Flowers) 2. Performance enhancements using multiblock and multibuffer counts in file opens to reduce I/O's. (Harry Flowers) Version 3.7.2 Version 3.7.2 Version 3.7.2 _____________ _____________ _____________ _____________ 6.5 Version 3.7.2 This release of Swing implemented the following new features and bug fixes: 1. Changed default behavior of [Return] in the file manager from a no-op to the same as "Y" to view files. This means that [Return] always has a function in the file manager; it either views the file(s) or returns to the directory manager depending on whether or not CR_RETURNS_FROM_FILE_TO_DIR_MGR is defined. (Harry Flowers) 2. Fixed problem with Listing a file, and specifing the queue as a batch queue, allowed a captive user to submit a command procedure. (Richard Hardy) Version 3.7.1 Version 3.7.1 Version 3.7.1 _____________ _____________ _____________ _____________ 6.6 Version 3.7.1 This release of Swing implemented the following new features and bug fixes: SWING USER GUIDE SWING USER GUIDE SWING USER GUIDE SWING USER GUIDE Page 38 RELEASE NOTES 17 March 1997 1. (Enabled by PRINTMENU) The addition of a print menu if a ? is typed for the queue name. The menu includes those queues which have a description field formatted as specified in PRINTMENU.README. (Butch Walker) 2. The Print command can now print the current file, rather than requiring that the user select a file. (Butch Walker) 3. (Changes to SWING.MMS) Added a DEBUG macro which compiles and links with debug and places the .OBJ files in a [.dbg] directory. This allows switching between debug and nodebug versions with minimal recompilation. Added a USESCA macro which creates an SCA library in [.scalib], compiles with /ana and loads the .ANA modules into the library. This allows users with SCA and LSE to make use of the utilities for maximum effectiveness. (Butch Walker) 4. Added debug changes to command files; the BUILD command file will now accept "DEBUG" as a parameter and work with either MMS or the command files. (Harry Flowers) 5. Better handling of iosb status block in swing29.c (deals more intelligently with WARNING or INFO versus ERROR or SEVERE). (Nissim Etrog) 6. Enabled passing of parameters to executeDCL(). (Nissim Etrog) 7. Added informational messages for presses of undefined command keys. (Nissim Etrog) 8. Changed headers of the MATSHACK and CRRETURNSFROMFILETODIRMGR logicals in swing.h to make more clear what they do and how they interact, and modified the quick help menu for the Directory manager along the lines submitted by Jeff Dykzeul (jd@mass.dnet.hac.com) so that it's correct, based on how they were defined. Also got the quick help menu to be correct no matter what combinations of these two logicals and the QEXITSTOORIGINALDIR logical are defined. (Foteos Macrides) 9. Sleep for only one second after warning messages to bottom of screen. (Foteos Macrides) 10. Improved MOST's spawning behavior and updated its doc file. (Foteos Macrides) 11. Updated C Swing manual and help library. (Foteos Macrides) SWING USER GUIDE SWING USER GUIDE SWING USER GUIDE SWING USER GUIDE Page 39 RELEASE NOTES 17 March 1997 Version 3.7.0 Version 3.7.0 Version 3.7.0 _____________ _____________ _____________ _____________ 6.7 Version 3.7.0 This release of Swing implemented the following new features and bug fixes: 1. Upgraded MOST to 3.2.0FM. Added lots of new features and switches as described in the header of its main.c and in most.doc_fm. Most notably, now has both Quick Help (summary of commands) and Full Help (display of doc file), GOLD and EDT style commands, -h qualifier for showing Full Help from the DCL command line, -n Naive Prompt qualifer and logical for replacing the dev:[dir]filename string in the status line with other information or a title. (Foteos Macrides) 2. Ported everything to DECC/Alpha, with tests for VAXC versus DECC in the code and build procedures. Thanks to Bill Forbes, BFORBES@MR4DEC.ENET.DEC.COM, for help with VAXC versus DECC differences. Thanks to Ross Smith, SMITH@MCCLB0.MED.NYU.EDU, for letting me use NYU Med's field test Alpha. (Foteos Macrides) 3. Updated the SWING Help Library and SWING Manual. (Foteos Macrides) 4. Fixed captive account editor selection (where there is no user profile) to not allow selection of "Other" editor commands, as any DCL command could be entered. (Harry Flowers) Version 3.6.5 Version 3.6.5 Version 3.6.5 _____________ _____________ _____________ _____________ 6.8 Version 3.6.5 Release 3.6.5 of Swing implemented the following features and bug fixes: 1. Changed file view option when files are selected to prompt for viewing the current file if selected files are not viewed. (Harry Flowers) 2. Fixed bug in showing broadcast messages; sometimes messages would fail to display, though the time banner would. This was caused by an incorrect declaration of the message length, which would sometimes be corrupted as a result. (Harry Flowers) 3. Upgraded MOST to 3.04FM. Added SecureMode extended switch (+s) for use with gopher client, and other fixes/enhancements described in the header of MOST's main.c. (Foteos Macrides) SWING USER GUIDE SWING USER GUIDE SWING USER GUIDE SWING USER GUIDE Page 40 RELEASE NOTES 17 March 1997 Version 3.6.4 Version 3.6.4 Version 3.6.4 _____________ _____________ _____________ _____________ 6.9 Version 3.6.4 Release 3.6.4 of Swing implemented the following upgrade: 1. Upgraded MOST to 3.03FM, as described in the header of its main.c. (Foteos Macrides) Version 3.6.3 Version 3.6.3 Version 3.6.3 _____________ _____________ _____________ _____________ 6.10 Version 3.6.3 Release 3.6.3 of Swing implemented the following new features and bug fixes: 1. Fixed more bugs in code for searching for directories under a 000000 directory if the device_000000SWSVE.DAT file exists and the device_directory_SWSVE.DAT file doesn't. Made this behavior an option via a -0 or /0 qualifier. It can be made the default (i.e., regardless of whether -0 or /0 is entered on the command line) by defining ALWAYS_TRY_000000 in SWING.H. (Foteos Macrides) 2. Enhanced or debugged aspects of logical device name handling. However, earlier modifications to respect terminal and concealed device logicals have broken some of CSWING's capacity to deal with search lists, and it can't all be restored without a major rewrite. (Foteos Macrides) 3. Added code such that arguments or logicals which translate to SYS$SYSROOT:[directory] will cause SYS$SPECIFIC:[directory] and SYS$COMMON:[directory] trees to be displayed (SYS$SPECIFIC is not in the SYS$SYSROOT search list, so it must be treated as a special case). Optional defines (SPECIFIC_EXITS_TO_SYSROOT and COMMON_EXITS_TO_SYSROOT) in SWING.H enable setting the default device to SYS$SYSROOT on exit in SYS$SPECIFIC or SYS$COMMON if an original call was for SYS$SYSROOT. Added a -s or /s and a -c or /c qualifier to evoke this behavior if SPECIFIC_EXITS_TO_SYSROOT and COMMON_EXITS_TO_SYSROOT, respectively, are not defined in SWING.H. For all other search lists that can be handled, the default directory on exit is always that of the particular tree you were in at the time of exit. (Foteos Macrides) 4. Modified the command line (-h) help module to describe the -0, -s and -c qualifiers if they were not made defaults via logicals in SWING.H or by including them in the foreign command definition for CSWING. (Foteos Macrides) 5. Added capacity to handle relative directory specs (e.g., [.foo] or [-.-.foo]). An argument with such a spec is handled relative to the directory from which CSWING was called, regardless of its position in an argument list (e.g., the list SYS$MANAGER,[] will put up trees for SWING USER GUIDE SWING USER GUIDE SWING USER GUIDE SWING USER GUIDE Page 41 RELEASE NOTES 17 March 1997 SYS$SPECIFIC:[SYSMGR], SYS$COMMON:[SYSMGR], and your calling default, in that order). (Foteos Macrides) 6. Added pause and prompt features for displays of CSWING.HLB (like those when reading help libraries via DCL). The help page length is determined by the value of page_length, determined at startup of CSWING. (Foteos Macrides) 7. Modified swing_8.c and swing_38.c to enable calling MOST with a set of selected files, and thereby use MOST's windowing features for multiple files (and appropriately modified the quick help list in swing_22.c). Made numerous modifications/enhancements of MOST for maximum compatibility with CSWING, as described in the header of MOST's main.c. Most noteably, command keys are now the same as or homologous to those of CSWING wherever possible. MOST called from CSWING will read and use MOST_SWITCHES and MOST_EDITOR if defined, can spawn editors and will use that defined for CSWING if its own logical is not defined, and can spawn to DCL in a manner analogous to spawns from CSWING (or will respect the 'captive' restriction if set). Also modified main.c so that a standalone MOST can be built with the same code at that for CSWING. Added confirmation of intent to edit in swing_16.c and MOST (our users too often hit E with intent to exit, not edit). Provided a MOST.DOC_FM for this version of MOST (Note that the original copyright applies to it, and to any programs derived from it: You must freely distribute the source code.). (Foteos Macrides) Version 3.6.2 Version 3.6.2 Version 3.6.2 _____________ _____________ _____________ _____________ 6.11 Version 3.6.2 Release 3.6.2 of Swing implemented the following new features and bug fixes: 1. Consistent build procedures. Corrected documentation. (Harry Flowers) 2. Supplied SWING-STARTUP.COM as documented in AAAREADME.1ST. (Chris Butler) 3. Changed behavior when Swing is invoked in an unknown subdirectory in a known structure. It used to just place you back at the top and give an unknown directory error. Now, it rebuilds the dir structure and places you where you wanted to start. (Harry Flowers) 4. Made code for Q_EXITS_TO_ORIGINAL_DIR more efficient. (Foteos Macrides) SWING USER GUIDE SWING USER GUIDE SWING USER GUIDE SWING USER GUIDE Page 42 RELEASE NOTES 17 March 1997 5. Fixed bugs when getting the version limits of files for display with format_5. If directory files are listed, their default version limits (for files created within the directories) are also displayed. (Foteos Macrides) 6. Modified to skip defragmentation of any files which have a version limit set (otherwise, such files would be trashed; the proper fix would be to eliminate the version limit, defragment the file, then restore its version limit, but since many sites now run defrag software this doesn't seem worth the bother). (Foteos Macrides) 7. Fixed a bug in the code I submitted a while ago for searching for directories under a 000000 directory. It didn't work for directories that have a _ in their name. From: Mark London (MRL@NERUS.PFC.MIT.EDU) Version 3.6.1 Version 3.6.1 Version 3.6.1 _____________ _____________ _____________ _____________ 6.12 Version 3.6.1 Release 3.6.1 of Swing had the following bug fix: 1. Bug fix with large screen size for MOST. (Harry Flowers) Version 3.6.0 Version 3.6.0 Version 3.6.0 _____________ _____________ _____________ _____________ 6.13 Version 3.6.0 This release of Swing contains no new features, only a fix for VMS v5.5, some bug fixes and improvements in the MOST Utility (v3.02), which has been totally rewritten. MOST is run when you select 'Y' (for TYPE a file) It was also decided to make this version 3.6 as there were becoming too many minor releases, and new sites would have otherwise needed to apply 6 sets of patches to the 3.5 kit. It will be available as a "whole" kit at archive sites. Modifications and bug fixes: 1. A small patch to SWING29.C for VMS v5.5, making use of the $SNDJBC call. 2. The latest version of MOST was incorporated into SWING 3. Major improvement in MOST performance, especially when viewing large files. 4. The online help screen in MOST has been rewritten. SWING USER GUIDE SWING USER GUIDE SWING USER GUIDE SWING USER GUIDE Page 43 RELEASE NOTES 17 March 1997 5. Fixed the annoying 80 column problem (showing up as a line too long if it's exactly 80 cols). 6. MOST now displays files which have more than 20,000 lines. Version 3.5.4 Version 3.5.4 Version 3.5.4 _____________ _____________ _____________ _____________ 6.14 Version 3.5.4 Two new features have been added to this minor release of Swing: 1. Added file exclude "#" option (opposite to the include "=" function) and SWING_EXCLUDE_FILES logical name to work like DIR/EXCLUDE. Note: The include "=" option is exclusive; also file purge would have to have been extensively re-worked, so purge is not supported if files are excluded 2. Added a check for supported terminal type Bug fixes: 1. Bug with negative percentages on large file copies occassionally appearing fixed. 2. File creation dates on copy are now preserved (just like DCL copy does) 3. Fixed memory leak; variables were being trashed when the starting directory was more than 40 characters in length; caused many bad side-effects 4. Fixed bug when Swing is started up on an empty directory 5. Change to volume set patch to handle very large file ids Version 3.5.3 Version 3.5.3 Version 3.5.3 _____________ _____________ _____________ _____________ 6.15 Version 3.5.3 Three new features have been added to this minor release of Swing: 1. The 'TYPE a file' command in File Manager now has a command 'W', 'w' or Ctrl/W to toggle between wide (132 columns) and narrow (80 columns) while viewing the file on the screen. (This is a new feature of the MOST utility). 2. For those who wish to use [Return] to toggle between the File and Directory manager screens, the SWING.H file has a 'macro directive identifier' called CR_RETURNS_FROM_FILE_TO_DIR_MGR. If you prefer this option and currently don't have it, see SWING USER GUIDE SWING USER GUIDE SWING USER GUIDE SWING USER GUIDE Page 44 RELEASE NOTES 17 March 1997 your system manager to define this in SWING.H and then rebuild swing. From Chris Butler (C.Butler@mof.govt.nz). 3. For those who want the option of returning to the original directory (instead of the current one) when exiting Swing, the SWING.H file has another 'macro directive identifier' called Q_EXITS_TO_ORIGINAL_DIR. This allows 'Q' and 'q' to perform this function, while all the other "exit" commands return the user to the CURRENT directory. If you prefer this option and currently don't have it, see your system manager to define this in SWING.H and then rebuild swing. Bug fixes: 1. Modified to ignore the non-displayable broadcast messages sent to VWS terminal windows. Otherwise whenever the VWS window running swing is selected, the broadcast paste buffer would pop up and try to display the message and fail with a SMG$_NONBRDMSG status. From Carl Karcher (KARCHER@WAISMAN.WISC.EDU) 2. A small bug in the add_dstructure() part of SWING_24.C now repsects device logical names which have the concealed and terminal attributes. Screen refresh after file manager @ and ~ leaves pointer at current file after command executes. Both from Charles Bailey (BAILEY@hmivax.humgen.upenn.edu). So far, one known bug still exists: There is a the problem with deleting a file when you've set default to a search list like SYS$MANAGER. There's a bug in RMS$ERASE that causes process termination (via executive mode bugcheck). It has been reported to DEC and it has been escalated to the VMS engineering group. The workaround is to set default to the individual directories (in this case, SYS$SPECIFIC:[SYSMGR]). Version 3.5.2 Version 3.5.2 Version 3.5.2 _____________ _____________ _____________ _____________ 6.16 Version 3.5.2 This release fixes all known bugs and provides the following New features: 1. Replaces MORE with MOST in the TYPE option of File Manager. 2. A /Help or -h command line option (eg. $ SWING /HELP) to display help for the command line. 3. A /Version or -v command line option (eg. $ SWING /VERSION) to display the current version of Swing, and then return to DCL. SWING USER GUIDE SWING USER GUIDE SWING USER GUIDE SWING USER GUIDE Page 45 RELEASE NOTES 17 March 1997 Version 3.5.1 Version 3.5.1 Version 3.5.1 _____________ _____________ _____________ _____________ 6.17 Version 3.5.1 It contains fixes to some bugs reported after V3.5 was released, as well as some nice new features. A description follows: New features: 1. A /file_manager or -f command line option (eg. $ SWING /FILE). This option specified on the command line will act just as if "F" were entered as soon as you get the directory manager screen. 2. For those who wish to have the option of hitting [Return] to exit SWING, instead of [Return] to go to File Manager the SWING.H file has a 'macro directive identifier' called MATS_HACK. If you prefer this option and currently don't have it, see your system manager to define this in SWING.H and then rebuild swing. If MATS_HACK is defined some commands (such as copy and move) are terminated with [Delete] instead of [Return]. From Mats Akerberg (mats@efd.lth.se). 3. When you don't have read access to your top directory, SWING will start with the directory it can read. Seems to be common practice as most sites use concealed logicals to hide the real top level directory. From Bernd Onasch (ONASCH@ira.uka.de). Bug fixes: 1. Old problem with change protection only changing world protection has been fixed. 2. Terminal characteristics (like numeric keypad) are now restored on exiting from CSWING. 3. Problem with long lines in configuration files (also from Mats). Version 3.5.0 Version 3.5.0 Version 3.5.0 _____________ _____________ _____________ _____________ 6.18 Version 3.5.0 The following new feature has been added between version 3.4 and 3.5. This feature has always been in the code, but never worked. 1. When exiting SWING, all Broadcast messages received during the SWING session and the current default directory are displayed. SWING USER GUIDE SWING USER GUIDE SWING USER GUIDE SWING USER GUIDE Page 46 RELEASE NOTES 17 March 1997 Version 3.4.0 Version 3.4.0 Version 3.4.0 _____________ _____________ _____________ _____________ 6.19 Version 3.4.0 The following bugs were fixed between version 3.2 and 3.4 by Harry Flowers (flowers@msuvx1.memst.edu). 1. Did not handle disks in bound volume sets. 2. Couldn't exit from "@ - change file protection". 3. Disk quota ("&") option did not stay on screen until key pressed. 4. Quit option did not work on copy or move files or directory options. 5. More ("Y") option failed after invoking it a fixed number of times. 6. More ("Y") option W did not reset internally to normal from wide. 7. More ("Y") option searching did not work in case-insensitive mode unless a lower-case string was used for the search pattern. 8. More ("Y") option spacing problem with form feeds; now treated just like a non-printable character (replaces it with a "^" character). 9. More ("Y") option caused the file manager to display the file in lower case after it had been viewed. Version 3.2.1 Version 3.2.1 Version 3.2.1 _____________ _____________ _____________ _____________ 6.20 Version 3.2.1 The following changes have been made since version 3.2 by Mats Akerberg (mats@efd.lth.se) DIRECTORY MANAGER: 1. The 'E' key has been added to allow you to exit out of swing. So you can use the following keys to exit: E, e, Q, q, Ctrl/C, Ctrl/Y or Ctrl/Z FILE MANAGER: 1. The [Return] key has been added to allow you to exit from file manager back to directory manager. So you can use the following keys to return to directory manager: Q, q, [Return] or Ctrl/Z SWING USER GUIDE SWING USER GUIDE SWING USER GUIDE SWING USER GUIDE Page 47 RELEASE NOTES 17 March 1997 2. You can now DISPLAY files on the the screen using the 'Y' command in file management. It makes use of the 'More' Utility and has some very powerful commands in it, such as edit the file you are viewing, search for strings, skip pages and switch From 80 to 132 columns (and back again), which allows you to look at wide reports. Hit 'H' when you are in the type utility for help.