ExtraDOS Toolbox Professional Version 2.63 03/11/91 by Foley Hi-Tech Systems 172 Amber Drive San Francisco, CA 94131 (415) 826-6084 (415) 826-1707 BBS (415) 826-1706 FAX Copyright (c) 1985-91 by Foley Hi-Tech Systems Introduction: ExtraDOS is a compilation of tools that Microsoft did not include with DOS. I originally wrote these tools under MS-DOS because I found the need for them and often couldn't find commercially available products to provide what I needed. In some cases I had a program written by someone else that did similar functions but not everything I needed. In other cases they were tools that I had found useful or familiar in the Unix world but where not available in the MS-DOS world so I wrote a version for MS-DOS. I like many MS-DOS users have a copy of PC-Tools and Norton Utilities on my system, but again, these packages don't provide all the tools necessary for my daily usage and thus this toolbox was created. The ExtraDOS utilities are Copyright (c) 1985-91 by Foley Hi-Tech Systems. These programs are not public domain, but are "shareware." They are made available and if you find they are of some useful value in your normal computer needs, then please register them. Registration is required if you keep and use any or all of the utilities. To receive technical support you will have to register. Registration will get you a complete set of the current ExtraDOS utilities and a printed manual. Registered users are also given access to the product updates on our BBS system. You will be able to get updates for any programs for free from the BBS system for one year after registration. You will also be added to our mailing list to receive newsletters, price lists and product announcements. To register print out the file ORDERFRM.TXT and fill in the information and send it via FAX or MAIL to: Foley Hi-Tech Systems ExtraDOS Registration 172 Amber Drive San Francisco, CA 94131 (415) 826-6084 (415) 826-1706 FAX If you find a bug in any of the programs please contact me at the above address, phone or BBS. Registered owners reporting a bug will be given a renewed gratis update period, unregistered users reporting an unknown bug will be given a gratis registration. Suggestions for updates, changes or improvements are also welcome at the above address. INDEX: Subject Page Introduction............................................... 2 Index...................................................... 3 ADDCOMM - Serial Port Management Program.............. 5 ALARMCLK - Alarm Clock Program......................... 5 ALLSUB - Perform task in all subdirectories.......... 6 AREA - Telephone Area Code Search Utility.......... 6 BANNER - DOS Banner Display..........................10 BOOT - PC Rebooting Utility........................10 BOOTLOCK - Lock out Reboot Keys and Break Keys.........11 BRKBOX - COM Port Break out Box Display..............11 CAL - DOS Calendar Display........................11 CAT - DOS Cat Text File utility...................12 CURLOCK - Lock Cursor Shape Permawntly...............12 CURSOR - Change Cursor Shapes........................13 CUT - DOS Cut Text file utility...................13 DELAY - Batch file Delay utility....................14 DETAB - File Detabulation Utility...................14 EDIT - Full Screen Editor..........................15 - CONFIG.EXE, EDIT.HLP, EDIT.HDX..............15 EVAL - DOS Command Line Calculator.................15 FF - Find File on Disk...........................19 FS - File Size Listing Utility...................19 FT - File Directory Tree Listing Utility.........20 HELP - DOS Command HELP............................20 HEX - File Hex Display Utility....................21 HUSH - Speaker Silencing Utility...................21 KILLDIR - Remove Directory and all contents...........22 LASER - Control HP Laser Jet from DOS...............22 LS - DOS Listing Utility.........................24 MAZE - DOS Maze Creator............................24 MOVE - MOVE Files Across Disks.....................25 ND - Name Directory Utility......................26 PAUSE - Pause Device Driver.........................26 PF - Path Find File Utility......................26 PSP - PostScript Text File Print Utility..........27 SA - Set Screen Attributes.......................27 TIDY - Clean up .BAK and 0 Length File Utility.....28 TOUCH - Touch File Date Utility.....................29 TS - Text Searching Utility......................29 TURBOBAT - Turbo Batch File Compiler...................29 ~ Index Continued ~ Terms of License Agreement.................................30 Limited Warranty...........................................30 Technical Support..........................................30 Trademarks.................................................30 Revision Notes.............................................31 New Utilities Under Development............................33 Other FHTS Products........................................33 Programmers Wanted!........................................33 ADDCOMM.EXE Version 1.10 03/08/91 ADDCOMM is a utility that allows you to define the address of your COM ports in the DOS lower memory segment. This is useful for machines whose BIOS doesn't support COM3 and COM4 ports by default. In many older machines including early 80386 based systems, the BIOS would only setup COM1 and COM2 for DOS. Newer serial cards and modems allow you to define COM3 and COM4 on the cards but these machines won't allow DOS to see these additional ports unless you place the corresponding address in low dos memory. ADDCOMM will place this information in the correct location for you. ADDCOMM will also display the current address values for any COM ports that are installed in your system. By placing the ADDCOMM statements in your AUTOEXEC.BAT file you can have the machine load the correct values without having to intervene. ADDCOMM is not a TSR and will not require any overhead memory to setup your ports from AUTOEXEC or the DOS prompt. Usage: ADDCOMM [port] [address] PORT - is the COM port to add ADDRESS - is the address of the COM port Example: ADDCOMM COM3 3E8 will tell DOS to address COM3 at address 3E8. ALARMCLK.COM Version 1.10 02/04/91 ALARMCLK is a simple alarm clock for MS-DOS machines. It allows you to set a time for your system to beep at you to remind you of appointments or meetings. You may install as many alarms as you wish. Each installation takes 736 bytes of resident memory. Usage: ALARMCLK [time] [PM] TIME - Time in HH:mm format 12 hour or 24 hour clocks are both accepted for the time format. PM - ALARMCLK will assume AM with 12 hour format unless PM is defined. Future Releases of this product will include the ability to uninstall and release alarms as well as have multiple alarms with only one installation of the program. ALLSUB.COM Version 1.00 05/20/90 ALLSUB is a utility that will allow any command or program to be run on the current directory as well as all subdirectories of the current directory. This is useful for deleting groups of files or performing tasks with programs that don't normally allow for subdirectories. As the command is performed in each subdirectory ALLSUB will display the directory of execution Usage: ALLSUB [command] COMMAND - Is any valid DOS command or program with it's parameters. Enter the command just as if you were running it from the DOS prompt. AREA.EXE Version 2.13 01/13/91 AREA is a utility that will help you locate a region to which an area code applies or to locate the area code for a specific region. Since the phone company constantly updates regions and expands with more area codes, the data may become incorrect. If you know of a new area code, or one that has been changed we would like to know of this change so that we may keep the AREA utility current. Please contact us either by BBS, FAX or PHONE. Usage: AREA [code] [string] [options] [code] is any 3 number area code. [string] is any string that might match a state or region that you are searching for. Valid options: /L - Load as a TSR. This will make the AREA code program a pop TSR that will allow you to call up and area code or location while running another application without exiting to DOS. [CTRL][LSHIFT]A is the hotkey to activate the program once installed as a TSR. /U - Will uninstall the AREA code program if it is installed as a TSR freeing up the overhead that it required. Uninstall will only work if AREA was the last TSR loaded on the Heap. If the program is unable to uninstall it will inform you when running the /U parameter. ~ AREA Continued ~ /NOH - If running AREA from a batch file or from another shell program you might sometimes wish to have it not display the header information. /NOH tells AREA to not display the header. /K$nnnn Allows you to set the default key for the TSR pop up command. You can alternatively set the hot key by using the environment variable AREAKEY. We suggest not using this option unless you are familiar with your systems currently defined hot keys. By changing the hotkey value you may cause conflict with another TSR in your system. Below is a chart that will show you the value to use for either the /K parameter or the environment variable /K Example: AREA /K$0836 /L would specify [ALT][RSHFT] as a new hotkey Example of Environment Variable for hotkey definition: SET AREAKEY=$0836 as a line in the AUTOEXEC.BAT file would set the [ALT][RSHFT] as the hotkey Keyboard Scan Codes for Hotkey Use Hotkey = $XXYY where: XX = aggregate hex code for the ALT, CTRL, Lshft, and/or Rshft YY = One of the hex codes from the scancode tables below. Computing the XX value: ALT = $0800 CTRL = $0400 LSHFT = $0200 RSHFT = $0100 so, [ALT][LSHFT] = $0800 + $0200 = $0A00 + YY = $0AYY or, [CTRL][RSHFT] = $0400 + $0100 = $0500 + YY = $05YY or, [ALT][CTRL][RSHFT] = $0800 + $0400 + $0100 = $0D + YY = $0DYY Note: If XX = $0000 then this is a single key hotkey which will be defined by the YY keycode. ~ AREA Continued ~ Computing the YY value: To use previous examples, [ALT][LSHFT][G] = $0A00 + 22 (G = hex 22) = $0A22 [CTRL][RSHFT][F10] = $0500 + 44 (F10 = hex 44) = $0544 You can also use something like [ALT][LSHFT] only. To do this, you would use $0800 + 2A = $082A [ALT] [LSHFT] = [ALT][LSHFT] NOTE: The XX portion of the hotkey may not use anything "lower" than CTRL for the following keys: Esc, BkSp, Space, CapsLock, Tab, ENTER, PrtSc, Ins, Del, and Num Lock. This means you can't use LSHFT-Tab, or RSHFT-Tab, but you can use CTRL-Tab or ALT-Tab. ~ AREA Continued ~ Scan Code Table --------------- Hex Key Code Key Code --- ---- --- ---- Esc 01 Q 10 ! 1 02 W 11 @ 2 03 E 12 # 3 04 R 13 $ 4 05 T 14 % 5 06 Y 15 ^ 6 07 U 16 & 7 08 I 17 * 8 09 O 18 ( 9 0A P 19 ) 0 0B { [ 1A _ - 0C } ] 1B + = 0D ENTER 1C BkSp 0E | \ 2B CTRL 1D A 1E Z 2C S 1F X 2D D 20 C 2E F 21 V 2F G 22 B 30 H 23 N 31 J 24 M 32 K 25 < , 33 L 26 > . 34 : ; 27 ? / 35 " ' 28 RSHFT 36 ~ ` 29 PrtSc* 37 LSHFT 2A ALT 38 Space 39 7 Home 47 CapsL 3A 8 UpArw 48 F1 3B 9 PgUp 49 F2 3C Minus sign 4A F3 3D 4 Left Arw 4B F4 3E 5 4C F5 3F 6 RightArw 4D F6 40 + 4E F7 41 1 End 4F F8 42 2 Down Arw 50 F9 43 3 PgDn 51 F10 44 0 Ins 52 Scroll L 46 Del 53 Tab 0F Num Lock 45 ~ AREA Continued ~ Note that you can use the ALT, CTRL, L/RSHFT keys by themselves. For example the following hotkeys/codes are valid: ALT-RSHFT $0836 CTRL-RSHFT $0436 LSHFT-RSHFT $0236 CTRL-ALT-LSHFT $0C2A BANNER.EXE Version 1.20 03/11/91 Banner Displays an ASCII rendition of the letters you put in a message rotated at 90 degrees. This is based on the BANNER that is available in many UNIX systems. Usage: BANNER [options] [message] /? - Displays Help /w - Set to 132 Column Width /wnn - Set to nn Column Width /p - Send output to LPT1 *default setting /pLPTn - Send output to LPTn /s - Send output to Screen /o[fname] - Send output to file [fname] /noh - surpress the header information BOOT.EXE Version 1.50 09/05/90 BOOT is a utility which can be called from the DOS command line or from a batch file. This program will reboot your PC either emulating a soft boot [CTRL][ALT][DEL] or a hard boot such as pressing the reset key. Usage: BOOT [parameters] Parameters: COLD - Perform a Cold Reboot of the System (same as Hard) HARD - Perform a Hard Reboot of the System (same as Cold) WARM - Perform a Warm Reboot of the System (same as Soft) SOFT - Perform a Soft Reboot of the System (same as Warm) Notes: The next release of BOOT will include the option to specify the time delay before rebooting. BOOTLOCK.COM Version 1.00 02/04/91 BOOTLOCK is a simple utility that will lock out the use of the [CTRL][ALT][DEL] soft boot sequence and the [CTRL]C or [CTRL][BREAK] break sequence. Once installed BOOTLOCK requires 624 bytes of memory. Usage: BOOTLOCK In the next revision we will be adding the ability to override the header information and to uninstall the utility once installed. BRKBOX Version 1.10 04/18/89 BRKBOX is a software version of a serial port breakout box. It displays the status of a COM port inside your PC. The status of the DTR, DSR, RTS, CTS, DCD, and RI pins as well as the data rate, parity, number of data bits, and number of stop bits are displayed on the top right hand corner of the screen. This information is sometimes useful when trying to debug a serial port or some associated communications software. If no communications port is specified the program will default to COM1. To toggle the display on and off use [ALT]C. The program will start with the display toggled off. BRKBOX can be uninstalled by entering it with the optional U parameter if it was the last TSR loaded. Usage: BRKBOX [port] [U] [port] - is the serial port COMx. Valid numbers are 1 through 4 [U] - tells the program to remove itself from memory. This will only work if BRKBOX is the last TSR installed. CAL.EXE Version 1.12 10/23/89 CAL displays a calendar from DOS in one of two formats, either one month or 12 months of one year. Usage: CAL [mm] yyyy - mm is the month [1..12] - yyyy is the year [100..9999] if you specify 2 digits for yyyy then it will assume you mean 19xx If you want to pause the display of a full year press [CTRL]S to pause the screen and then any key to continue the display. CAT.EXE Version 1.10 11/16/89 CAT is a UNIX utility written for the MS-DOS world. For people that are used to UNIX it is a handy familiar tool for displaying, printing, and concatenating files together. CAT handles redirection of both input and output. It can be used similar to copy con to create files as well. Usage: CAT [fname] - copy std input to file fname or CAT [file1] [file2] > [file3] - concatenate file1 and file2 to file3 CURLOCK.COM Version 1.10 9/16/89 This program was written when I purchased my laptop computer with LCD screen. I found that I could set the DOS cursor shape with my CURSOR.EXE program but when loading other software, the cursor was set to it's own cursor shape. CURLOCK locks the cursor shape (optionally set with CURSOR.EXE) so that no matter what software you use the cursor will not be changed. I found that on my laptop if I set the cursor to a block and then locked it with CURLOCK I had much better luck in seeing and locating the cursor in various programs. CURLOCK intercepts all calls to BIOS interrupt 10h and bypasses any calls to change the cursor shape. It is a TSR requiring 592 bytes of resident ram. Usage: CURLOCK Notes: Future Releases of this utility will allow the user to un- install the program. CURSOR.EXE Version 2.00 12/29/90 CURSOR is a program that lets you control your cursor from the DOS prompt. You can set the cursor to various shapes as listed above. Some software uses the DOS cursor in which case the cursor will stay the same as what you set it using CURSOR. If the software makes it's own cursor then the cursor you create with CURSOR will not function inside this software. Some software resets the DOS cursor to it's own shape. Therefore you might want to put CURSOR in a batch file after this software to reset the cursor to what you want it to be at the DOS prompt. Usage: CURSOR [switches] D - turns the cursor on to the bootup default underline H - turns the cursor off (hide cursor) B - makes the cursor a full block M - displays the values of the registers for the video call ? - displays the help screen V - returns version information I - Interactive Setup. Gives you a full screen editor of your cursor T:nn - set the top scan line of your cursor B:nn - set the bottom scan line of your cursor CUT.EXE Version 1.10 12/06/89 CUT is another UNIX utility written for the MS-DOS world. For people that are used to UNIX it is a handy familiar tool for displaying and printing text files in different formats by eliminating columns and other formatting options. Usage: CUT -clist [fname1] [fname2] ... Example: CUT -c1-15 test.txt will display all characters in the file test.txt in columns 1 through 15 DELAY.EXE Version 1.50 8/26/90 Delay is a utility that can be used to replace the PAUSE command within a batch file. Pause will never continue until a key is pressed, whereas with delay you can set the amount of seconds to pause, and then continue or continue immediately by pressing a key. Pressing [CTRL]C will also cause a break in a batch file that can be monitored with the error level returned by DELAY. This is useful if you are trying to break out of stream of commands from within a large batch file. Usage: DELAY [time] Delays a specified number of seconds before continuing. Wait can be a value between 0 and 65000, defaults to 5. Returns an ERROR LEVEL of : 2 - [CTRL][BREAK] pressed 1 - A key was pressed 0 - Time ran out Example of how to use DELAY error codes in a batch file: DETEST.BAT echo off echo Now I will wait 5 seconds for you to decide echo Press [CTRL]C to skip the network loader delay 5 if errorlevel=2 goto skip :load network :skip The above batch file will skip over the network program if CTRL C is pressed during the delay period. DETAB.EXE Version 1.00 09/27/85 DETAB is a utility that will strip any tab characters from a ascii text file and convert them into 4 spaces. This is especially useful when working with old formatted .ASM files that you would like to work with in an editor which treats fixed tabs differently. USAGE: DETAB [input filename] [output filename] Notes: In the next revision of this utility we plan to add the ability to specify how many spaces to replace each tab with. EDIT.EXE Version 2.21 7/9/90 SuperEdit is an MS-DOS based full screen editor. It was written using Borland International's Editor ToolBox. It has many features of most editors on the market today including multiple windows and pull down menus. This editor has not been completed at this time so there is no documentation. You may press F1 and any time during the program to get online help about various features. F10 will display the menu bar. When using a menu choice the equivalent keystrokes of the menu choice will be displayed in the upper left part of the screen. To change these keystrokes to match any editor that you are used to run the CONFIG.EXE program to install the editors keystrokes. Do not modify EDIT.HLP or EDIT.HDX. These are the files used for the online help system and configuration program. These files must appear in the same directory as CONFIG and EDIT in order to be loaded properly. Notes: The CONFIG and HELP parts of the Editor are only available in the registered or commercial versions of the tool kit. A new version is currently being written which will provide mouse and printing support, and optional automatic loading of all boot up files. EVAL.EXE Version 1.00 10/08/90 EVAL is a program designed to evaluate mathematical expressions input on the command line. Usage: EVAL [expression][function][expression]... Example: EVAL 35+9 EVAL supports the four basic functions; addition, multiplication, subtraction, and division. The syntax used is very similar to that of the mathematic expressions used by most modern computer languages and by most spreadsheet programs. For example, to add two to eight and multiply that result by thirteen, one would use: EVAL (2+8)*13 ~ EVAL Continued ~ Exponents The operator precedence used is similar to most high level languages, as well. Multiplication and division are "higher" than addition and subtraction. Exponents, represented by the carat (^) is lower than all four operators. You will find that you can exponentiate values by using ** in place of the carat. Thus, you can use: EVAL 2**1/2 to find 2^0.5. It should be noted, by the way, that this is a good way to find roots. The program has no sqrt() or curt() functions. You may recall from your math courses that, to find the y-th root of x, you can do: x^(1/y) Of course, EVAL will complain if this results in a complex number. For example, the result of the above is complex if x == -4 and y == 4. Range EVAL uses the full "double" precision of the C language. Thus, answers will be represented to a maximum of 16 digits to the right of the decimal point. EVAL allows all numbers between 1.7E-308 and 1.7E+308 to exist. Of course, the negatives of these numbers are also available. It should be noted that EVAL doesn't check for overflows or underflows. EVAL will, however, flag "digital math" nono's, such as division by zero and exponentiations resulting in complex numbers. To use these numbers, just write them as you would specify them in a program like 1-2-3 or in a program: 3.1415 0.1 -34 18.01 35e-2 6.2e+23 Modulo Division EVAL, as well as complementing the four functions with exponentiation, allows the use of the modulo operator. This operator provides the integral "remainder" of division. Since 5 divided by two is two remainder one, the command: EVAL 5%2 will result in the answer 1.0. ~ EVAL Continued ~ Functions EVAL supports an extensive list of functions, as well. Functions may be specified in either upper or lower case, and may be abbreviated to as little as three characters. (Of course, if the function's name is one or two characters long, all characters must be specified.) These functions are supported by EVAL: abs(x) - absolute value of x acos(x) - arc cos of the angle x radians acot(x) - arc cotangent of the angle x radians acsc(x) - arc cosecant of the angle x radians asec(x) - arc secant of the angle x radians asin(x) - arc sine of the angle x radians atan(x) - arc tangent of the angle x radians cos(x) - cosine of the angle x radians cot(x) - cotangent of the angle x radians csc(x) - cosecant of the angle x radians deg(x) - convert x radians to degrees exp(x) - e to the power of x fact(x) - factorial of x ln(x) - natural (base e) logarithm of x log(x) - base 10 logarithm of x pi(x) - pi times x rad(x) - converts x degrees to radians sec(x) - secant of the angle x radians sin(x) - sine of the angle x radians tan(x) - tangent of the angle x radians sinh(x) - hyperbolic sine of x cosh(x) - hyperbolic cosine of x tanh(x) - hyperbolic tangent of x sech(x) - hyperbolic secant of x csch(x) - hyperbolic cosecant of x If any of these functions are passed invalid values, EVAL will abort with an error. The arc-trig functions, for example, cannot accept values outside of the closed interval [0,1]. Using these functions is similar to any other high level language. The function name and its ending left parenthesis function as an opening parenthesis in the precedence of the evaluation. Thus, sin(.7)^2+cos(.7)^2 would evaluate to 1.0. You may find that certain identities don't evaluate to what you would expect them to. ~ EVAL Continued ~ This is because of the limits of precision in computer math when dealing with irrational numbers. While the sin^2+cos^2 identity almost always works, the sec^2-tan^2 identity usually doesn't work, for example. Along with this problem, another comes. For example, mathematically sec(0.5*pi) is undefined. However, EVAL will evaluate sec(pi(0.5)) to be a very (very) large number. This is again because of the rounding errors in binary math. It is a good approximation, considering lim (sec(x)) == +infinity x -> 0.5+ Memory By popular demand, a "memory" feature has been added to EVAL. If you make a computation using EVAL, the result is remembered and may be used as needed in any further invocation of EVAL. For example, using the command: EVAL SIN(1) would display the sine of one radian. If you executed the command: EVAL ASIN(@) next, you'd get, effectively, ASIN(SIN(1))... the result would be one. Similarly, if you used EVAL 35+15 EVAL would print 50. If you did EVAL @+100 a result of 150 would be displayed. EVAL stores the results in your machine's environment. You may see the previous result by typing the SET command; DOS will list the environment variables it has stored. EVAL's environment variable is listed on the line "EVAL". FF.EXE Version 2.00 02/15/91 Will locate files by searching the entire disk for a specified file. You may use DOS wildcards to find a group of files as well. The new version of FF will also search within compressed files to search for filenames as well. FF searches across your disk looking for any files that you specify. When it finds a matching file it will display the Directory the file was found in, the complete file name, the file size, creation date and time, and any attributes associated with the file. Usage: FF [d:] fname[.ext] [options] Where d: designates a valid DOS drive fname[.ext] specifies the file(s) to search for. Wildcards are accepted. Valid Options: /V - Verbose mode, will show file statistics /T - Total mode, will show file totals and not found names /D - Progress Display, will show files as searching /R - All Drive mode, will search across all drives found /N - normal files only, do not search inside any compressed files (this is a combination of all of the below options) /O - do not search inside .ZOO files /Z - do not search inside .ZIP files /A - do not search inside .ARC files /P - do not search inside .PAK files /L - do not search inside .LZH files [CTRL]C - Will halt the execution of the program at any time. [CTRL]S - Will pause the display at any time. FS.EXE Version 1.20 03/09/91 FS is a utility that will list each individual file in a directories size, then sum that listing and then show total and free space on that particular disk drive. You may pass FS a specific file to list, or group of files. If no parameters are passed FS will list all files in the current directory. USAGE: FS [filespec] The next release of FS will contain the ability to show files in subdirectories of the current directory, pause on screenfuls and will display file sizes in comma delimited format for better readability. FT.EXE Version 1.01 09/27/85 FT is a utility which will scan the directory structure of a disk and give a top down tree listing of the entire disks directory structure. USAGE: FT Notes: FT only works on the currently logged drive. We will fix this problem in our next release. HELP.EXE Version 1.11 /16/90 HELP prints out help messages on some of the more useful and popular DOS commands. To use the utility just type HELP followed by the name of the command that you want help with. Usage: HELP [command] Help is available for the following DOS commands: append, assign, attrib, backup, break, chcp, cd, chdir, chkdsk, cls, command, comp, copy, ctty, date, del, dir, diskcomp, diskcopy, edlin, erase, exe2bin, exit, fastopen, fc, fdisk, find, format, graftabl, graphics, join, keyb, label, mem, md, mkdir, mode, more, nlsfunc, path, print, prompt, rd, recover, ren, rename, replace, restore, rmdir, select, set, share, sort, subst, sys, time, tree, type, ver, verify, vol, xcopy In the next release of help we will be adding HELP for all of the ExtraDOS utilities. HEX.EXE Version 1.12 12/17/90 HEX is a utility that will give you a quick dump of the contents of any file. The dump is very similar in format to what you get with the Norton Utilities file viewer. An advantage of HEX is that you can quickly dump the contents of any file to the screen without having to load the overhead of a shell program. You can display any type of file ASCII or Binary. The default display is to list the HEX values on the left and the ASCII equivalents on the right hand column. USAGE: HEX [filename] [options] [filename] can be any valid DOS file including .EXE type files /B - will dump the file in binary groups rather than hex. /O - will dump the file in octal groups rather than hex. /H - will display the file in raw hexadecimal format rather than showing the hex and ascii values side by side /P - Pause mode, will pause each screen full HUSH.COM Version 1.20 09/17/85 HUSH is a utility that can eliminate a majority of the sounds generated by the PC's internal speaker. The way that HUSH works, it can not eliminate all beeps. Tones that it can not completely silence, it can reduce to a small click. HUSH is a small TSR which when loaded watches for output to the speaker. When activated, HUSH will try and suppress the speaker 18.2 times a second. USAGE: HUSH [mode] ON - Enable HUSH functions OFF - Disable HUSH functions NOTE: if you install other timer monitoring functions such as screen blankers after HUSH, than you may not be able to disable HUSH's functions. KILLDIR.EXE Version 1.02 02/08/91 KILLDIR is a utility that will make eliminating a directory and all of it's contents a lot easier. When you run KILLDIR it will display the information about the directory that you wish to remove including the number of files and sizes as well as any subdirectory information. KILLDIR will remove all files and file types including hidden or system files. Usage: KILLDIR [dirname] LASER.EXE 1.40 10/18/90 LASER helps you set your laser printer's mode and also makes it easy for you to send some control codes to it. It is specifically designed to work with HP LaserJet Compatible Printers but some of the generic functions such as Form Feed, Line Feed and Carriage Return will work with any printer. Usage: LASER [mode] [mode] ... BOLDON - Turns on Bolding of all characters BOLDOFF - Turns off Bolding Off ITALON - Sets the PCL Font to Italics ITALOFF - Turns of the PCL Italics LF - Send a Line Feed to the printer FF - Send a Form Feed. This will generally eject the page that is currently in the printer. CR - Send a Carriage Return to the printer. ESC - Sends the ESCAPE code to the printer. ASCII 027. 6LPI - Sets the PCL Font to 6 Lines Per Inch 8LPI - Sets the PCL Font to 8 Lines Per Inch 16CPI - Sets the PCL Font to 16 Chars Per Inch 10CPI - Sets the PCL Font to 10 Chars per Inch PORT - Sets the print mode to Portrait Orientation. Output prints vertically on the page. LAND - Sets the print mode to landscape orientation. Output prints horizontally on the page. AUTO - Tells the printer to use the internal paper tray to feed from. MAN - Tells the printer to wait for manually fed pages before printing each page. ~LASER Continued~ LEG - Set up the printer to use 8 1/2 x 14 Legal sized paper. LET - Set up the printer to use 8 1/2 x 11 Letter sized paper. TEST - Prints a Test page to the printer. RESET - Send the RESET code to the HP Laserjet. PAGEON - This parameter is for use with HP Laserjet users that have a Pacific Page Postscript Cartridge installed. This cartridge allows you to emulate an Apple LaserWriter Postscript printer on your HP LaserJet. Some software does not support the Postscript mode, and rather than having to power on and off and insert and remove the cartridge each time you wish to switch modes, you can use laser to set the proper mode of the cartridge. PAGEON tells the Printer to use the PostScript emulation mode. PAGEOFF - This tells the Pacific Page cartridge functions to disable and the printer will now except standard PCL commands. STRING=[text] - This parameter allows you to send whatever strings you wish to the printer. It can be used in conjunction with the ESC parameter to select soft fonts and send setup commands. Notes: In the next release of this utility we are working on more generic printer controls as well as the ability to control Postscript devices. LS.EXE Version 1.00 03/29/90 LS is a file listing utility that is found in the Unix operating system. It has many advanced features beyond that of the DIR command found in DOS. This implementation has most of the Unix features built in. This version will also search the environment string for LS=[defaults]. Any options that you set LS= with the SET command will be loaded automatically when you run the program from the DOS prompt. Set your most used parameters in your AUTOEXEC.BAT file and then a plain LS will run those parameters for you. Options as in the Unix LS the switches are case sensitive. Usage: LS [options] [filespec] -1 list in single column -C list in multiple columns -F directories are marked with a trailing '\', system files are marked with a trailing '@' and executable files are marked with a trailing '*' -P print the directory name before listing -R recursively list subdirectories -S sort by file size in bytes (cluster size if option 's' is selected) -a list all entries including hidden and system files -d list directories as if they were a normal file -f do not sort (list in the order files appear in the directory) -l list in long format ([size in clusters,] mode, size, date, name) -r reverse the order of the selected sort -s list the file size in clusters -t sort by time MAZE.EXE Version 1.00 02/09/87 This program is a mimic of the UNIX maze utility. It creates a random maze each time it is run. It pipes the output to the standard output device which is usually the Screen. To redirect the output to a printer type MAZE > LPT1. MOVE.EXE Version 2.00 12/17/90 Will any file from one place to another. If moving the file from one drive to a different drive, MOVE will first check to make sure that there is enough space on the destination drive. If you don't specify a destination MOVE will assume the current directory and the same file name. Usage: MOVE [source] [dest] [options] [source] source file name [dest] destination file name or directory both file names may contain wildcards [/C] specifies optional confirmation [/O] always overwrite all colliding files [/N] never overwrite all colliding files Examples: MOVE ABC.TXT \DOS This will move the file ABC.TXT to the directory \DOS keeping the same name MOVE \DOS\ABC.TXT This will move the file \DOS\ABC.TXT to the current directory keeping the same name. If a file of the same name already exists where you are trying to move a file to you will be prompted whether or not you wish to overwrite that file. If a destination is unclear as to whether it is a file name or a directory name MOVE will prompt you to decide for it. If a destination directory does not exist, MOVE will ask you whether or not you would like it to create a new destination directory for you. ND.EXE Version 1.20 12/11/90 ND is a utility that is used to rename directories. This program will rename a directory without having to empty or modify it's contents. Usage: ND [olddir] [newdir] ND is based on the concept of renaming directories from a program called FDR written by Mike Viens. PAUSE.SYS Version 1.00 11/06/89 This utility is similar to the PAUSE command that can be used in DOS batch files. It is designed to be placed anywhere in the Config.SYS file that you would like a pause until a key is pressed. This allows you to see device driver screens that normally flash by without delay. To use this utility just add a device line calling it wherever you would like a pause. There is no memory overhead or resident code used. Usage: DEVICE=PAUSE.SYS Notes: In the next release of this product we will be adding the option to have a time delay built in rather than having to wait for a keystroke. PF.EXE Version 1.30 12/14/90 PF is a utility that allows you to search the file path for any files. This is handy when you are trying to locate a similar program of file that could exist in multiple places in your path statement. It will display the files that it finds in order of appearance within the path. Usage: PF [filespec] You may use any DOS wildcards in the filespec. Future versions of this program will support the ability to search any path, rather than just the DOS path. This is useful for searching file specifications for programs such as compilers. PSP.EXE Version 1.40 03/02/91 PSP is a utility that allows you to print DOS ASCII Text files on a PostScript device without any conversion. PSP is based on a unix filter taking STDIN input and sending the converted text to STDOUT output. By rerouting the output to the printer and specifying an input file name PSP will print the file to the printer specified. The default settings may be modified at a run time basis by using the optional parameters on the command line. To set a default output mode you can specify the environment variable PSPOUT=[destination] in your AUTOEXEC.BAT file. By using PSPOUT=LPT1 the output will be redirected to the LPT1 printer port rather than STDOUT. Usage: PSP [parameters] filename Parameters: -m[xx] - set left margin (in points) (24) -t[xx] - set top margin (in points) (24) -l[xx] - set leading (points between lines) (11.5) -p[xx] - set pointsize of font (10) -f[name] - set font name (Courier) -n[xx] - number of lines per page (66) -i - ignore form feed -c[x] - number of copies to print. Default is 1 -noh - suppress the header information SA.EXE Version 1.10 11/06/89 SA allows you to set the foreground, background and border colors of your monitor. To use it, just type SA followed by three of the allowed parameters. Usage: SA [fore] [back] [border] The following are valid colors: Black Blue Green Cyan Red Magenta Brown Gray DarkGray LightBlue LightGreen LightCyan LightRed LightMagenta Yellow White Notes: SA Currently does not work with DOS 4.0. We are working on a fix for the next release. TIDY.EXE Version 1.00 10/20/90 This program is designed for the hard disk user who finds that they have many backup or null files on his disk at the end of each work session. The program is run simply by typing TIDY. TIDY will find all the subdirectories on the current disk and will remove all *.BAK files, as well as any files that have a length of zero. TIDY will display the name of each file as it is deleted. It will also display a summary of files that it has erased, as well as a total showing how much disk space was freed. USAGE: TIDY [extension] [drive] [/p] If you enter any words on the command line after TIDY, the program will search for files with those extensions and delete them. Example: TIDY MAP tells TIDY to delete all *.BAK files, as well as all *.MAP files. You can not specify wildcards in the file extension here, but you can list up to 64 extensions to search for. Additionally, you can give TIDY a disk drive specifier to have the program tidy that drive. For example, to clean up on the A: drive, use TIDY A: You can use the extensions and disk drive specifier in any order. The only restriction is that the specifier must contain the colon, and there must only be one specifier on a line. So, TIDY A: MAP TMP will perform identically to TIDY MAP TMP A: The /P option will cause the program to prompt the user if the file should really be deleted or not. If the user enters Q, for quit, the program exits and display a status report. TOUCH.EXE Version 1.20 12/17/90 TOUCH is a unix utility that is used to stamp a file's attributes with the current system date and time. This is useful if you want to have a group of files with identical date and time stamps. Wildcards are acceptable in the filespec. Usage: TOUCH [filespec] [filespec] [filespec]... TS.EXE Version 1.01 09/27/85 TS is a utility that will search for all occurrences of a given string inside of a specified text file. It will stop at each occurrence and display the found string, and prompt the user to continue or to exit. USAGE: TS [filespec] [text] Notes: Currently TS is case sensitive and does not work on executable files. In the next release of the tool kit we will address these problems. TURBOBAT.COM Version 1.00 10/08/90 TurboBat allows you to compile standard DOS batch files into .COM binary programs. This will greatly enhance the speed of large batch files by allowing them to run in native code rather than interpreted DOS commands. The resulting .COM files may call nested batch files without loosing the parent since the parent calling program is now no longer a batch file. Usage: TURBOBAT filename.ext The output will be filename.COM. Notes: In the next release of TurboBat, we will be making an effort to support all of the DOS commands as well as an extended batch language that will allow the user to write complicated routines within batch files. TERMS OF LICENSE AGREEMENT The EXTRADOS Toolbox programs and documentation are the property of Foley Hi-Tech Systems. This product and its documentation are protected by United States Copyright Law, Title 17 U.S. Code, are licensed for use on one computer per copy only. EXTRADOS is Licensed and not Sold. You may duplicate the EXTRADOS Toolbox programs and documentation files for backup use only, for your own use, and for only one computer. LIMITED WARRANTY We do not warrant that the documentation is accurate, or that the program operates as specified. We will not be liable for any damages of any kind sustained through the use of the program. By using this product, you agree to this. TECHNICAL SUPPORT Program bug reports are welcome. If you have any questions feel free to give us a call or write a letter to us at: Foley Hi-Tech Systems 172 Amber Drive San Francisco, CA 93131 9:00am - 4:30pm PST Monday - Friday (415) 826-6084 VOICE (415) 826-1706 FAX (415) 826-1707 BBS TRADEMARK NOTICES ExtraDOS Toolbox is a trademark of Foley Hi-Tech Systems MS-DOS, is a trademark of Microsoft Corporation. Revision Notes: 10/11/90 - Version 2.01 was released. This version incorporated documentation that had been run through a word processor for spelling and formatting cleanliness. Functionally, it contained an update to the LASER program to support Pacific Page PCL/PS on and off commands. 10/15/90 - Version 2.02 update. This included the HEX utility for displaying the HEX dump of a file from the command line. The AREA utility was also recompiled and added to this revision as well. 10/18/90 - Version 2.03 update. Updated the LASER utility to allow generic strings to be sent to the printer. 10/24/90 - Version 2.04. Added UNIX Touch utility to package. Allows stamping of files to current system date and time. Updated the MOVE program to 2.00 adding the /C /N /O options and making it much smaller. 11/20/90 - Version 2.11 Added the PSP PostScript utility that allows the printing of DOS Text files on PostScript printers. Added the PAUSE.SYS utility that allows pausing during the CONFIG.SYS bootup routine. Added the revised HELP utility to give help syntax with DOS commands. 11/27/90 - Version 2.20 Updated AREA utility to include searches for strings or area codes and updated the 902 area code. Updated the HEX utility to support HEX, BINARY and OCTAL displays. Added the TIDY utility, formally known as NJTIDY in the shareware world. Allows cleanup across a drive of .BAK and 0 length files. 12/12/90 - Version 2.30 Updated the PSP and AREA utilities and added the ND (rename directory) utility. 12/14/90 - Version 2.40 Added the PF path find utility. Allows you to search just the path rather than the whole disk for a filespec. 02/04/91 - Version 2.50 Added new ALARMCLK utility. Added new ALLSUBS utility. Update of AREA utility allowing it to become a 7k TSR and define hot key for activating. Added new utility BOOTLOCK which locks out the SOFT Boot and Break Keys from having any function. Updated the CURSOR program to allow full screen interactive editing of the CURSOR's shape. Added the KILLDIR utility that allows the removal of entire directories. Fixed the PSP utility to allow printing of files with an empty first line. Added the new ADDCOMM utility for managing serial ports. ~ Revision Notes Continued ~ 02/08/91 - Version 2.51 Fixed the space estimator on the KillDir utility. Added new version of FF that allowed searching within compressed files. 03/02/91 - Version 2.60 Added the BRKBOX utility to monitor COM ports. Updated the PSP utility to include multiple copies and header suppression. Revised the documentation to require fewer pages. Rather than 1 utility per page, made better use of each page.(save those trees) 03/05/91 - Version 2.61 Added updated BANNER 1.15 with ability to directly print to a printer rather than using DOS redirection. 03/08/91 - Version 2.62 Updated ADDCOMM utility to reduce code size to 3k. 03/11/91 - Version 2.63 Updated ADDCOMM utility to fix bugs with some AMI non-standard BIOS machines. Updated BANNER utility to automatically send output to printer, and support file output as well. Updated FS utility to work on any drives including Network drives. Added update to TOUCH utility that allows multiple filespecs on a single command line. New Utilities Coming We are constantly updating and writing utilities for the ExtraDOS Toolbox. Below is a list of some of the utilities currently under development: ASK - Ask Questions in a batch file and branch depending on response. BATCHPLUS - Enhancements for batch file processing that give batch files the power that MS-DOS forgot. CHIMES - Grandfather clock type CHIMES for your PC. Choose from a library of chimes. CLEANER - Program to make better use of floppy drive head cleaning diskettes. CLEANUP - A program to replace tidy. Will recover a lot of lost space on your hard disk due to backup, duplicate and redundant files. CSH - UNIX like CShell for MS-DOS Users. CUTPASTE - TSR to cut and paste text to and from any programs in your PC. Gives you a clipboard like function for MS-DOS programs. DS - Sort directories on your disk drive. DT - Comprehensive test of disk surface, controller, and file structures EMS - EMS Memory Manager for 286, 386 and 486 based machines. Remaps Extended memory as EMS 4.0 memory. LQPRINT - Makes 9 pin Dot Matrix Printers print Near Letter Quality. Enhances fonts on inexpensive printers. RAMDISK - FAST RAM disk for Extended or EMS Memory. RAMTEST - RAM Diagnostic and Bad Chip locating utility. RECALL - Recall DOS commands. Buffers all commands entered at the DOS prompt and allows you to display them and recall them. Also allows the creation of DOS Macros. SCNSAVER - Screen Saver. Blanks screen after no use of system. SCROLL - Recall lost screens from DOS. Allows you to scroll back to previously displayed screens. ~ NEW UTILITIES Continued ~ SI - System Information utility. Displays a list of installed equipment and software. SORT - Sort information in ASCII Files. SPEEDRAM - Allows setting of DMA refresh rate to squeeze as much as 5% increase in performance. VL - Set disk drive volume labels VSPEED - Increase the performance of your video card in text mode by replacing slow BIOS commands. XCD - XDOS Smart Directory Changer. Allows partial names to quickly change directories. Other FTHS Products ExtraDOS Toolbox Professional. A large collection of utilities that DOS forgot. Includes many helpful utilities that enhance MS- DOS machines. $19.00 Safety Disk. Safety Disk saves all of your systems vital information and will solve most problems due to: Loss of battery power, Loss of CMOS information, accidental deletion of boot files, virus damage to boot disk. $49.95. Programmers Wanted! We are constantly looking to add new products to our line. If you have a utility or other product that you would like us to include with one of our packages, or that you would like us to publish we are always interested. We are also looking for part time and full time contractors to build a variety of products that we are working on. If you are interested, self motivated and skilled at PC or MAC programming please upload a sample of your work and your resume to our BBS and leave a note with the SYSOP on how to contact you.