PC-Test Pro

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

/ PC-Test Pro / PCTESTPRO.iso / disktool / deadwood / entp / manual.doc < prev next >

Wrap

Text File | 1994-03-13 | 48.3 KB | 1,101 lines

DeadWood v1.00 "If it's dead, let's bury it!" Christopher B. Eckles P.O. Box 225 Waleska, GA 30183-0225 USA 404-479-2888 Compuserve 76635,1012 This program is SHAREWARE, and is not free. LEGAL STUFF: Copyright 1994 by Christopher B. Eckles, all rights reserved. No part of this document may be reproduced, transmitted, transcribed, stored in a retrieval system, or translated into any other language or computer language in whole or in part, in any form or by any means, whether it be electronic, mechanical, magnetic, optical, manual or otherwise, without prior written consent of Christopher B. Eckles. Permission is granted to distribute the shareware files, unaltered and unchanged, as allowed in the accompanying files LICENSE.DOC and SYSOP.TXT. Full terms for your license to use DeadWood, along with disclaimers and other terms, are spelled out in the file LICENSE.DOC. If there is a conflict with any other document or agreement, the terms contained in LICENSE.DOC shall have precedence unless explicitly stated in writing. If you do not have a copy of this file, or cannot read or understand it, please contact Christopher B. Eckles at the address listed on the cover page above. The following is an extract of a key section of the license document: ***************************************************************** Users of DeadWood must accept this disclaimer of warranty: "DeadWood is supplied as is. The author disclaims all warranties, expressed or implied, including, without limitation, the warranties of merchantability and of fitness for any purpose. The author assumes no liability for damages, direct or consequential, which may result from the use of DeadWood." ***************************************************************** Users are STRONGLY encouraged to read the entire manual before running any of the DeadWood programs. In particular, there are certain activities that could have unpredictable results - up to and including file loss and/or damage. BE SURE TO READ AND UNDERSTAND THE "CAUTIONS" SECTION. DeadWood has been well tested in many (not all) circumstances, and has proven to be safe when used as directed. Windows and Visual BASIC are registered trademarks of Microsoft Corporation. 2 REASONS TO REGISTER: - You get the most recent version: less bugs and more features! - You get a printed manual, with an index, to refer to. - You get a database repair utility that may allow you to salvage your history of file use if your history file is corrupted (not uncommon). - I'll notify you of future version releases, which will be offered at a reduced price to registered users. - You won't feel guilty if you need to call for technical assistance. - The registered version doesn't keep suggesting that you register the program! - It's the right thing to do, if you use the program. Details on how to register this software are contained in the file ORDER.DOC. If you do not have this file, or cannot read it, please contact Christopher B. Eckles at the address listed on the cover page above. 3 TABLE OF CONTENTS: LEGAL STUFF. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2 REASONS TO REGISTER. . . . . . . . . . . . . . . . . . . . . . . . . . . .3 TABLE OF CONTENTS. . . . . . . . . . . . . . . . . . . . . . . . . . . . .4 GENERAL. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5 INSTALLATION . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6 WINDOWS NOTES . . . . . . . . . . . . . . . . . . . . . . . . . . . .7 GENERAL USE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .8 CAUTIONS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10 HOW DEADWOOD WORKS . . . . . . . . . . . . . . . . . . . . . . . . . . . 12 THE DEADWOOD FILE INTERFACE SCREEN . . . . . . . . . . . . . . . . . . . 15 MOVING THROUGH DISKS AND DIRECTORIES . . . . . . . . . . . . . . . . . . 16 MENU CHOICES . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17 MENU (FILE) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18 MENU (SELECT FILES) . . . . . . . . . . . . . . . . . . . . . . . . 20 MENU (DISPLAY). . . . . . . . . . . . . . . . . . . . . . . . . . . 21 NOTES ON DELETING FILES. . . . . . . . . . . . . . . . . . . . . . . . . 23 INCOMPATIBLE PROGRAMS. . . . . . . . . . . . . . . . . . . . . . . . . . 25 KNOWN PROBLEMS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26 TROUBLESHOOTING. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29 TECHNICAL ASSISTANCE . . . . . . . . . . . . . . . . . . . . . . . . . . 29 INDEX. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30 4 GENERAL: DeadWood is a file management utility that lets you find files that are not being used. There are two parts: a file management program and a pair of small (19k total), well-behaved TSR's that track file usage under both DOS and Windows. The DeadWood TSR's and the creation/updating of the file use history have the potential to create very large files. In most cases, these will total 250,000 bytes or so. If, however, your disk activity is high, you perform infrequent updates of the history file, and/or you monitor programs that access all of the files on your hard disk (like virus checkers), these files could grow to a total of 1 Megabyte or more. Please read the HOW DeadWood WORKS section for more information on disk file size. 5 INSTALLATION: All of the files should be placed in a single directory, such as \DEADWOOD. To create a new directory, enter the command MD \DEADWOOD at the DOS prompt and press ENTER. You can then go to that directory by changing directories: type CD \DEADWOOD and press ENTER. Copy the file DEADxxx.EXE (where xxx is the version number) into the \DEADWOOD directory. DEADxxx.EXE is a self-extracting file, and when run it expands into the many files needed to run DeadWood. Simply type DEADxxx in the \DEADWOOD directory and press ENTER. You may then delete the DEADxxx.EXE file, if you wish. All of the files should be kept in the same directory. There is no need to include the DeadWood directory in your path. Some people will want to put the DeadWood TSR's in their AUTOEXEC.BAT file. This is a good idea, generally, because it loads the DeadWood TSR's automatically whenever the computer is started. It can also be useful to include the TSR's early in the AUTOEXEC.BAT file once in a while - this allows you to monitor the files used during startup (such as your disk cache or other TSR's). Once a TSR is loaded, the original files on disk may not be accessed again. If the DeadWood TSR's are loaded afterwards, these earlier TSR's files may be listed incorrectly as Unused. If you put the TSR's early in your AUTOEXEC.BAT you will probably be loading other TSR's after the DeadWood TSR's. This may prevent you from being able to unload the DeadWood TSR's, because TSR's generally must be unloaded in reverse order. This would prevent you from being able to do certain functions (such as update the usage history) until you remove the DeadWood TSR's from your AUTOEXEC.BAT file and reboot the computer. In other words, loading the TSR's at the very start of AUTOEXEC.BAT is interesting to do on occasion, but not recommended for frequent use. 6 WINDOWS NOTES: An icon (DEADWOOD.ICO) and PIF (DEADWOOD.PIF) file are provided to assist users who wish to use DeadWood under Microsoft Windows. DeadWood functions well as a DOS application under Windows, though the TSR's must be loaded and unloaded outside of Windows. You can run Deadwood via the file manager, or you can create a program group which simplifies repeated running. To create a group, perform the following steps: Go to the Program Manager, and select FILE. Select NEW from the menu. Choose PROGRAM GROUP and choose OK. This brings up a window that allows you to enter the Program Group Description: enter DeadWood and choose OK. This creates an empty program group on the screen. Once again go to the Program Manager, and select FILE. Select NEW from the menu. Choose PROGRAM ITEM and choose OK. This brings up a window that asks you to input several items. For DESCRIPTION, enter DeadWood. For COMMAND LINE, enter C:\DEADWOOD\DEADWOOD.PIF. For WORKING DIRECTORY, enter C:\DEADWOOD. Choose OK. This creates a DeadWood item in the program group, with a standard MS-DOS icon. Again, go to the Program Manager, and select FILE. Select PROPERTIES from the menu. Choose CHANGE ICONS. An error may occur, indicating that there is no icon for DeadWood. Choose BROWSE, and select the DeadWood directory from the list of directories. Then select the DEADWOOD.ICO file from the file list. This changes the DeadWood icon to the tree icon, which is the proper one. 7 GENERAL USE: The DeadWood file management program may be used without the TSR's. Most people will run the TSR's for a while, then use the DeadWood file management program. This provides you with information on file usage, which is collected by the TSR's. To start the TSR's: at the DOS prompt in the DeadWood directory, type DLOAD and press ENTER. This runs a batch file that is the same as the following commands (the hard way): Type DEADTSR1 and press ENTER. Then type DEADTSR2 and press ENTER. Always run both TSR's together. Once the TSR's are running, use your computer as you normally would. You could also concentrate on just one application, and make extra-heavy use of it - change fonts, print, spell check, etc. The TSR's are watching what you do - do it all! Before running the DeadWood file manager, unload the TSR's. You may be able to run the file manager with the TSR's active, but you will be unable to update the history file with file information recently collected by the TSR's. To unload the TSR's: at the DOS prompt in the DeadWood directory, type DUNLOAD and press ENTER. This runs a batch file that is the same as the following commands (the hard way): Type DEADTSR2 /U and press ENTER. Then type DEADTSR1 /U and press ENTER. The TSR's may be loaded or unloaded in any order. After the TSR's have run a while, it can be interesting to look at the file DEADWOOD.DAT. This is a list of the files that have been accessed by your programs, in order. Also listed is the method of access (Usage Code). This list is deleted when the DeadWood database is updated. The Usage Codes are as follows: C - Create file (while TSR's were active) E - Execute file O - Open file for Read or Write F - Find file with given name or wildcards Start the DeadWood file manager by typing DEADWOOD and pressing ENTER at the DOS prompt in the DeadWood directory. The DEADWOOD.DAT file will continue to grow as you use the TSR's. It would be good practice to periodically unload the TSR's and update the DeadWood database, to keep this file to a reasonable 8 size. When you run the DeadWood program, you are prompted to perform an update if the DEADWOOD.DAT file exists (and the TSR's are not active). One way to clear all of the DeadWood history is to delete the data file(s). First unload the TSR's. Then, in the DeadWood directory, type DEL *.DAT and press ENTER. 9 CAUTIONS: 1) Never use disk repair/management utilities while the TSR's are loaded. This caution applies to defragmentation, file repair, and other utilities included in such programs as Norton's Disk Doctor, Optune, SCANDISK, and the like. 2) Some programs, such as virus checkers, will create a tremendous level of file activity, and list all of your files as used - for which there is no useful purpose to track. Listing every file on your disk could make the DEADHIST.DAT file grow very large (about 500k for every 100 MB of files on disk). 3) Never load or unload the TSR's while inside Windows. Unpredictable results may occur. Windows may tell you that the TSR's have been unloaded when the unload procedure has failed. 4) Never run DEADTSR1 without DEADTSR2. After a short period of time, DEADTSR1 will crash. This is caused by DEADTSR1 accumulating an ever-increasing list of files accessed, and never having this list cleared by DEADTSR2. DEADTSR2, when run, simply creates a custom interrupt which does nothing until called by DEADTSR1. The batch files (DLOAD and DUNLOAD) load and unload both of the TSR's together. 5) The maximum filename + path length allowed is 50 characters ("C:\dir\file.txt" = 15 long). Longer values will be truncated, and will be listed as Unused. 6) The filename capture TSR has a 100 character buffer. At any given time, up to 100 characters of file use information (approx. 4 file names) may have been recorded without being written to the disk file yet. To flush this buffer (as you may wish to do before turning the computer off) simply enter a DOS command consisting of random characters (such as "abcabcabc") and press ENTER. The system will search your PATH for this file, creating enough meaningless file entries to flush the buffer. 7) File and directory names cannot contain chr$(19) (!!). This symbol is used by the TSR's to delimit entries. Any such files/directories will be listed as Unused in DeadWood. It would be (ahem) rather difficult and unusual for this to occur, so normal people shouldn't worry. 10 8) MOST DOS- and Windows-based file access will be recorded by the TSR's. The following file operations will not be recorded by the TSR's: Rename Get/set file size, date, time Get/set file attributes Set/clear file access locks Print spooler interface (using PRINT.COM) Delete file Some file Creation (with unique file name, generally used for temp files) Direct disk access (sector reads/writes) 9) Be sure that you exit the DeadWood file manager before turning your computer off. The history data file may be damaged if the machine is turned off while the database engine is still working. 10) The DeadWood TSR's have been lightly tested while FASTOPEN was active, without apparent problems. Nonetheless, the author considers FASTOPEN to be extremely dangerous to all but the most organized minds (who may be able to lead normal lives given extended therapy), and use of FASTOPEN is discouraged. 11) The DeadWood TSR's may be loaded high (see your DOS manual). Unfortunately, the TSR's are unable to detect themselves when a copy is loaded high, and it becomes possible to have one set of TSR's loaded high and another set in normal memory. This situation could have unpredictable results. I'm not sure what would happen, since when the beta tester relayed this situation I was laughing too hard to think to ask. 11 HOW DEADWOOD WORKS: The DeadWood TSR's track file usage, and this information is used by the DeadWood file interface to mark files as used or unused. DEADTSR1 intercepts interrupt 21, and looks at all of the DOS calls that 1) involve disk use, and 2) send a file name. The file operations that are not tracked are listed in the CAUTIONS section. DEADTSR1 adds the filename (with drive and path) and DOS access code (C,E,O, or F) to its buffer. When this buffer becomes longer than 100 bytes, it starts trying to call DEADTSR2. If DEADTSR2 is called and performs successfully, then the buffer is cleared. DEADTSR2 is called by DEADTSR1 via interrupt 80. When called, it seeks the buffer value in DEADTSR1 and writes the values to the DEADWOOD.DAT file. This file is opened for APPEND when the TSR is started, and remains open until the TSR is removed. The data file is opened/created in the same directory that the DEADTSR2.EXE file is in. The DeadWood TSR's can create some rather large files, particularly if you don't use the DeadWood interface to update the history file very often (DEADWOOD.DAT is deleted after the history is updated). On the author's system, starting Windows, running one application, and exiting adds about 10k to the DEADWOOD.DAT file! Since this file is just a list of files that DOS tried to access, and each entry is only about 20 bytes, this means that over 500 files were referenced! The creation of large files could be a problem on some systems, since DeadWood is most useful to people with disk space problems. To minimize this, the TSR's have been designed to limit the opportunity to eat your remaining free space. The following checks are in place: When DEADTSR2 starts, it checks available space on the drive containing DEADTSR2.EXE. If this value is above 250,000 bytes, then no further action is taken unless a DISK FULL error is detected during a write in DEADTSR2. If a DISK FULL error occurs (starting with lots of free space), then recording of file use stops without notifying the user. If less than 250,000 bytes is free on startup, then available disk space is checked before every disk write by DEADTSR2. If this value falls below 25,000 then recording of file use stops without notifying the user. 12 If recording of file use stops because of limited disk space, then a window pops up when the DeadWood file interface is started. This window indicates that file tracking stopped because of limited disk space. When the DeadWood file interface is started, it searches for the DEADWOOD.DAT file in the same directory. If this file exists, it asks the user whether it should update the history file. The history file, DEADHIST.DAT, is the file that is used to determine if displayed files are used or unused. If the TSR's are active and the data file exists, then a window pops up explaining this and recommending that the user exits and unloads the TSR's before continuing: the opportunity to update the file history is not offered. If the user selects YES and updates the history file, the DEADWOOD.DAT file is processed. DeadWood goes through the list of filenames in DEADWOOD.DAT one line at a time, and if there are no internal blanks in the filename the program checks to see if the file exists. Because of this, your diskette drive may spin occasionally if you did any diskette access while the TSR's were active. Once a DRIVE DOOR OPEN error is detected (no diskette in your drive), the update routine will no longer look for files on that diskette drive. If the file exists, then the filename is added to the DEADHIST.DAT file (if it isn't already there) and the file access code is added/updated. If you access files on a diskette while the TSR's are active, and a diskette containing the same filename is loaded when the update process occurs, then the usage for that diskette (drive) will be recorded in the DEADHIST.DAT file. This usage information will be accessed if there is a diskette loaded and you use the file interface to examine the diskette. In this case the history would, for example, record filenames accessed in the root directory of the A drive. These filenames could over time have come from multiple diskettes. In practice, filenames from diskette accesses will rarely be recorded. The processing of the DEADWOOD.DAT file involves a lot of disk access, so don't be alarmed if your disk drive makes lots of noise (it shouldn't start smoking or screaming - that would be bad). At the end of the update procedure, the file DEADWOOD.DAT is deleted. The DEADHIST.DAT file is an ISAM file from Microsoft's Visual BASIC for DOS. This means that file access is fast, even for large files. It also means that a data file with just a few file accesses will create an initial file size of 65,000 bytes plus. This data file is intended for single user access, and cannot be accessed by multiple users on a network. 13 When the DeadWood file interface is run, a list of the currently existing files in the selected directory is obtained from DOS. Then the history file is searched, filename by filename, to see if there is a matching entry. If there is a match, the definition of "used" is checked, and the appropriate usage codes are appended to the file info on the screen. 14 THE DEADWOOD FILE INTERFACE SCREEN: The display screen is made up of several parts. Across the top is a list of menu items (File, Select Files, etc.). In the upper right corner is a button labeled "Mark Highlighted". Under this is a short bar for selecting the drive to display, and a small box containing directory information for selecting which directory is displayed. The currently selected directory is highlighted in this box, and is also printed above the list of files. Under the file list box are values for the total size of the files displayed, marked, and unused, as well as the total disk space free on the currently selected drive. At the bottom of the screen is a list of file access codes. These codes are used by the program to let you know what kind of access the "used" files have had. This list of codes and the 'number of bytes unused' are not displayed if there is no history file yet (i.e. if you have not yet run the TSR's and updated the history). Aside from the menus, you move from item to item by either clicking on the desired item with your mouse or by using the Tab key. Most of the time, the program focus will be in the file list. If you wish to move to the drive box you would move the cursor onto the box and click once, or use the Tab key until the box is highlighted. You may delete or move large numbers of files at a time. Do this by marking all of the files that you want to take action on. You mark files by first highlighting the file you want to mark. Then you either 1) press the spacebar, 2) press ENTER, 3) press Alt+m, 4) click on the 'Mark Highlighted' button with your mouse, or 5) double click on the file you want to mark. 15 MOVING THROUGH DISKS AND DIRECTORIES: The displayed file list is from the selected directory. Selecting other disks and directories does NOT change the current DOS directory or drive (in other words, exit the program and you will still be in the DeadWood directory). When you first start DeadWood, the file list displayed is from the current directory - usually \DEADWOOD. To change directories, first highlight the directory box by clicking on it, or by using Tab. If the directory you want to examine is displayed, simply double click on it or highlight it using the arrow keys (up/down) and press ENTER. Since only the subdirectories and parent directories are displayed, most of your directories won't be visible. Simply select the directory that is the parent of the one you want to display (often C:\). Then, the directory you want will be displayed as a subdirectory. Some parent directories, such as the root directory (C:\), will have lots of subdirectories, so you will have to scroll through the list until you find the one you want. For example, on my disk, DeadWood is a subdirectory of the root directory, and the directory box looks like this when I start DeadWood: C:\ DEADWOOD (highlighted) If I want to see the files in C:\WIN\SYSTEM, I first double click on C:\, then find WIN by pressing W, double click on WIN, then find the SYSTEM subdirectory and double click on it. The directory box entry then looks like this: C:\ WIN SYSTEM (highlighted) To change drives, the easiest way is with a mouse. Click on the down arrow to the right of the drive box. A list of all valid drives drops down, and you can use your mouse to click on the drive you want to examine. Without a mouse, use Tab to highlight the drive box. Then enter the single letter of the drive that you want to examine. For example, to change to the D: drive, Tab to the drive box (it will then be highlighted) then touch the d key. 16 MENU CHOICES: Use the Alt key or the mouse to activate the menu options. Most people will use Alt plus the highlighted letter to drop down the main menu lists. For example, Alt+f drops down the File menu. You can also click on the menu item (in this case File). You can also use the arrow direction keys and ENTER. The About DeadWood menu item displays a screen that tells a little bit about the DeadWood program. The Help menu item displays a few paragraphs of general information that you can scroll through. Once a menu has dropped down, use your mouse to click on the item that you want to execute. You can also use the up/down arrow direction keys, or use Alt plus the highlighted letter of the menu item (for example, Alt+d to delete the highlighted file). Some of the menu items have shortcut keys. These keys - actually keystroke combinations - allow you to directly execute the function without going through the process of opening the menu and selecting an action item. The shortcut keys are displayed on the menu, next to the menu item that they refer to. For example, the shortcut key for 'Delete Highlighted' is Ctrl+D. To quickly delete the highlighted file, simply hold down the Ctrl key and press d. This is exactly the same as selecting 'Delete Highlighted' from the File menu. 17 MENU (FILE): - Delete Highlighted (shortcut key Ctrl+D). This function deletes the highlighted file, regardless of whether there are marked files or not. There is an 'are you sure' prompt. - Delete All Marked (shortcut key Ctrl+A). This function deletes all marked files. A prompt is displayed asking you whether you want to delete the file, skip it, delete all marked without further prompt, or cancel the delete operation. You can use the delete option to step through all of the marked files, one at a time, deciding to delete or skip each one. Cancel stops further deletion, and does not undo the file deletions that have already been done. - Move Highlighted... (shortcut key Ctrl+M). This function moves the highlighted file to another disk or directory, regardless of whether there are marked files or not. When selected, a window pops up asking where you want the file moved to. This window contains both a drive bar and directory box, similar in function to those on the main screen. See the section titled MOVING THROUGH DISKS AND DIRECTORIES for instructions on selecting a (destination) drive and/or directory. There is an 'are you sure' prompt. - Move All Marked... (shortcut key Ctrl+O). This function moves all marked files to another disk or directory. When selected, a window pops up asking where you want the files moved to. This window contains both a drive bar and directory box, similar in function to those on the main screen. See the section titled MOVING THROUGH DISKS AND DIRECTORIES for instructions on selecting a (destination) drive and/or directory. A prompt is displayed asking you whether you want to move the file, skip it, move all marked without further prompt, or cancel the move operation. You can use the move option to step through all of the marked files, one at a time, deciding to move or skip each one. Cancel stops further moves, and does not undo the file moves that have already been done. Rename Highlighted... (shortcut key Ctrl+R). This function allows you to rename the currently highlighted file. It does not allow you to enter a path. This means that the rename is used only for renaming inside the currently displayed directory. - View Highlighted (shortcut key Ctrl+V). This function views the currently highlighted file, regardless of whether there are marked files or not. The view routine is useful in helping to decide the contents of a file, but because it is an ASCII viewer, 18 files such as your word processing or graphics file may not be easy to decipher... This function is most useful for files such as those having an extension of .BAT or .TXT. - Directory Maintenance >>. This function brings up another menu, when selected. Your two choices are to 'Add Directory...' or 'Remove Directory...'. Both choices will pop up the drive/directory selection box, similar in function to those on the main screen. See the section titled MOVING THROUGH DISKS AND DIRECTORIES for instructions on selecting a (destination) drive and/or directory. When adding a new directory, you are selecting the parent directory of the new one. You are then prompted for a unique directory name. There is an 'are you sure' prompt. When removing an existing directory, you are selecting the directory to be removed. There is an 'are you sure' prompt. The directory that you are deleting must be empty - no files still in it - to be deleted. Also, there can be no subdirectories. You may delete the currently active directory, in which case the parent directory is selected and displayed. - Delete History... This option allows you to delete (clear) the history file, which in essence starts you with all files being Unused again. It may be useful to do this occasionally, as your file use patterns may change, or one-time used files will be marked as used. This is also useful if you have made the mistake of using a virus checker while the TSR's were active, and all of your files are listed as used! This is the functional equivalent of deleting the file DEADHIST.DAT. - Exit (shortcut key Ctrl+F4). This function exits the program. The shortcut key, Ctrl+F4, exits without the 'are you sure' prompt. Mouse users could also click on the square in the upper left corner, and select Close from the menu that drops down. You can also double click on this square, which exits without further prompt. 19 MENU (SELECT FILES): - Mark Selected (shortcut key <F9>). This function allows you to mark large numbers of files at a time, based on certain file name attributes. When selected, a window pops up asking you to enter the file name selection criteria. For example, you could use this function to highlight all of the files with a 'BAK' extension by selecting all files that meet the '*.BAK' criteria. You can use the wildcards ? and * in this window. - Mark All (shortcut key <F3>). This function marks all of the files currently displayed. It could be used to delete all of the files in the directory, or to move them all to another disk or directory. If you are only displaying certain files, such as Archive or Unused files, you would only be marking those files. - Mark All Unused (shortcut key <F5>). This function marks all of the files listed as 'Unused'. It has no effect if there is no history file. Remember that you can vary your definition of 'Unused' in the Display menu. - Unmark All (shortcut key <F4>). This function unmarks all marked files. You can unmark files one at a time by 'marking' them again. The mark feature used for individual files is a toggle switch - mark once and the file is marked, mark again and it is unmarked. The three 'group mark' functions listed above do not toggle the mark, they simply ensure that the selected files are marked. 20 MENU (DISPLAY): - Display Filter... This function allows you to add another display criteria to the file list. A window pops up asking you to input a file name criteria, using wildcards. For example, this feature could be used to display ONLY those files with a filename of *.BAK. This selection is in addition to the 'Show (type)' functions listed below. When you enter a new filter criteria, the entire list of files in the directory is again reviewed for display-ability based on both the display filter and show (type) values selected. - Show Unused Files Only. When selected, this function changes the list of files displayed. This is a toggle switch, and changes value when you select it. For example, the default is False. To show only the unused files, click on this item or highlight it and press ENTER. This changes the value to True: you are jumped back to the main screen, a diamond is placed next to the menu item, and the file list is displayed with the new show criteria. - Show Hidden Files. When selected, this function changes the list of files displayed. This is a toggle switch, and changes value when you select it. For example, the default is True. To NOT show the files that are only Hidden, click on this item or highlight it and press ENTER. This changes the value to False: you are jumped back to the main screen, the diamond next to the menu item is removed, and the file list is displayed with the new show criteria. - Show ReadOnly Files. When selected, this function changes the list of files displayed. This is a toggle switch, and changes value when you select it. For example, the default is True. To NOT show the files that are only ReadOnly, click on this item or highlight it and press ENTER. This changes the value to False: you are jumped back to the main screen, the diamond next to the menu item is removed, and the file list is displayed with the new show criteria. - Show Archive Files. When selected, this function changes the list of files displayed. This is a toggle switch, and changes value when you select it. For example, the default is True. To NOT show the files that are only Archive, click on this item or highlight it and press ENTER. This changes the value to False: you are jumped back to the main screen, the diamond next to the menu item is removed, and the file list is displayed with the new show criteria. - Show Normal Files. When selected, this function changes the list of files displayed. This is a toggle switch, and changes value when you select it. For example, the default is True. To NOT show the files that are only Normal, click on this item or 21 highlight it and press ENTER. This changes the value to False: you are jumped back to the main screen, the diamond next to the menu item is removed, and the file list is displayed with the new show criteria. - Define Unused... This function is used to determine which files are listed as "Unused" on the file list, and which have the file access codes next to them (being used). When selected, a window pops up asking you to define which files are USED. The five types of access are listed: Created, Executed, Opened for read/write, Find specific file, and Wildcard find. Most users should use the default definition of used: any file access at all. This is the safest, most conservative definition. Generally, the only other use will be to eliminate the Wildcard finds, and possibly the Find specific files. Eliminating these finds could dramatically increase the number of files listed as unused. While this simplifies the screen and your decision process, there is a small chance of increasing the likelihood of deleting a required (though not actually USED used, if you know what I mean) file. - Colors... This function allows you to change the colors that DeadWood uses. When selected, a window pops up which lists the various screen elements. For each element, you may select a ForeColor (foreground), and for some you also select a BackColor (background). Choosing OK after making changes will save the new color scheme. Choosing Cancel resets the colors to the previously active colors. - Save Setup. This saves 1) the 'Define Unused' criteria, and 2) the 'Show (type)' criteria to a disk file, which is recalled every time you restart DeadWood. The colors are saved separately, and the 'Display Filter' criteria are not saveable. 22 NOTES ON DELETING FILES: Please note: DeadWood makes it much easier to determine which files are safe to delete, but personal judgement and common sense are still required. Almost every computer user laments his or her decision to not buy a larger hard disk. Many users have to delete files in order to make room to do something else - the trick is knowing what to delete! Deleting files is a bit of an art form. It's easy to delete all of the *.BAK backup files, and maybe the *.ZIP files that have already been expanded. But once you start deleting files in, say, your word processing directory, things stop being easy. You'll find hundreds of files with strange names. DeadWood can tell you, for certain, that a file wasn't used while the TSR's were active. Smart users will use the TSR's to monitor several "heavy-duty" sessions before making decisions on which files to delete. You should recall files large and small. Preview, change fonts, use your macros, spell-check, print, and anything else that you are likely to do. In order to BE SURE, you have to DO EVERYTHING THAT YOU WILL EVER WANT TO. Only then will you have the freedom to highlight all of the unused files and delete them. You can change your definition of "Unused" via the DISPLAY menu option. The most important decision here is to decide whether a wildcard search qualifies a file as used or not. A file is listed as having been searched by wildcard if a program or command was executed listing a filename that contains a wildcard (usually ? or *). For example, entering the DOS command DIR *.* will wildcard search every file in your directory. This wouldn't be a good reason to NOT delete a file. An editor might look for all of the BASIC files, *.BAS, when asking you which file to open. It is possible, though unlikely, that an important file is accessed only via a wildcard search. Because of this, the most conservative option is to include wildcard searches in your definition of "Used," and avoid wildcard searches while the TSR's are running. Some programs require the physical presence of a certain file to run, even though they never use the file. For example, the MS- DOS EDIT command won't work if the file QBASIC.EXE is missing. As a result, generally files with an "F" access shouldn't be deleted. This is a clear indication that some program asked for that file by name. 23 Most of us will take a less conservative (lazier) route. We'll do the basic functions, then use DeadWood with a bit of experience to delete the useless files that are cluttering our disks. It is a very good idea to move files temporarily before deleting them. This is called SAFE DELETING. Simply create a subdirectory called DEAD in your directory, move all of the unused files into it, and continue running for a few days or weeks. Eventually it will become obvious that the files in that subdirectory aren't needed, and they can be deleted. Remember that most of us have needed to re-load individual files from the original installation disks at one time or another. Oh, yes - there are a few files, such as COMMAND.COM, IO.SYS, AUTOEXEC.BAT, and CONFIG.SYS that shouldn't be deleted. They'll often be listed as Unused because they are used when you turn the computer on, before the TSR's are started. I put this warning in because a relative of mine recently confessed to "weeding these files out" during an intense disk space crisis. Disk space quickly became the least of his worries. <g> Be careful about deleting files in the DOS directory if you aren't familiar with DOS. You can go years without needing XCOPY, and then find a situation where this utility is the only solution. The same holds true for many of the other executable files. Files in the root (C:\) directory should be deleted with caution, as well. This is often a place where silly stuff accumulates, and you can usually find lots of files to delete here. WINA20.386 is another file to avoid deleting, as it is required for certain Microsoft Windows operations. 24 INCOMPATIBLE PROGRAMS: The TSR's use DOS interrupt 80. Any program that also uses this interrupt will crash the system (the screen will lock up and the keyboard won't respond). This interrupt is generally reserved for the old GW-BASIC interpreter, which is rarely used today (Please don't write letters telling me how valuable GW-BASIC is!). The modern QBASIC interpreter appears to work fine with DeadWood. Modern programs created and compiled with BASIC, such as BASIC PDS, Visual BASIC, and the like should run fine. You may have problems with the following programs: 1) GW-BASIC Interpreter - This is the program supplied with early versions of DOS. While QBASIC works fine, other BASIC interpreters may have the same problem. 2) BASIC PDS Editor (QBX.EXE) - QBX appears to work fine, but the TSR's are deactivated, and usage tracking stops until the TSR's are unloaded and reloaded. The Visual BASIC Editors for both DOS and Windows appear to work fine, and usage is tracked without problem (much of DeadWood was developed under VBDOS with the TSR's running). 25 KNOWN PROBLEMS: 1) Under certain circumstances, the DOS cursor is turned off. The cursor can usually be reactivated with the "MOUSE ON" command. See your mouse software manual for details. 2) File usage may not be tracked under Novell Networks. 3) Hidden directories are not displayed on the directory list. This will be fixed in a future release. 4) After using the VIEW FILE option approximately 90 times during a single session, the program crashes with an "Out of Stack Space" error message. This will be fixed in a future release. 5) If you use the mouse to mark the highlighted file by clicking on the 'Mark Highlighted' button, the highlight bar does not advance to the next file. The preferred method when using a mouse is to double click on the file name itself. 26 TROUBLESHOOTING: - Computer Locks Up: The DeadWood TSR's have been tested on a number of computer systems with a wide variety of software. It is likely, though, that some software "just won't work" while the TSR's are active. If the TSR's work for most of your other software, then there is nothing you can do - it just isn't compatible. Use DeadWood to analyze the other 98% of your software. Please write or send me a Compuserve email and I will add this program to the list of incompatible programs. Please don't phone me with this kind of information. If your computer always locks up when you load the TSR's, then the problem is probably another TSR or device driver that is trying to use the same DOS Interrupt. Try to find this program by booting your computer from diskette and loading your TSR's and device drivers one by one until the computer locks up with the DEADTSR's. Then remove the offending program (temporarily) from your AUTOEXEC.BAT or CONFIG.SYS file. - "DATABASE NEEDS REPAIR": This error message results when the file DEADHIST.DAT has been damaged. It is repairable by using Microsoft's Visual Basic for DOS ISAMREPR program - which is supplied with registration. If you have the repair program, simply type ISAMREPR DEADHIST.DAT and press ENTER. This error is almost always caused by turning off your computer before exiting the DeadWood file management program (The DEADTSR's do not affect this). A quick fix is to delete this file by using the command DEL DEADHIST.DAT and pressing ENTER. Then run the TSR's again to accumulate another history. - Device I/O Error: Computers using MS-DOS version 3.10 may experience this error when running DeadWood with the history data. This is caused by a problem with the ISAM data engine. One beta tester experienced this problem with a more recent version of DOS while using the DeadWood interface with active DEADTSR's - the problem disappeared when he unloaded the TSR's prior to running DeadWood. - Some Items on the Screen are Invisible: This is common, particularly with mono screens. To fix this, simply change the color values in the Color Control Panel, in the Display Menu. First try disabling the 3-D option, then try using different colors. In case you can't see the screen to do this (ha-ha), the sequence (once inside the DeadWood program) is Alt+d, C, Alt+t, ENTER. - Cursor Doesn't Work in Windows: The cursor may not work when the program is run under Windows and is displayed in a small window. This is usually a result of your video or mouse drivers not allowing this ability. You may try adding the line 27 "MouseInDosBox=1" to the [nonWindows-App] section of your SYSTEM.INI file. DeadWood can be run full screen from within Windows to avoid this problem. - Can't Unload TSR's: This is usually caused by putting the TSR's early in your AUTOEXEC.BAT and/or loading other TSR's after the DeadWood TSR's. TSR's generally must be unloaded in reverse order - that is the last TSR loaded must be the first TSR unloaded. If you have the TSR's in your AUTOEXEC.BAT, edit this file and either remove the startup commands or move them towards the end of the file. To unload the DeadWood TSR's, simply type DEADTSR1 /U and press ENTER, then type DEADTSR2 /U and press ENTER. These commands should be entered from within the DeadWood directory. - The DeadWood file manager crashes immediately: This may occur if you have upgraded your DeadWood from an earlier version. The current version requires a different format database. You must delete the old database, DEADHIST.DAT, and any records pending update, DEADWOOD.DAT, before running the new version. 28 TECHNICAL ASSISTANCE: Technical assistance is available, for FREE, both before and after registering the software. Most people who ask for help before registering will end up sending me money - so the more helpful I am, the more successful I'll be! There are three ways to receive help: Via Compuserve (PREFERRED): I check Compuserve most days, including weekends. My User ID is 76635,1012. Send me a message and I'll be happy to respond. I particularly like suggestions for improvements and people telling me what a genius I am. By Mail: I try to give particularly clear and complete responses to mailed inquiries (hint, hint). I can be reached at the following address: Christopher B. Eckles P.O. Box 225 Waleska, GA 30183-0225 USA By Phone: If your problem is urgent, I am available to take phone calls. Please be sure that you are VERY clear on what your problem is. PRECISELY what are the error messages? Does the error happen EVERY time? (Don't call to tell me that something strange just happened once!) What version of DeadWood are you using? You may call me at 404-479-2888 during the following hours: Monday } Tuesday } 8:00am to 3:00pm Eastern Standard Time (EST) Wednesday } Thursday CLOSED - My day to volunteer at Kennestone Hospital Friday } 8:00am to 3:00pm EST Saturday } 1:00 to 5:00pm EST (often) Sunday CLOSED Please don't call collect. Please don't call outside these hours. Please don't leave a message for me to return your call if you do try to call outside of these hours. Oh, yes - be VERY sure that you have read the manual, including the sections on CAUTIONS, KNOWN PROBLEMS, and TROUBLESHOOTING. Ich kann etwas Deutsch sprechen, aber ich bin nicht fliessend. 29