U S T E R E O S H E L L version 3.20 * User documentation * M.R.E. Software (c) copyright 1989,90 ========================================================================== ,--------------------, ,----------, ,---------------------, | | | 8 USER | | | | ........ | |----------| | ........ | | .............. | | EDITOR . | | .............. | | ................ | |----------| | ................ | | ................ | | PAK .... | | ................ | | .............. | |----------| | .............. | | ........ | | LHARC .. | | ........ | | | |----------| | | | | | PKPAK .. | | | | ..... .. | |----------| | .. ..... | | ....... `..' | | PKZIP .. | | `..' ....... | | ..... | ,---`----------'---, | ..... | | Stereo |--| MS-DOS ........ |--| Shell | `--------------------' `------------------' `---------------------' * The components of power * ========================================================================== == == == ======================================== DOS never sounded this good before! ======================================== == == == ========================================================================== .---------. (tm) Published by: ,-----'---, | -------------------------- --| |o |------------------ M.R.E. Software | .-----'---. | Association of 150 Jones St. | | |-' Shareware West Point, Ms. 39773 `---| o | Professionals -------------------------- ------| | |-------------------- Emery D. Wooten Jr. `---------' MEMBER (C.) Copyright 1989,90 Microsystems Research and Engineering (C.) Copyright 1989,90 Emery D. Wooten Jr. Stereo Shell, M.R.E. Software, Microsystems Research and Engineering (TM)s * All rights reserved worldwide * U C O N T E N T S _____________________________________________________________________ PREFACE ......................................................... I HARDWARE REQUIREMENTS ........................................... II PART 1 ** INITIAL SETUP Sec. 1.1 INTRODUCTION ..................................... 1 Sec. 1.2 THE STS DEFAULT SETUP ............................ 1 Sec. 1.3 RUNNING StS THE FIRST TIME ....................... 1 Sec. 1.4 HOW TO FULLY TUNE STEREO SHELL ................... 2 Sub-Sec. 1.4.1 SCREEN AND MOUSE OPTIONS .............. 2 Sub-Sec. 1.4.2 COLOR SETUP ........................... 3 Sub-Sec. 1.4.3 FILES/EXTERNAL SETUP .................. 4 Sub-Sec. 1.4.4 SAVE SETTINGS AND EXIT ................ 6 Sub-Sec. 1.4.5 EXIT NO SAVE .......................... 7 PART 2 ** USING STEREO SHELL Sec. 2.1 INTRODUCTION ..................................... 8 Sec. 2.2 THE StS DISPLAY .................................. 9 Sub-Sec. 2.2.1 THE FILE WINDOWS ...................... 9 Sub-Sec. 2.2.2 THE CHG.DIR. WINDOW ................... 10 Sub-Sec. 2.2.3 THE TITLE AND FUNCTION KEY AREA ....... 11 Sec. 2.3 StS DIRECT KEYS AND COMMANDS ..................... 11 Sub-Sec. 2.3.1 THE CURSOR AND SCREEN KEYS ............ 11 Sub-Sec. 2.3.2 THE LETTER, NUMBER, AND MARKING KEYS .. 12 Sub-Sec. 2.3.3 THE COMMAND KEYS ...................... 14 Sub-Sec. 2.3.4 MOUSE CONTROL ......................... 16 Sub-Sec. 2.3.5 FILENAME CONVENTIONS .................. 17 Sec. 2.4 THE DOS MENU ..................................... 17 Sec. 2.5 THE GENERAL FILES MENU ........................... 18 Sec. 2.6 THE MARKED FILES MENU ............................ 21 Sec. 2.7 THE EXE COM BAT MENU ............................. 22 Sec. 2.8 THE FILE COMPRESSOR MENU ......................... 23 Sub-Sec. 2.8.1 THE I/O REDIRECTION MENU .............. 26 Sub-Sec. 2.8.2 THE EXTENDED ZIP MENU ................. 26 Sec. 2.9 THE INTERNAL VIEW UTILITY ........................ 28 Sec. 2.10 USEFUL NOTES AND HINTS ........................... 28 APPENDIX A ** COMPRESSION UTILITY INTERFACING ................... A1 APPENDIX B ** LICENSE/WARRANTY .................................. B1 Sec. B.1 LICENSE .......................................... B1 Sec. B.2 WARRANTY ......................................... B2 Sec. B.3 TRADEMARKS ....................................... B2 APPENDIX C ** StS REGISTRATION .................................. C1 Sec. C.1 WHY SHOULD I REGISTER ? .......................... C1 Sec. C.2 REGISTRATION FEES ................................ C2 Sec. C.3 SITE LICENSE/QUANTITY DISCOUNT ................... C2 Sec. C.4 THE MRE SOFTWARE BBS ............................. C3 Sec. C.5 REGISTRATION FORM ................................ C4 I PREFACE _____________________________________________________________________ Stereo Shell is a unique DOS shell utility program. This program provides two fully independent file/directory displays which enable it to provide extremely powerful, yet simple, file handling functions. The twin, or if you will, stereo display allows the user to perform file operations such as move and copy between any two drives, or directories, or combinations of drive/directories on the machine without ever typing a file or path name. Stereo Shell also offers many more exciting features. A full complement of standard DOS functions is provided. These include the well known move, copy, erase, etc. and all in stereo! A built in view as well as a user defined editor and 8 user defined file utility programs serve to enhance the power and usefulness of the program to the maximum. Intelligent menus that appear when a filename is selected provide the main user interface. These menus are selected by the program based on the file type and offer the most frequently needed functions for that type of file in top-down order allowing quick, effortless operation. All ten function keys are also "hot" providing more experienced users with instant action. And we haven't forgotten the mouse, full rodent support is built in. Four different file compression programs are also supported by Stereo Shell! Stereo Shell has built-in menus and a file handling system to support PKZIP, PKPAK, LHARC, and PAK. This system provides an effortless interface to these excellent compression utilities. Our system uses the actual utility programs, not some kind of built in approximation to the real thing. This insures the user that his compressed files are really compatible and it also allows simple updates to revised versions of the various file compression programs without the need to update StS itself. Stereo Shell provides a great shell environment for your everyday activities. Its ease of use and ability to execute files while taking only a meager 42Kb of RAM makes it a refreshing change from the hum-drum character based MS-DOS or some of those plain old mono directory utilities. StS is also absolutely perfect as an executable utility program for Procomm (tm) or other communications packages since it provides the means to view directories, edit files, and even extract and execute files from compressed library files, all while still on-line! There is much more! Please give this program a full test on your system. We know you'll agree, DOS never sounded this good before. Stereo Shell......The hi-fidelity DOS shell. II HARDWARE REQUIREMENTS _____________________________________________________________________ StS will run on the IBM PC-XT-AT-PCjr-PS/2 and all true compatibles. The general system requirements are outlined below. Memory .......... 128 Kb. minimum. Shrinks its own memory usage to about 40Kb while executing external programs. Operating sys. .. MS/PC DOS version 2.11 or later. Video ........... The MDA, CGA, MCGA, EGA, and VGA video adapters or any adapters that can emulate these are supported. StS offers the 43/50 line mode as an option on EGA, MCGA, or VGA equipped systems. Full 16 color text mode is provided on all but the MDA. Screen writing is user selectable between BIOS and direct modes. This program is compatible with DoubleDos (TM) and other similar multitasking systems. Disk ............ All disk I/O is controlled through standard DOS function calls. Stereo Shell was designed primarily for hard disk based systems and at least one hard disk is recommended. Network systems.. StS version 3.20 has been tested on the Novell (tm) network software with excellent results. 1 _____________________________________________________________________ >> PART 1 INITIAL SETUP _____________________________________________________________________ >> Sec. 1.1 INTRODUCTION _____________________________________________________________________ StS has a built in setup program to allow the user to configure it to his system and requirements. This section will guide you through the initial execution of the program and also the setup program features. >> Sec. 1.2 THE STS DEFAULT SETUP _____________________________________________________________________ StS comes pre-configured to run on what is considered the most likely system configuration. It assumes you have an IBM compatible video card and that your primary hard disk drive is C:. Although the program is totally re-settable with respect to these parameters, this will be your starting point. StS uses several external utility programs to accomplish the tasks of library file handling, editing, and listing. The default pathnames defined for these functions is C:\STEREO. It is highly recommended but not required that you create a sub-directory called STEREO on the root directory of your primary hard disk and place these files in it; PKZIP.EXE ........ ZIP file packer PKUNZIP.EXE ........ ZIP file un-packer PKPAK.EXE ........ ARC file packer PKUNPAK.EXE ........ ARC file un-packer LHARC.EXE ........ LZH file utility PAK.EXE ........ PAK file utility LIST???.COM ........ ASCII file list program E88.EXE ........ ASCII text editor (available from M.R.E.) If you do not have all of these programs or do not want to move them, no problem. The creation of this sub-directory and the availability of all these programs should only be considered as a helpful suggestion. >> Sec. 1.3 RUNNING StS THE FIRST TIME _____________________________________________________________________ To execute StS, just type in STS at the DOS prompt like you would any other program. StS is not resident or special with respect to general operation with one exception. StS expects to find the COMSPEC environment string defined. In 99% of all cases MS-DOS has already done this job for you so no action is required by the user. In the event that StS does not find this string, it will report the error. If this happens, then simply add this statement to your AUTOEXEC.BAT file. SET COMSPEC = C:\COMMAND.COM If you are not running a hard disk, you should adjust the drive letter as required. 2 When executed, the StS screen will appear on your display, in living black and white. The system defaults are set to direct screen writes which allow the program to operate on any type of IBM display compatible system. If your machine is not IBM display compatible, you will need to specify the /B switch on the DOS command line to force StS to use BIOS screen writes. ie. STS /B Users of very old IBM CGA cards may experience display "fetches" or "snow" on the display when StS is running. StS has a snow suppression option which may be used to correct this problem. --------------------------------------------------------------------- To turn snow suppression on: (1.) Press the key pair to go into setup mode. (2.) Press the function key to set Screen and Mouse settings. (3.) Press the function key to toggle Snow suppression < ON> (4.) Press the key when you are finished playing with the other options. (5.) Press the key to save the change and exit setup mode. --------------------------------------------------------------------- >> Sec. 1.4 HOW TO FULLY TUNE STEREO SHELL _____________________________________________________________________ This section will outline the operation of Stereo Shell's tuning control center. To fully exploit the power of StS, it is important that you understand the setup procedure. To enter the setup area, press the key pair. You should see a screen with five windows. In the upper left hand corner is a main menu area that provides access to the various other menus in the setup routine. We will examine each option in detail. >> Sub Sec. 1.4.1 SCREEN AND MOUSE OPTIONS _____________________________________________________________________ (F1) Screen and Mouse settings allows you to set various operational parameters. The sub-menu options are listed below. (F1) Snow suppression. This option is provided for users of older IBM display adapters. It prevents flicker when the screen is updated while in direct video mode. If you have an older display adapter you will want to toggle this option ON. To toggle the option simply press the key. If you do not have a snow problem, leave this option off for fastest operation. (F2) Exploding windows. Looks sharp and makes noise. Toggle it by pressing (F3) Date/Time display. For users who find the ticking clock irritating or for those who don't know or care what time or day it is. Toggle by pressing . 3 (F4) Sound effects. Enables or disables all sound effects in StS. (F5) Hidden files displayed. When < ON> StS will "see" and display hidden files that reside on your disks. Hidden files will carry a small "h" hi-lighted by the date field in the list. (F6) Screen saver. (3 modes) The StS screen saver will clear the video display to black after ten minutes of keyboard inactivity. Unlike the other options in this section, the screen saver is a 3 mode option. The (OFF) mode will disable the feature entirely. The ( ON) mode will simply clear the screen to black. The (MSG) mode will randomly "bounce" a message around on the screen prompting the user to press a key. The screen saver is only in effect when the StS screen is active. It will NOT blank the screen while the user is executing another application from Stereo. The screen saver is also a simple "clear the screen to black" type, it does no fancy or dan- gerous tricks with the video display adapter. (F7) Wrap around file windows. If on, the file and directory windows will allow the cursor to wrap around from top to bottom, bottom to top when the cursor moves past the first/last file. When the wrap around occurs, the speaker will beep to indicate it. (F8) Mouse sensitivity. Does not refer to the emotional state of the rodent. This option is provided to allow the user to adjust the speed of the mouse. To set this value, press which will print instructions and the current value. Use the <+> and <-> keys to change the value, press when you are satisfied. Press the key to return to the main menu. >> Sub Sec. 1.4.2 COLOR SETUP _____________________________________________________________________ (F2) Color Setup (main screen) This option allows the user to set the screen window colors. Use the number keys listed in the menu to set your desired screen colors and press when satisfied. We have provided a "magic key" (key #9) that will give you a default color setup to examine. The setting of the colors abides by the following sequence. [ black, blue, green, cyan, red, magenta, brown, white ] Foreground colors will cycle through 16 shades of these colors while background colors use only the low intensity 8. (F3) Color Set (borders) This option allows the user to adjust the border colors and hi-lite bar color. Its operation is identical to (F2) above. 4 >> Sub Sec. 1.4.3 FILES/EXTERNAL SETUP _____________________________________________________________________ (F4) Files/external setup StS interfaces to various external programs to allow the user to process compressed files, edit files, and more. This option will allow you to define the programs and location of these programs on your system. First we need to define some general rules for the program descriptions. These rules apply to all programs defined under the option. GENERAL RULES FOR EXTERNAL FILE SPECIFICATION (1.) Include the drive letter. Unless you absolutely plan to use StS only on one drive you will need to include a drive letter on all program descriptions. (2.) Include the full and complete path from the root. StS uses the MS-DOS EXEC function to run these programs. The EXEC function does not search for the user defined PATH= string in the environment so you must explicitly tell StS where the file is located. (3.) Include the complete filename with the extension. The EXEC function does not assume a .COM or .EXE extension as does DOS itself. If the extension is not provided StS will be unable to execute the program. Example: Assume that my editor (E88.EXE) was located in a sub- directory I call GREAT which is itself a sub-directory of EDITORS located on my hard disk drive c. My string to define the Editor utl would be: C:\EDITORS\GREAT\E88.EXE 5 Now that we have the general rules down, lets examine the programs needed. These will be discussed in the order they appear in the menu. To set these strings, press the associated function key and type in the new name at the prompt. (F1) ZIP utility setup. These are the programs to work with .ZIP format files. (F2) ARC utility setup. These are the programs to work with .ARC format files. (F3) LZH utility setup. These are the programs to work with .LZH format files. (F4) PAK utility setup. These are the programs to work with .PAK format files. * * NOTICE * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * Please see Appendix A in this .DOC file for information about * changing the actual file compression program commands. Do not * attempt to change these strings before reading Appendix A. * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * (F5) and (F6) Editor, Viewer and user files 1-3 & 4-8 The editor may be ANY user defined text editor or word processor. It is highly recommended but not required that the program be capable of accepting the filename to be edited on the command line. For example: It is possible to run E88 from the DOS prompt and give it a filename to edit at the same time. ie. C>E88 myfile.txt would load E88 for editing myfile.txt. If your word processor can accept a filename in this manner, it will work well from StS. You will also note a line asking for parameters to pass. The parameters refer to command line switches that some programs can accept. For example if I use the /H option with E88 it would cause the editor to come up in 43 line EGA mode. *** If you want StS to prompt for user input parameters, enter a question mark (?) in the parameter field of any of the user defined utility programs. The viewer definition is optional. The user may define any external view program in a manner similar to the editor definition above. If the viewer is not defined by the user, StS will use its internal view routine. 6 The user defined utility(s) can be ANY .EXE, .COM or .BAT file. If the utility accepts a filename on the command line then you should set the Pass filename option to . If you would like for StS to pause before it clears the screen and returns then set the Pause option to . The pause option allows the user to read whatever text that the utility might print to the screen just before it exited. If you desire to use a .BAT file that changes directories, make sure that you use the complete path from the root with the CD command. This function can be used for a secondary editor or list program. Buerg's LIST.COM program is a popular choice for this option. StS version 3.20 now supports up to 8 user defined utilities. (F7) Help File path/name. This option allows the user to define the name and location of the StS help file. The help file may be any ASCII text file. Follow the on-screen instructions to modify this option. (F8) Working directory setting. This is the default setting for the right side of the StS display. Stereo Shell uses this working directory as the default source and destination of files that will be included in, or extracted from, compressed files. This setting defaults to C:\ZDIR\ and it is recommended that the novice user not adjust this unless it is necessary. Unless your system for some reason does not have a C: drive with sufficient space on it, or you just can't stand the name ZDIR, it should not be necessary to change this path. If you do decide to adjust this, please follow the instructions provided on the screen carefully. Include the drive letter and the complete path from the root. This directory may at times contain large numbers of files and should not be setup on a floppy disk drive. >> Sub Sec. 1.4.4 SAVE SETTINGS AND EXIT _____________________________________________________________________ (F5) Save settings and exit. This main menu option will save the settings you have defined and exit back to the StS main screen. The settings are saved in the root directory of the current disk drive in a file named STSCFG.CFG. In the event that you ever want to start over from the internal program default settings, simply erase this .CFG file before running StS. SETUP NOTE: You may set each window of the StS display to sort files in various manners by using the function key while running the main program. When you select option (F5) in setup mode your currently defined sort settings will be saved. The windows will then "come up" sorted as you have them defined each time you execute StS. 7 NOTE: An environment variable setting is provided to allow the user to "hard code" the configuration file name and location. This feature will allow you purists out there to put the config- uration file in some place other than the root directory. This also allows users who desire to run STS from various disk drives to ensure that STS will always be able to find the setup file The string is: SET STS_CFG=[d:][path](filename.ext) Note: Use all CAPITAL LETTERS. It is the user's responsibility to provide a valid drive and path specification. If you wish to place your config file in a different place but do not want to go through the setup procedure again, first copy your present config file to the place where you want it and then set the string to point at it. If you rename it, make sure the string contains the proper name. STS will use the SET= data if found, otherwise it will default to the current root and the default name. Example: If I wanted my config file to be located in a sub-directory I have named STEREO, I would add this string to my AUTOEXEC.BAT file. SET STS_CFG=C:\STEREO\STSCFG.CFG >> Note that I have included the complete drive, path, and filename. This is necessary! >> Sub Sec. 1.4.5 EXIT NO SAVE _____________________________________________________________________ (F6) or Exit NO save. This option will take you back to the StS main screen without saving the changes in the STSCFG.CFG file. This is useful for experimenting with colors or for temporary setup changes. 8 _____________________________________________________________________ >> PART 2 USING STEREO SHELL _____________________________________________________________________ >> Sec. 2.1 INTRODUCTION _____________________________________________________________________ Stereo Shell is a unique DOS shell utility program. This program provides two fully independent file/directory displays which enable it to provide extremely powerful, yet simple, file handling functions. The twin, or if you will, stereo display allows the user to perform file operations such as move and copy between any two drives, or directories, or combinations of drive/directories on the machine without ever typing a file or path name. Stereo Shell was also intended to be a fast, simple, and user friendly program to handle the otherwise tedious task of working with compressed files. StS takes a fresh approach to this task in that it uses a separate directory and split screen display to isolate and monitor the files associated with a compressed file. StS provides intelligent, easy to use menus for handling file and compressing functions. These menus are intelligent in that the menu that appears on the screen for the user is based on the filename extension of the file selected. For example, selecting a .ZIP file from the directory display will automatically open the file compressor operation window. The menu functions are of the "point-n-shoot" variety but also allow quick execution via the function keys. StS supports most of the standard file and compression commands through its menus and function keys. The following list is provided to give the user an idea of what StS will do. StS Functions Move file ........................ (from anywhere to anywhere) Rename file ...................... (standard DOS function) Copy file ........................ (from anywhere to anywhere) Erase file ....................... (standard DOS function) Erase read-only files ............ (asks to be sure, then zap) Move tagged files ............... (very fast and smooth) Copy tagged files ............... (from anywhere to anywhere) Erase tagged files ............... (prompted super zap) Add tagged to library file ....... (build a compressed file) Convert tagged to another format . (block convert your library files) View file ........................ (built in dual mode viewer) Edit file ........................ (user defined editor/Wp) File attribute modify ............ (change dates times and attributes) User file function ............... (8 user defined utility programs) Execute program .................. (.EXE, .COM, .BAT files) Quick find filename .............. (intelligent search within dir.) Change drive ..................... (with a single keystroke) Change drive ..................... (from DOS menu. Allows A-Z drives) Change alternate drive ........... (changes un-hooked side) Change alternate drive ........... (from DOS menu. Allows A-Z drives) 9 Change directory ................. (fast, easy, sidebar technique) Make directory ................... (from DOS command menu) Sort options ..................... (sort each window independently) Remove directory ................. (use or ) DOS command ...................... (run any DOS command from StS) DOS gateway ...................... (type EXIT to return) Supports .ZIP .ARC .LZH .PAK formats ------| Create compression | Extract files |- Compression utility Test compression |- command support. View files in compression |- Works with four com- Verbose list compression contents. |- pession programs. Freshen files. | Update files. |- Tagged file support Delete files from compression. |- as well, see above. Convert from format to format ------| >> Sec. 2.2 THE StS DISPLAY _____________________________________________________________________ When StS is executed, the user is presented with a screen split into 3 main sections. There is a left file window that includes a sidebar labeled Chg. Dir., and a right file window that shows the contents of the working directory. Near the bottom of the screen is a title line with date/time display and also a function key guide. This section, explaining what the screen windows mean and do, is probably the most important section of the .DOC file. A complete understanding of the StS display and the stereo directory concept will make the remainder of the information presented here almost redundant. The split screen/dual directory display is the key to StS's simplicity and also what sets it apart from other DOS shell utility programs. We will start at the top of the display and examine each main area in detail. >> Sub-Sec. 2.2.1 THE FILE WINDOWS ________________________________________________________________ Both file windows are dynamic. They are capable of display- ing the contents of any drive or directory on your machine. The ability to work with two fully functional displays at a time makes for an extremely powerful file manipulation and maintenance utility. The user can work "between" the displays when moving or copying files. This unique ability eliminates the necessity of ever typing in a path or filename. Please note; StS does allow you to type in paths and such for convenience, but unless a file is being renamed or created, it is possible to do all move and copy operations with only your mouse or cursor keypad. Information pertaining to the current file window display is presented at various points within the window. At the top center of each file window, actually on the border, StS displays a VOLUME = message. This will always show the disk drive to which the window is currently assigned. The drive:path at which the window is currently pointed is displayed in the top title 10 area of the window. In the center or main section is the familiar filename-size-date display. An occasional hi-lighted block containing a lower-case s, r, or h may also appear just to the left of the date on some files. This indicates that the file has special attribute(s) assigned to it on the disk. r,s, and h refer to read-only, hidden, and system files respectively. In cases where the file has more than one of these attributes set only the most important will appear with the hierarchy being h, r, s. Also note that several filenames may also show a small dot to the immediate right of the file size. This dot indicates that the file archive bit is set. File attributes and their meanings are discussed later in this manual under the General File option command menu. The filename display will list the files present on disk in sorted order depending on the sort option chosen by the user. Sort types of file/ext, ext/file, date, size, and unsorted are supported and selected by pressing or . will cycle backwards through the list of sort types. The sort you have defined for each window is saved when you save the setup in setup mode. In the bottom title area the free disk space for the selected drive is shown. The sort type, file size, date, and attributes are shown on the bottom border areas. >> Sub-Sec. 2.2.2 THE CHG. DIR. WINDOW ________________________________________________________________ In the center of the display is a narrow vertical window titled Chg.Dir. This window area is used to display sub-directory information and allow you to easily move around on the disk(s). A brief definition is in order here to explain a bit of Stereo Shell jargon:.... "Hooked" refers to the appearance of the directory window as it is graphically displayed on the screen. When the Chg.Dir. window is hooked to a file window, it appears to be connected to the file window and will form a continuous outer boundary. If the left and right file windows are in different colors, the Chg.Dir. window will assume the color of the file window to which it is hooked. The Chg.Dir. window always displays the sub-directories of the file window currently hooked. Pressing the left and right arrow keys or moving the mouse will allow the user to hook the Chg.Dir. window to either file window so long as there is file or directory information available to be read from that drive. StS logic prevents the user from placing the cursor in a completely blank window and thus will not allow a hook when a disk is completely blank and contains no sub-directories. The Chg.Dir. window, or directory sidebar window is a unique feature of StS and provides the user with the means to zip around on the disk. The change directory sidebar window displays, in sorted order, the sub-directories associated with the currently hooked file window. By separating the directories from the filename list and providing the user with a scrollable sorted listing, StS is probably one of the fastest, easiest, and 11 most convenient to use directory programs available. By simply placing the "light bar" on the directory you want and pressing [ENTER], you can move anywhere on the disk. One feature of the directory display may not be familiar to some users and requires some explanation here. If you are displaying a sub-directory listing, you will notice that the first directory in the Chg. Dir. sidebar window appears as two dots (..). These two dots are the link to the parent of that sub-directory. Selecting the double dot directory will take you "up a notch" thus, this is the means to go backwards on the tree. This is the standard DOS method to do this job, not something that was created by the author. In fact many users will be delighted to know that this works from the DOS prompt. Anytime you are in a sub-directory entering a CD .. command will take you up to the parent directory. In the bottom title area of the Chg.Dir. window the total of all marked (tagged) files for the currently hooked directory is displayed. One quick trick worth mention here is the fact that the user can mark all files in the window and quickly find the total disk space occupied by the files. See the INS and DEL keys for the mark/un-mark all feature. >> Sub-Sec. 2.2.3 THE TITLE AND FUNCTION KEY AREA ________________________________________________________________ Across the bottom of the StS display the user finds a program title/version/copyright and date/time line. Below that is a function key guide. This is a standard function key help line and shows an abbreviated command for each F-key. Keys F8 and F10 may be used to rename and erase directories as well as files. DOS 3.xx+ is required to rename a directory. >> Sec. 2.3 StS DIRECT KEYS AND COMMANDS _____________________________________________________________________ This section will describe the direct key functions available to the StS user when file selection is in effect. >> Sub-Sec. 2.3.1 THE CURSOR AND SCREEN KEYS ________________________________________________________________ The cursor and screen keys provide the user with the means to select files and directories. Here we will list all the active keys in this group and detail what they do. > Left and Right arrow keys < The left and right arrow keys select the screen window. The selected window will contain a "light bar" cursor. The arrow keys wrap around between windows and all empty windows are skipped. 12 > Up and Dn arrow keys < The up and down arrow keys allow the user to select a file or directory within a window. These keys move the cursor and also scroll the display when on the edge. The speaker will beep when the first and last entry in the window is reached. > Home and End keys < The home and end keys will instantly scroll the selected window to the first and last entry in the window and place the light bar on it. > PgUp and PgDn < The page up and page down keys will instantly scroll the selected window display one page up or down. > The tab key. < The tab key will move the cursor between windows. >> Sub-Sec. 2.3.2 THE LETTER, NUMBER, AND MARKING KEYS ________________________________________________________________ The letter and number keys serve a very important role in the StS user interface. This section explains their use. > The letter keys; A,B,C,D, etc < The letter keys are used for a "QUICK FIND" scroll. Pressing a letter key will find a filename, extension, or directory beginning with the letter that is nearest to, without exceeding the letter that was pressed. This QUICK FIND is based on either the filename or extension depending on what the user has selected as the primary sort, ie. filename/ext or ext/file- name. QUICK FIND also has some built in intelligence. If all the files in a directory have extensions that begin with the same same letter, and you are sorting by extension, then the QUICK FIND automatically switches to a filename find. This switching allows users to set up directories containing files which are all of the same type and still be able to use QUICK FIND to advantage. QUICK FIND is disabled if you have selected any sort than file/ext or ext/file. Pressing a letter key more than once will cause the cursor to go to the next file starting with that letter and so on until the last file is found. Pressing the same letter key twice on the last file will cause the cursor to again go to the first file and start back down the list. Valid keys for the QUICK FIND are A-Z. 13 > The number keys; 1,2,3 etc. < The number keys allow the StS user to select the disk drive for display in the hooked window. Upon execution, StS request drive information from DOS and assigns the number keys 1- 9 to access the correct drive letters. The keys are assigned as 1=A: 2=B: etc. If you press an unassigned number key StS will respond with a beep. Pressing a number key will change the hooked window to the drive specified. The user can change the other side, the un-hooked side by using <1,2,3,etc.>. Users with more drives than are accessible with the number keys may select these drives from the DOS menu. > The number keys; 1,2,3 etc. < *** The combination of and the number keys 1,2,3, etc. will allow the user to change the un_hooked file window to another drive. This is a very important feature due to one of the idiosyncrasies of stereo windows. If you have a window pointed at say, a blank, formatted floppy disk, there is no way to hook to that window because it is totally blank. Pressing 1,2,3 will allow the user to change the drive of that window without ever hooking to it. A good way to remember this command is to always think of the un-hooked window as the alternate window and hence key controlled. Users with more drives than are accessible with the number keys may select these drives from the DOS menu. > The space bar. < The space bar will mark or unmark (tag) a file for subsequent copy or erase activity. The marked file is indicated by a small diamond displayed at the end of the filename extension. > The Ins. and Del. keys. < The insert and delete keys will instantly mark or un-mark all files in a directory window. > The [Alt] [H] key. < (help) This key pair will load the user defined StS help file and display it with the viewer. > The [Alt] [Q] key. < (quit) This key pair is the fastest way to exit from StS. When pressed, this key combination will return the user to DOS and restore the drive/directory that was current when StS was executed. > The [Alt] [R] key. < (reset) This key pair will reset the right side to the work dir. 14 > The [Alt] [S] key. < (setup) This key pair will place StS in setup mode. > The [Alt] [T] key. < (time check) This key combination will toggle the hooked window display mode between size/date and date/time mode. The window mode for each window can be saved by saving the setup with the windows set as desired. > The [Alt] [E] key. < (enhanced display) This key pair will switch the StS display resoloution on MCGA, EGA, or VGA equipped systems. Three modes are sup- ported on the MCGA and VGA, two are available on the EGA. > The [Alt] [D] key. < (DOS commmand/gateway) This key pair will open a dialogue window which will allow the user to either execute a DOS command directly or to "gateway" to DOS. Entering nothing on the command line will open the gateway. The drive/directory that will be considered "current" by DOS when the command is issued is displayed in the window. >> Sub-Sec. 2.3.3 THE COMMAND KEYS ________________________________________________________________ The command keys open an StS menu. This section outlines the use of the command keys. > The Enter key < The carriage return or enter key is used to select a file or directory. In the case of a directory selection, StS will immediately change and display the new directory in the hooked window, and any associated sub-directories in the Chg. Dir. sidebar area. In the case of a file selection, StS will open the appropriate menu to work with that file based on the filename extension. A .ZIP or .ARC file opens the compression menu. A .EXE .COM or .BAT file opens the EXE COM BAT window. And the selection of any other file extension opens the GENERAL file menu. > [F1], [+], or [Esc] keys < Pressing the F1, +, or Esc. keys opens the DOS menu. The DOS window is described in detail in the following sections, but for now, this is how it is accessed. It was decided to use so many keys to do this job for several reasons. F1 and Esc. are the keys most users instinctively think of as the method to escape from, or get help in using, a program. So, they were both used here. F1 has the added nicety of being the first command in the DOS window, namely, EXIT to DOS. By pressing F1 repeatedly the user can quickly exit from StS. The plus key was chosen for its location. Since most keyboards have a large plus key located near the numeric keypad (cursor control) area, using the plus key as a 15 substitute for Esc. allows one handed operation of StS. The plus key works as a replacement for Esc. everywhere in StS except when the program is prompting for a filename. Since the user has full cursor control, an ENTER key, and a plus key, all located in one bundle on the standard keyboard, the user can almost operate StS with just one hand. > The other active function keys < Several other function keys are active when StS is in file selection mode. Here is a description of their functions. [F2] Function key F2 calls the marked file option menu. This key will allow you to move, copy, erase, etc. files that have been tagged. [F3] Function key F3 will cycle the currently hooked window through the various sort types and re-sort the list. [Alt] [F3] This key pair is identical to [F3] except that it backs up though the sort types. Press this pair to quickly get back to where you were. [F4] Function key F4 will immediately open the user defined file utility menu which will allow you to select a pre-defined utility program to run. Please see part 1 for information on defining these utilities. [F5] Function key F5 will immediately execute the user defined edit utility program, passing to it, the filename beneath the cursor. Please see part 1 for information on defining this utility. [F6] Function key F6 will immediately execute the internal view utility program. The Stereo Shell view utility will analyze the filename extension and appear either in HEX mode or ASCII mode. Pressing the space bar will switch modes. Please see the later section on StS view. [F7] Function key F7 will allow the user to move a file to any other directory. When F7 is pressed, the lower screen will be overlaid with a dialogue box requesting that the user enter a new path filename to move to. The currently selected file will be displayed in the top left corner of the box window. If only a path is specified, the file will be moved to the new location using the same name. If a new name is specified, the file will be moved and renamed in one operation. * * * As a special feature of StS, if nothing is specified, and the user simply presses ENTER, the file is moved between the currently displayed windows. If the user is in the left window the file will be moved to the right window and vice-versa. Pressing Esc. while being prompted for input will cancel the operation. 16 [F8] Function key F8 will allow the user to rename a file. When F8 is pressed, the lower screen will be overlaid with a dialogue box requesting the new filename. The currently selected file will be displayed in the top left corner of the box window. * * * F8 also serves as a move file command. If a valid path is entered without a filename then the file is simply moved to the new location. If a path and filename are entered, the file is both moved and renamed in one operation! If only the filename is given, the file is simply renamed. Pressing Esc. while being prompted for input will cancel the operation. [F9] Function key F9 will allow the user to copy a file to any drive or directory. When F9 is pressed, the lower screen will be overlaid with a dialogue box requesting that the user enter a new [d:] [path] [filename.ext]. The current- ly selected file will be displayed in the top left corner of the box window. If only a drive or path is specified the file will be copied to the new location under the same name. If a new name is specified, the copy of the file will use the specified name. * * * As a special feature of StS, if nothing is specified, and the user simply presses ENTER, the file is copied between the currently displayed windows. If the user is in the left window the file will be copied to the right window and vice-versa. Pressing Esc. while being prompted for input will cancel the operation. [F10] Function key F10 is the erase file command. This key prompts for confirmation of the erase. Please see the next function for a more efficient way to erase files. [Alt] [F10] The key combination of Alt. F10 will erase the file or directory under the cursor! In the case of a file the operation simply "zaps" the file. If this key is used to delete a directory entry, the directory must be empty or StS will report the error and the directory will not be removed. Please note that a two key combination was used for this function to prevent accidental erasure of files. >> Sub-Sec. 2.3.4 MOUSE CONTROL ________________________________________________________________ Stereo Shell includes a built in mouse interface. To use your mouse, a Microsoft compatible mouse driver is all that is required. See your mouse documentation for information on how to load the mouse driver. 17 The StS mouse interface emulates various keyboard keys to provide user control. The key emulations are outlined below. Left button:...... Same as key. Right button:..... Same as key. Both buttons:..... Same as . Hold to repeat. Roll away:........ Same as key. Roll toward:...... Same as key. Roll left:........ Same as key. Roll right:....... Same as key. >> Sub-Sec. 2.3.5 FILENAME CONVENTIONS ________________________________________________________________ StS uses standard DOS filename conventions when prompting for input. Items displayed in square brackets are optional while those displayed in parenthesis are required. All drive letters must be followed by a colon and all path names must end in either a slash or backslash. For more information on standard DOS conventions, see the DOS manual. >> Sec. 2.4 THE DOS MENU _____________________________________________________________________ The DOS window provides the StS user with the ability to perform some basic program functions such as opening the DOS gateway and exiting StS. This window is opened by pressing either or <+> or . This section will take the functions available in the DOS window and explain them in the order they appear. [F1] QUIT and return to DOS. This option will end StS. Through this method, the user may exit back to the original load drive\directory or exit into either displayed window. See also for a faster exit method. [F2] ERASE working dir. files. This option provides a fast and neat method to erase the contents of the working directory. When selected, the files in the working directory will be erased. [F3] DOS gateway/command. This option opens a dialogue window which will allow the user to either execute a DOS command directly or to "gateway" to DOS. Entering nothing on the command line will open the gateway. The drive/directory that will be considered "current" by DOS when the command is issued is displayed in the window. [F4] CREATE a compressed file. This option will allow the user to create a totally new 18 compressed file. The user will first be asked to select a type and then the program will prompt for the filename. StS will then execute the utility and pass the create command to it. All files that are currently in the work dir. will be included in the new compression or added to any existing compression that has the name specified by the user. The new file will be created in the currently hooked window. Pressing Esc. while being prompted for the file type or filename will cancel the operation. * This command invokes a sub-menu that allows I/O re-direction. Please see section 2.8.1 for information concerning this menu. [F5] MAKE a new sub-directory This option will allow the user to make a new sub-directory on the disk. The user will be prompted for the path and directory name. Pressing Esc. while being prompted for the name will cancel the operation. [F6] MARKED file operations. This command will open the marked file operations window allowing the user to do marked operations. Please see the marked file menu section later in this manual. [F7] DRIVE chg. (hooked side) This option allows the user to change the disk drive to which the hooked window is assigned. Users with more logical disk drives than are addressable via the number key method may use options F7 and F8 to reach them. StS internally bit-maps all valid disk drives and will only display valid letters. Mouse users can select drives by moving the mouse vertically and clicking the left button on the drive letter. [F8] DRIVE chg. (un-hooked). This option is identical to option F7 above except that it allows selection of the un-hooked window. [F9] SETUP (tune Stereo Shell) Will run the internal setup program. The use of the setup program is explained in part 1. >> Sec. 2.5 THE GENERAL FILE MENU _____________________________________________________________________ The general file menu is opened when the user selects a file that does not have an extension of EXE, COM, BAT, ARC, ZIP, etc. This section describes the options available via this window. [F1] VIEW the selected file. This option will run the internal dual mode view utility. The View utility will begin in either ASCII or Hex mode depending on the file type selected. Pressing the space bar will switch modes. The full cursor pad or the mouse may be used to control the viewer. 19 [F2] EDIT the selected file. This option will execute the user defined external editor or word processor program and pass the filename to it. Please see part 1 for setup information. [F3] USER defined file utility. This function will immediately open the user defined file utility menu which will allow you to select a pre-defined utility program to run. Please see part 1 for information on defining these utilities. [F4] COPY the selected file. This function will allow the user to copy a file to any drive or directory. When this function is used, the lower screen will be overlaid with a dialogue box requesting that the user enter a new [d:] [path] [filename.ext]. The currently selected file will be displayed in the top left corner of the window. If only a drive or path is specified the file will be copied to the new location under the same name. If a new name is specified, the copy of the file will use the specified name. * * * As a special feature of StS, if nothing is specified, and the user simply presses ENTER, the file is copied between the currently displayed windows. If the user is in the left window the file will be copied to the right window and vice-versa. Pressing Esc. while being prompted for the filename will cancel the operation. [F5] RENAME the selected file. This function will allow the user to rename a file. When this function is selected, the lower screen will be overlaid with a dialogue box requesting the new filename. The currently selected file will be displayed in the top left corner of the window. * * * This function also serves as a move file command. If a valid path is entered without a filename then the file is simply moved to the new location. If a path and filename are entered, the file is both moved and renamed in one operation! If only the filename is given, the file is simply renamed. Pressing Esc. while being prompted for input will cancel the operation. [F6] MOVE the selected file. This function will allow the user to move a file. When this function is selected, the lower screen will be overlaid with a dialogue box requesting the new pathname. The currently selected file will be displayed in the top left corner of the window. * This function is a variation of the rename command tailored specifically for moving files. If the source and destination paths are on different drives, the program will automatically switch to a copy/delete sequence to accomplish the move operation. The move command takes advantage of the stereo aspects of StS by allowing the user to move files between windows. 20 [F7] ERASE the selected file. The currently selected filename appears in the top left corner of the window. Selecting this option will erase the file. Warning: The user is not queried for a confirmation on the erase single file commands. Pressing this key WILL erase the file. It was felt that since this was a menu driven function and the key was well defined, that a confirmation request on the single file function would be a burden to the user. In keeping with recognized DOS methods, the multiple file erase commands do prompt for a Y/N confirmation but the single file erase commands do not. [F8] ATTRIBUTE/date editor. Selecting this option will open another menu which displays the current file attributes, date and time and allows the user to change them. To change any of the file attributes, simply press the appropriate function key. The attrib- ute will be toggled off/on. Selecting will allow the user to change the file's date and time. When is pressed the cursor will appear on the displayed date. At this point, three things can be done; (1.) Press to exit with no change. (2.) Press to automatically insert the current date/ time. (3.) Type in the complete date/time values. All fields must be entered by the user. Four file attributes are defined by DOS to classify files on your disk. The archive, system, hidden, and read only bits may be controlled with this option. What follows is a brief description of normal bit settings. Archive: This bit is set ON by most programs that are capable of changing a file. (text editors for example) It is turned off by most backup programs whenever the file is backed up. (hence changed/archived) System: This bit is normally set ON only on files that relate to the operating system proper. Files such as MSDOS.SYS will have this bit set. Hidden: If this bit is set ON the filename will be excluded from normal directory searches by MS-DOS. StS can still "see" the file if the hidden option is < ON> in the setup program. Read only: This is probably the most useful attribute from the standpoint of the user. If this bit is set ON the file cannot be modified or erased by any normal means. StS has the ability to erase read-only files but will prompt the user for confirmation before doing so. Examples: Standard file entry: A s h r Standard r/only file: A s h R Hidden file entry: A s H R Hidden system file: A S H R 21 >> Sec. 2.6 THE MARKED FILES MENU _____________________________________________________________________ The marked files menu allows the user to copy, move, erase, view edit, perform user defined file functions, change the attributes and dates and also perform compressed file operations on "marked" or "tagged" files. Since these first six functions are virtually identical to their individual file counterparts, the reader is referred to the previous section for details. Option (F7), (F8), and (F9) however deserve some explanation. [F7] ATTRIBUTE/date editor. The attribute date editor's application for marked files differs slightly from its single file equivalent. When this option is selected, the attributes displayed do not reflect the attributes of any of the marked files. The initial con- dition for the attributes is all OFF. You may toggle any of the attributes any way you like, and saving the settings will set ALL the marked files to your defined attributes. Likewise the initial date/time fields are filled with asterisks. If you do not enter a new date/time, the dates and times of the marked files will not be changed. If you do enter a date and time, then ALL the marked files will be set to this date and time. [F8] CONVERT library types. This option provides the means to block convert library files from one type to another. Library files of any type may be marked and converted to the same format. For example you could mark .LZH, .ARC, and .PAK files and convert them all to .ZIP format in one pass. Files marked that are not of a defined extension type are simply ignored by the command. When selected, you will be asked to define the type of file to convert to. Once the type is selected the program will automatically load the proper programs to extract and re-com- ress each of the marked files. As with any other marked file operation, pressing the key will terminate the automatic process. Please see the FILE COMPRESSOR MENU section for more in- formation about file conversion and error handling. [F9] ADD/CREATE to a library. This option will allow the user to pick out files from a directory and either add them to a library or create a new library file with them included. When this option is selected it may scare you a little. It first performs an automatic copy of the selected files to a temporary sub-directory. This is done so that the files may be isolated from the others and the wildcard *.* can be used to control the compression program. Once the auto-copy is completed the user will be prompted to select a library type and a library file name. This option will either add or create the library file depending on whether it previously existed. 22 Marked file operation with stereo windows is an extremely powerful feature. It provides the user with the means to move large numbers of files around quickly, without the drudgery of typing in pathnames. By simply pointing the two windows at the source and destination of your operation and accepting the default "across display", you can get the job done quickly and see what is going on during the process. >> Sec. 2.7 THE EXE COM BAT MENU _____________________________________________________________________ The EXE COM BAT file menu is opened when the user selects a file that has an extension of EXE, COM, or BAT. This section describes the options available via this window. [F1] EXECUTE the selected file. This option will execute the selected file which is displayed in the lower left corner of the window. When selected this option prompts for additional parameters to pass to the program. These parameters are what the user would normally enter on the DOS command line after the filename. For example: If the user wanted to run DEBUG and pass the filename TEST.EXE to it, he would place the cursor on DEBUG and press , StS would open the EXE COM BAT window and from there the user selects [F1]. The response to the parameter entry window would be; TEST.EXE. StS is capable of executing .EXE .COM and .BAT files via the [F1] function, however, the process for .EXE and .COM files differs from .BAT files because a duplicate copy of COMMAND.COM is needed for .BAT files. Although this process is transparent to the user, the author of this program likes to know what is going on behind the scenes and thinks most users do too. When a file is executed, StS shrinks its total memory usage to 42Kb to allow the maximum memory for the application's use. In the case of .BAT files, the command processor is loaded and takes a block of RAM depending on the MS-DOS version used. What this means in reality is that you can run larger programs directly from StS than you can if the program is run via a batch file executed from StS. *--------> NEVER run a terminate and stay resident (TSR) program from StS or any other DOS shell. When this type of program is executed it makes a permanent place for itself at the memory address it was loaded. Since the program is loaded above the DOS shell, it will permanently cut out a large chunk of usable memory. [F2] - [F9] VIEW, EDIT, USER, COPY, RENAME, MOVE, ERASE, CHG. ATTR. The F2-F8 options are identical in operation to the general files menu options described above. 23 >> Sec. 2.8 THE FILE COMPRESSOR MENU _____________________________________________________________________ Selecting a file with a ZIP, ARC, LZH, or PAK (defaults) extension will open the file compressor menu. This section will describe the options available from this menu and give the equivalent PK commands. NOTE: In this section the default name ZDIR, is used for the working dir. StS handles library (compressed) file procedures by using the sub-directory ZDIR as an isolated work area. All files are extracted into ZDIR and all freshen/update/create activity uses ZDIR as the source of files. This concept makes StS extremely useful for working with compressed files. It is possible to keep large programs compressed, extract to ZDIR, execute from ZDIR, freshen or update and then erase the individual files without disturbing anything else on the disk. This approach, when combined with with the powerful copy and move features of Stereo, makes file compression a logical alternative to bigger disk drives. Note: References to actual commands in the descriptions that follow are based on PKZIP. These are provided only for illustrative purposes and may vary with different compression utilities. [F1] EXTRACT files. This option uses the -x command to extract files from the selected library. The user is prompted for filenames so that a partial or "wildcard" extract can be performed. If nothing is entered in response to the filename prompt, all files will be extracted. The extracted files are placed in the ZDIR directory unless the user redirects the output. Pressing Esc. while being prompted for the filename(s) will cancel the operation. (I/O redirection. see next section) [F2] LIST filenames to screen. This option uses the -v command to provide the user with a listing of the library's contents. Filenames, file sizes, and other related technical information is provided to the user. This option is useful to determine the contents of a library before selective extracting or deletion is performed. [F3] TYPE text files on screen. This option uses the -cm command to extract files directly to the video display. On the later versions of PKUNZIP the more command is added and prompts the user after each screen full of information is given. This option provides the user with the means to quickly view text files without the need to extract them. 24 [F4] TEST compress integrity. This option uses the -t command to test the validity of the library and the files within it. This command should be particularly useful to BBS sysops and program librarians who need to perform a quick test of their library files. [F5] DELETE files from library. This uses the -d command to delete files from the selected library. The user will be prompted for the file- name(s) to delete. The user must enter a filename or press Esc to cancel the operation. To determine the filenames present in any given library use the [F2] (verbose list) command from this menu first. [F6] FRESHEN library file. This option uses the -f command to freshen the files in the library. In the case of PKZIP, the actual command string is -f -ex which provides extra compression on binary files. Freshen differs from update in that new files are not added to the library file. Freshen only updates files that already exist in the library and have been changes since the library originally created. (I/O redirection. see next section) [F7] UPDATE + add to library. This option uses the -u command to update the files in the library. In the case of PKZIP, the actual command string is -u -ex which provides extra compression on binary files. Update differs from freshen in that new files ARE added to the library file. Update not only updates files that already exist in the library and have been changes since the library originally created, it also ADDS any new files that are present in ZDIR or in the user specified override directory. (I/O redirection. see next section) * * * * * NOTES AND HINTS ABOUT FRESHEN/UPDATE. ... Freshening * means that only files that have filenames matching those files * already in the library will be considered in the update * process. This option should be used if the extracted files * are changed by some activity performed on them. For example: * If you un-arc a spreadsheet file and make a few changes, then * the original library should be freshened so that the changes * will be reflected the next time the file is used. As * another example: If a new spreadsheet file is created in the * ZDIR then you should update and add to insure that the new * file is stored within the library. * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * [F8] CONVERT compress format. This option will automatically convert compressed files from format to format. The user will be asked to select the type of format that the file will be converted into. A sub directory named Z_STS_TD is created on the working drive and is used as a temporary holding area for the extracted files. The filename extension is changed as well as the file format. Example: TEST.ARC converted to LZH format becomes TEST.LZH. 25 * * * * * CONVERSION UTILITY NOTES ... The process of library * file conversion merits some deeper explanation into the actual * procedure that is going on behind the scenes. This is necessary * due to the possibility of the program failures that can occur * during the process. A good understanding of the StS file con- * version method will allow you to easily locate and recover your * data in the event of a failure. * * The conversion process: * * (1.) Files are extracted to a temporary sub-directory that StS * creates on the working drive. (see the setup program for * information about the working drive) The sub-directory is * named \Z_STS_TD. If a failure occurs in this step the * conversion process will be terminated and the original * library file will still be intact. In some cases there * may be files in \Z_STS_TD that will need to be erased * before any other files may be converted. * * (2.) If step 1 is successful, the original library file is * erased at this point. This is done to allow the conversion * of files to be performed on floppy disk drives. Quite * often disk space will not permit both the old and new * library files to exist simultaneously. It is worth noting * here that the user can prevent step 2 from occurring by * giving the library file a read only attribute mark before * doing the conversion. Please see the change attribute * options for information on how to do this. * * (3.) The files that were extracted to \Z_STS_TD are now added * to a new library file that assumes the same filename as * the original. If a failure occurs in this step the * conversion process is terminated and the user may recover * his original files from the \Z_STS_TD sub-directory. * * (4.) If step 3 is successful the extracted files are erased and * temporary sub-directory \Z_STS_TD is removed. The * original date/time and file attributes are passed on to the * new library file. * --------------------------------------------------- * We have designed the file conversion process to be as safe * as possible in order to prevent the loss of data during a * conversion. It is hoped that the descriptions above will help * you recover your files in the event that something like an ill * defined utility path causes a runtime crash. It is wise to test * your utility programs on single files to be sure that they are * working properly before using the convert. * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * [F9] GENERAL FILES MENU. This command will open the General files menu allowing you to move/copy/erase etc. a library file. See General files menu section for more details. 26 >> Sub Sec. 2.8.1 THE I/O RE-DIRECTION SUB MENU __________________________________________________________________ Several of the file compression commands invoke a sub-menu which allows the user to specify where to send files that are extracted from library files or where to look for files that are intended to add, freshen, or update a library file. Hence the file input or output of the compressed file operation may be controlled by the user. The following is a brief description of the options available on this sub-menu. [F1] WORKing directory. This option will send\receive files to/from the working directory. (ZDIR) [F2] ACROSS display. This option will send\receive files to/from the un-hooked window. This is similar to the copy across dis- play feature of Stereo. [F3] HERE no re-direction. This option will send\receive files to/from the hooked window. [F4] USER defined path. This option will prompt the user for the I/O path to use. >> Sub Sec. 2.8.2 THE EXTENDED ZIP MENU __________________________________________________________________ The "EZ" interface is offered to users whenever a .ZIP file is selected and either an extract, view text files, or delete, command is issued. If the EZ interface is opted for, the menu window will expand and a directory of the .ZIP file will be displayed. In the interest of memory preservation and speed, only the filename and extension data is provided. The files are sorted by StS and the sort is either name/ext or ext/name. The sort of the ZIP directory listing takes on the same sort as the hooked window if the hooked window was one of these two types else it uses whatever sort it used the last time it was opened. The ZIP directory menu filename list is controlled in a manner identical to to the main screen file windows. Full cursor pad and mouse support as well as the quick find letter keys are supported. Files may be marked with the space bar or both mouse buttons. All files may be marked or unmarked with the insert and delete keys. IF NO FILES ARE MARKED: Pressing the ENTER key will cause only the file the cursor is on to be processed. 27 IF FILES ARE MARKED:... Pressing the ENTER key will cause the marked files to be processed. The filename that the cursor bar is on will be ignored unless it is marked. Pressing ESCAPE will exit with no action. The "EZ" interface attempts to read the contents of the central directory of the selected .ZIP file directly. It opens the file and reads the filename information directly from the file PKZIP is not involved in this process. The program is compatible with PKZIP version 1.00 and later, some older versions such as .91 are not supported. If a file zipped with an older version of PKZIP is encountered, it may easily be converted to the newer version with StS. If Stereo Shell cannot read the .ZIP directory directly, it automatically switches to the standard interface. An error is reported in the menu window when this occurs but the program continues on as if the user had selected the default standard interface. If an unrecoverable error occurs while the actual zip directory menu is displayed, StS will abort the whole process just as if the Escape key had been pressed. An error of this type might occur when a re-sort is attempted if say the file is on a floppy and the disk has been changed. In a rare case like this, there is nothing more StS (or PKZIP) can do, so the abort is appropriate. The EZ interface does not support the extremely rare case of ZIP files whose central directory structure spans multiple disk media. It will switch to the standard interface and let PKZIP handle it. The EZ interface has limited support for .ZIP files with relative path names stored inside. These are .ZIP files created with the the -r option that are generally used for system backup purposes. The EZ interface will show the filenames, however PKUNZIP will be unable to extract the files unless the -d option is specified under the extract command. If -d is specified, then the relative paths will be created on extraction... It is better to use the standard interface which will override the path information entirely and extract all the files to wherever they have been I/O re-directed. This type of .ZIP file is rarely encountered in normal operations. We DO NOT recommend the -d option be used for extractions in StS. This situation is better handled with dedicated batch files for backing up and restoring hard disk information. The EZ interface has a maximum capacity of 1050 files within the .ZIP file. If a .ZIP file contains more than 1050 files, only the first 1050 filenames encountered will be displayed. The EZ interface creates and destroys a file named STS_PKZP.LST on the working drive as the list file to pass the filename list information to PKZIP. This filename should be considered reserved. 28 >> Sec. 2.9 THE INTERNAL VIEW UTILITY _____________________________________________________________________ Stereo Shell includes an internal dual mode view utility that will allow viewing of ASCII or binary files. The view utility determines from the filename extension what type of file is selected and automatically comes up in the correct mode. ie. either ASCII or HEX. The StS view utility was designed to be used as a "quick look" tool and not a full blown do everything viewer. Most users of this program probably attach the Buerg LIST.COM program to one of the USER defined keys to be used as a full blown view tool. By keeping the internal viewer small and relatively simple we have kept the overall size of StS to a minimum allowing it to run from within other applications and also to provide more memory for programs running under it. This section notes the key commands used in view and also makes note of the special mouse control. >> KEYBOARD CONTROL > Up/Dn arrows ............ Scroll 1 line up and down > Lt/Rt arrows ............ Scroll 1 page up and down > PgUp and PgDn ........... Scroll 1 page up and down > Home and End ........... Top or End of file > Enter key ............... Scroll one page down > Space bar ............... Switch HEX/ASCII mode > Esc. or + key ........... Exit view mode >> MOUSE CONTROL > roll up and down ........ Scroll 1 line up and down > roll rt. and lt. ........ Scroll 1 page up and down > left button ............. Scroll one page down > right button ............ Exit view mode > both buttons ............ Switch HEX/ASCII mode >> PRINTER CONTROL KEYS > F2 key:.........=> Print from top of screen until a key is pressed. > F3 key:.........=> Send a form feed (ASCII 12) to the printer. >> Sec. 2.10 USEFUL NOTES AND HINTS _____________________________________________________________________ This section contains some notes and hints for using Stereo Shell. Using the menus: StS includes what we call quadraphonic menus. This means that the user may enter a command in any of four ways. (1.) Point and shoot with the cursor keys. (2.) Point and shoot with the mouse. (3.) Type the corresponding function key. (4.) Type the letter that appears the the left of the command. The letters are generated automatically on user defined functions and generally are the first letter of the user defined text string. If the first letter has 29 already been used, the second letter is used and so on. Printing files: A text file may be sent to the standard printer by copying it to PRN. To do this, place the cursor on the file and issue a copy command. When StS prompts for the destination, enter PRN. Do not include a colon after the device name. StS may report a "file exists overwrite" message on some systems, if it does, tell it yes. Upon completion of the print, StS may report that the file was not copied, but of course if the printer printed it, it was. The error messages are a result of the checking StS does when copying files between disk drives. Since the PRN device does not behave like a disk drive, it causes StS to report the errors. Stereo Shell's internal viewer may also be used to print files and of course the user can load a file into an editor or external viewer and print it from there. Floppy disks: Although both of Stereo's windows will allow the user to perform all the same functions, use of the right window for floppy disk access will provide slightly better performance. The reasons for this are complicated but have to do with the fact that DOS only has one true default directory active at any time. When Stereo is running, the left window always displays the true default directory. If the left window remains pointed at a hard disk, whose directory information is buffered in RAM by DOS, the need to read the physical disk when changing directories is minimized. If the left window points at a floppy, StS will re-read it more often when the user changes directories on either side. A1 APPENDIX A COMPRESSION UTILITIES INTERFACING _____________________________________________________________________ The compressor interface of StS is built upon the speed and power of four different compression utility programs. This appendix is provided as a guide for modifying the commands StS passes to these utilities in order to perform the various file compression functions. If you plan to modify your file compression interface be warned that StS allows very powerful control and you can change the entire personality of the program. You will need a copy of the user manual that comes with your file compression utility before proceeding. To set the various file compression commands you must go into setup mode (F3 from main screen) and then select (F3) Files/external options. In this menu, you may select any one of four file compression utilities you wish to re-program. Selecting these options will open a screen that shows the current settings for each supported command. Simply select a command and use the built in line editor to change the string. The string may be up to 16 bytes in length. The Extension key may be somewhat un-familiar and will be discussed here. The other options and the program that executes their respective commands is outlined in table 1 below. The Extension key defines the filename extension that will trigger Stereo Shell into opening the file compressor window. Some examples are ARC, PAK, ZIP, etc. If you decide to change this option, just enter the three letters, no need to place a period before them. The entire program menu system will be updated to reflect your change. For example, if you set the EXTENSION trigger to ZAP, the COMPRESSION TYPE WINDOW will then have an option that says "(F ) ZAP - File compression options. --------- A2 >> Table 1 << Compression command chart. ____________________________________________________________________ EXECUTED BY THE PACKER| Un-PACKER Command ----------------- Description EXTRACT files | | X | Extracts files from the library file. --------------------------------------------------------------------- TYPE text files | | X | Allows reading text files on screen. --------------------------------------------------------------------- DELETE files | X | | Removes files from within the library. --------------------------------------------------------------------- LIST all files | X | | Provides a directory of files in lib. --------------------------------------------------------------------- TEST integrity | | X | Checks the library file for errors. --------------------------------------------------------------------- FRESHEN no add | X | | Freshens files that have been changed. --------------------------------------------------------------------- UPDATE and add | X | | Freshens old files and adds new files. --------------------------------------------------------------------- CREATE new file | X | | Creates a totally new library file. In this table, PACKER and Un-PACKER refer to the programs you have defined earlier. For example the default ZIP packer is PKZIP. For information about programming these SUFFIX types please refer to the example below. _______________________________________________________________________ As the author, I think the best method to describe the programming of the file compression interface is by example. What follows is intended to do just that. The text is narrated as if I were performing the process myself. E X A M P L E Suppose my objective is to switch my ARC utilities from the default programs (PKWARE) to the System Enhancement Associates (SEA) (tm) ARC (tm) compression utility programs version 6.00. Here is how it would be done; I would read the .DOC file for the SEA programs to get the commands needed and note the general format that they are placed on the command line. After some reading, I notice that the SEA program ARC.EXE will execute all of the needed commands and that it uses the same general format as the PKWARE command line. I also note that the SEA extract program ARCE.COM is completely incompatible as far as the command format goes. Well obviously I must use the SEA ARC.EXE program for both my packer and unpacker. I then go into SET-UP mode and set both my ARC compression AND my ARC extraction program to the drive:path and filename of ARC.EXE. A3 Now that I have the program names setup, I must change to the SEA command set. I cursor down to the next line on the screen and look at the EXTENSION key. It is already set to ARC and since I am still going to be working with ARC files, I'll leave it alone and get on to the heavy stuff. I cursor down to the extract files command and type in the new command needed to extract files with. I recall that an upper-case X will do the job... That was easy, I do all the remaining commands the same way until I reach the SUFFIX types. What the H*** is this about I ask? Well it seems that the people who write these file compression systems all have their own ideas about how to send path names. Noting the help window on the screen I can see that StS supports three types of path passing strings. There are also four commands that the file utility programs use that need one of these suffix strings added to it in order to work properly. The EXTRACT, FRESHEN, UPDATE and CREATE commands all need the strings. The FRESHEN and UPDATE commands have exactly the same form in use so I have combined them into a single category. What I need to do here is enter three numbers which will tell StS what suffix to attach to each command. The first number represents what the EXTRACT command uses, the second number represents what the FRESHEN/UPDATE command uses and the third number represents what the CREATE command uses. From the ARC.EXE documentation I know that ARC.EXE requires the type 1 suffix string for all three commands, so my three number sequence will be 111. ____________________________________________________________________ SETUP for SEA(tm) ARC utility program: ARC Packer ......... ARC.EXE ARC un-packer ...... ARC.EXE EXTENSION trigger .. ARC EXTRACT files ...... X TYPE text files .... P DELETE files ....... D LIST files ......... L TEST integrity ..... T FRESHEN no add ..... F UPDATE and add ..... U CREATE new file .... A SUFFIX types ....... 111 ____________________________________________________________________ NOTES: ------------- This program has been tested with the above setup using the SEA ARC.EXE program and functions satisfactorily. The ability to "port" any other file compression utility other than the PKWARE series and ARC.EXE (version 6.00) is not guaranteed. ------------- The ability to edit the command strings used by the file compression programs also allows the user to "tune" the new ZIP program compression options. Although the defaults are quite good, I will leave the tinkering to you and your PK DOC file. We at M.R.E welcome your comments and suggestions about such "tuning" in our registered user conference on the BBS. Enjoy! -------------- Register your file compression utilities with their authors! Without them, where would we all be? B1 APPENDIX B LICENSE / WARRANTY _____________________________________________________________________ >> Sec. B.1 LICENSE _____________________________________________________________________ StS ver. 3.20 is being distributed under the "shareware" or user supported concept. This software is NOT free software. The use or reproduction of this software outside of the limits specified in this license agreement is prohibited. Non-registered users are granted a limited license to use this software for a period not to exceed thirty days. During this period they should test and evaluate the software to determine if it will meet their needs. The use of this program beyond this limited time period requires registration. Non-registered users are not allowed to distribute this software without the express written permission of Microsystems Research & Engineering. The only exceptions to this distribution restriction are SYSOPS of electronic bulletin boards and distributors of public domain and user supported software. SYSOPS and software distributors must abide by the copying restrictions specified below. Registered users are granted the right to use StS on only one computer at any time. Site licensing agreements are available for businesses, corporations, and government agencies. Registered users are also granted the right to copy and distribute StS subject to the following conditions. StS must be copied in its original unmodified form. All of the files must be included in the copy. No fee or charge may be requested or paid to any licensee by the recipient of the copy. StS may not be distributed in conjunction with any other product without the express written consent of MRE Software. B2 >> Sec. B.2 WARRANTY _____________________________________________________________________ Microsystems Research and Engineering makes no warranty of any kind, express or implied, including without limitation, any warranties of merchantability and or fitness for a particular purpose. Microsystems Research and Engineering shall not be liable for any damages, whether direct, indirect, special or consequential arising from a failure of this program to operate in the manner desired by the user. Microsystems Research and Engineering shall not be liable for any damage to data or property which may be caused directly or indirectly by use of the program. IN NO EVENT WILL Microsystems Research and Engineering BE LIABLE TO YOU FOR ANY DAMAGES, INCLUDING ANY LOST PROFITS, LOST SAVINGS OR OTHER INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF YOUR USE OR INABILITY TO USE THE PROGRAM, OR FOR ANY CLAIM BY ANY OTHER PARTY. >> Sec. B.3 TRADEMARKS _____________________________________________________________________ IBM, IBM PC-XT-AT-PCjr-PS/2 and PC-DOS are registered trademarks of International Business Machines Corporation. Microsoft, MS-DOS, MASM, and Microsoft Macro Assembler are registered trademarks of Microsoft Inc. LIST.COM was written by and (C.) Copyright Vern Buerg ProComm is a registered trademark of Datastorm Technologies Inc. PC-BOARD is a registered trademark of Clark Development Co. SEA, ARC, ARCE (tm) System Enhancements Associates PKZIP, PKUNZIP, PKWARE, (tm) PKWARE inc. Other tradenames are referenced where they occur. SPECIAL NOTE TO USERS WHO PURCHASED THIS PROGRAM VIA ONE OF OUR ADS. You ARE a registered user! Section C of the .DOC file has been included in the interest of completeness. It details all of the benefits you are entitled to as a registered user and also provides an order form so that you may order more copies. - you may discard this page - C1 APPENDIX C REGISTRATION _____________________________________________________________________ Sec. C.1 WHY SHOULD I REGISTER ? _____________________________________________________________________ StS is distributed under the shareware concept. Shareware is a unique marketing concept born of the computer revolution. Users are allowed to obtain complete working programs to freely test and evaluate for a limited time period. If they find the programs useful then they are required to register their copy of the program. The small registration fee goes to support the authors and encourage them to continue to improve the software. Shareware depends on honesty. The computer programs are freely distributed as finished products. The authors of this type of program depend completely on the honesty of end users for compensation for their work. If you use a shareware program, any shareware program, please be honest and register your copy. Shareware is not free software. It requires just as much work and effort to produce as the highly advertised commercial products, but it usually sells for a small fraction of the price. Registering a shareware program also gives you the unique opportunity to do something that is virtually impossible with most commercial software. When you register, your comments and ideas are usually communicated directly to the author of the program and the response you will receive is from him/her. This fact assures you that your ideas are heard by someone who is paying attention. It is also from this pool of suggestions and ideas that future improvements improvements are spawned. Shareware companies in general don't spend millions of dollars doing "market research" or advertising the heck out of their products in order to sell you something that you have only read about. We lay it out there on the line....here it is....fully functional....you like it, please buy it, you don't .... erase it. We also don't charge you $400.00 for our products. Don't take this the wrong way however, commercial software is a necessity. God knows that this program would not exist if it weren't for MS-DOS and MASM. (which are quality, reasonably priced, and supported). Shareware that is of high quality at low prices does tend to keep all software prices lower and is therefor a necessity in its own right. When you support shareware you not only receive the right to use a good program (usually with free updates) but you also make a statement to the entire software industry. Make the free world economy work! Register shareware. C2 >> Sec. C.2 REGISTRATION FEES _____________________________________________________________________ The registration fee for StS version 3.20 is only $25.00. This small registration fee entitles the user to use any shareware version of StS for life. It also entitles the user to one year's access to the M.R.E. Software support BBS and one year's free updates to the registered version of StS which is downloadable from the BBS. Registered users are also entitled to update their registered versions at any time after the first year for the yearly subscription fee that is currently set at $10.00. The $10.00 subscription fee goes to cover our cost of maintaining names and passwords on the BBS and will always be kept at the lowest feasible rate. This update fee is not based on a year to year subscription rate like a magazine, the user can update anytime, even skipping months or years, without any additional cost incurred. The year of access to the BBS will start on the date we receive the update payment. All registered users, including those who just pay the initial registration fee, will be notified of all major updates and changes to StS for a minimum period of five years. M.R.E. Software will also ship disk copies of StS to users based on the following pricing arrangement. ---------------------------------------------------------------------- StS shareware version (no registration) .................... $5.00 StS shareware version (no registration) on 3.5 inch media .. $7.00 StS registered version & first time registration ........... $30.00 StS registered version & first time registration (3.5 disk)..$32.00 StS registered version update. (for 1 year from reg) ....... $5.00 StS registered version update. (for 1 year from reg) (3.5).. $7.00 StS registered version and 1 year subscription update ...... $15.00 StS registered version and 1 year subscription update (3.5). $17.00 StS registered user BBS support & download privileges only. $10.00/yr after the first year which is included with registration. The basic charge amounts to $5.00 for the diskette and shipping plus any registration or update fees. 3.5 inch floppies are also available for an additional $2.00 per disk. Please specify 3.5 inch diskettes when you order. ---------------------------------------------------------------------- C3 Sec. C.3 SITE LICENSE/QUANTITY DISCOUNT _____________________________________________________________________ Quantity discounts are available for $20.00 per copy to qualified businesses, corporations, individuals, and government agencies. This represents a $5.00 per copy or 20% savings. A minimum of five copies must be registered to qualify. Site licensed organizations will receive a 5.25 inch diskette which contains a current registered version of StS. Holders of site licensed copies share all the same privileges as single copy holders concerning access to free updates for one year and the minimal fee of $10.00 per year to update. Even if your organization holds 1000 copies of StS they can be updated by simply downloading, or requesting shipment of the latest registered version of the program for just $10.00 for each year's worth of updates. Businesses may of course register less than five copies at the individual copy price. (OPTIONAL) Upon request, M.R.E. Software will ship the 5 or more registered copies of StS on individual 5.25 inch floppy disk for $2.50 per copy provided they are all shipped to one location. This represents a total cost of $27.50 per copy for five or more copies shipped on disk. 3.5 inch diskettes are also available for 4.50 per copy. Please specify when you order. >> Sec C.4 THE M.R.E SUPPORT BBS _____________________________________________________________________ M.R.E. Software provides a support bulletin board system for distributing the latest versions of StS, on-line registration, and processing user questions and suggestions. We are running the latest version of PC-BOARD and StS author Emery Wooten is the sysop. Non-Registered users: Will be given limited access to the BBS. We are currently running an "open" system and no delay is imposed requiring you to make two calls to gain access. Non registered users will be provided with access to the main message base, the MRE file area, and the on-line registration procedure. You will be able to download the latest shareware version of StS, E88, and other selected files. Questions and suggestions from non-registered users will be processed as time permits. Registered users: Will be given complete access to the BBS with full time allocation for a period of one year. Registration will entitle the user to join the StS conference area. The StS conference provides a forum for discussion and presentation of comments, ideas, problems, and suggestions related to the StS program. This conference also has a separate file area where the latest REGISTERED version of StS can always be found. Registered users are always given priority support and consideration relating to their C4 questions and suggestions. Additional access to the StS conference can be obtained at anytime for the nominal update fee of $10.00 per year. Please see section C.2 of this .DOC file for more information related to user registration privileges. 300 to 9600-V BPS N-8-1 Running HAYES 9600 ULTRA V.32 Telephone: (601) 494-8078 24 hours/day 7 days/week You are invited! >> Sec C.5 REGISTRATION FORM _____________________________________________________________________ This section contains the StS registration form. It is meant to provide users with a convenient means to register. Please type or print clearly. THANK YOU FOR YOUR SUPPORT! D4 StS REGISTRATION FORM ver. S3.20 YES! I would like to register my copy of StS. I have read the information contained in appendix B and C as well as tested the software and would like to support the efforts of MRE software. Name .............:__________________________________________________ Street Address ...:__________________________________________________ City .............:__________________________________________________ State ............:__________________________________________________ Zip Code .........:__________________________________________________ Place an X by those that apply. __ I am enclosing $25.00 per copy for 1 to 4 copy(s) registration. __ Please ship my copy(s) on disk. __5.25in. ($5.00) __3.5in ($7.00) * Add $5.00/copy for 5.25in. disk or $7.00/copy for 3.5in. disk * Supplied on diskette(s) for $30(2).00/copy for 1 to 4 copies. * Mississippi residents must add 6% sales tax. * International users please send a money order in U.S. dollars __ Requesting site license for _______ copies at $20.00 per copy. __ Please ship my copy(s) on disk. __5.25in. ($2.50) __3.5in ($4.50) * A minimum of 5 copies is required to qualify for site license. * Add $2.50/copy for 5.25in. disk or $4.50/copy for 3.5in. disk * Supplied on diskettes for $22(4).50 per copy for 5 or more. * Mississippi residents must add 6% sales tax. * International users please send a money order in U.S. dollars Enclosed : - Check - Money Order - Company PO. __ I prefer to purchase using my VISA/MasterCard. __ VISA __ MasterCard Card #: ______ ______ ______ ______ Expires date: / Card issuing bank name: _________________________________________ your signature _______________________________tel.(___)____-_____ * You MUST sign this form if using a credit card. =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-= *** The following info is optional. Answer only those you wish.*** Company/Title ..............: _______________________________________ Where did you obtain StS? : _______________________________________ >>>>>> Send to: M.R.E. Software 150 Jones St. West Point, Ms. 39773 Please feel free to write your comments and suggestions about StS on the back of this form. We welcome user input!