.p Getting going with SWING is a painless exercise. Follow the steps below and you'll soon learn how to use the major features. .HL2 ^*^&SETTING_ UP_ LOGIN.COM\&\* .P SWING needs a directory in which it can keep data files. The default directory is sys$login, but the logical SWING$SAVE can be set to a different directory if desired. .p It is better to use SWING$SAVE than have your sys$login directory cluttered with seemingly unintelligible files with weird filenames. .P If your default device and directory were MY__DISK:[MY__DEVICE], create a new directory MY__DISK:[MY__DEVICE.SWSAVE] via the DCL command .p $ create/dir MY__DISK:[MY__DEVICE.SWSAVE] .p Then put the following line in you login.com file: .p $ define/process SWING$SAVE MY__DISK:[MY__DEVICE.SWSAVE] .p Remember to change MY__DISK and MY__DEVICE to your actual default device and directory. .p Now you've done the hard work. Just invoke login.com (@sys$login:login) or if you logout and log back in then you'll be able to invoke SWING by typing: .p $ SW .p or SWI, SWIN or SWING. .HL2 ^*^&USING_ SWING\&\* .p Start swing via the foreign command you just set up, i.e. .p $ SWING .p and SWING will start up. First of all SWING will create a key__definitions file in SWING$SAVE (or sys$login if you decided not to define SWING$SAVE). Then SWING will search your directory structure, make a record of it in SWING$SAVE, and display your structure on the screen. You'll immediately see the difference between SWING and DCL - your directory structure is shown in 1990s' fashion for the first time! You are now using the DIRECTORY MANAGER. .HL2 ^*^&DIRECTORY_ MANAGER\&\* .p Try the cursor keys. You will find that you can move around your structure as easily as you can edit a file. Good-bye SET DEFAULT. Try typing T, B, N (or press NEXT SCREEN), P (or press PREVIOUS SCREEN) as you wish - see how you move around the structure. .p Although this part of the manual will not describe all the features of SWING, we'll run through a few of them here. Move to your top directory (that's where we started all this). Type F. The display changes... .HL2 ^*^&FILE_ MANAGER\&\* .p You are now in the FILE MANAGER - you now see all the files in your top directory. .p You can also navigate around the FILE MANAGER with up-arrow, down-arrow, T, B, N (or NEXT SCREEN), P (or PREVIOUS SCREEN) as you wish - see how you move around the file list. .p You can change the format of the directory information on display by using the left- and right-arrows or typing in directly the format you desire - in the range 0 to 9. Try it and see. .p Now we'll leave the FILE MANAGER and return to the DIRECTORY MANAGER by typing Q (for quit). .HL2 ^*^&ANOTHER_ DIRECTORY_ STRUCTURE\&\* .p You can see more than just your own directory structure - you can add directory structures for other users in your group to the display. The way to do this is by typing I (or INSERT HERE) to insert another structure. You'll be prompted for a directory specification. For example, type MOF_LIB and you will see the directory structure of MOF_LIB. .l You are also able to do the same to your application directories or other users directories who you are able to share data with. File security is always maintained through normal UIC or identifier protections. .p You now have two structures on display. You can move between them as you wish. A quick inter-structure hop can be made by moving to the left-most column and pressing the up- and down-arrow keys to move up and down the display. .p When you've had enough of (say the) MOF_LIB structure, you can remove it from your display. To do this, move to any directory in his structure. Press the grey REMOVE key (also above the cursor keys) (or type k). You'll be prompted to check that you wish to remove this structure from the display - type Y, and the structure will disappear. You'll be back in your own directories. .HL2 ^*^&DEFINING_ AN_ EDITOR\&\* .p You can edit files with SWING when you're in the FILE MANAGER. Before you do so it's best to define the editor you wish to use. It's not essential that you define your editor first, as SWING will prompt you for the name of the editor you wish to use if you haven't defined an editor. .p Type _^D (Control-D). The USER-OPTIONS window appears. A few lines down there is an entry for the editor that will be invoked whenever you decide to edit a file. Use the down-arrow key to move to this line, and press the SPACE BAR. You'll now be prompted for the editor you prefer. If you prefer EDT enter EDT, if you prefer EVE-WHIPS enter TPU. .p Now type E to return to the DIRECTORY MANAGER. You're now ready to edit you first file with SWING. .p Select the FILE MANAGER in the directory containing the file you wish to edit. move the cursor so that it appears by the file you wish to edit, type E and you'll be in the editor. Exit from the editor as you would do normally. .HL2 ^*^&CUSTOMISING_ KEYS\&\* .p You can define any of the grey keys on the top of the keyboard (F6 - F20) and the numeric keypad on the right of the keyboard (PF1 - PF4, 0 - 9, the MINUS, COMMA and ENTER keys) as you wish. .p Here we will define F11 to perform a SHOW USERS. .p Type _^D (Control-D) by holding down the 'Ctrl' key (on the left hand side of the keyboard, and while holding it down, hit the letter D). The USER-OPTIONS window appears. Move down the window, and you'll come to the entry "func. key F11". Press the SPACE BAR, and enter .p SHOW USERS ! . .p The ! is explained later in this manual. Then type E to leave the USER-OPTIONS. Press F11, and you'll be prompted to confirm a SHOW USERS command. Type Y, and you'll see that a new window appears in which your SHOW USERS command executes. .HL2 ^*^&THE_ DIRECTORY_ STACK\&\* .p SWING maintains a stack of directories as they are `visited'. A directory is said to be `visited' when the FILE MANAGER is invoked in that directory. It is possible to cycle through these directories in both the DIRECTORY MANAGER and the FILE MANAGER using the SELECT (LK201) and FIND (LK201) keys, thus reducing keystrokes to move between your favourite directories. .p SELECT moves you to the directory `visited' prior to the currently displayed directory, FIND moves you to the directory you `visited' prior to the currently displayed directory (i.e. undoes the last SELECT). .p The directory you are in goes to the top of the stack when you perform any operation in the FILE MANAGER other than SELECT or FIND. .p A directory disappears from the stack either when the FILE MANAGER detects that there are no files in the directory or when a more recently accessed directory pushes this directory off the stack. .p Thus the stack is ordered with the most recently used directories at the top. .p Pressing SELECT when at the bottom of the stack takes you to the top of the stack, similarly pressing FIND when at the top of the stack takes you to the bottom of the stack. .note The stack is not saved between invocations of SWING. .end note .HL2 ^*^&NOW_ READ_ THE_ MANUAL\&\* .p You're under way. Now read the rest of this manual, trying the commands as they are described. I hope you find SWING a labour-saving utility. .p Don't forget the ? quick menus and the help file which is invoked by typing H.