%ě Librarian A09-16–q?…B{˜Çúj†B{˜žB ŸŸ"5 SWING ­Çúj†B{˜1 SWINGF SWING is a powerful utility for the graphic display and manipulationF of VMS directory structures on any terminal which supports the SMGF (Screen Management) routines, e.g., the VTxxx series of terminals or' any PC terminal emulation of a VTxxx.F SWING is designed to make life easy for a user who frequentlyF performs file or directory operations. It is designed with theF philosophy of PC file management packages such as XTREE-GOLD and F PCTOOLS, where the user need not know operating system commands to manage directories and files.F SWING displays the top eight directory levels of the user'sF directory structure. If there are more than eight levels a diamondF is displayed in the right-most column indicating that there are non-displayed directories.F You can optionally specify the starting directories. These are theF directory structures you wish to display and manipulate. The6 sp ecifications may be separated by commas or spaces. e.g. $ Swing or $ Swing [.subdir] or $ Swing SYS$LOGIN3 or $ Swing SYS$LOGIN,SYS$EXAMPLES,SYS$LIBRARY3 or $ Swing SYS$LOGIN SYS$EXAMPLES SYS$LIBRARYF There is a two level help facility within SWING. Quick menus areF available via the ? option. Standard VMS help is available via3 hitting H (or the [Help] key on LK201 keyboards).F Each SWING command description will have its equivalent DCL comma ndF (ie. the command you type at the '$' prompt), so that any existingF VAX users can identify with the SWING command set. This is> identified in the text as a line starting with 'DCL equiv:'.2 CAPTIVE_ACCOUNTS D If you are using Swing from a Captive Account, then a number ofD functions are disabled for security reasons. In particular, theD goal was to prevent doing anything outside the current directory< structure and disable execution of arbitrary DCL commands. D If you see the following message, then this means that you are in a captive environment:B The following functions have been disabled for Captive Accounts:/ Opt Description DirMgr FilMgr/ --- ----------- ------ ------- I Introduce dir structure Yes N/A: ^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 YesD Note that SWING$SAVE should point to a writable directory outsideD the user's directory structure. This allows the systemD administrator to configure the user's options file for choice ofD editor, queues, and key definitions. The user could change themD if SWING$SAVE is accessible under their structure and compromiseD the setup by editing in key defi nitions. Disabling ^D whileD retaining the ability for the administrator to customize the key? definitions is seen as a feature that must be used carefully.2 COMMANDS D Commands are invoked by entering the single keystroke associatedD with the command. Some of the commands use the LK201 keyboardD keys found above the `arrow keys' on the LK201 keyboard. Typical+ examples are PREV SCREEN and NEXT SCREEN.3 DIRECTORY_MANAGER4 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.4 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.1 DCL equiv: SET FILE/OWNER=new-owner [...]*.*;*4 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.9 DCL equiv: SET PROTECTION=(protection-mask) [...]*.*;*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 not6 possible to create more than eight directory levels.@ The name of the directory must be valid. Invalid names are" automatically rejected by SWING.0 DCL equiv: CREATE/DIRECTORY [.directory-name]4 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.4 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 t he 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 [...]*.*;* [...]*.*;*4 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.# NOTE8 SWING will only delete files that the user8 could otherwise delete via the DCL commands$ SET PROTECTION and DELETE.4 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.8 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 n ame. 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 qualifiers4 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: EDIT4 HELP + Enter H, h (or [Help] on LK201 keyboards)@ Help allows the user access to this information. The full VAX help features are available.4 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 transfer7 is in progress to bolster the confidence of the user.& DCL equiv: COPY/LOG full-filespec *4 INSERT_STRUCTURE . 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 number7 of structures that may be displayed at the same time., Each structure may only be displayed once.4 LIST_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 no t, 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 numbers3 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 [...])4 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 [...]filename4 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.4 MOVE  Enter M or m@ Move allows the user to move part of a directory structure to@ a new parent directory. Move i nitiates 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.7 You cannot move a directory to another physical disk.7 DCL equiv: RENAME directory.dir [ne w-directory-path]4 PURGE  Enter U or u@ Purge allows the user to purge the current directory and all sub-directories." DCL equiv: PURGE/LOG [...]*.*;*4 QUIT_SWING ; 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.4 REMOVE_STRUCTURE * Enter K, k or [Remove] (LK201 keyboards)@ This option allows the user to remove the current structure from the display.# NOTE8 There must be" at least two structures on8 display, otherwise an error message will be8 displayed - if there's only one structure then it can't be removed.4 RENAME  Enter R or r; Rename allows the user to change the name of a directory.4 DCL equiv: RENAME directory.dir new-directory.dir4 REPAINT_SCREEN # Enter ^W or ^R (Ctrl/W or Ctrl/R) Refreshes the screen.4 RETURN_TO_MARK  Enter \, ], } or )> The user can ret#urn 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 {.4 RE-SEARCH Enter S@ 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 DCL6 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 understandi%ng of your structure up-to-date.4 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 ).4 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 QUOTA4 SNAPSHOT_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.@ Si'nce the special characters used to draw lines cannot always@ be displayed in a file, the device-independent characters! (+,-,|) are used to draw lines.4 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 su(bmitted by SWING.2 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).# NOTE8 No file name is added when a user-definable2 *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.# NOTE8 The ! and ^ should not be used with the& editor o+r queue definitions." The settings are saved in either$ SYS$LOGIN:SWING_OPTIONS.INITIAL or< SWING$SAVE:SWING_OPTIONS.INITIAL if SWING$SAVE is defined.4 WHERE  Enter W or w@ WHERE switches on or off the dynamic display of the current5 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.3 FILE ,_MANAGERB Enter F or f, (^F (Ctrl/F) to see ONLY the directory files via the FILE_MANAGER).B Your system manager may have also enabled [Return] to move fromB Directory to File manager. Hit '?' to see if it is allowed.1 See the Release Notes for v3.5.1 for more info.B FILES allows the user to manipulate the files in the selected1 directory. Only non-directory files are shown.B The user selects / deselects files by pressing the [Space Bar].B The status of the -file next to the cursor will be toggled" between selected and deselected.B The user can SELECT ALL the files via 'A' (all), and DESELECT ALL files via 'Z' (zap).B Also the user can SELECT SPECIFIC files based on a (partial)B file specification via '+', and DESELECT in a similar way via '-', using wildcards.B At least one file must be selected for the Copy, Delete, Move, Rename and List options.B If you select a series of files before entering the tYpe optio .n,B their names will all be passed to MOST. You can then use itsB multiple windowing feature to examine the files simultaneously.B Use MOST's Full Help for information on its multiple windowing feature.B The logical CSWING$USERCOMMAND can be predefined as a setupB option. If it is defined, then the command G (or g) in the fileB manager will cause a scratch file to be written and to have allB selected filenames written to it, one per line with newlineB between, a /nd the user command defined in the logical will beB executed via a system() call with the filename of the scratchB file passed as an argument on the command line. Thus it can be, picked up by a DCL script or by a program.B This is provided so that Swing can be used as a file selectorB front end for pretty much anything you like, withoutB particularly touching the Swing program itself (apart from theB additions to the source made to support this primitive by G 0lennB Everhart). It is of course up to the application to ensure thatB the selected file or directory names (or both) are passed to anyB images called in pieces that can be used. There are no limitsB on how large the scratch file may become; it just walks the tree< of selected filenames and writes them to the scratch file.B After the user application is done, the scratch file is deleted.B If the user entered ^F a subset of the FILE MANAGERB functionality is inv1oked. Only the SUB-DIRECTORIES areB displayed. This option is included to allow the user to obtain0 directory information for the 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 be1 many thousands of files in a directory.B SWING 2allows the use of the = key (EQUALS) to specify a searchB criteria for files in the file manager. This key may be used inB both the directory manager and the file manager. When = isB pressed SWING prompts for the search specification the responseB to which is a file specification (name.type) including wildcardsB as required. This specification becomes the basis of the searchB by the file manager when building up lists of files. This is3 similar to the DCL command DIR *.C ( 3for example).B Conversely, files can be excluded from the display by hittingB the # key (HASH). A logical SWING_EXCLUDE_FILES can also be9 defined in your LOGIN.COM to permanently exclude files.B 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 to5 entering F or f to invoke th4e file manager.< e.g. of responses are *.c, *.exe, test.*, *junk*.*, etc..$ NOTE2 Any version number specified is ignored.4 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 automat5ically@ 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.4 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.2 DCL equiv: SET FILE/OWNER=new-owner filespec(s)4 CHANGE_FILE_PROTECTION Enter @@ This option allows the user to chang 6e the protection on the@ selected files and / or directories as desired. The user is' able specify the new file protection.4 DCL equiv: SET PROT=(protection-mask) filespec(s)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@ situ 7ation 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@ 8 directory for EXPORT prior to actually entering export. This@ can be very useful when copying files into a directory for7 which the user must specify a user name and password.2 DCL equiv: COPY/LOG filespec(s) [new-directory]4 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, hen9ce any additions made to the DCL tables* will not be present in this sub-process. LOGOUT when finished.4 DEFRAGMENT_FILES Enter %@ Defragmentation allows the user to defragment the selected@ files. The user is twice prompted to confirm that the files5 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)4 DELETE  Enter D or d@ Delete allows the user to delete the selected files. The user4 is prompted twice to confirm the intent to delete.# ; NOTE8 SWING will only delete files that the user8 could otherwise delete via the DCL commands* SET FILE /PROTECTION and DELETE.$ DCL equiv: DELETE/LOG filespec(s)4 DIRECTORY_DISPLAY_FORMAT@ There are ten (yes, ten!) different formats of directory. information display within the file manager.@ 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 the9 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).1 The display formats should be self-explanatory.@ DCL equiv: DIRECTORY/all-sorts-of-qualifiers [current-directory]4 EDIT_EXISTING_FILE  Enter E or e@ Edit allows th =e 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.5 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.5 OTHER> This is any other editor of the user's choice. Fo?r 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.> This will be somewhat slower than using EDT or TPU, as SWING7 will set up a sub-process in which to do the editing.5 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 use@d 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:9 $ define/nolog TPU$SECTION my-tpu-initialisation-file4 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 EDITA option. DCL equiv: EDIT4 EXECUTE  Enter X or x@ Execute allows the user to execute the current file either as7 a command file (.COM) or as a executable (.EXE) file.@ If the file has a filetype of .COM, then it will be4 automatically executed as a DCL command procedure. DCL equiv: @filename.COM@ If the file has a filetype of .EXE, then it will be0 automatically executed as an executable image. DCL equiv: RUN filename.EXE@ BIf 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.4 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 dispClayed while the transfer7 is in progress to bolster the confidence of the user.5 DCL equiv: COPY/LOG filename(s) remote-filespec(s)4 HELP + Enter H, h (or [Help] on LK201 keyboards)@ Help allows the user access to this information. The full VAX help features are available.4 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 direDctory, e.g. NODE"user password"::filespec@ The percentage file transfer is displayed while the transfer7 is in progress to bolster the confidence of the user.& DCL equiv: COPY/LOG full-filespec *4 LIST (Print)  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.4 MENU E 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.4 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 alreadyF exists.# NOTE8 Files can only be moved on the same physical device.0 DCL equiv: RENAME filespec(s) [new-directory]4 PRINT  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.4 PURGE  Enter U or u7 GPurge allows the user to purge the current directory.# NOTE) Sub-directories are not purged. DCL equiv: PURGE/LOG *.*4 QUIT_FILE_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 NoteHs for v3.5.3 for more info.4 RENAME  Enter R or r@ Rename allows the user to rename the selected files one at a time.0 DCL equiv: RENAME filename(s) new-filename(s)4 REPAINT_SCREEN # Enter ^W or ^R (Ctrl/W or Ctrl/R) Refreshes the screen.4 RE-SEARCH  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 Ientered, using Wildcards. e.g. *.C .4 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. J@ 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 c Kommand 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. Thus6 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 L 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 Mscratch file.@ After the user application is done, the scratch file is deleted.4 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 QUOTA4 SNAPSHOT_SCREEN Enter *@ Throughout SWING a snapshot of the screen may be taken. The@ resulting file is written to SWING$SAVE if this is defined.@ N 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.4 SUBMIT  Enter S or s@ Submit allows the user to submit the selected files O 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.4 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 f Pirst 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 CTQRL-Z.# NOTE8 If the standalone version of MOST supplied8 with SWING has been installed on your system,8 you also can access its Full Help at the3 system prompt via the command: $ most -h4 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 Rtime.< 2. The default printer queue for files printed via SWING.; 3. The default batch queue for files submitted by SWING.2 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 S 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 marTk).# NOTE8 No file name is added when a user-definable2 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.#U NOTE8 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.2 Command_Qualifiers D The following Swing qualifiers (or switches) can be used from DCL: /HELP D This qualifier displays help for the Swing command line (from DCL)( and then returns the user Vback 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.0 swing[ -f][ -0][ -s][ -c][ dir][,dir...] 3 -f Start up directly in the File manager.7 -0 Look for and use a device_000000_SWSVE.DAT7 file if a device_directory_SWSVE.DAT file7 is not found in the SWING$SAVE directory.9 W -s Exits in SYS$SPECIFIC restore SYS$SYSROOT as the default dir.9 -c Exits in SYS$COMMON restore SYS$SYSROOT as the default dir.5 dir Use VMS syntax including brackets (e.g.,7 [topdir.subdir] or device:[topdir.subdir]6 or [.subdir]). You can also use logical7 dir names (e.g., SYS$EXAMPLES). If a dir7 is not specified, your current default is assumed.D However, if anXy of the command line qualifiers have been installedC as defaults for Swing, they are not included in the help display. /VERSION D 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:D C SWING v3.7.5 (S.J.Brown, M.Akerberg, H.Flowers, F.Macrides & others) /FILEMANAGERD This command qualifier takes the user directly into the File4 YManager Screen and bypasses the Directory Manager. e.g. $ SW /F or $ SW -F /0 D This command qualifier directs Swing to look for a master (totalD device) SAVE_FILE if it does not find an SWSVE.DAT file for the root directory structure. e.g. $ SW /0 or $ SW -0D It is of relevance only to system managers, who would have the4 privileges required to access a total device tree. /C D This command quaZlifier directs Swing to make SYS$SYSROOT theD default device if you exit in a SYS$COMMON tree, and such a treeD has been put up via an argument or logical translation that had SYS$SYSROOT as the device. e.g. $ SW /C or $ SW -CD 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]D The SYS$SYSROOT device name is, in turn, a logical fo [r twoD devices, SYS$SPECIFIC and SYS$COMMON. In effect, you have entered a command equivalent to:C $ SW SYS$SPECIFIC:[SYSHLP.EXAMPLES],SYS$COMMON:[SYSHLP.EXAMPLES]D so that two directory trees are created. The files of interest toD general users are in the SYS$COMMON tree, whereas most of those inD the SYS$SPECIFIC tree are privileged, for use by the systemD manager. If you enter the SYS$COMMON tree to examine or use itsD files, and subsequently exit from Swing in t \hat tree, your default* device normally would become SYS$COMMON.D Note that the /C or -C qualifier will apply for all SYS$COMMOND trees if any have been put up via a SYS$$SYSROOT argument orD translation, but not if all were put up via explicit# SYS$COMMON:[directory] arguments. /S D This command qualifier directs Swing to make SYS$SYSROOT theD default device when you exit in a SYS$SPECIFIC tree, and such aD tree had been pu]t up via an argument or logical translation that had SYS$SYSROOT as the device. e.g. $ SW /S or $ SW -SD See the description of the /C or -C qualifier for more information.D Note that the /S or -S qualifier will apply for all SYS$SPECIFICD trees if any have been put up via a SYS$$SYSROOT argument orD translation, but not if all were put up via explicit% SYS$SPECIFIC:[directory] arguments.2 DOCUMENTATION D A full User ^Manual and Tutorial, SWING_MANUAL.MEM, can be found inD the SWING directory. Your system manager should have defined itD as the logical SWING_MANUAL, so that it can be printed via the command: $ print swing_manualD When using the TYPE utility (MOST), for displaying files withD paging, searching, and multiple-windowing facilities, use its FullD Help option (GOLD PF2 or GOLD H, where GOLD is PF1 or CTRL-X) toD access complete documentation of its functions and commands._ IfD the standalone version of MOST is installed on your system, itsD Full Help can be accessed at the system prompt by entering its help qualifier: $ most -hD SWING_MANUAL.MEM also can be viewed with the standalone MOST utility: $ most swing_manual2 LOGICAL_NAMES / The following logical names are used by SWINGD SWING$SAVE - see also SWING SAVE_FILE. This specifies the- destination for the files created by SWING.D It is recommended you defi `ne this logical if you want SWING'sD working files kept in a separate directory to your loginD directory. See the manual's section 2.1 (Setting up LOGIN.COM) for more details.D SWING$HLP - defined when the system boots to point to the SWING" help files. Do not change this.D MOST_HELP - defined when the system boots to point to the MOST& Full Help file. Do not change this.D CSWING$USERCOMMAND - can be predefined as a setup option. If itD is defianed, then the command G (or g) in the file manager willD cause a scratch file to be written and to have all selectedD filenames written to it, one per line with newline between, andD the user command defined in the logical will be executed via aD system() call with the filename of the scratch file passed as anD argument on the command line. Thus it can be picked up by a DCLD script or by a program. This is provided so that Swing can beD used as a file selector bfront end for pretty much anything youD like. It is of course up to the application to ensure that theD selected file or directory names (or both) are passed to anyD images called in pieces that can be used. After the user3 application is done, the scratch file is deleted.2 MOVING_AROUND D 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 cmove right,1 N, n or [Next Screen] to advance by one screen,3 P, p or [Prev Screen] to move back by one screen,D T, t to move to Top of the current structure, or if already at theB top then to the top of the previous structure (if there is one),D B, b to move to Bottom of the current structure, or if already atD the bottom then to the bottom of the next structure (if there is one) andD [Select] and [Find] (LK201 keyboard) can be used to move around anD internally he dld stack of `visited' directories. A directoryD becomes `visited' when the user invokes the FILE MANAGER in this2 directory. SELECT moves forward, FIND backward.2 PANIC D PANIC - Control-C or Control-Y gets you out of SWING in a hurry,D saving the current directory structure if necessary as it does so.2 QUICK_MENUS Enter ?D Quick menus are available throughout SWING whenever the top lineD of the display shows a ?. The user can select the requi ered option directly from this menu.2 RELEASE_NOTES 3 V3.7.5B This release of Swing implemented the following new features and bug fixes:B 1. Added the optional logical CSWING$USERCOMMAND. If defined,B the command "G" in the file manager will cause a scratchB file to be written and to have all selected filenamesB written to it, one per line with newline between, and theB user command defined in the logical will be executed via aB sy fstem() call with the filename of the scratch file passedB as an argument on the command line. Thus it can be pickedB up by a DCL script or by a program. This is provided soB that Swing can be used as a file selector front end forB pretty much anything you like, without particularly touchingB the Swing program itself. After the user application is: done, the scratch file is deleted. (Glenn Everhart)B 2. Fixed a bug with a routine not returni gng a successful statusB when it should. Caused problems with DEC C V4 on AXP. (Jesper Partoft)B 3. Several reports of A, B, C, or D being entered when a userB pressed arrow keys, etc. led to turning on hostsync whileB Swing is running. It should probably be on all the time forB these users, but Swing restores the original setting on exit. (Harry Flowers)B 4. Checked for and disallowed a directory to be moved under itself. (hHarry Flowers)B 5. Use different check for presence of DEC C compiler during aB build so that it will work using DEC C on a VAX. (Harry Flowers)3 V3.7.4B This release of Swing implemented the following new features and bug fixes:B 1. Fixed problem where Swing wouldn't purge a large number of files. (Harry Flowers)B 2. Fixed problem where sometimes a renamed file didn't show@ being renamed in the file manager window. (Harry Flowers)B i3. Fixed problem with DEC C where some versions can't findB fcbdef.h by defining DECC$TEXT_LIBRARY to point to the lib# definitions. (Harry Flowers)3 V3.7.3B This release of Swing implemented the following new features and bug fixes:B 1. Replaced SWING-STARTUP.COM with a totally newB SWING_STARTUP.COM. [Actually, this made it out in some of+ the V3.7.2 releases.] (Harry Flowers)B 2. Performance enhancements using multiblock and j multibuffer< counts in file opens to reduce I/O's. (Harry Flowers)3 V3.7.2B This release of Swing implemented the following new features and bug fixes:B 1. Changed default behavior of [Return] in the file managerB from a no-op to the same as "Y" to view files. This meansB that [Return] always has a function in the file manager; itB either views the file(s) or returns to the directory managerB depending on whether or not CR_RETURNS_FROM_FILE_TO_DIRk_MGR" is defined. (Harry Flowers)B 2. Fixed problem with Listing a file, and specifing the queueB as a batch queue, allowed a captive user to submit a command! procedure. (Richard Hardy)3 V3.7.1B This release of Swing implemented the following new features and bug fixes:B 1. (Enabled by PRINTMENU) The addition of a print menu if a ?B is typed for the queue name. The menu includes those queuesB which have a description field formatted as speci lfied in' PRINTMENU.README. (Butch Walker)B 2. The Print command can now print the current file, ratherA than requiring that the user select a file. (Butch Walker)B 3. (Changes to SWING.MMS) Added a DEBUG macro which compilesB and links with debug and places the .OBJ files in a [.dbg]B directory. This allows switching between debug and nodebugB versions with minimal recompilation. Added a USESCA macroB which creates an SCA library in [. mscalib], compiles withB /ana and loads the .ANA modules into the library. ThisB allows users with SCA and LSE to make use of the utilities0 for maximum effectiveness. (Butch Walker)B 4. Added debug changes to command files; the BUILD command fileB will now accept "DEBUG" as a parameter and work with either0 MMS or the command files. (Harry Flowers)B 5. Better handling of iosb status block in swing29.c (dealsB more intelligently with WAR nNING or INFO versus ERROR or SEVERE). (Nissim Etrog)B 6. Enabled passing of parameters to executeDCL(). (Nissim Etrog)B 7. Added informational messages for presses of undefined# command keys. (Nissim Etrog)B 8. Changed headers of the MATSHACK andB CRRETURNSFROMFILETODIRMGR logicals in swing.h to make moreB clear what they do and how they interact, and modified theB quick help menu for the Directory m oanager along the linesB submitted by Jeff Dykzeul (jd@mass.dnet.hac.com) so thatB it's correct, based on how they were defined. Also got theB quick help menu to be correct no matter what combinations ofB these two logicals and the QEXITSTOORIGINALDIR logical are! defined. (Foteos Macrides)B 9. Sleep for only one second after warning messages to bottom# of screen. (Foteos Macrides)B 10. Improved MOST's spawning behavior and updated its doc filpe. (Foteos Macrides)A 11. Updated C Swing manual and help library. (Foteos Macrides)3 V3.7.0B This release of Swing implemented the following new features and bug fixes:B 1. Upgraded MOST to 3.2.0FM. Added lots of new features andB switches as described in the header of its main.c and inB most.doc_fm. Most notably, now has both Quick Help (summaryB of commands) and Full Help (display of doc file), GOLD andB EDT style commands, -h qualifier q for showing Full Help fromB the DCL command line, -n Naive Prompt qualifer and logicalB for replacing the dev:[dir]filename string in the status@ line with other information or a title. (Foteos Macrides)B 2. Ported everything to DECC/Alpha, with tests for VAXC versusB DECC in the code and build procedures. Thanks to BillB Forbes, BFORBES@MR4DEC.ENET.DEC.COM, for help with VAXCB versus DECC differences. Thanks to Ross Smith,Br SMITH@MCCLB0.MED.NYU.EDU, for letting me use NYU Med's field$ test Alpha. (Foteos Macrides)B 3. Updated the SWING Help Library and SWING Manual. (Foteos Macrides)B 4. Fixed captive account editor selection (where there is noB user profile) to not allow selection of "Other" editorB commands, as any DCL command could be entered. (Harry Flowers)3 V3.6.5B Release 3.6.5 of Swing implemented the following features and bug fixe ss:B 1. Changed file view option when files are selected to promptB for viewing the current file if selected files are not viewed. (Harry Flowers)B 2. Fixed bug in showing broadcast messages; sometimes messagesB would fail to display, though the time banner would. ThisB was caused by an incorrect declaration of the messageB length, which would sometimes be corrupted as a result. (Harry Flowers)B 3. Upgraded MOST to 3.04FM. tAdded SecureMode extended switchB (+s) for use with gopher client, and otherB fixes/enhancements described in the header of MOST's main.c. (Foteos Macrides)3 V3.6.4; Release 3.6.4 of Swing implemented the following upgrade:B 1. Upgraded MOST to 3.03FM, as described in the header of its main.c. (Foteos Macrides)3 V3.6.3B Release 3.6.3 of Swing implemented the following new features and bug fixes:B 1. Fixed more bugs in code ufor searching for directories underB a 000000 directory if the device_000000SWSVE.DAT file existsB and the device_directory_SWSVE.DAT file doesn't. Made thisB behavior an option via a -0 or /0 qualifier. It can be madeB the default (i.e., regardless of whether -0 or /0 is enteredB on the command line) by defining ALWAYS_TRY_000000 in! SWING.H. (Foteos Macrides)B 2. Enhanced or debugged aspects of logical device nameB handling. How vever, earlier modifications to respectB terminal and concealed device logicals have broken some ofB CSWING's capacity to deal with search lists, and it can'tA all be restored without a major rewrite. (Foteos Macrides)B 3. Added code such that arguments or logicals which translateB to SYS$SYSROOT:[directory] will causeB SYS$SPECIFIC:[directory] and SYS$COMMON:[directory] trees toB be displayed (SYS$SPECIFIC is not in the SY wS$SYSROOT searchB list, so it must be treated as a special case). OptionalB defines (SPECIFIC_EXITS_TO_SYSROOT andB COMMON_EXITS_TO_SYSROOT) in SWING.H enable setting theB default device to SYS$SYSROOT on exit in SYS$SPECIFIC orB SYS$COMMON if an original call was for SYS$SYSROOT. Added aB -s or /s and a -c or /c qualifier to evoke this behavior ifB SPECIFIC_EXITS_TO_SYSROOT and COMMON_EXITS_TO_SYSROOT,B respec xtively, are not defined in SWING.H. For all otherB search lists that can be handled, the default directory onB exit is always that of the particular tree you were in at* the time of exit. (Foteos Macrides)B 4. Modified the command line (-h) help module to describe theB -0, -s and -c qualifiers if they were not made defaults viaB logicals in SWING.H or by including them in the foreign7 command definition for CSWING. (Foteos Macrides)B 5. y Added capacity to handle relative directory specs (e.g.,B [.foo] or [-.-.foo]). An argument with such a spec isB handled relative to the directory from which CSWING wasB called, regardless of its position in an argument listB (e.g., the list SYS$MANAGER,[] will put up trees forB SYS$SPECIFIC:[SYSMGR], SYS$COMMON:[SYSMGR], and your calling1 default, in that order). (Foteos Macrides)B 6. Added pause and prompt features for displa zys of CSWING.HLBB (like those when reading help libraries via DCL). The helpB page length is determined by the value of page_length,9 determined at startup of CSWING. (Foteos Macrides)B 7. Modified swing_8.c and swing_38.c to enable calling MOSTB with a set of selected files, and thereby use MOST'sB windowing features for multiple files (and appropriatelyB modified the quick help list in swing_22.c). Made numerousB modificati{ons/enhancements of MOST for maximum compatibilityB with CSWING, as described in the header of MOST's main.c.B Most noteably, command keys are now the same as orB homologous to those of CSWING wherever possible. MOSTB called from CSWING will read and use MOST_SWITCHES andB MOST_EDITOR if defined, can spawn editors and will use thatB defined for CSWING if its own logical is not defined, andB can spawn to DCL in a manner analogous t |o spawns from CSWINGB (or will respect the 'captive' restriction if set). AlsoB modified main.c so that a standalone MOST can be built withB the same code at that for CSWING. Added confirmation ofB intent to edit in swing_16.c and MOST (our users too oftenB hit E with intent to exit, not edit). Provided aB MOST.DOC_FM for this version of MOST (Note that the originalB copyright applies to it, and to any programs derived fromB it}: You must freely distribute the source code.). (Foteos Macrides)3 V3.6.2B Release 3.6.2 of Swing implemented the following new features and bug fixes:B 1. Consistent build procedures. Corrected documentation. (Harry Flowers)B 2. Supplied SWING-STARTUP.COM as documented in AAAREADME.1ST. (Chris Butler)B 3. Changed behavior when Swing is invoked in an unknownB subdirectory in a known structure. It used to just placeB ~you back at the top and give an unknown directory error.B Now, it rebuilds the dir structure and places you where you' wanted to start. (Harry Flowers)B 4. Made code for Q_EXITS_TO_ORIGINAL_DIR more efficient. (Foteos Macrides)B 5. Fixed bugs when getting the version limits of files forB display with format_5. If directory files are listed, theirB default version limits (for files created within the9 directories) are also disp layed. (Foteos Macrides)B 6. Modified to skip defragmentation of any files which have aB version limit set (otherwise, such files would be trashed;B the proper fix would be to eliminate the version limit,B defragment the file, then restore its version limit, butB since many sites now run defrag software this doesn't seem+ worth the bother). (Foteos Macrides)B 7. Fixed a bug in the code I submitted a while ago forB searching for € directories under a 000000 directory. ItB didn't work for directories that have a _ in their name.0 From: Mark London (MRL@NERUS.PFC.MIT.EDU)3 V3.6.13 Release 3.6.1 of Swing had the following bug fix:? 1. Bug fix with large screen size for MOST. (Harry Flowers)3 V3.6.0B This release of Swing contains no new features, only a fix forB VMS v5.5, some bug fixes and improvements in the MOST UtilityB (v3.02), which has been totally rewritten. MOST is run when you select 'Y' (for TYPE a file)B It was also decided to make this version 3.6 as there wereB becoming too many minor releases, and new sites would haveB otherwise needed to apply 6 sets of patches to the 3.5 kit. It6 will be available as a "whole" kit at archive sites. Modifications and bug fixes:B 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 SWINGB 3. Majo‚r improvement in MOST performance, especially when viewing large files.8 4. The online help screen in MOST has been rewritten.B 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.3 V3.5.4B Two new features have been added to this minor release of Swing:B 1. Added file exclude "#" option (opposite to the include "="B function) and SWING_EXCƒLUDE_FILES logical name to work like DIR/EXCLUDE.B Note: The include "=" option is exclusive; also file purgeB 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:B 1. Bug with negative percentages on large file copies$ occassionally appearing fixed.B 2. File creation dates on copy are now preserved (just like DCL copy does)B„ 3. Fixed memory leak; variables were being trashed when theB 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 ids3 V3.5.3B Three new features have been added to this minor release of Swing:B 1. The 'TYPE a file' command in File Manager now has a commandB 'W', 'w' or Ctrl/W to toggle betwee …n wide (132 columns) andB narrow (80 columns) while viewing the file on the screen.2 (This is a new feature of the MOST utility).B 2. For those who wish to use [Return] to toggle between theB File and Directory manager screens, the SWING.H file has aB 'macro directive identifier' calledB CR_RETURNS_FROM_FILE_TO_DIR_MGR. If you prefer this optionB and currently don't have it, see your system manager toB define this † in SWING.H and then rebuild swing. From Chris$ Butler (C.Butler@mof.govt.nz).B 3. For those who want the option of returning to the originalB directory (instead of the current one) when exiting Swing,B the SWING.H file has another 'macro directive identifier'B called Q_EXITS_TO_ORIGINAL_DIR. This allows 'Q' and 'q' toB perform this function, while all the other "exit" commandsB return the user to the CURRENT directory. If you preferB th ‡is option and currently don't have it, see your system? manager to define this in SWING.H and then rebuild swing. Bug fixes:B 1. Modified to ignore the non-displayable broadcast messagesB sent to VWS terminal windows. Otherwise whenever the VWSB window running swing is selected, the broadcast paste bufferB would pop up and try to display the message and fail with aB SMG$_NONBRDMSG status. From Carl Karcher (KARCHER@WAISM ˆAN.WISC.EDU)B 2. A small bug in the add_dstructure() part of SWING_24.C nowB repsects device logical names which have the concealed and terminal attributes.B Screen refresh after file manager @ and ~ leaves pointer atB current file after command executes. Both from Charles. Bailey (BAILEY@hmivax.humgen.upenn.edu).% So far, one known bug still exists:B There is a the problem with deleting a file when you've setB default to a search list ‰ like SYS$MANAGER. There's a bug inB RMS$ERASE that causes process termination (via executive modeB bugcheck). It has been reported to DEC and it has beenB escalated to the VMS engineering group. The workaround is toB set default to the individual directories (in this case, SYS$SPECIFIC:[SYSMGR]).3 V3.5.2B This release fixes all known bugs and provides the following New features:A 1. Replaces MORE with MOST in the TYPE option of File Manager.B 2.Š A /Help or -h command line option (eg. $ SWING /HELP) to( display help for the command line.B 3. A /Version or -v command line option (eg. $ SWING /VERSION)B to display the current version of Swing, and then return to DCL.3 V3.5.1B It contains fixes to some bugs reported after V3.5 was released,< as well as some nice new features. A description follows: New features:B 1. A /file_manager or -f command line option (eg.B $ SWING /FIL ‹E). This option specified on the command lineB will act just as if "F" were entered as soon as you get the directory manager screen.B 2. For those who wish to have the option of hitting [Return] toB exit SWING, instead of [Return] to go to File Manager theB SWING.H file has a 'macro directive identifier' calledB MATS_HACK. If you prefer this option and currently don'tB have it, see your system manager to define this in SWING.H and th Œen rebuild swing.B If MATS_HACK is defined some commands (such as copy andB move) are terminated with [Delete] instead of [Return].+ From Mats Akerberg (mats@efd.lth.se).B 3. When you don't have read access to your top directory, SWINGB will start with the directory it can read. Seems to beB common practice as most sites use concealed logicals to hideB the real top level directory. From Bernd Onasch (ONASCH@ira.uka.de). Bug fixes:B 1. Old problem with change protection only changing world protection has been fixed.B 2. Terminal characteristics (like numeric keypad) are now& restored on exiting from CSWING.B 3. Problem with long lines in configuration files (also from Mats).3 V3.5.0B The following new feature has been added between version 3.4 andB 3.5. This feature has always been in the code, but never worked.B 1. When exiting SWING, all ŽBroadcast messages received duringB the SWING session and the current default directory are displayed.3 V3.4.0B The following bugs were fixed between version 3.2 and 3.4 by+ Harry Flowers (flowers@msuvx1.memst.edu).0 1. Did not handle disks in bound volume sets.6 2. Couldn't exit from "@ - change file protection".B 3. Disk quota ("&") option did not stay on screen until key pressed.B 4. Quit option did not work on copy or move files or directory options.B 5. More ("Y") option failed after invoking it a fixed number of times.B 6. More ("Y") option W did not reset internally to normal from wide.B 7. More ("Y") option searching did not work in case-insensitiveB mode unless a lower-case string was used for the search pattern.B 8. More ("Y") option spacing problem with form feeds; nowB treated just like a non-printable character (replaces it with a "^" character).B 9. More ("Y") option caused the file manager to display the2 file in lower case after it had been viewed.3 V3.2.1B The following changes have been made since version 3.2 by Mats Akerberg (mats@efd.lth.se) DIRECTORY MANAGER:B 1. The 'E' key has been added to allow you to exit out ofB swing. So you can use the following keys to exit: E, e, Q,! q, Ctrl/C, Ctrl/Y or Ctrl/Z FILE MANAGER:B 1. The [Return] key has been added to a ‘llow you to exit fromB file manager back to directory manager. So you can use theB following keys to return to directory manager: Q, q, [Return] or Ctrl/ZB 2. You can now DISPLAY files on the the screen using the 'Y'! command in file management.B It makes use of the 'More' Utility and has some veryB powerful commands in it, such as edit the file you areB viewing, search for strings, skip pages and switch From 80B to’ 132 columns (and back again), which allows you to look at wide reports.8 Hit 'H' when you are in the type utility for help.2 SAVE_FILE D SWING only searches the directory structure if a save file cannot be found. SWING looks 1) first in SWING$SAVE:,D 2) second in the top directory of the structure being examined, 3) third in SYS$LOGIN:.D If no save file is found SWING searches the directory structureD and creates a save file, attemp“ting to store the save file asD above. SWING automatically attempts to purge old save files. All# save file names end in SWSVE.DAT.% 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.2 SNAPSHOT_SCREEN Enter *D Throughout SWING a snapshot of the screen may be taken. TheD resulting file is written to SWING$SAVE if this is ”defined. IfD not, then it is written to SYS$LOGIN. Screen snapshot filenamesD are of the form: SNAPSHOT_xxxxxx.LIS, where xxxxxx is a selectionD of unique letters and numbers chosen by SWING, to make the snapshot file unique.D Since the special characters used to draw lines cannot always beD displayed in a file, the device-independent characters (+,-,|) are used to draw lines.2 USER_DEFINABLE_OPTIONS Enter ^D (Ctrl/D), This will display the USER-OPTIONS win•dow. The user is able to define:D 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.2 4. The editor used by SWING when editing files.D 5. The LK201 function keys F7 through F20 (top of the keyboard)D and all the keys on the LK201 numeric keypad (right-hand side).D To change an entry in –the USER-OPTIONS window move the cursorD opposite the entry to be changed and press the [Space Bar]. TheD entry being changed is highlighted. When the next definition isD complete press [Return]. The original value can be restored by using the R option.D When a user-definable key is entered in the File Manager the nameD of the current file will be added to the command to be executed.D If this is not desirable for the specific command (e.g. the keyD has been d—efined as SHOW USERS, and no filename is required) theD 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.D Normally, the user will be prompted to confirm that the command isD to be processed. If this extra confirmation is not felt necessaryD a ^ ([Shift] 6) can be appended to the key definition. When a keyD de˜fined in this manner is pressed the command will execute/ IMMEDIATELY. So be careful with this option.% 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.2 VERSION  Enter V or vD Entering V causes the current version of SWING to be displayed on™! the bottom line of the display.2 WORKSTATION_SUPPORTD SWING supports workstations to a limited extent. On a workstationD it is possible to have windows with up to 64 lines. This is set via $ set term/page=64D SWING will support terminals of any size with the proviso that theD terminal is set to at least 24 lines (the default for a VT100, VT200 ...).2 BUG_REPORTS D CSwing was originally developed by Simon Brown from the BritishD Isles during l šate 1989 from a previous FORTRAN version. He made> substantial changes and produced about 95% of the C version.D Since then, it has been maintained by a small group of people,3 scattered from one end of the earth to the other.D If you have any bug reports, new feature requests, or have madeD 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 ›Tennessee Phone: +1 (901)678-2663; email: FLOWERS@MSUVX1.MEMST.EDU (on INTERNET)9 FLOWERS@MEMSTVX1 (on BITNET) Foteos Macrides3 Worcester Foundation for Experimental Biology Massachussetts Phone: +1 (508)842-8921; email: MACRIDES@SCI.WFEB.EDU (on INTERNET)9 MACRIDES@WFEB2 (on BITNET) Mats Akerberg" Lund Institute of Technology< School of Electrical Eœngineering and Computer Sciences Lund SWEDENB Phone: +46 (46)109-847 Fax: +46 (46)129-948; email: mats@efd.lth.se (on INTERNET)9 MATS@SELDC52 (on BITNET) Chris Butler Forest Research Institute Rotorua NEW ZEALANDB Phone: +64 (7)347-5604 Fax: +64 (7)347-9380; email: C.Butler@MoF.Govt.NZ (on INTERNET)D Acknowledgements to the follo wing people who developed andD maintained the FORTRAN-version (from which intellectual content of the C-version was gained):1 Eric Andresen of General Research Corporation* Craig Young of Hughes Aircraft Company Frank Nagy of Fermilab1 Walter Lamia of DIGITAL Equipment CorporationD Thanks also to the following people who have contributed to the= development of the C-version over the last couple of years:5 Charles Bailey (BAILEY@HMIVAX.HUMGEN.UPENN.EDU). ž Peter Chen (PETECHEN@CS.RUTGERS.EDU)2 Bill Forbes (BFORBES@MR4DEC.ENET.DEC.COM)/ Carl Karcher (KARCHER@WAISMAN.WISC.EDU), Mark London (MRL@NERUS.PFC.MIT.EDU)1 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)0 Holger Teutsch (TEUTSCH@FFM-IW.DEGUSSA.DE)D and finally, to John E. Davis (DAVIS@PACIFIC.MS.OHIO-STATE.EDU),> the author of MOST (from which our TYPE utility is derived).wwşŤZńw†B{˜ FLOWERS SWING