robertj@tekgen.bv.tek.com (Robert Jaquiss) (05/13/91)
Index Number: 15534 PC Tools and Speech by Mitchell Lynn PC Tools Deluxe (from Central Point Software) is an extremely powerful collection of hard disk utilities and personal management tools. Unfortunately, like most MS-DOS software, these programs do not come up talking right out of the box. It is up to you and your screen reader to add speech to PC Tools. This article will help you get PC Tools up and talking. Along the way, I will show you some tricks that will make the PC Tools programs work more effectively with your speech software. What is PC Tools? PC Tools is an indispensable collection of utility programs. The programs in PC Tools can be divided into four groups: hard disk backup and restore, desktop manager, disk utilities, and a DOS shell. PC Backup is a fast and flexible substitute for the DOS backup. The backup program allows you to set various options and save these selections to a configuration file. PC Backup provides a compression capability that reduces the number of required disks by about thirty percent. You also have the option of setting error correction, subdirectory inclusion exclusion, file inclusion and exclusion criteria, date range selection criteria, and formatting options. The desktop manager contains programs designed to increase productivity. These include a macro editor, a word processor, a data base, several calculators, and an ASCII table. Perhaps the most powerful feature of the Desktop is the resident clipboard which allows you to cut information from one DOS application to a second DOS application. The disk utilities include programs to unfragment files, recover deleted files and repair damaged disks both hard and floppy. Finally, PC Shell is a program that sits on top of the DOS environment and simplifies the user's interaction with DOS and other applications. With PC Shell, you will still have access to all the usual DOS commands. In addition, PC Shell provides many capabilities for which DOS makes no provision. For example, with PC Shell you can locate specific files and then view those files in their native format. That is if the file is a WordPerfect file, it will be displayed in WordPerfect's format. PC Shell also allows you to launch the program that created a particular file. When you launch an application, you have the option to have the selected file automatically loaded when the application is run. Other enhancements include the ability to copy, rename, delete, and move files either singularly or in groups. Installing PC Tools To install PC Tools, make whatever drive contains your distribution disk the default drive. If you are using 5.25 inch disks, this probably will be drive A:. If you are using 3.5 inch disks, this probably will be drive B:. To change the default drive, at the DOS prompt, type [drive:] where drive: is the letter of the drive you wish to make the default. Now that you have logged onto the appropriate drive, you are ready to start installing PC Tools. Begin the installation by typing "pcsetup." PC SETUP automatically decompresses the PC Tools package and steps you through the process of installation. For the most part, the setup does not use DOS screen service, so you must keep up with prompts by reading the screen. You will have the option of installing all or just some of the PC Tools programs. The setup program also provides you with the option of installing several programs in your autoexec.bat file. The setup program will prompt you to press "i" to install or "c" to continue without installing at each program. For the memory conservationists among you, PC Shell requires less than 10k when running in "resident mode." However, if you choose to run PC Shell in "shell mode," you are looking at 210 k of RAM. Note: regardless of what programs you choose to install, the original copy of your autoexec.bat file remains unchanged. It will be saved as autoexec.sav. Important The setup program allows you to set passwords and "user levels" for both PC Shell and PC Backup. To accept the defaults (no passwords and advanced user level) press enter at the prompts. It is important that you accept the "advanced option" for the user level. The following discussions may not work as detailed if you accept anything other than the advanced user level. The reason is that the advanced user level makes available options that are not available in the beginner and intermediate levels. Getting Started PC Tools is a collection of programs, and the secrete to getting the package to talk is to treat each program as a separate entity. PC Tools presents the same "user interface" throughout all the programs. In other words, the on screen look and feel of the programs is consistent. So, our job of making the programs talk is largely one of modification. We will modify our first speech environment to fit the other programs in the PC Tools package. Let's get started. First, if you have not already done so, examine the autoexec.bat file in a text editor. It is imperative that you load your speech software before any of the PC Tools programs. If you make changes, be sure to save the file as an ASCII text file. Second, when you have finished examining (and when necessary modifying) the autoexec file, reboot the computer. This will force any changes to your autoexec.bat file to take effect. At the DOS prompt load PC Shell. If you allowed the setup program to install PC Shell in your autoexec.bat file, you can hot key into PC Shell by pressing [ctrl -escape]. If you did not install PC Shell "RAM resident," type "pcshell" at the DOS prompt. For those diehard DOS command-line commandos who have no use for a DOS shell, read on anyway. Much of what you learn here will be applicable to Diskfix, Compress, Desktop, PC Secure and PC Backup. Now that you have loaded PC Shell, enter your screen reader's review mode and examine the PC Shell main screen. When you run PC Shell for the first time, the screen will appear exceedingly busy. Yet, at least some of that screen should look familiar. The main screen can be divided into roughly three parts. The top line contains a group of menu headings and the current system time. This line reads "files, disk, options, applications, special, and help." This "horizontal menu bar" is present in all PC Tools programs. Immediately below the horizontal menu bar PC Shell displays the current drive and the user level. PC Shell shows the active drive by highlighting the appropriate letter. The middle of the screen consists of three windows. You should see a file list, a tree list, and a view window. We will talk more about these windows shortly. Finally, the bottom line of the screen serves as the PC Shell status line, or "message bar." Usually, this line contains a group of function keys. The key to getting PC Shell to talk is to reduce the on screen clutter. Each of the aforementioned windows can be toggled off and on singly or as a group. . In this case, we want to toggle all three windows off simultaneously. First, open the options menu by pressing [alt -o]. Immediately follow the [alt -o] with a press of [w]. This will remove all windows from the screen. If you look at the screen now, you should see only the horizontal menu bar and the function key commands on line 25. The Background Mat Normally, PC Shell allows you to see part of the underlying application's screen when you remove one or more of PC Shell's windows. Unfortunately, this has the annoying habit of getting in the way of our screen access software. PC Shell does allow you to turn on a background mat that effectively masks the output of the underlying application. You can toggle the background mat with the following sequence. The escapes at the end return you to the main screen: they exit you from all menus. To toggle the background mat, press [alt -o], [c], [b] [escape], [escape]. The background mat, when on, will hide the information remaining from the underlying application or DOS screen. Now that we have removed the various windows from the display, take a second look at the screen. You can bring back each element of the PC Shell screen by first pressing [alt -o] followed by either [f] for the file list, [t] for the tree list, or [v] for the view window. The file list shows the files in the current directory. This should be the root directory of your boot-up drive. The tree list shows all the directories on the current drive. Both the file list and the tree list will scroll if the lists are too large to fit in the window. Finally, the view window displays a portion of the currently selected file. "Selected" is PC Tools' nomenclature for the highlighted (or marked) files. If there is more than one selected file, the files will be highlighted and numbered. Now that we have explored the components of the PC Shell main screen, let's begin designing our speech environment. First, define a window that reads only the bottom line (line 25) of the screen. Most of the time, this line displays function key shortcut commands. However, PC Shell frequently displays status information, messages, prompts and explanations on this line. This is true of all PC Tools programs. Until you are more familiar with PC Shell, you should closely monitor this window. If your screen reader has a hyperactive capability, I highly recommend that you use it with this window. For those of you who use Vocal-Eyes, you can use the accompanying set file. Window 5: reads the status line. I have defined [ctrl -s] in the hot key menu to read this window. Before we can use PC Shell to manipulate files and directories, we must define windows that encompass both the file list and the tree list. First, make sure that the file list is visible. If you do not see files on screen, open the options menu with [alt -o] and press [f] to toggle the file list back on. Use the following coordinates to define a window that encompasses the file list. The coordinates for the file list window are: left column 30, top line 4, right column 80, and bottom line 24. When you read this window, you should see only a list of files for the current directory. To set up the tree list, follow the steps enumerated above. Use the [alt -o] [t] to toggle the tree list. The coordinates for the tree list are: left column 1, top line 4, right column 17, and bottom line 24. In the accompanying Vocal-Eyes set file, window 8 reads the file list, and window 9 reads the directory list. The next step is to set up the speech so that you can track your movements in the file list and the tree list. While PC Shell allows multiple lists on screen, only one list can be active at any given time. The easiest way to determine which list is active is by turning off the list you are not currently working in. Succinctly put, if you want to manipulate files, you turn off the tree list. Similarly, if you are working with directories, you turn off the file list. Whether you choose to have the view window on screen is purely a matter of preference. You can access this window by pressing [alt -o] [v]. PC Shell indicates your position in the active window with a light bar (sometimes called a highlight bar or cursor bar). To ensure that your screen access software is tracking properly, first turn off the tree list--if it is not already off. Now press [home]. This will move the highlight bar to the top of the file list. The first file in the list is now highlighted. If you are using a color monitor, the light bar will be bright white on blinking red. For those using a monochrome monitor, the attribute is black on white. To set bar tracking up for the tree list, follow the same steps above. Be sure to remove the file list and switch to your tree list window. Thus far, we have defined separate windows for both the file list and the tree list. We can simplify things considerably by defining a window that encompasses both lists. Now, we need only swap active lists. For example, I have defined window 0 as a full screen window, and it is my default start up window. I have also set bar tracking up for the appropriate attribute (bright white on blinking red). Whenever I want to work on files, I swap the tree list for the file list. Similarly, if I want to work with directories, I swap the file list for the tree list. This eliminates the need to switch windows within Vocal-Eyes. It also gives me the ability to read the entire screen if the need should arise. Before we continue, save the speech configuration to disk. You also should save any changes that you may have made in PC Shell to a configuration file. In fact, anytime you have made changes in PC Shell and attempt to exit, PC Shell will prompt you to save the changes to PCSHELL.CFG. This message appears on line 25. To save any changes you have made, open the options menu [alt -o] and press [a] to save. Note: not all of the hot key assignments under the pull down menus are pneumonic. PC Shell and the DOS Command-Line PC Shell allows you to turn on a DOS command-line from which you can run, or use, any standard DOS command. You also can run any stand alone program from within PC Shell when this command-line is active. To turn the DOS command-line on, open the options menu [alt -o] and press [c] change operating arguments, and press [c] command-line on/off. To exit the menus, press [escape] twice. When the DOS command-line is active, the current path appears on line 24. Vocal-Eyes users can read this window with [ctrl -p]. This window will contain nothing when the command-line is not active. The Final Touches Thus far, we have covered the essentials of the PC Shell screen. There are, however, a few fine points still to be discussed. The remaining windows to be defined are specialty windows; they are not essential. The first of the two remaining windows is what I call my view window. This window allows you to examine files when using the [f -2] quick view in PC Shell. The view window (window 7 in the Vocal-Eyes set file) has the following coordinates: left column 1, top line 3, right column 80, and bottom line 24. Control V will read this screen in the Vocal-Eyes set file. The last window is designed to track the topics in the help menu. Start by setting the window to read the entire screen except the top and bottom lines. Now remove any lists you may have on screen. Finally, press [f -1] to call up the contact sensitive help. You must now set up light bar tracking. The highlight bar is at the top of the list. The selected topic is "help on help." On a color monitor, this light bar has the attribute of cyan on black. On a monochrome monitor, the attribute is white on black. When you are ready to exit the help, press [escape] or [f -3]. Finally, PC Shell typically displays status information, prompts, and error messages in two places. The first is in the message bar on line 25. The second place does not lend itself to static definition. The information changes in volume, and it usually appears along with, more frequently among, other information. Consequently, setting a window is not useful. However, this information always appears in the same attribute. Vocal-Eyes users can take advantage of the "user attribute" hot key. In the accompanying set file, this is [alt -u]. For those using color monitors, the attribute is the ubiquitous cyan on black. On a monochrome monitor, the attribute is black on white. You can get a good idea of what these pop-up messages look like by pressing [f -7] (locate) from the main PC Shell screen. Now enter review mode and track down the lines that says "file locate." In all likelihood, you also will see a group of applications that looks suspiciously like the programs on your hard disk. This list has the target attribute. If your screen reader has the ability to track a user defined attribute, use it here. You will find that it is indispensable in many of the PC Tools programs. You now have the foundation to make many of the PC Tools programs talk. Remember that much of what we established in PC Shell is applicable to Compress, Diskfix, Desktop, PC Backup and PC Secure. Each of these programs retains the same basic user interface. The top line of each of these programs is the same horizontal menu bar as in the shell. The choices listed will be different, but you access the items listed in exactly the same way. Compress, Diskfix, PC Secure, Desktop, and PC Backup all employ the status line to display prompts, messages and menu selection explanations. Finally, remember that [f -1] (help), [f -3] (exit), and [f -10] (menu) are the same in all PC Tools programs. A Few Advanced Options The following tips and tricks are for the more daring among you. If you are not familiar with PC Tools and PC Shell, I do not recommend changing function key assignments. If you have used the shell for any length of time, you are probably wondering if there is an easier way to toggle the file and tree lists on and off. Well! There is. Before we start changing function key assignments, we must define another window. The coordinates for this window are: left column 45, top line 2, right column 65, and bottom line 24. Light bar tracking is again necessary, and the attribute is the omnipresent cyan on black. To change the function key assignments and to set bar tracking follow these steps. First, consider carefully which keys you want to redefine. I suggest [f -5] and [f -6]. Since you will want one of these keys to toggle the file list and the other to toggle the tree list, you will want them close together. This will make it easier to tag them both at the same time. Second, turn all PC Shell windows off. The less that is on screen the better. Third, open the option menu by pressing [alt -o] and press [c] to select "change operating arguments." Finally, press [f] to select "change function key assignments." At this point, you must set bar tracking for the proper color. The highlight bar is resting on "copy file." Once you have set bar tracking, you are ready to begin. PC Shell is currently prompting you to supply the function key to be reassigned. Press that key now. You cannot change [f -1], [f -3] nor [f -10]. When you have selected the key to be changed, use the up and down arrow keys to scroll through the list of available functions. The "file list window" and "tree list window" selections are nearer the bottom of the list. Therefore, it is easier to press the [end] key and use the up arrow from the bottom of the list. When you have highlighted "file list window," press [enter]. PC Shell now prompts you to enter another key to be redefined; press that key now. Again, move the highlight bar to the new assignment. This time, we want "tree list window." The highlight bar will remain where you made your first selection, so just press the up arrow once. When you have made both selections, press [u] to update. Be sure that you monitor line 25 throughout this process. If you make a mistake in the reassignment, you can reset the function keys to their default by selecting [r] for reset. Finally, do not forget to save the configuration changes with the [alt -o] [a] save command. Before you save the configuration, try out the new function key assignments. Remember that we toggled both lists off before we actually redefined the function keys. You probably will want one of these on screen whenever you start PC Shell. PC Tools is a complex and powerful package, and I am constantly finding new ways to make speech work more effectively with the programs. If you have any questions, or are having difficulties making the programs talk, fell free to contact me at (913) 271- 5369. Sorry, I cannot take collect calls, nor can I provide technical support for the PC Tools programs themselves. PC SHELL SHORTCUT COMMANDS File Oriented Functions The files in this list act against a file or a group of selected files. You can access commands in the files menu by typing [F] if the shortcut keys are on or by typing [alt -F] if the shortcut keys are off. Attribute Change [B] Clear File [A] Copy Files [C] Compare File [O] Delete File [D] Edit File [E] Exit [X] Hex Edit File [F] Launch Application [H] [ctrl enter] Locate Files [L] More File Info [I] Move Files [M] Print Files [P] Print File List [T] Quick View [Q] Rename Files [R] Search Text [S] Undelete Files [U] Verify Files [V] Disk Oriented Functions The commands in the following list act against disks--either hard or floppy. Commands in the disk menu can be accessed by typing [D] if the shortcut keys are on or by typing [alt -D] if the shortcut keys are off. Change Drive [D] Compare Disk [O] Copy Disk [C] Directory Maint [M] Directory Maint Sub Menu Add a Sub [A] Delete a Sub [D] Modify Attribute [M] Prune and Graft [P] Rename a Sub [R] Disk Info [I] Format Data [F] Format System Disk [Y] Park Disk [P] Rename Volume [R] Search Disk [S] Verify Disk [V] View Edit Disk [E] Options Menu The options menu is used to modify PCSHELL setup configurations. These options can be saved to a "config" file, so that they are the default the next time you run the program. The options menu is accessed by typing [O] if the shortcut keys are active or by typing [alt -O] if the shortcut keys are off. File List [F] Modify Display [O] Re-Read Tree [D] Save Config [A] Setup Config [C] Show Windows [W] Size or Move Window [S] Tree List [T] View Window [V] Zoom Current Window [Z] Special Menu For the most part, commands under this menu provide information about the system. The exceptions here are "directory sort" and "undelete file." The commands in the special menu are accessed by typing [S] if the shortcut keys are active or by typing [alt -s] if the shortcut keys are off. System Info [S] LapLink /QC off [L] Undelete Files [U] Directory Sort [D] File Map [F] Disk Map [M] Memory Map [E] Remove PC Shell [R] If you are using Vocal-Eyes, you can find a set file and the documentation for that configuration in the directory VOCALEYES in the SOFTWARE section of the magazine.