ProfitPress Mega CDROM2 Shareware Freeware (MSDOS)(1992)(Eng)

home *** CD-ROM | disk | FTP | other *** search

/ ProfitPress Mega CDROM2 …eeware (MSDOS)(1992)(Eng) / ProfitPress-MegaCDROM2.B6I / UTILITY / FILE / SAS41.ZIP / SAS24.DOC < prev next >

Wrap

Text File | 1990-05-19 | 114.9 KB | 2,560 lines

Swiss Army Shell Version 2.4 Copyright 1988, 1989, 1990 Steven C. Lee Swiss Army Shell Version 2.4 (c) 1988,1989,1990 Steven C. Lee ----------------------------------------------------------------- Introduction to Swiss Army Shell . . . . . . . . . . . . . . 5 What's New with Version 2 . . . . . . . . . . . . . . . . . 5 Mouse Support ! . . . . . . . . . . . . . . . . . . . . 5 Fast Loading ! . . . . . . . . . . . . . . . . . . . . 5 Support for PKPAK and PKZIP ! . . . . . . . . . . . . . 6 Point and Shoot at Another Drive ! . . . . . . . . . . 6 More Execution RAM ! . . . . . . . . . . . . . . . . . 6 Configuration Capability ! . . . . . . . . . . . . . . 7 Other New Features and Improvements . . . . . . . . . . 7 It's a LOTTA work! . . . . . . . . . . . . . . . . . . . . . 7 Registration Benefits . . . . . . . . . . . . . . . . . . . 7 WARRANTY DISCLAIMER . . . . . . . . . . . . . . . . . . . . 8 Distribution License . . . . . . . . . . . . . . . . . . . . 8 Software Requirements . . . . . . . . . . . . . . . . . . . 9 Program Limits . . . . . . . . . . . . . . . . . . . . . . . 10 Compatibility . . . . . . . . . . . . . . . . . . . . . . . 10 Installing Swiss Army Shell . . . . . . . . . . . . . . . . 11 Included Files . . . . . . . . . . . . . . . . . . . . . . . 12 Starting Swiss Army Shell . . . . . . . . . . . . . . . . . 13 Quitting . . . . . . . . . . . . . . . . . . . . . . . . . . 13 The Directory Tree File . . . . . . . . . . . . . . . . . . 13 Using Swiss Army Shell . . . . . . . . . . . . . . . . . . . 14 Mouse Usage . . . . . . . . . . . . . . . . . . . . . . 14 The Directory Window . . . . . . . . . . . . . . . . . 14 Files Window . . . . . . . . . . . . . . . . . . . . . 15 The Statistics Window . . . . . . . . . . . . . . . . . 16 Yes-No Questions . . . . . . . . . . . . . . . . . . . 17 Swiss Army Shell Tutorial . . . . . . . . . . . . . . . 17 Configuring Swiss Army Shell . . . . . . . . . . . . . . . . 21 Selecting List, Edit and Word Processing Programs . . . 21 Setting Window Colors . . . . . . . . . . . . . . . . . 22 Program List and Program Execution Menus . . . . . . . 24 ----------------------------------------------------------------- SAS24.DOC Page 2 Swiss Army Shell Version 2.4 (c) 1988,1989,1990 Steven C. Lee ----------------------------------------------------------------- Program Execution Option Codes . . . . . . . . . . . . 25 Archive Program Default . . . . . . . . . . . . . . . . 26 PKZIP Compression Switch . . . . . . . . . . . . . . . 26 Confirm Exit . . . . . . . . . . . . . . . . . . . . . 26 Sound ON/OFF . . . . . . . . . . . . . . . . . . . . . 26 Duplicate File Check . . . . . . . . . . . . . . . . . 26 Write Configuration File . . . . . . . . . . . . . . . 26 Swiss Army Shell Commands . . . . . . . . . . . . . . . . . 27 Shortcut Keys . . . . . . . . . . . . . . . . . . . . . 27 Cursor Movement Summary . . . . . . . . . . . . . . . . 28 Directory Cursor Movement . . . . . . . . . . . . . . . 28 File Cursor Movement . . . . . . . . . . . . . . . . . 28 Archive Management SubSystem . . . . . . . . . . . . . 29 Attribute Menu . . . . . . . . . . . . . . . . . . . . 29 Enter Dos Command . . . . . . . . . . . . . . . . . . . 29 Copy Tagged Files . . . . . . . . . . . . . . . . . . . 30 Copy Directory . . . . . . . . . . . . . . . . . . . . 30 Drive Change . . . . . . . . . . . . . . . . . . . . . 31 Delete Tagged Files . . . . . . . . . . . . . . . . . . 31 Edit File . . . . . . . . . . . . . . . . . . . . . . . 31 Find File . . . . . . . . . . . . . . . . . . . . . . . 32 Find File (Normal or Archived) . . . . . . . . . . . . 32 Find File (Search Archive Only) . . . . . . . . . . . . 32 List File . . . . . . . . . . . . . . . . . . . . . . . 32 Move Tagged Files . . . . . . . . . . . . . . . . . . . 33 New Screen . . . . . . . . . . . . . . . . . . . . . . 33 OS Shell . . . . . . . . . . . . . . . . . . . . . . . 33 Program Execution . . . . . . . . . . . . . . . . . . . 33 Print Tagged Files . . . . . . . . . . . . . . . . . . 34 Quit in Current Directory . . . . . . . . . . . . . . . 34 Quit in Original Directory . . . . . . . . . . . . . . 34 Rename File . . . . . . . . . . . . . . . . . . . . . . 34 Rescan Current Drive . . . . . . . . . . . . . . . . . 34 Rename Directory . . . . . . . . . . . . . . . . . . . 34 SAS Configuration . . . . . . . . . . . . . . . . . . . 35 Sort Options . . . . . . . . . . . . . . . . . . . . . 35 Tag File . . . . . . . . . . . . . . . . . . . . . . . 35 Tag All Files . . . . . . . . . . . . . . . . . . . . . 35 Untag File . . . . . . . . . . . . . . . . . . . . . . 35 Untag All Files . . . . . . . . . . . . . . . . . . . . 35 View Archive . . . . . . . . . . . . . . . . . . . . . 36 Execute Program . . . . . . . . . . . . . . . . . . . . 36 Add Directory . . . . . . . . . . . . . . . . . . . . . 36 Delete Directory . . . . . . . . . . . . . . . . . . . 36 Quit in Highlighted Directory . . . . . . . . . . . . . 37 ----------------------------------------------------------------- SAS24.DOC Page 3 Swiss Army Shell Version 2.4 (c) 1988,1989,1990 Steven C. Lee ----------------------------------------------------------------- Archive Management Subsystem . . . . . . . . . . . . . . . . 38 Add Tagged Files . . . . . . . . . . . . . . . . . . . 38 Extract File Under Cursor . . . . . . . . . . . . . . . 38 Extract Tagged Archives . . . . . . . . . . . . . . . . 39 Compress Directory . . . . . . . . . . . . . . . . . . 39 UnCompress Archive . . . . . . . . . . . . . . . . . . 39 PKPAK/PKZIP Options . . . . . . . . . . . . . . . . . . 39 Make File Self Extracting . . . . . . . . . . . . . . . 40 Toggle Compatibility . . . . . . . . . . . . . . . . . 41 PKZIP Compression Toggle . . . . . . . . . . . . . . . 41 Integrity Test . . . . . . . . . . . . . . . . . . . . 41 Switch . . . . . . . . . . . . . . . . . . . . . . . . 41 Swiss Army View . . . . . . . . . . . . . . . . . . . . . . 41 Support . . . . . . . . . . . . . . . . . . . . . . . . . . 42 SAS Entomology . . . . . . . . . . . . . . . . . . . . . . . 42 Kudos . . . . . . . . . . . . . . . . . . . . . . . . . . . 42 Registration Form . . . . . . . . . . . . . . . . . . . . . 43 ----------------------------------------------------------------- SAS24.DOC Page 4 Swiss Army Shell Version 2.4 (c) 1988,1989,1990 Steven C. Lee ----------------------------------------------------------------- Introduction to Swiss Army Shell -------------------------------- Swiss Army Shell is designed to make management of hard disks easy. It provides you with an organized view of the directory structure on your disk, and can manage up to 20 logical drives. Swiss Army Shell makes copying, deleting, moving, and archiving files simple. You also have options for listing and editing text files or executing other programs with just a few keystrokes or mouse clicks. It has been designed to interface with the PKPAK/PKUNPAK and PKZIP/PKUNZIP archive systems by Phil Katz. You will need one or the other of these packages to use the Archive Management functions, but Swiss Army Shell will work fine without these programs. Swiss Army Shell has a point and shoot user interface which allows you to tag files for copy, move, delete, and archive operations. Operations may be performed on single files without tagging. The mouse interface (new with version 2) allows you to handle most operations without touching the keyboard. Throughout this document I refer to Swiss Army Shell by using the acronym "SAS". This is done simply to avoid typing the full name each time, and is not intended to associate Swiss Army Shell with the Statistical Analysis System, which is a product of the SAS Institute in Cary, North Carolina. What's New with Version 2 ------------------------- Mouse Support ! --------------- Version 2 has added a completely new mouse interface, as well as an alternative menu driven keyboard interface. The same commands used in version 1.1 are still available as shortcut keys, but you may now do everything from menus if you wish. The Master Menu may be popped up and down by pressing F10, or the right mouse button. Fast Loading ! -------------- Swiss Army Shell now stores a file named SASDRV.TRE in the root of each hard drive. If this file is found SAS will load the directory tree from that file rather than scanning the drive, making initial startup MUCH! faster. When you first start this version you should change to each hard drive so that SAS can scan and write the .TRE file. After each drive has been scanned and the .TRE file written, SAS will load and change drives VERY fast! ----------------------------------------------------------------- SAS24.DOC Page 5 Swiss Army Shell Version 2.4 (c) 1988,1989,1990 Steven C. Lee ----------------------------------------------------------------- * Note : If you add or delete directories while NOT inside SAS, the next time you start SAS you should Rescan (ALT R) the drive so that the .TRE file will be updated. SAS has no way to detect changes since it was last run, and will not know the directories have changed if you don't do a Rescan! If you start SAS while in an unrecognized directory, the drive will automatically be rescanned. Support for PKPAK and PKZIP ! ----------------------------- Swiss Army Shell now supports PKPAK/PKUNPAK and PKZIP/PKUNZIP. PKARC/PKXARC are no longer supported, so you will need one or both of these programs to use Archive Management. Point and Shoot at Another Drive ! ---------------------------------- Swiss Army Shell now allows you to point and shoot at directories on other drives for Copy Tagged, Copy Directory, and Archive Extraction operations. When you invoke Copy Tagged Files or Extract Archive you may now press Alt D or click on the Directory Window title block, and select a drive (Escape will abort the operation). If SASDRV.TRE exists on the drive, a tree diagram will be quickly loaded, and you may point at the desired directory with the directory cursor keys. If SASDRV.TRE does not exist you will have options to scan the drive or abort the operation. Pressing <CR> or clicking on the highlighted directory will copy the tagged files to the directory highlighted on the tree. More Execution RAM ! -------------------- Swiss Army Shell 2 has added the capability to swap itself to disk or EMS memory during program execution. Through the Configuration Option you may select whether or not to swap for each program. Swap to Disk/EMS capability is provided by the generosity of TurboPower Software. Swiss Army Shell uses the ExecSwap unit published in the April 1989 issue of Dr. Dobb's Journal. I can't give enough thanks to TurboPower for releasing this unit ! ----------------------------------------------------------------- SAS24.DOC Page 6 Swiss Army Shell Version 2.4 (c) 1988,1989,1990 Steven C. Lee ----------------------------------------------------------------- Configuration Capability ! -------------------------- Swiss Army Shell now allows you to configure the following items : - Select your favorite File Listing Program - Select your favorite Editor - Select your favorite Word Processor - Select your favorite Colors for All Windows - Enter up to 10 DOS Command lines for Quick Execution - Pick PKPAK or PKZIP as your Default Archive Program - Exit Confirmation - Select Swap to Disk/EMS for EACH program you run - Toggle Sound On or Off Other New Features and Improvements ----------------------------------- Other new features in Swiss Army Shell include : - Copy a directory and all subdirectories to another location. - Complete control over file attributes. - Find File speed has DOUBLED ! - Find Files across MULTIPLE drives ! - Support for PKZFIND ! - Improved and more powerful Delete Directory. It's a LOTTA work! ------------------ I estimate that I now have at least 1000 hours work invested in Swiss Army Shell through version 2.4. Version 2.4 is freely distributed without restriction. The registration fee has been reduced to $20 to encourage registrations. Registration Benefits --------------------- The registration fee for Swiss Army Shell is $20. Anyone who registers will receive a disk containing the next update to Swiss Army Shell. ----------------------------------------------------------------- SAS24.DOC Page 7 Swiss Army Shell Version 2.4 (c) 1988,1989,1990 Steven C. Lee ----------------------------------------------------------------- Registrations should be sent to: Steven C. Lee 304 Pierson Drive Trussville, Alabama 35173 I may be contacted via EMail on the following systems : The ST BBS (Steve Lee) Birmingham, Alabama (205)836-9311 300/1200/2400-8-N-1 Compuserve EasyPlex (71076,1216) Please don't leave a CompuServe Forum message because I just can't keep up with the board. The ST BBS is the best place to leave a message as I am on that board frequently. If you have questions or need support you may contact me at (205) 655-3926. WARRANTY DISCLAIMER ------------------- SWISS ARMY SHELL IS NOT COVERED BY ANY WARRANTY EITHER EXPRESSED OR IMPLIED, INCLUDING WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. THE AUTHOR WILL NOT BE HELD RESPONSIBLE FOR ANY DAMAGES WHATSOEVER, EITHER DIRECT OR INDIRECT, INCLUDING LOSS OF REVENUE, LOSS OF SAVINGS, OR LOSS OF DATA RESULTING FROM THE USE OF THIS PROGRAM. YOUR USE OF THIS PROGRAM CONSTITUTES YOUR ACCEPTANCE OF THIS DISCLAIMER AND YOUR RELEASE OF THE AUTHOR FROM ANY FORM OF LIABILITY OR LITIGATION. Distribution License -------------------- Swiss Army Shell Test Drive may be freely distributed as SAS24.ARC or SAS24.ZIP. The archive may be extracted and rearchived in another format as long as all files remain unmodified. This software may not be bundled with any product without the written consent of the author. ----------------------------------------------------------------- SAS24.DOC Page 8 Swiss Army Shell Version 2.4 (c) 1988,1989,1990 Steven C. Lee ----------------------------------------------------------------- Software Requirements --------------------- Swiss Army Shell runs under MSDOS or PCDOS 2.0 or higher. DOS versions below 3 will not be able to rename directories. The only support files needed are KEYHELP.SAS and MOUSHELP.SAS. These files must be in the PATH for help to be available. External programs are called to handle Archive Management, file listing, and file editing functions, and they MUST be in the current PATH for those functions to work. Swiss Army Shell makes working with archive files easy. In order to make use of the archive management features in SAS, you will need the following archive management programs: PKPAK.EXE PKUNPAK.EXE PKFIND.COM PKZIP.EXE PKUNZIP.EXE PKZFIND.EXE If you work only with .ARC files you will not need PKZIP or PKUNZIP. Swiss Army Shell also makes it easy to list and edit files. The configuration menu gives you the ability to choose your favorite file listing and editing programs. The default list program is set up as LIST.COM which is intended to call Vernon Buerg's popular LIST program. The default Editor and Word Processor will be set up as EDLIN.COM. You should use the Configuration Option to set up your own choices for LIST, EDIT, and Word Processing programs. PKPAK, PKZIP and LIST are ShareWare programs and can usually be obtained from Compuserve and most bulletin boards. If you use these programs you should support the authors and register them. I also recommend that you obtain a keyboard repeat rate enhancer such as QUICKEYS.COM or TURBOKEY to speed up cursor movement. Quickeys is a program from PC Magazine and is free. The BROWSE program from PC Magazine is also an excellent file lister. Although Swiss Army Shell is specifically designed to interface with PKPAK, PKUNPAK, PKFIND, PKZIP, and PKUNZIP, these programs are not required. If these programs cannot be found, the commands that call them simply will not work. ----------------------------------------------------------------- SAS24.DOC Page 9 Swiss Army Shell Version 2.4 (c) 1988,1989,1990 Steven C. Lee ----------------------------------------------------------------- Program Limits -------------- Swiss Army Shell is currently limited to 100 directories, 512 files per directory, and a directory nesting depth of 7 below the root. The only reason for these limits is my attempt to keep memory requirements within reason. If you become a registered user and need a version with higher limits, I will be happy to supply you with a customized version upon request. Both color and monochrome adapters are supported. Monochrome adapters will be automatically detected. Hercules adapters must be in text mode for SAS to work properly, and will be treated as standard monochrome adapters. If you have a color adapter driving a composite monochrome monitor, you may append "/m" to the invocation line to get the monochrome color setup. Swiss Army Shell 2.4 requires 210K of free RAM. However, the addition of swap to disk/EMS capability reduces this requirement to under 67K during external program execution. Although the size of the executable file has doubled since version 1.1, version 2.4 actually allows external programs more free RAM in which to execute when swapping is enabled. Compatibility ------------- Swiss Army Shell should run on any PC compatible. It was developed on a 5 year old Columbia MPC with CGA, 512K RAM, AST Six Pack Plus, Seagate ST225 20 meg hard disk, and a 10 + 10 Bernoulli Box. It is compatible with SideKick, and should be compatible with any TSR that does not preempt its command keys. The mouse interface requires that a Microsoft Mouse compatible drive be installed. Swiss Army Shell 2.4 has been tested with Microsoft, Mouse Systems, Logitech, and Keytronics mice. The Turbo Power Software ExecSwap unit has been tested with some extremely large programs including AutoCad, Word Perfect, PC Paint, and Procomm Plus. It has proven extremely reliable, and also extremely fast when EMS memory is available. Version 2 has an annoying habit of leaving mouse cursor blocks when restoring screen segments on some monitors. This does not affect program operation in any manner. ----------------------------------------------------------------- SAS24.DOC Page 10 Swiss Army Shell Version 2.4 (c) 1988,1989,1990 Steven C. Lee ----------------------------------------------------------------- Installing Swiss Army Shell --------------------------- * Note : Throughout this document <CR> means to press the return key and click means to position the mouse cursor on the item mentioned and press the left mouse button. If you are an experienced PC user you may want to skip this section. Just make sure that SAS.EXE, SAV.EXE, SASCFG.EXE, KEYHELP.SAS, MOUSHELP.SAS and the external programs mentioned in the Software Requirements section above are in the current PATH and go to work. You can get help at any time by pressing H, clicking the mouse on the word Help at the lower right corner of the screen, or selecting Misc from the Master Menu. I am not going to attempt to explain the PATH statement or how DOS finds the programs used by SAS. I will simply describe in "cookbook" fashion how to set up your disk to work with SAS. Although a hard disk is not required to use SAS, if you don't have one then you probably don't need this program. The following instructions assume you have at least one hard disk configured as drive C. 1) Boot your computer and wait for the C:> prompt. 2) Enter TYPE AUTOEXEC.BAT <CR>. 3) Look for a line beginning with the word PATH. if you see this line you will notice one or more directory names separated by semicolons. For example : PATH C:\;C:\DOS;C:\UTIL If AUTOEXEC.BAT does not exist then skip to step 7 below. If AUTOEXEC.BAT does exist but does not contain a PATH statement, use a word processor or editor to add the PATH statement shown in step 7. 4) Decide which directory you want to use to store SAS (I use \UTIL) and change to it. For example enter: CD\UTIL <CR> 5) Place the disk containing SAS.EXE, SASCFG.EXE, SAV.EXE, KEYHELP.SAS, and MOUSHELP.SAS in drive A and enter COPY A:*.*<CR> DOS will copy the files to your hard disk. 6) If you have obtained PKPAK,PKUNPAK,PKFIND,PKZIP,PKUNZIP and LIST, copy these programs to the same directory. If you have ----------------------------------------------------------------- SAS24.DOC Page 11 Swiss Army Shell Version 2.4 (c) 1988,1989,1990 Steven C. Lee ----------------------------------------------------------------- word processing and editing programs you wish to run from SAS, you will need to set them up using the Configure SAS option explained later in this document. 7) If AUTOEXEC.BAT does not exist then: a) Go to your computer store and shoot the salesman who sold you your computer. b) Boot your computer, wait for the C:> prompt, and enter the following keystrokes exactly as they appear below: COPY CON AUTOEXEC.BAT <CR> PATH C:\;C:\SAS <CR> <CTRL>Z <CR> ( <CTRL>Z means to hold the control key down while pressing Z) ( <CR> means press the Enter or Carriage Return key. ) DOS should respond with the message "1 File(s) copied" and you will see C:> again. c) Enter MD SAS <CR> then CD SAS <CR> d) Follow steps 5 and 6 above. e) Reboot your computer. Swiss Army Shell may now be run from any drive or directory by entering SAS<CR>. If you don't understand these instructions then you may call me at 205-655-3926. I will be happy to talk you through the procedure. Included Files -------------- This disk should contain the following files: SAS.EXE SAS24.DOC SASCFG.EXE SAV.EXE KEYHELP.SAS MOUSHELP.SAS SAV.DOC README.SAS There will also be one or more files named UPDATE. These files contain revision history since version 2.0. You should check the end of the file for the latest features and bug fixes. ----------------------------------------------------------------- SAS24.DOC Page 12 Swiss Army Shell Version 2.4 (c) 1988,1989,1990 Steven C. Lee ----------------------------------------------------------------- Starting Swiss Army Shell ------------------------- Swiss Army Shell may be started from the DOS command prompt by entering: SAS [drive:path] [/m]<CR> If the optional drive:path is specified, SAS will change to that drive and directory and look for the file SASDRV.TRE in the root directory of the drive. If SASDRV.TRE is found, SAS will immediately display the directory tree and the files in the current directory. If SASDRV.TRE is not found, the disk will be automatically scanned. If the drive:path is invalid, the current drive and directory will be used. Monochrome adapters will be automatically detected. The optional "/m" switch will start SAS with the monochrome color scheme even if you are using a color adapter. If you are using a color adapter and a composite monochrome monitor you may prefer this black and white mode to the normal color scheme. The video mode is not checked during startup. If you have an EGA or VGA you should insure that it is in 25 line mode before starting SAS. Hercules adapters should be in text mode. Quitting -------- Swiss Army Shell has three keyboard exit options. Q will exit in the current directory. ALT Q will exit in the original drive and directory from which you started. Escape exits in the directory under the directory cursor. There is a fourth option for mouse users. Pressing both left and right mouse buttons simultaneously (called a chord) will exit in the current directory (same as Q). Swiss Army Shell usually waits until it detects a button release before taking action, so you should press and hold both buttons, then release them simultaneously. The Directory Tree File ----------------------- Each time you quit or change drives, a file named SASDRV.TRE will be written in the root directory of the current drive. This file contains the directory tree of the current drive. If this file is found during startup or drive changes the tree file is loaded rather than scanning the drive. This make startup much faster. Version 2.4 will automatically detect incompatible tree files from earlier versions, and automatically rescan. Though SAS is not network aware, it will work with may networks. This has caused some problems in the past where a ----------------------------------------------------------------- SAS24.DOC Page 13 Swiss Army Shell Version 2.4 (c) 1988,1989,1990 Steven C. Lee ----------------------------------------------------------------- network drive may have a different drive letter depending on which drop it is accessed from. SAS stores the drive letter in the .TRE file, and when the tree file is loaded from a remote drop on the network, the root directory on the tree diagram would not reflect the correct drive letter as recognized by the remote machine. Version 2.4 will now show the correct drive letter in the root directory. * Note : Tree files will not be created on drive A or B. If you use removable media hard drives such as Bernoullis, you should rescan those drives each time you change cartridges. Using Swiss Army Shell ---------------------- When you run Swiss Army Shell, three windows will be displayed. If SAS cannot find SASDRV.TRE it will scan the current disk, then display a tree diagram of your directory structure in the upper left window, with the current directory highlighted. The files in the current directory will be displayed in the upper right window, and statistics about the disk, current directory, and file under the cursor will be show in the small window across the bottom of the screen. The upper left window is called the Directory Window. The upper right Window is called the Files Window, and the bottom window is called the Statistics Window. Mouse Usage ----------- The mouse will display a character sized block called the mouse cursor. This cursor will be visible except when the mouse is being used to select from menus. The usual selection procedure is to point by placing the mouse cursor on an item and pressing, then releasing the left mouse button. The left mouse button may also be used like the Enter key to accept default choices in data entry windows. The right mouse button Escapes from menus and other types of windows. It is also used to toggle the Master Menu on and off. The Directory Window -------------------- The Directory Window depicts the subdirectories on your disk. All first level subdirectories are shown to branch from the root ("\") directory, with child directories shown below their parents. To change directories you must move the Directory Cursor to your destination directory and select it. Once the directory is ----------------------------------------------------------------- SAS24.DOC Page 14 Swiss Army Shell Version 2.4 (c) 1988,1989,1990 Steven C. Lee ----------------------------------------------------------------- selected it will be scanned, and its files displayed in the Files Window. The Directory Cursor may be moved with the keyboard or mouse. The keyboard commands are shown here : F1 or Ctrl PgUp Moves up one directory F2 or Ctrl PgDn Moves down one directory F3 or Ctrl Home Moves to the root directory F4 or Ctrl End Moves to the last directory F5 or Ctrl Left Arrow Moves to first directory in the window F6 or Ctrl Right Arrow Moves to the last directory in the window <CR> Selects the directory under the cursor To move the Directory Cursor with the mouse, point the mouse cursor to the desired directory and press the left button once. When the Directory Cursor has been moved, the directory may be selected by a click on the highlighted directory. There are several special areas in the Directory Window that may be used in conjunction with the mouse. These areas and their functions are show here : Upper Left Corner Cursor to Root Dir Lower Left Corner Cursor to Last Dir Upper Right Corner Page Up Lower Right Corner Page Down Top Bar Scroll Up Bottom Bar Scroll Down TitleBlock Change Drive Menu Hilited Directory Changes to that Dir The Directory Cursor is free to move around anytime, but it is important to note that a directory does not become the current directory until it has been selected by pressing <CR> or clicking on it while it is highlighted by the Directory Cursor. Files Window ------------ The Files Window shows the files in the current directory. There may be several pages of files, and Swiss Army Shell allows up to 512 files in a directory with 60 files per page. Note that this may not necessarily be the same directory under the Directory Cursor. The current file will be highlighted by the Files Cursor, which is two triangles with the file name bracketed between them. The Files Cursor may be moved by the keyboard or the mouse. The keyboard commands for moving the Files Cursor are shown here : ----------------------------------------------------------------- SAS24.DOC Page 15 Swiss Army Shell Version 2.4 (c) 1988,1989,1990 Steven C. Lee ----------------------------------------------------------------- Up Arrow Move up one file Down Arrow Move down one file Left Arrow Move left one column Right Arrow Move right one column Home Move to the first file End Move to the last file PgUp Displays the previous page PgDn Displays the next page If there is no next page PgDn moves to the last file on the page. To move the File Cursor with the mouse, move the mouse cursor to the desired file and click the left mouse button. The File Cursor will move to that file, and the file will be tagged (or untagged if it was already tagged). There are several special areas in the Files Window that may be used in conjunction with the mouse. These areas and their functions are shown here: Upper Left Corner First File (same as Home) Lower Left Corner Last File (same as End) Upper Right Corner Page Up Lower Right Corner Page Down Files may be tagged for Group File operations. Tagged files will be shown in reverse video. File Tag Status may be toggled on or off by clicking on a file. If the file is already tagged it will be untagged, or vice versa. Multiple files may be tagged or untagged by clicking and holding the left button on a file that is NOT under the cursor, then dragging the mouse. Note that dragging the cursor across an untagged file will tag it, and dragging it across a tagged file will untag it. CAUTION : If the mouse is moved too fast, not all files crossed will be detected. The Statistics Window --------------------- The Statistics Window takes up the bottom 3 lines on the screen and displays information about the current drive, directory, and file. Displayed at the left end of the window will be the current drive size, and the amount of free and used space on the drive. The top line in the rest of this window shows the number of files, the number of bytes, and the number of bytes tagged in the current directory. ----------------------------------------------------------------- SAS24.DOC Page 16 Swiss Army Shell Version 2.4 (c) 1988,1989,1990 Steven C. Lee ----------------------------------------------------------------- The bottom line shows information about the file under the File Cursor. The file name, extension, attributes, date, and time are displayed under appropriate headers. There is one special area in the Statistics Window that is used in conjunction with the mouse. Clicking on the word Help in the lower right corner will display the Mouse Help File. The Keyboard Help file may be displayed by pressing H. Yes-No Questions ---------------- Whenever you are asked a yes-no question, you may press "Y", "N" or Escape. If you have a mouse, the window that appears will contain buttons that will highlight when the mouse cursor is on them. To answer Yes or No, move the mouse cursor to the appropriate button and press the left mouse button. Pressing the right mouse button or Escape will return a No answer. Swiss Army Shell Tutorial ------------------------- This section will give you a short introduction to the features in Swiss Army Shell. If you have a mouse, you make sure that the Microsoft compatible mouse driver is loaded. If you have a Microsoft Mouse, just run MOUSE.COM. If you have a Mouse Systems mouse, run MSMOUSE.COM. For additional details on setting up and using your mouse you should consult your mouse user's manual. Start up Swiss Army Shell by typing SAS and pressing the Enter key. The three windows described above will be displayed. This is called the main screen. The first thing you should do is press the F3 key then the Enter key. This will make the root directory current for the following exercise. Press the F10 key a few times. You will see a horizontal bar at the top of the screen appear and disappear. This is called the Master Menu, and the words appearing on this line represent submenus. With the Master Menu visible, press the left and right arrow keys. You will see each submenu title highlighted as the Menu Cursor (sometimes called the Menu Bar) moves. If you have a mouse, click the right button several times. When you are in the main screen the right button toggles the Master Menu on and off just like the F10 key. With the Master Menu visible move the mouse left and right. The Menu Cursor will move just as if you were moving the arrow keys. Move the Menu Cursor so that it is on the left most item, "DiR". This is the Directory submenu. There are several ways to select a submenu, and they are described below. ----------------------------------------------------------------- SAS24.DOC Page 17 Swiss Army Shell Version 2.4 (c) 1988,1989,1990 Steven C. Lee ----------------------------------------------------------------- The fastest way to select from any menu is using the menu HOT keys. Notice that each item on the menu has a capital letter displayed in a color or intensity different from the rest of the line. This is the HOT key for that item. The HOT key for the "DiR" submenu is "R". If you press "R", the Master Menu will disappear and the Directory Menu will appear. The Directory Menu allows you to Add, Delete, Rename, and Copy subdirectories. This menu also contains the Rescan Drive command. Notice that the items in the Directory Menu also have HOT keys. Now press "A" to select Add Directory. A small window will appear in the center of the screen requesting a directory name. Type "abc1" and press the Enter key. The subdirectory "abc1" will be created using the current directory as the parent. The Directory Menu has now disappeared, and the Master Menu is visible again. Some menus are "sticky", meaning that they remain on screen until you exit the menu using Escape or the right mouse button. Other menus will return you to the Master Menu or the main screen. Whether a menu is "sticky" or not depends on whether Swiss Army Shell must return to the main program loop to execute the operation. With the Master Menu visible, move the Menu Cursor to "Drive". Another way to select menu items is with the arrow and Enter keys. With "Drive" under the menu cursor press Enter. The Drive Menu will appear showing a list of the disk drives in your computer. If you have more than one hard disk in your computer you should select a different drive each time during this part of the tutorial so that Swiss Army Shell can scan and create a .TRE file for each drive. If you have only one drive you should simply select drive C each time. There are several different ways to display the Drive Menu. Press the F10 key or the right mouse button until the Master Menu is not visible. From the main screen you can simply press "D" to pop up the Drive Menu. Once the Drive Menu is displayed you can select a drive using the HOT key, the arrow and Enter keys, or move the mouse and select with the left mouse button. The fastest way to change drives is to press "D", then the letter of the desired drive. For example, pressing "DDDCDE" would rapidly change to drive D, drive C, and drive E in that order. You may also pop up the Drive Menu by placing the mouse cursor on the Directory Window title block (point to the word "Drive") and click the left mouse button. The final way to bring up the Drive Menu is by toggling the Master Menu on with F10 or the right mouse button, and selecting Drive. Now we will try moving around in your subdirectories. First press F10 or the right mouse button so that the Master Menu is ----------------------------------------------------------------- SAS24.DOC Page 18 Swiss Army Shell Version 2.4 (c) 1988,1989,1990 Steven C. Lee ----------------------------------------------------------------- not visible. Try pressing the F1 (or Ctl PgUp) and F2 (or Ctl PgDn) keys a few times. You will see the Directory Cursor move down when you press F2, and up when you press F1. F3 (or Ctl Home) and F4 (or Ctl End) act like Home and End keys, and will place the cursor on the root directory or last directory. F5 (or Ctl Left) and F6 (or Ctl Right) will position the cursor to the first and last directories on the current page. Using the F1 and F2 keys (or Ctl PgUp and Ctl PgDn), position the cursor on any directory other than the current one and press the Enter key. The Files Window title block will change to show the name of the new directory, and the files in that directory will appear in the Files Window. If you have a mouse, move the mouse cursor to another directory and press the left mouse button. The Directory Cursor will move to that directory. Try moving the Directory Cursor several times, making sure that you do not click on a directory that is actually under the cursor. Now try clicking on a directory that IS under the cursor. This will have the same affect as pressing the Enter key. Now move the mouse cursor to the upper left corner of the Directory Window and click the left button. The upper left corner acts like the F3 (or Ctl Home) key, and the directory cursor will be placed on the root directory. If you click on the lower left corner it will place the cursor on the last directory. Try clicking on the upper and lower right corners. These corners act like the F5 and F6 keys (or Ctl PgUp and Ctl PgDn), and if you have many directories on your disk it will move the cursor up or down a page (20 directories) at a time. Now try placing the mouse cursor on the top and bottom bars or lines of the Directory Window, being sure to avoid the title block. Press the left button and hold it. The Directory Window will rapidly scroll up or down as long as you hold the button. Now we will add some temporary directories to practice file operations. Press F3 or click on the upper left corner of the Directory Window to move the cursor to the root directory. Earlier we created a directory named "abc1" by using the "DiR" submenu through the Master Menu. Swiss Army Shell was originally written as a completely command driven program with very few menus. Those commands are still available, and are now called "shortcut" keys. The shortcut keys are completely described in the Swiss Army Shell Commands section of this document. Press the Insert key. Insert is the shortcut key for the Add Directory command. The Add Directory window will pop up and ask for a directory name. Type in "abc2" and press Enter. "abc2" will be added to the tree diagram directly under "abc1". Now move the Directory cursor to "abc2" and press the Delete key. The directory you just created will be removed. If the directory is empty and is not the current directory, it will be ----------------------------------------------------------------- SAS24.DOC Page 19 Swiss Army Shell Version 2.4 (c) 1988,1989,1990 Steven C. Lee ----------------------------------------------------------------- removed immediately. If the directory is current or contains files or subdirectories, you will be asked to confirm TWICE that you REALLY want to do it. CAUTION : The Delete Directory command is extremely powerful. If you answer yes to both confirming questions, the directory under the cursor and ALL its subdirectories will be removed. As you can see, moving around your directory tree and inserting and deleting directories is easy. Now we will do some file operations. Make sure you are in the main screen, with only the three main windows visible. As long as you are in the main screen you can use the arrow keys to move the File Cursor. Swiss Army Shell can handle a maximum of 512 files in a single directory. If there are too many files for one page, PgUp and PgDn will allow you to browse through the files. Home or End position the File Cursor to the first or last file. If you have a mouse, place the mouse cursor on the lower left corner of the Files Window and click the left button. The lower left corner acts like the End key and moves the File Cursor to the last file. The upper left corner acts like the Home key, and the upper and lower right corners act like the PgUp and PgDn keys. Place the mouse on a file and click the left button. The File Cursor will jump to that file, and the file will appear in reverse video. Files shown in reverse video are tagged. If you click on a tagged file it will change to untagged and normal video. Now place the mouse cursor on an untagged file that is NOT under the Files Cursor. When you press the left button, hold it and move the mouse up or down. The File Cursor will follow the mouse as long as it remains inside the Files Window. Whenever the cursor crosses a file, the Tag Status of the file will change. If the file is tagged it will be untagged, and vice versa. This feature is handy for tagging groups of file. Now make sure that you have some files tagged, then pop up the Master Menu and select "Group". The Group Menu allows you to copy, move, delete and archive tagged files. The menu also has options for tagging and untagging ALL files in the current directory. Select Copy Tagged Files from the Group Menu. The Statistics Window will clear and you will be prompted to enter a path. At this point you have a number of options. The first option is to simply type in the destination path and press the Enter key. This is the option you should use if you are copying to a floppy disk. ----------------------------------------------------------------- SAS24.DOC Page 20 Swiss Army Shell Version 2.4 (c) 1988,1989,1990 Steven C. Lee ----------------------------------------------------------------- If you are copying to a directory on the current or another hard disk you have a much better option. If the destination is on the current drive, you can select the destination directory by moving the Directory Cursor with either the F1 through F6 keys or the mouse, and pressing Enter or clicking the left mouse button on the desired directory. To try this now, move the Directory Cursor to the "abc1" directory created earlier and press Enter. The tagged files will be copied to that directory. Copying may be aborted at any time by pressing the Escape key. To copy tagged files to a directory on another drive, you can press Alt D or click on the Directory Window title block. This will pop up the Drive Menu, and you can select a drive from it. When the drive has been selected, Swiss Army Shell will look for the file SASDRV.TRE on that drive. If SASDRV.TRE is not found, you will be asked if you want to scan the drive or abort the operation. If SASDRV.TRE is found, it will be quickly loaded and a tree diagram of the other drive's directories will be displayed. You may select a destination directory just as if you were in the current drive. This operation may be aborted by pressing Escape or the right mouse button. You have now learned how to navigate and modify your directories, tag files and initiate copy file operations. In general, all group file functions work in the same way. There are far too many features in Swiss Army Shell to cover in this tutorial. Configuring Swiss Army Shell ---------------------------- The configuration menu is actually a separate program named SASCFG.EXE. It may be run from the DOS command line, or called up while inside SAS by pressing Alt S, or selecting it from the Misc Menu through the Master Menu. SASCFG allows you to configure SAS to use your favorite lister, editor, and word processor. You configure the colors for every window, up to ten programs which may be executed with two keystrokes, and toggle PKPAK or PKZIP as the default archive program. Version 2 has added the capability to swap itself to disk during execution of any external program. You may also turn swapping on or off for each program by using SASCFG. Selecting List, Edit and Word Processing Programs ------------------------------------------------- To select the list, edit and wp programs you may use the arrow keys or mouse to move the menu bar and press <CR>, press the left mouse button, or simply press the highlighted Hot Key to ----------------------------------------------------------------- SAS24.DOC Page 21 Swiss Army Shell Version 2.4 (c) 1988,1989,1990 Steven C. Lee ----------------------------------------------------------------- select a menu item. A window will pop up allowing you to edit or replace the existing entry. You may backspace over the current entries and replace them with your own choices. The full program name including the .COM or .EXE extension must be included. The programs must be in the PATH for SAS to find them. The file under the File Cursor will be appended to the program command lines when they are called. When you have entered the program name, you should press <CR>. You will then be asked if you want Swiss Army Shell to swap to disk during execution. If you do not have EMS memory available, I recommend that you do not use swap for your LIST and EDIT programs. If you use a large word processing program, such as Word Perfect, you should enable swap for the Word Processor. Swap to disk makes response slower, and small programs do not need to use it. Large programs may not run at all without it. Setting Window Colors --------------------- The Set Colors selection will display the Set Colors Menu, which lists the windows used in Swiss Army Shell. To change the colors, just select the desired window from the menu and a window showing the current color scheme will appear. The window will contain text telling you how to change the colors of different items such as the foreground, background, title, etc. When the window looks like you want it just hit Escape, and the Set Colors Menu will be displayed again. You may choose another window to change, or hit Escape or select Exit Set Colors to return to the Configure SAS main menu. The windows used by Swiss Army Shell are described here: Directory Window ---------------- This is the upper left window which contains the tree diagram displaying the directory structure of the current drive. The highlight foreground and background colors will be used for the Directory Cursor. Other Drive Window ------------------ This window replaces the Directory Window when you point and shoot at another drive. I recommend you use colors which will contrast it with the Directory Window. Files Window ------------ This is the upper right window which displays the files in the current directory. Tagged files will be displayed in reverse ----------------------------------------------------------------- SAS24.DOC Page 22 Swiss Army Shell Version 2.4 (c) 1988,1989,1990 Steven C. Lee ----------------------------------------------------------------- video, and the cursor is displayed in the selected highlight foreground and background colors. Statistics Window ----------------- This is the small window at the bottom of the screen. It displays statistics on the current drive, directory, and file. Path Entry Window ----------------- This window replaces the Statistics Window when entry of a path is required. Message Window -------------- This window is used to display warning and informative messages. YesNo Window ------------ This window is used to ask Yes No questions. The question will be displayed in the highlight color. Name Entry Window ----------------- This window is used by Rename File, Rename Directory, and several other commands. Help Window ----------- This window is used by the help screen. You may only set the foreground and background colors. All Menus --------- Allows you to set the Menu colors. Monochrome adapter users will not be able to use this feature. If a monochrome monitor is detected, SAS defaults to the standard monochrome colors regardless of the configured colors. You are not prevented from setting unreadable colors. SAS will attempt to detect use of the same color for foreground and background, but only the main screen windows check for this. ----------------------------------------------------------------- SAS24.DOC Page 23 Swiss Army Shell Version 2.4 (c) 1988,1989,1990 Steven C. Lee ----------------------------------------------------------------- Program List and Program Execution Menus ---------------------------------------- The Program List is extremely handy, and I use it every day at work. By setting up different entries to edit note files or display graphics files, with two keystrokes I can display the graphics file under the cursor or edit a project note file. It may be popped up by pressing P, or through the Master and Exec Menus. The Program List selection displays a menu which allows you to enter up to ten DOS command lines. You may enter any valid DOS command line up to 45 characters long. The line length is determined by the maximum window width of the Program Execution Menu. These command lines may be executed while inside Swiss Army Shell by pressing P then the number of the command line, or by pressing the right mouse button, selecting Exec from the Master Menu, and selecting Program List from the Exec menu. When the Program Execution Menu pops up it will display the command lines you have entered. Command lines may be executed by selecting them just like any other menu item. You may move the menu cursor and press <CR>, move the mouse and press the left button, or press the highlighted Hot Key. To modify the Program List, select Program List from the Configure SAS menu, then select the entry number you want to modify. A window will pop up with the current entry, and you may backspace over it and enter the modified line. You MUST enter the full program name including the extension. If you would like to append or insert the filename under the file cursor into the command line, you may include a percent (%) sign anywhere in the line, and SAS will insert the filename (only once per line). If you select an entry, then decide to leave it alone you may hit Escape or the right mouse button and the previous entry will be retained. When you have completed a command line, press <CR> or the left mouse button to accept it. You will then be asked three questions. The first question is "Do you want to change directories?" If you would like SAS to change to the directory which contains the program, you must have previously entered the full path to the program being executed. You may want to do this when you execute programs that require support files, and don't know how to find them. In this case the program does not need to be in the current PATH. SAS will change to the directory containing the program and execute it. The second question is "Do you want to drop to a command line?" If you would like to drop to a command line to enter additional parameters prior to execution you should answer Yes. SAS will clear the Statistics Window and display the command line when you select this Program Execution Menu choice. You will not ----------------------------------------------------------------- SAS24.DOC Page 24 Swiss Army Shell Version 2.4 (c) 1988,1989,1990 Steven C. Lee ----------------------------------------------------------------- be able to edit the command line, but you will be able to add to it before executing it with <CR>. The third question is "Would you like to swap SAS to Disk ?" If you would like for the ExecSwap to provide maximum free RAM for the program you should answer Yes. EMS memory will be used if available, otherwise the disk will be used. Here are a few typical Program List entries as they would be displayed in the Program Execution Menu : 1 c:\pcp\pcplus.exe +CD+S 2 format.com a: 3 sort % +CL These entries would be invoked from inside SAS like this: Pressing P then 1 would change to drive C, directory \PCP, swap SAS to disk or EMS memory, and execute PCPLUS. When you exit PCPLUS you will be returned to the same directory you started from. Pressing P then 2 would format a disk in drive A. Pressing P then 3 would drop to a command line and append the filename under the File Cursor to the program name SORT. You would then be able to enter additional parameters before initiating execution by pressing <CR> or clicking the left mouse button. * Note : The last selection, sort % + Cmd, would actually load a secondary copy of COMMAND.COM to execute the sort command. If the program name includes either a .COM or .EXE extension, Swiss Army Shell will execute it directly or through ExecSwap. If there is no file extension, swap will be disabled, and COMMAND.COM will be called to execute the command line. Program Execution Option Codes ------------------------------ The Program List uses the following codes in the menu line to show options in affect for each choice : +CD - Change Directory before execution +CL - Drop to command line before execution +S - Swap to disk/EMS before execution ----------------------------------------------------------------- SAS24.DOC Page 25 Swiss Army Shell Version 2.4 (c) 1988,1989,1990 Steven C. Lee ----------------------------------------------------------------- Archive Program Default ----------------------- The Archive Default selection allows you to select PKPAK or PKZIP as the default archive program. The default archive program will be the one selected when SAS is started. The selected archive program may be changed during a session through the Switch menu choice in the Archive Management Menu, but the default program may only be changed in the Configure SAS Menu. PKZIP Compression Switch ------------------------ Toggles PKZIP between Fast and Maximal Compression. The default is Max compression. Confirm Exit ------------ When you exit Swiss Army Shell, you will be asked to confirm that you really wish to exit. This configuration option allows you to turn exit confirmation on or off. Sound ON/OFF ------------ This option allows you to turn sound on or off. Duplicate File Check -------------------- Starting with version 2.4, Swiss Army Shell provides an option to check for duplicate files before copying. This configuration option allows you to turn this option on or off. Write Configuration File ------------------------ When you have made all your configuration changes you should press Escape. You MUST answer Yes to the Write Configuration question to save your choices. A file named SAS.CFG will be written in the directory pointed to by the SAS Environment variable. You can set an SAS environment variable by including the following line in your AUTOEXEC.BAT : SET SAS=pathspec where pathspec is the desired directory. If no SAS Environment variable is found, SAS.CFG will be written in the directory pointed to by the COMSPEC Environment variable. SAS will not check to see if the drive is a floppy ----------------------------------------------------------------- SAS24.DOC Page 26 Swiss Army Shell Version 2.4 (c) 1988,1989,1990 Steven C. Lee ----------------------------------------------------------------- drive, so if you boot from a floppy, you should include a SET COMSPEC= statement in your AUTOEXEC.BAT file to point to a hard disk. Swiss Army Shell reads SAS.CFG only once during program initialization. Any changes you make to the configuration file will not take affect until the next time you run SAS. Swiss Army Shell Commands ------------------------- Shortcut Keys ------------- Shortcut keys are single key and ALT or Control key combinations that directly execute commands without using the menus. Some commands prompt for input. The Help screen may be displayed by pressing H. Some commands pop up menus with available options. Menus are of the moving bar type and selections may be made by moving the bar with the cursor keys and pressing <CR>, or by simply pressing the letter highlighted for that selection. You may also use the mouse and left mouse button to make menu selections. Commands that require a path entry place a window at the bottom of the screen. Some commands will supply a default entry which may be edited using the backspace key. You may enter either a relative or full path (including drive) or move the directory cursor to the desired directory and press return. A new feature with version 2 is the capability to point and shoot at other drives. During Copy, Move, and Archive Extraction operations you may press ALT D and select a drive from the pop up menu, then point at a directory on that drive by using the directory cursor keys and shoot by pressing <CR>. As always, Escape will terminate the command. You may also point and shoot at other drives with the mouse. To pop up the drive menu just point the mouse at the Drive Window title block and click the left button. You may then select a drive and pick a directory on that drive with the mouse. Some commands such as ALT F - Find File (Normal or Archived) allow entry of multiple filenames. These commands will provide a wide window and prompt with "Enter Filename(s)". Escape will abort any window or menu and return to SAS. Escape also terminates copy, move, and delete operations in progress. ----------------------------------------------------------------- SAS24.DOC Page 27 Swiss Army Shell Version 2.4 (c) 1988,1989,1990 Steven C. Lee ----------------------------------------------------------------- Cursor Movement Summary ----------------------- Directory Cursor Movement ------------------------- The directory cursor moves about the directory tree using the following commands: F1 or Ctrl PgUp Moves up one directory F2 or Ctrl PgDn Moves down one directory F3 or Ctrl Home Moves to the root directory F4 or Ctrl End Moves to the last directory F5 or Ctrl Left Arrow Moves to first directory in the window F6 or Ctrl Right Arrow Moves to the last directory in the window <CR> Selects the directory under the cursor Click Mouse On -------------- UnHilited Directory Cursor to that directory Hilited Directory Changes to that Dir Upper Left Corner Cursor to Root Dir Lower Left Corner Cursor to Last Dir Upper Right Corner Page Up Lower Right Corner Page Down Top Bar Scroll Up Bottom Bar Scroll Down TitleBlock Change Drive Menu File Cursor Movement -------------------- The file cursor moves in two dimensions and wraps from page to page. If you press Down Arrow when it is on the last file on a page, the next page will appear and the cursor will be placed on the first file on that page. Up Arrow Move up one file Down Arrow Move down one file Left Arrow Move left one column Right Arrow Move right one column Home Move to the first file End Move to the last file PgUp Displays the previous page PgDn Displays the next page If there is no next page PgDn moves to the last file on the page. ----------------------------------------------------------------- SAS24.DOC Page 28 Swiss Army Shell Version 2.4 (c) 1988,1989,1990 Steven C. Lee ----------------------------------------------------------------- Click Mouse On -------------- Upper Left Corner First File (same as Home) Lower Left Corner Last File (same as End) Upper Right Corner Page Up Lower Right Corner Page Down File Move Cursor and Toggle Tag File Tag Status may be toggled by clicking on a file. Multiple files may be toggled by clicking and holding the left button on a file that is NOT under the cursor, then dragging the mouse. * Note : All windows and menus may be exited with Escape. A - Archive Management SubSystem -------------------------------- This invokes the Archive Management SubSystem which is explained later in this document. May also be reached through the Master Menu. Ctrl A - Attribute Menu ----------------------- The Attribute Menu allows you to toggle the readonly, hidden, system, and archive attribute bits of files. When Ctrl A is pressed, a menu will be displayed showing the file under the cursor in the title block. Attribute bits may be toggled by moving the menu bar and pressing <CR>, or by pressing the highlighted Hot Key. You must select Update Attributes before leaving this menu to actually change the file attributes. May also be reached though the Master and File Menus. C - Enter Dos Command --------------------- You will be prompted to enter a valid DOS command line. Terminate the command line with <CR> and the screen will be cleared and the command executed. The screen will be restored when DOS returns control to SAS. This command may be terminated with Escape. May also be reached through the Master and Exec Menus. ----------------------------------------------------------------- SAS24.DOC Page 29 Swiss Army Shell Version 2.4 (c) 1988,1989,1990 Steven C. Lee ----------------------------------------------------------------- Alt C - Copy Tagged Files ------------------------- Tagged files will be copied to the destination directory. You may enter the destination in the window provided, move the directory cursor to the desired directory, and press <CR>, or press ALT D to point and shoot at another drive. You will be asked if you want to check for duplicate files, and if you answer yes, SAS will check before copying each file. If duplicates are found, the size, date and time for both versions will be displayed and you will have an option to skip copying the file. You may turn this option off using the configuration option. As each file is copied the filename will be displayed in the files window. Copying may be aborted by pressing Escape. If readonly, hidden, or system files are encountered, you will be given the option of copying or skipping them. May also be reached through the Master and Group Menus. Copy tagged files is used for the Copy File option on the File Menu. Ctrl C - Copy Directory ----------------------- This command provides the ability to copy all files in the directory under the directory cursor to another location. You will first be asked if you want to copy the directory. You will then be asked if you want to copy any subdirectories. You may enter a path or point and shoot at a directory on the current drive or another drive. SAS will check to see if the directory already exists, and if it does will give you the option of using it or aborting the operation. If you choose to continue, you will be asked if you wish to continue without interruptions. Answering yes will suppress further prompts if additional duplicate directories are found. If the directory does not exist, it will be created as a subdirectory of the directory pointed at, and all files will be copied to it. If you have chosen to include subdirectories, they will also be created, and their files will be copied. This operation may be aborted at any time by pressing Escape. If you copy a directory to another location on the current drive, the drive will automatically be rescanned to recreate the directory tree. If you copy to another drive, the SASDRV.TRE file on that drive will be erased to force a rescan the next time you access the drive. If you choose to copy the root directory of a drive to a subdirectory on another drive, you will be prompted for a name to substitute for "\". The word "root" will be supplied as a default, and my be replaced with a name of your choice. This ----------------------------------------------------------------- SAS24.DOC Page 30 Swiss Army Shell Version 2.4 (c) 1988,1989,1990 Steven C. Lee ----------------------------------------------------------------- option allows you to clone a drive, and the entire directory and file structure will be duplicated on the other drive. If readonly, hidden, or system files are encountered, you will be given the option to copy or skip them. May also be reached through the Master and DiR menus. D - Drive Change ---------------- A menu will pop up showing the drives available. You may use the arrow keys and <CR> to select a new drive, or simply press the letter of the desired drive. The quickest way to change drives is to press D then the drive letter. May also be reached through the Master and Drive menus, or by clicking on the Directory Window title block. Alt D - Delete Tagged Files --------------------------- You will be asked if you are sure you want to delete the tagged files. A Yes response will start the delete operation. Each filename will be displayed in the files window as it is deleted. The delete operation may be aborted at any time by pressing Escape. If readonly, hidden, or system files are encountered, you will be given the option to delete or skip them. * Note : The Y/N response is 'hot', ie. <CR> is NOT required to initiate the operation. May also be reached through the Master and Group menus. Delete tagged is also used for the Delete File option on the File menu. E - Edit File ------------- SAS will execute the program you have entered under Edit Program Name in the configuration menu. The filename under the cursor will be supplied as a command line parameter. If you have not configured for your favorite editor, SAS will attempt to execute EDLIN.COM. May also be reached through the Master and File menus. ----------------------------------------------------------------- SAS24.DOC Page 31 Swiss Army Shell Version 2.4 (c) 1988,1989,1990 Steven C. Lee ----------------------------------------------------------------- F - Find File ------------- SAS will search the current drive for the filespec entered, and if it is found will display it in the files window. Wild cards may be used. The directory cursor will be placed on the directory containing the file and you may move to that directory by pressing <CR>. When the directory is displayed the cursor will be on the target file. F2 or Ctrl PgDn will continue the search. Version 2.4 has added the ability to search multiple hard disks for a filespec. If multiple hard drives are found, you will be asked if you wish to search all hard drives. If you answer no, only the current drive will be searched. If you answer yes, SAS will search all hard drives until the filespec is found, or the search fails. Searching will begin with the current drive, then wrap to the first hard drive when the last drive has been searched. May also be reached through the Master and File menus. Alt F - Find File (Normal or Archived) -------------------------------------- SAS will attempt to execute PKFIND.COM, supplying the filename(s) entered as command line parameters. If PKFIND exists and is in the current PATH, it will search all directories and archives on the current drive. SAS does not attempt to interface with PKFIND, it simply executes it. Read the PKFIND documentation for further details. PKFIND will not search inside .ZIP files. May also be reached through the Master and File menus. Ctrl F - Find File (Search Archive Only) ---------------------------------------- Operates exactly like Alt F but searches only inside archives. May also be reached through the Master and File menus. L - List File ------------- This command will execute the program entered under LIST Program Name in the configuration menu. The file under the cursor will be supplied as a command line parameter. If you have not configured your favorite file lister, SAS will default to a list program named LIST. This feature was originally intended to execute LIST.COM by Vern Buerg, but numerous requests prompted me to make the program name selectable. ----------------------------------------------------------------- SAS24.DOC Page 32 Swiss Army Shell Version 2.4 (c) 1988,1989,1990 Steven C. Lee ----------------------------------------------------------------- May also be reached through the Master and File menus. If the file is not an executable or archive file, this will be the default choice when the File Operations Menu pops up. M - Move Tagged Files --------------------- Tagged files will be moved to the specified directory. You may enter the path in the window provided or move the directory cursor to the desired directory and press <CR>. Move works much faster than copying and deleting. Move may be terminated by pressing Escape. I have had a number of requests to make Move work across drives. Since a Move across drives would simply be a copy and delete operation, I have decided not to implement it. When you copy files to another drive, the tagged files will remain tagged and may be deleted with Alt D - Delete Tagged Files. The Copy Directory command was also added to help cover this request, and will allow you to create and copy a directory, its files and subdirectories to another drive. The directory may then be deleted by placing the directory cursor on it and pressing Del. May also be reached through the Master and Group menus. Move Tagged files is also used by the Move File option on the File menu. Alt N - New Screen ------------------ Alt N has replaced Ctrl R as the refresh screen command. This was done so that Ctrl R could be used for Rename Directory. Refresh screen will redraw the screen if it becomes garbled. O - OS Shell ------------ SAS will load a secondary copy of COMMAND.COM. Enter EXIT at the DOS prompt to return to SAS. SAS will restore the default path in effect when this command was issued. May also be reached through the Master and Exec menus. P - Program Execution --------------------- A menu showing the command lines entered in the Program List in the configuration menu will be displayed. A command line may be selected by using the arrow keys and <CR> or by pressing the number corresponding to the desired selection. The Program List is explained in Configuring Swiss Army Shell elsewhere in this document. ----------------------------------------------------------------- SAS24.DOC Page 33 Swiss Army Shell Version 2.4 (c) 1988,1989,1990 Steven C. Lee ----------------------------------------------------------------- May also be reached through the Master and Exec menus. Alt P - Print Tagged Files -------------------------- Tagged files will be submitted to the DOS PRINT utility. Printing will take place in the background, but will run much faster if you exit SAS after executing this command. * Note : If you use this feature, PRINT.COM should be loaded before starting SAS. If you don't, then PRINT will grab a chunk of memory above SAS as well as some interrupt vectors, and you might have problems running other programs after exiting SAS. May also be reached through the Master and Group menus. Q - Quit in Current Directory (See Escape) ------------------------------------------ Exits SAS leaving the currently selected drive and directory as the default. Alt Q - Quit in Original Directory (See Escape) ----------------------------------------------- Exits to DOS after changing to the drive and directory from which SAS was originally started. R - Rename File --------------- Rename the file under the cursor. You will be prompted for the new filename. May also be reached through the Master and File menus. Alt R - Rescan Current Drive ---------------------------- SAS will rescan the current drive and directory. May also be reached through the Master and DiR menus. Ctrl R - Rename Directory ------------------------- This command will allow you to rename the directory under the directory cursor. It will only work in DOS versions 3.1 and above. You will be prompted for a new directory name. May also be reached through the Master and DiR menus. ----------------------------------------------------------------- SAS24.DOC Page 34 Swiss Army Shell Version 2.4 (c) 1988,1989,1990 Steven C. Lee ----------------------------------------------------------------- Alt S - SAS Configuration ------------------------- This command will run SASCFG.EXE which will pop up the Configure SAS Menu. See Configuring Swiss Army Shell elsewhere in this document for details on use of this menu. May also be reached through the Master and Misc menus. Ctrl S - Sort Options --------------------- A pop up menu will allow selection of a file sort method. The default is Sort by Name. Other sort options are by Extension, Size, and Time (Date and Time). Sorting is always in ascending order. May also be reached through the Master and Sort menus. T - Tag File ------------ Tags the file under the cursor and moves the cursor to the next file. Tagged files will be displayed in reverse video. Alt T - Tag All Files --------------------- Tags all files in the directory. May also be reached through the Master and Group menus. U - Untag File -------------- Untags the file under the cursor and moves the cursor to the next file. May also be reached through the Master and Group menus. Alt U - Untag All Files ----------------------- Untags all files in the directory. May also be reached through the Master and Group menus. ----------------------------------------------------------------- SAS24.DOC Page 35 Swiss Army Shell Version 2.4 (c) 1988,1989,1990 Steven C. Lee ----------------------------------------------------------------- V - View Archive ---------------- The cursor must be positioned on a file with a .ARC or .ZIP extension. SAS will invoke SAV.EXE. Swiss Army View (SAV) allows tagging of the files in the archive, and invokes PKPAK/PKUNPAK or PKZIP/PKUNZIP to extract or delete the tagged files from the archive. SAV.EXE is summarized in the Archive Management section and fully described in SAV.DOC. May be reached through the Master and Archive or File menu. X - Execute Program ------------------- The cursor must be positioned on a file with a .COM, .EXE, or .BAT extension. SAS will prompt for command line parameters then execute the program when you press <CR>. This command may be terminated with Escape. May also be reached through the Master and Exec Menus. Clicking the left mouse button will act as <CR>. Ins - Add Directory ----------------------------- To Add a directory, position the directory cursor on the parent directory and press Ins. You will be prompted for the new directory name. The directory will be created and the directory tree will be updated. May also be reached through the Master and DiR menus. Del - Delete Directory ---------------------- To Delete a directory, position the directory cursor on the directory and press Del. If the directory is the current directory or is not empty you will be asked TWICE if you REALLY want to delete it. If you answer yes both times, the directory and ALL files and subdirectories will be deleted. You may abort this command at any time by pressing Escape. May also be reached through the Master and DiR menus. ************************** CAUTION **************************** THIS COMMAND IS VERY POWERFUL AND SHOULD BE USED WITH CAUTION. *************************************************************** ----------------------------------------------------------------- SAS24.DOC Page 36 Swiss Army Shell Version 2.4 (c) 1988,1989,1990 Steven C. Lee ----------------------------------------------------------------- Escape - Quit in Highlighted Directory -------------------------------------- SAS will exit in the directory highlighted by the directory cursor. ----------------------------------------------------------------- SAS24.DOC Page 37 Swiss Army Shell Version 2.4 (c) 1988,1989,1990 Steven C. Lee ----------------------------------------------------------------- Archive Management Subsystem ---------------------------- The Archive Management Subsystem is a series of pop up menus and windows which allow you to perform various functions which aid in managing archive files. It may be reached through the Master Menu, or you may simply press A. The Archive Menu functions are described below. Pressing V invokes SAV.EXE which allows tagging and extracting or deleting of individual files contained in the archive. Swiss Army View (SAV) is summarized below, and fully described in SAV.DOC. This option is also available through the Main and File menus. The Archive Management Menu contains the following options: Add Tagged Files ---------------- SAS will call the currently selected archive program to add the tagged files to the archive. The archive program may be toggled between PKPAK and PKZIP using the Switch menu selection described below. SAS will default to using PKPAK, but you may change the default to PKZIP through the configuration menu. You will be prompted for the archive name. If the archive resides in a directory other than the current, you must provide the path as well. The path may be relative or fully qualified. The currently selected PKPAK/PKZIP parameters (explained under PKPAK/PKZIP Options below) will be in effect (ie. '-a' - Add, '-u' - Update, '-f' - Freshen, or '-m' - Move). The documentation for PKPAK and PKZIP should be reviewed for details on these parameters. Extract File Under Cursor ------------------------- The file under the cursor must have a .ARC or .ZIP extension. SAS will call PKUNPAK or PKUNZIP (depending on the file extension) to extract the file under the cursor. You will be prompted for the destination directory, and may enter the destination in the window provided or position the directory cursor on the desired directory and press <CR>. You may also Press Alt D to point and shoot at a directory on another drive. The mouse may also be used to point and shoot at directories on the current or other drives, just as with the Copy Tagged Files command. ----------------------------------------------------------------- SAS24.DOC Page 38 Swiss Army Shell Version 2.4 (c) 1988,1989,1990 Steven C. Lee ----------------------------------------------------------------- Extract Tagged Archives ----------------------- SAS will call PKUNPAK or PKZIP (repeatedly if necessary) to unarc the tagged archives. Archives with .ARC and .ZIP extensions may be mixed, and SAS will automatically select the correct program for each file. All tagged archives will be completely extracted to the directory specified. As usual the destination may be entered in the window provided or the directory cursor may be positioned on the desired directory and <CR> pressed to select that directory. You may also Press Alt D to point and shoot at a directory on another drive. The mouse may also be used to point and shoot at directories on the current or other drives, just as with the Copy Tagged Files command. Compress Directory ------------------ The currently selected archive program will be called with the -m parameter and archive all files in the current directory. You will be prompted for an archive name. The files will be deleted after they are added to the archive. Compress Directory ignores the PKPAK/PKZIP Options you may have selected. When PKPAK is selected, directories are always compressed using new (ntc) compatibility. Add tagged files should be used if you need old compatibility or any non-default PKPAK/PKZIP options. * Note : If this directory was previously extracted and the .ARC or .ZIP file was not deleted the .ARC or .ZIP file will be added to the archive. Use the UnCompress Archive menu selection when extracting compressed directories to avoid this problem. UnCompress Archive ------------------ SAS will call PKUNPAK or PKUNZIP to extract the archive under the cursor. The archive will be extracted to the current directory. You will have the option to delete the .ARC or .ZIP file after extraction. PKPAK/PKZIP Options ------------------- SAS will pop up a menu showing the current PKPAK/PKZIP parameters in effect. The menu will allow toggling these options on or off. The menu selections are as follows : Add Option - Enables PKPAK/PKZIP Add ('-a') parameter. Update ('-u'), Freshen ('-f'), and Move ('-m') will be disabled. This is the default when SAS is loaded. ----------------------------------------------------------------- SAS24.DOC Page 39 Swiss Army Shell Version 2.4 (c) 1988,1989,1990 Steven C. Lee ----------------------------------------------------------------- Update Option - Enables PKPAK/PKZIP Update ('-u') parameter. Add ('-a'), Freshen ('-f'), and Move ('-m') will be disabled. Freshen Option - Enables PKPAK/PKZIP Freshen ('-f') parameter. Add ('-a'), Update ('-u'), and Move ('-m') will be disabled. Move Option - Enables PKPAK/PKZIP Move ('-m') parameter. Add ('a'), Freshen ('f'), and Update ('u') will be disabled. Files added to an archive will be deleted. Encrypt Option - Enables PKPAK Encrypt ('g') parameter. SAS will prompt for a password before calling PKPAK or PKUNPAK. The password will be echoed with asterisks. This option is not available in PKZIP 0.92, but should work when PKZIP adds encryption capability. * Note : Experimentation has shown that encrypted archives may be viewed and PKUNPAK will extract them with a Failed CRC check message, however the extracted files will contain garbage if extracted without specifying a password. Comment Archive- Enables PKPAK Archive Comment ('x') parameter or PKZIP Zipfile Comment ('z') parameter. Optional Comments - Enables PKPAK File Comment ('c') parameter. PKZIP 0.92 does not support individual file comments, and if this option is used with PKZIP selected, you will get the standard Usage screen displayed by PKZIP when it cannot understand the command line. If future versions of PKZIP use 'c' as the command option for this function, it should work fine. * Note : You should consult the documentation for PKPAK/PKUNPAK or PKZIP/PKUNZIP for further details on these parameters. Make File Self Extracting ------------------------- The file under the cursor must have a .ARC or .ZIP extension. SAS will search the current path for PKSFX.PGM if the file has a .ARC extension and will concatenate the file under the cursor with it to make a self extracting archive. You may accept the default .EXE file name displayed or backspace over it and enter another name. If the file has a .ZIP extension, SAS will call the program ZIP2EXE.EXE to make the file self extracting. ----------------------------------------------------------------- SAS24.DOC Page 40 Swiss Army Shell Version 2.4 (c) 1988,1989,1990 Steven C. Lee ----------------------------------------------------------------- Toggle Compatibility -------------------- Toggles PKPAK between new ('ntc') and old ('otc') compatibility. The default is new compatibility, so if you want old compatibility, when SAS is run press A then T to toggle it on. This option has no affect on PKZIP. PKZIP Compression Toggle ------------------------ Toggles PKZIP between Fast and Maximal compression. The default is Max compression, but may be changed in the configuration menu. Integrity Test -------------- Calls PKUNPAK or PKZIP with the -t parameter. Each file in the archive under the cursor will be tested for integrity. Switch ------ Switches the currently selected archive program from PKPAK to PKZIP (or vice versa) for the current session only. To permanently change the default, use the Configure SAS option. Swiss Army View --------------- Swiss Army View (SAV.EXE) is a stand alone program which may be distributed freely. SAV extracts and displays the file header information from .ARC and .ZIP files in a pageable display and will allow tagging and untagging of files for extract and delete operations. Special thanks to Basil Copeland on the IBMSYS forum for the ARC and ZIP header structures and scanning routines. You should read SAV.DOC (included in this archive) for complete instructions on the use of Swiss Army View. ----------------------------------------------------------------- SAS24.DOC Page 41 Swiss Army Shell Version 2.4 (c) 1988,1989,1990 Steven C. Lee ----------------------------------------------------------------- Support ------- I will be happy to answer any questions you have about Swiss Army Shell. I may be reached at 205-655-3926, or on The ST BBS at 205-836-9311, 300/1200/2400/8/n/1. SAS Entomology -------------- This program probably contains some bugs. I have tested all features, and have tried entering garbage to find potential crashes, but I know better than to claim it is bug free. Crashes should return a run time error number and an address consisting of a segment and offset separated by a colon. If you encounter any of these please copy them down and let me know. It would also be helpful if you could give me a brief description of what you were trying to do at the time. Kudos ----- First, I would like to thank my wife and kids for putting up with the long hours of writing and testing. They have endured quite a lot, and deserve most of the credit ! I want to thank Steve Turner, Sysop of The ST BBS for being a willing and enthusiastic guinea pig during the development and testing of Swiss Army Shell since version .001 ! I would also like to express thanks to Turbo Power Software for publishing and allowing the free use of the ExecSwap unit. This unit has solved most of the problems with executing large external programs. Thanks to Basil Copeland for AZD10, a Turbo Pascal arc, zip, and lzh file viewer. I used the arc and zip header structures and scanning routines almost unchanged in SAV. I am considering adding LZH to SAV in the future. This program was originally intended to emulate Directory Scanner written by Nat Martino. Although it has now taken directions of my own choosing, I would like to thank Nat Martino for coming up with the basic keyboard user interface. And finally I would like to thank Phil Katz for his excellent archive management programs, and Vern Buerg for LIST.COM. If you use these programs you should support the authors and register for them. Steven C. Lee May 19, 1990 ----------------------------------------------------------------- SAS24.DOC Page 42 Swiss Army Shell Version 2.4 (c) 1988,1989,1990 Steven C. Lee ----------------------------------------------------------------- Registration Form ----------------- Name:________________________________________________________ Address :________________________________________________________ Phone Voice : ____________ Data : ____________ ID :_________ Registration Benefits --------------------- The registration fee for Swiss Army Shell is $20. Anyone who registers will receive a disk with the next available update. Registrations should be sent to: Steven C. Lee 304 Pierson Drive Trussville, Alabama 35173 Amount Enclosed : $_________ Computer Make:__________________________________________________ RAM : _____ Dos Version : ________ Video Adapter:__________ Number of drives Hard : ________ Floppy : _________ Comments:_______________________________________________________ ________________________________________________________________ ________________________________________________________________ Bug Reports:____________________________________________________ ________________________________________________________________ ________________________________________________________________ What features would improve Swiss Army Shell ? ________________________________________________________________ ________________________________________________________________ ----------------------------------------------------------------- SAS24.DOC Page 43