





1 SWING



  SWING is a very powerful VAX/VMS utility for displaying the  graphic

  representation  of  the VMS directory structure on any terminal that

  can support the SMG routines - that is primarily  the  VT100,  VT200

  and  VT300  series  of terminals or any PC terminal emulation of the

  above.  SWING  is  designed  to  make  life  easy  for  a  user  who

  frequently  performs  file or directory operations within his or her

  directories.

  It is designed using the same philosophy as  the  Personal  computer

  file  management  packages, such as XTREE-PRO, where the user should

  not (doesn't need) to  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 specify optional  parameters  -  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 SYS$LOGIN

  or     $ Swing RM_DISK:[JUNKDIR],MOF_LIB,FS_LIB

  or     $ Swing RM_DISK:[JUNKDIR] MOF_LIB FS_LIB

  or     $ Swing RM_DISK:[JUNKDIR],MOF_LIB FS_LIB



  SWING has a two level help facility.  Quick menus are available  via

  the  ?   option.   Standard  VMS help is available via the H or HELP

  (LK201) option.

2 COMMANDS



  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.

3 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.

3 CHANGE_FILE_OWNERSHIP

  Enter ~



  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.

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.

3 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.

3 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.

3 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 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.

3 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.



                                NOTE



          SWING will only delete files that the user could

          otherwise   delete  via  the  DCL  commands  SET

          PROTECTION and DELETE.



3 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

      ration  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.   The

  statistics are grouped together with the directory name.

3 FILE_MANAGER

  Enter F or f, (^F to  see  ONLY  the  directory  files  via  the

  FILE_MANAGER)



  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  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',  and  deselect  all

  files via 'Z' (zap).



  Also the user  can  select  files  based  on  a  (partial)  file

  specification via '+', and deselect in a similar way via '-'.



  At least one file must be selected for the Copy,  Delete,  Move,

  Rename and List options.



  If the user entered ^F a subset of the FILE MANGER functionality

  is  invoked.   Only  the  sub-directories  are  displayed.  This

  option is  included  to  allow  the  user  to  obtain  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 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).



                                NOTE



          This operation 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, *.h, *.exe, test.* etc..



                                NOTE



          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  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_OWNER

  Enter ~



  This option allows the user to change  the  ownership  of  the

  selected  files  and / or directories as desired.  The user is

  able specify the new file owner.

4 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.

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.

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  files  in  the

  current  directory.   The files to be fragmented must first be

  selected.  The user is twice  prompted  to  confirm  that  the

  directories   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.

4 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.



4 DIRECTORY_FORMAT



  There are ten  (yes,  ten!)  different  formats  of  directory

  information display within the file manager.



  To select the desired format just press key 0 through  key  9.

  The  selected format is shown on the bottom right-hand side of

  the display.



  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.

4 EDIT_EXISTING_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 key_definitions

  (^D) option.  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.

4 EDIT_NEW_FILE

  Enter ^E



  This allows the user to edit a new file.



  The user may define the default editor as per the EDIT option.

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.  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.



  This will be somewhat slower than using EDT or TPU, as SWING

  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".



  It has been tailored  to  use  the  Ministry  of  Forestry's

  EVE-WHIPS editor by default.

  If you want to overrride this and use a different flavour of

  TPU, then define a logical name in your LOGIN.COM thus:



  $ define/nolog  TPU$SECTIO  my-tpu-initialisation-file

4 EXECUTE

  Enter X or x



  Execute allows the user to execute the current file either  as

  a  command  file  or  as a executable (.EXE) file.  Only files

  with the .EXE file type will be executed



  e.g.  $ run <filename>



  others will be invoked



  e.g.  $ @ <filename>

4 EXPORT

  Enter >



  Export is like copy, except that the user is able to specify a

  full DECENT 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.

4 HELP

  Enter H, h



  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  DECENT file specification for the file to be copied into

  the current directory, e.g.



  NODE"user password"::file .



  The percentage file transfer is displayed while  the  transfer

  is in progress.



  The percentage file transfer is displayed while  the  transfer

  is in progress to bolster the confidence of the user.

4 KEY_DEFINITIONS

  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.



                               NOTE



          The !  and ^  should  not  be  used  with  the

          editor or queue definitions.





  The settings are saved in either



  SYS$LOGIN:SWING_SETTINGS.INITIAL or



  SWING$SAVE:SWING_SETTINGS.INITIAL if SWING$SAVE is defined.

4 LIST (Print)

  Enter L or l



  List allows the user  to  print  the  selected  files  to  the

  printer queue defined by the key_definitions option (^D).



  The user may, if desired, change the  printer  queue  for  the

  duration of the current session.

4 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  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.



4 MOVING_AROUND

  The user may move around  the  displayed  directory  structure

  using the four `arrow-keys',



  ^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 (LK201) and FIND (LK201) can be used to move around  an

  internally  held  stack of `visited' directories.  A directory

  becomes` visisted' when the user invokes the FILE  MANAGER  in

  this directory.  SELECT moves forward, FIND backward.

4 PURGE

  Enter U or u



  Purge allows the user to purge the current directory.



                               NOTE



          Sub-directories are not purged.



4 PRINT

  Enter L or l



  List allows the user  to  print  the  selected  files  to  the

  printer queue defined by the key_definitions option (^D).



  The user may, if desired, change the  printer  queue  for  the

  duration of the current session.

4 QUIT

  Enter Q, q, [ENTER] or ^Z



  Quit will leave the file manager  option  and  return  to  the

  directory managers

4 RENAME

  Enter R or r



  Rename allows the user to rename the selected files one  at  a

  time.

4 REFRESH_SCREEN

  Enter ^W or ^R



  Refreshes the screen.

4 RESEARCH

  Enter F, f or =



  The files  in  the  current  directory  are  researched.   The

  display is updated accordingly.



  If = is entered, then a search specification can be entered,



  e.g.  *.C .

4 SELECT_FILES



  The user selects / deselects files by pressing 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',  and  deselect  all

  files via 'Z' (zap).



  Also the user can select  files  based  on  a  (partial)  file

  specification via '+', and deselect in a similar way via '-'.



  At least one file must be selected for the Copy, Delete, Move,

  Rename and List options.

4 SUBMIT

  Enter S or s



  Submit allows the user to submit the  selected  files  to  the

  batch queue defined by the key_definitions option (^D)



  The user may, if desired,  change  the  batch  queue  for  the

  duration of the current session.

4 TYPE

  Enter Y or y



  Type allows the user  to  display  the  current  file  on  the

  terminal, and is the Public-domain "More" Utility.



  At the end of each screen, it displays (in reverse video)  the

  filename and the percentage displayed so far.



  To get help, hit 'H' or 'h'.



  To exit, hit 'Q', 'q' or CTRL/Z.



  A summary of the options in TYPE are:

  <SPACE>, f, ctrl-v             next screen

  b                              skip backward

  <cr>, +, j,ctrl-n,down arrow   next line

  -, ctrl-p, k, up arrow         scroll up one line

  c                              configure more

  d                              half a screen

  e                              start editing the file

  g                              go to specified line

  h, ?                           get help

  m                              mark current line (bottom line)

  n                              repeat last search

  q, ctrl-Z                      quit

  s                              skip over next screen

  t                              top of the file

  .                              repeat last command

  =                              display current line number

  ^G, '                          go to marked line

  ^L                             redraw screen

  ^W                             toggle narrow/wide screen width

  % #                            go to # per cent of the file

  !                              spawn subprocess

  /string                        search forward

  ?string                        search backward

3 HELP

  Enter H, h



  Help allows the user access to this information.  The  full  VAX

  help features are available.

3 IMPORT

  Enter <



  Import is like copy, except that the user is able to  specify  a

  full  DECENT  file  specification for the file to be copied into

  the current directory, e.g.



  NODE"user password"::file .



  The percentage file transfer is displayed while the transfer  is

  in progress.



  The percentage file transfer is displayed while the transfer  is

  in progress to bolster the confidence of the user.

3 INSERT_STRUCTURE

  Enter I, i or INSERT HERE (LK201)



  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.

3 KEY_DEFINITIONS

  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.



                                NOTE



          The !  and ^ should not be used with the  editor

          or queue definitions.





  The settings are saved in either



  SYS$LOGIN:SWING_SETTINGS.INITIAL or



  SWING$SAVE:SWING_SETTINGS.INITIAL if SWING$SAVE is defined.

3 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.

3 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.

3 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

  ENTER  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 or ENTER.

3 PURGE

  Enter U or u



  Purge allows the user to purge the  current  directory  and  all

  sub-directories.

3 QUIT

  Enter Q, q, E, e, Control-Z, Control-C, Control-Y



  Quit allows the user to exit  from  SWING.   The  save  file  is

  updated if changes have been made to the directory structure.

3 PRINT_DISPLAY

  Enter ^G



  This creates a file in  SYS$LOGIN:SWING_LISTING_FILE  containing

  the current structure(s) on display.



  The files may subsequently be printed via the list files  option

  in the file manager.

3 REFRESH_SCREEN

  Enter ^W or ^R



  Refreshes the screen.

3 REMOVE_STRUCTURE

  Enter K, k or REMOVE (LK201)



  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.



3 RENAME

  Enter R or r



  Rename allows the user to change the name of a directory.

3 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 {.

3 SEARCH

  SEARCH researches 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 BACKUP)



  If there are more than one structure on display then the user is

  prompted  to  research either all structures or just the current

  structure.

3 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 ).

3 WHERE

  Enter W or w



  WHERE switches on or off the  display  of  the  current  default

  device and directory on top of the display.

2 DOCUMENTATION

  A full User Manual and Tutorial can be found in:



  MOF_ROOT:[SWING]SWING.LIS

2 KEY_DEFINITIONS

  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.



                                 NOTE



          The !  and ^ should not be used with the editor or

          queue definitions.





  The settings are saved in either



  SYS$LOGIN:SWING_SETTINGS.INITIAL or



  SWING$SAVE:SWING_SETTINGS.INITIAL if SWING$SAVE is defined.

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.



  SWING$HLP - defined when the system boots to  point  to  the  help

  files.  Do not chnage this.

2 MOVING_AROUND

  The user may move around the displayed directory  structure  using

  the four `arrow-keys',



  ^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 (LK201) and FIND (LK201) can be  used  to  move  around  an

  internally  held  stack  of  `visited'  directories.   A directory

  becomes` visisted' when the user invokes the FILE MANAGER in  this

  directory.  SELECT moves forward, FIND backward.

2 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.

2 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.

2 RELEASE_NOTES_V32

  This is a major upgrade from version 1.0



  It has been totally rewritten  in  the  'C'  programming  language

  (from FORTRAN) and has a large number of new features that are too

  numerous to mention here.



  Almost all commands are upward compatible from the old version.



  It is recommended  that  you  read  the  tutorial  /  user  manual

  thoroughly  before  experimenting  too  much,  which  is  found in

  MOF_ROOT:[SWING]SWING.LIS.  This will take around 30 mins.



  It runs VERY fast and you can  do  all  your  directory  and  file

  management in this package, without going anywhere near DCL.

2 RELEASE_NOTES_V321

  The following changes have been made since  version  3.2  by  Mats

  Akerberg, Lund Institute of Technology, Sweden.



  DIRECTORY MANAGER:



  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:



  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



  You can now DISPLAY files on the the screen using the 'Y'  command

  in file management.

  It make 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.

2 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.



                                 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 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

  it is written to SYS$LOGIN.



  Since the special characters used to draw lines cannot  always  be

  displayed in a file, the device-independent characters (+,-,|) are

  used to draw lines.

2 VERSION

  Enter V or v



  Entering V causes the current version of SWING to be displayed  on

  the bottom line of the display.

2 WORKSTATION_SUPPORT



  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 ...).

