High Voltage Shareware

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

/ High Voltage Shareware / high1.zip / high1 / DIR4 / PDQ140.ZIP / PDQ.DOC < prev next >

Wrap

Text File | 1993-12-17 | 36KB | 1,198 lines

PDQ Utilities ver. 1.40 A Product of Chenango Shoreware Copyright 1992, 1993 by G. Vrooman All rights reserved Keeping track of files on a large hard disk can be a real headache. PDQ Utilities is a set of matched utilities which can make life easier for any hard disk user. PDQ includes the following utilities: SDC - A directory changer which can change to any directory on any hard drive by entering just the first few letters of the directory name. Unlike one directory changer which has been widely reviewed - SDC can access floppy drives. SDC can display the directory tree. SDC can access drives explicitly. SDC can relocate as well as rename directories. SDC can recursively delete non-empty directories. SDL - A directory lister which can display filenames sorted by name, extension, date or size and display them in one, two, four or five column formats sorted vertically or horizontally. SDL can use the data files maintained by SDC to display any directory on any drive with the same ease of use. GFF - The Gonzo File Finder is a powerful, flexible file locator which can locate files by date, search files for strings, remove unwanted files and execute DOS commands using the located file as an argument. FFV - A handy file viewer which can read files containing over 150,000 lines, do text searches and access lines by number. FFV is compatible with EGA and VGA extended text modes and can be used with virtually any size screen. PDQ does not use a complex color configuration scheme for each utility. Instead, an easy to use screen color utility is provided which will allow you to color your screen any way you want. PDQ Utilities will then determine appropriate highlight and menu bar colors based on the colors you have selected. SYSTEM REQUIREMENTS: Hard disk, Any Monitor, 256k, IBM Compatible BIOS and DOS 3.0 or later. SUPPORT: If you have any questions or comments about PDQ I can be reached by E-MAIL on CompuServe (70304,2223), GENIE (G.VROOMAN) or DELPHI (GVROOMAN) or you can write to me at the address below: Gerald M. Vrooman 6400 NY RT 79 Chenango Forks, NY 13746 INSTALLING PDQ Just copy the files to any convenient directory and make sure that the directory is included in the PATH statement in your AUTOXEC.BAT file. CONFIGURING PDQ Under ordinary circumstances, PDQ is self-configuring. You can use CC to set your screen colors and PDQ will do the rest. To provide an additional degree of flexibility certain parameters can be set from the environment. This is done by setting the environment variable PDQCFG to the desired options. eg: SET PDQCFG=CB6E6F7F25080 char 1 Drive to find PATH.SDC. The default is drive C but you may have reason to want PATH.SDC on another drive. char 2 If this character is a "B" FFV will use the BIOS to write text to the screen. If it is any other character FFV will write directly to video memory. If you have a not-so-close compatible computer you may have to use this feature. char 3-4 Normal screen colors for FFV and the menus for SDC and SDL. These are hex numbers and correspond to standard DOS color attributes. The first digit ranges from 0 to 7 and sets the background color. The second digit ranges from 0 to F and sets the foreground color. char 5-6 Highlite colors for FFV, SDC and SDL. Same as above. char 7-8 Menu bar and scroll bar colors for FFV, SDC and SDL. char 9-10 Number of rows in screen in decimal. The normal screen has 25 rows. FFV checks low memory for the correct screen size but it may be necessary to use this on some computers. char 11-13 Number of columns in screen in decimal. The normal screen has 80 columns. If you just want to set the first one or two parameters you do not have to set the others, but you do have to specify any paramters occurring before the one you want to use. You will not be able to use the mode switching feature of FFV if you set the screen size. You can use your AUTOEXEC.BAT file to set PDQCFG when your computer is booted. DOS SCREEN COLOR CODES NORMAL BRIGHT / BLINK 0 BLACK 8 BLACK 1 BLUE 9 BLUE 2 GREEN A GREEN 3 CYAN B CYAN 4 RED C RED 5 MAGENTA D MAGENTA 6 AMBER E YELLOW 7 WHITE F WHITE If a number between 8 and F is used for a foreground color you will get bright text. If it is used for background you will get blinking text. PDQ COMMAND SUMMARY _______________________________________________________________________________ NAME: CC Change Color SYNTAX: cc Clears screen without resetting attributes. cc [/ab] fgnd [bkgnd [brdr]] Sets screen foreground, background and border colors. SWITCHES: a ANSI compatible mode. b Set foreground Bold attribute to ON. DESCRIPTION: CC sets the screen foreground, background and border colors to those specified by the user. The following colors are supported: BLACK RED GREEN YELLOW AMBER BLUE MAGENTA CYAN WHITE Because yellow is high intensity amber, it is impossible to have a yellow background. Border colors will vary with the type of monitor. If only a foreground color is specified the background color defaults to black. The border color always defaults to the background color. To change the background color you need to specify the foreground color. To change the border color you need to specify foreground and background colors. For ease of use CC will recognize the first three letters of any color name. For example: cc yel sets the foreground color to yellow with a black background and border, cc whi blu sets the foreground color to white and the background and border colors to blue, and cc red whi red sets the foreground color to red, the background color to white and the border color to red. The /b switch sets the intensity of the foreground color to high. For example: cc /b red sets the foreground color to high intensity red. If the screen is cleared after using CC, and ANSI.SYS is not installed, the screen will return to normal. This can be avoided by using CC without arguments to clear the screen, or by installing ANSI.SYS. If ANSI.SYS is installed, CC will detect it and generate the necessary escape codes. A /a switch has been provided to force ANSI mode if needed. See your DOS manual for more information about ANSI.SYS. NAME: FFV Friendly File Viewer SYNTAX: ffv [/bfw] [-##] [+###] [+\string] file1..filen Displays contents of files one page at a time. ffv dir Lists directory and allows you to choose file. SWITCHES: +### Begin displaying at line ###. +\string Begin displaying at first occurrence of string. -## Set display adaptor to mode ##. /b Write to BIOS instead of video memory. /f Pipe Standard Input to temp file and read. /w Wrap long lines. DESCRIPTION: FFV is a text file viewer which can be used to read files containing over 150,000 lines depending on available memory. Wild cards and multiple arguments can be used to view several files in sequence. For example: ffv *.doc can be used to page through all .DOC files, and ffv whats.new pdq.doc will first read WHATS.NEW, then PDQ.DOC. When FFV begins, it will display one page of text and then pause. The user can then enter one of the following commands: <space> Display next page of text. <PgDn> Clear screen and display next page. ^D, D, ] Display next half page of text. Enter or Display next line of text. Down Arrow <PgUp>, ^B Clear screen and display previous page. ^U, U, [ Move back one half page. Up Arrow Move back one line. Right Arrow Shift screen one tab stop right. Left Arrow Shift screen one tab stop left. H, Backspace Display help page. ^L, . Rewrite current page. Home Move to beginning of file. End or $ Move to end of file. N Display next file. P Return to previous file. F4 Select new file from directory. F5 Select new file by name. F6 Toggle line numbers. \ Search text for string. Ignore case. | Search text for string. Match exact case. / Search text for next occurrence of string. ? Search text for previous occurence of string. -### Move back ### lines. +### Move forward ### lines. ### Move to line number ###. Q, Esc Terminate the program. The escape key can be used to interrupt text searches and exit the help screen. It will also terminate the program from the main menu. F10 or Del can be used in place of Esc and ^PgUp and ^PgDn can be used in place of Home and End. The number of the top line is displayed on the menu bar unless the end of file message is visible, then the line number displayed will be the last line of the file. Unless the file is very small, you can use PgUp to realign the last page and get rid of the message. If the number keys are used to go to a line already on the screen, the screen will scroll until the line is at the top. Otherwise the screen will clear and a new page will be displayed. You can choose a new file by pressing F4. The current directory will be displayed and you can use the arrow keys to choose either a new file or a new directory. You can start the program in this mode by using a directory as an argument. Pressing F5 while in this mode will allow you to change the file mask and pressing F5 from the main program will let you enter a new file name. Pressing F6 will display line numbers. Text searches can be done by typing a "\" or a "|". You will then be prompted to enter a search string. FFV will begin displaying ten lines before the line containing the search string and the matching line will be highlighted. The "\" command will ignore differences between upper and lower case. The "|" command will find only strings having the exact case as the search string. Typing a "/" will find the next occurrence of the string and will work with either of the two previous commands. Typing a "?" will search back through the file for any previous occurence of the string. If the +\string switch is used, FFV will search the first occurrence of "string" before displaying. For example: ffv +\ffind dosnix.doc will scan DOSNIX.DOC for the first occurrence of "ffind" and begin displaying ten lines before the first matching line. Case sensitive searches can also be initiated from the command line. Because "|" is a DOS operator it will be necessary to put the argument in quotes. For example: ffv "+|FFIND" dosnix.doc When +### is used as a switch, FFV will begin displaying at whatever line number is given after the plus sign. For example: ffv +300 dosnix.doc will begin displaying at line 300. An option has been provided to change the mode of your display adaptor. To use this option type ffv -# filename where # is the number of the new mode in decimal. # can be any valid text mode and you should check the manual for your graphics card to see what modes are supported. Common text modes are listed below: Standard Text Modes Mode Card Format 0 CGA 40 X 25 Black & White 1 CGA 40 X 25 Color 2 CGA 80 X 25 Black & White 3 CGA 80 X 25 Color 7 Monochrome 80 X 25 Black & White EGA and VGA cards support all of the above modes but VGA does not distinguish beetween CGA Color and Black & White modes. Extended Text Modes Trident TVGA BIOS Mode Format 80 (50h) 80 X 30 81 (51h) 80 X 43 82 (52h) 80 X 60 83 (53h) 132 X 25 84 (54h) 132 X 30 85 (55h) 132 X 43 86 (56h) 132 X 60 Tseng ET-4000 Mode Format 34 (22h) 132 X 44 35 (23h) 132 X 25 36 (24h) 132 X 28 38 (26h) 80 X 60 The output of other programs can now be redirected to FFV using the /f switch. The syntax for this is: (program) | ffv /f This only works for programs that write to Standard Output. Redirected input will be stored in a temporary file before reading and the file will be removed when you exit FFV. As an experiment you can try: type whats.new | ffv /f Excessively long lines are normally truncated at the right side of the screen. You can use the Right Arrow key to shift the screen and read the remainder of the line. If the /w switch is used long lines will be wrapped and continued on the line below. The wrapped portion of the line will be given a new number so line numbers will not be accurate in this mode. For this and other reasons the F6 key is disabled when using line wrap. Lines are automatically wrapped if the screen is in 40 column mode. FFV normally writes a page directly to video memory, bypassing the BIOS screen write routines. The result is a much faster page. If you would like to have FFV write to the video BIOS instead, you can use either the /b switch or the "B" settine of PDQCFG as described above. If you have a CGA monitor which is prone to snow you may have to do this. NAME: GFF Gonzo File Finder SYNTAX: gff [/switches] [path] [+-=date] filename Finds all files in path with the same name. gff /e "command {}" [path] [+-=date] filename Executes DOS command when each file is located. gff /s "string" [path] [+-=date] filename Searches all copies of file for text. SWITCHES: a Include hidden and system files in search. c Continous scroll, no highlights. d Include directories in search. e Execute DOS command. f Include floppy drives in search. l display in long format, showing attributes, size, time and date. m Display totals for each directory. n Display output in lower case. r Remove files interactively. ru Remove files Unconditionally. s Search files for text. ? Display help screen. DESCRIPTION: GFF will search the specified path for all copies of a given file. "path" should be a valid directory name or drive spec. If "path" is omitted the search will begin from the root directory of the current drive. If "*:" is used for a path GFF will search all available hard drives. Wild cards can be used in file names and all subdirectories will be searched. For example: gff *.bak or gff \ *.bak will search the entire current drive for all files named with an extension of .BAK. gff d: temp will search all of drive D for all files named TEMP, gff *: temp will search all hard drives for all files named TEMP, and gff \games poker.exe will search the directory \GAMES and all subdirectories for all files named POKER.EXE. The /r switch can be used to delete files. For example: gff /r c:\ *.bak will search drive c for all files with an extension of .BAK and remove them. The user will be prompted before each file is removed. To delete files without verification use the /ru switch. GFF will locate hidden and system files with the /a switch but the /ru switch cannot be used to remove protected files. Use the /r switch to remove these files. The /l switch can be used to display complete information on each file located and the /c switch will disable highlights and screen pauses, allowing the output to be redirected. The /m switch will display the total number of matching files in each directory along with the total number of bytes used. For example: gff /almk c:\ *.* > disk.log will create a complete usage map of the user's hard disk and store it in DISK.LOG. When "*:" is used as a drive spec, GFF will ignore floppy drives unless the /f switch is used. This eliminates the annoying wait on empty floppy drives. Floppy drives can still be searched directly without using the /f switch. A semicolon can now be used to terminate a drive spec in place of a colon. In addition GFF will consider ";;" equivalent to "*:" and search all drives. These modifications save a few key strokes. NOTE: GFF uses the MSDOS LASTDRIVE parameter to determine the number of available drives. If GFF attempts to search non-existent drives insert the following line in CONFIG.SYS: LASTDRIVE = x where x is the letter of your last logical drive. GFF can also locate files based on date. The date parameter should be entered after any switches and before the path and file arguments. The date should be preceded by a "+", "-" or "=". For example: gff -07/04/91 *.* will locate all files created or modified since July 4th, 1991. gff /l +07/04/1991 *.txt will locate all .TXT files older than July 4th, 1991 and display them in long format. gff /ru =07/04/1991 d; *.* will locate and remove all files on drive D which are dated July 4th, 1991. GFF can now locate files by number of days back as well as actual date. For example: gff =5 *.* will locate all files created exactly five days ago and gff -5 *.* will locate all files newer than five days. The /e switch which will cause the program to shell to DOS and execute a command whenever a file is located. The command can be any valid DOS command or any executable program. The name of the located file can be parsed into the command argument by inserting a pair of braces wherever you want the file to be used. For example: gff /e "pkunzip {}" *.zip would unzip all the ZIP files on the current drive. If a null argument is used, GFF will shell to DOS in the directory in which the file is located, giving you an opportunity to do whatever you want. For example: gff /e "" test.txt GFF can also be used to search files for text. For example gff /s "four score" *.txt will locate all .TXT files containing the text "four score". The name of each file will be displayed along with each line containing the desired text. Text searches do not distinguish between upper and lower case. This switch is intended for use with text files and can not be used reliably with binary files. NAME: SDC Slick Directory Changer SYNTAX: sdc [/switches] [d:]dir1 Changes directory to dir1. sdc /mv dir1 dir2 Moves dir1 to dir2. SWITCHES: c Do not pause when screen is full. l Scan drive and list directories. m Create directory and update path file. mv Move directory and update path file. n Display directory tree without graphics. q Quick scan. Do not look for extensions. r Remove directory and update path file. s Scan drive. No screen output. t Display directory tree with graphics. ? Display help screen. DESCRIPTION: SDC allows you to change directories by entering only the directory name rather than the whole path name. For example, if you have a directory named \MODEM\FILES\ZIP you can reach the directory from anywhere on your drive by entering: sdc zip instead of: cd \modem\files\zip SDC can also find directories if given just the first few letters of the name. If you have a directory named \GAMES\POKER\BIGDECK, entering: sdc big will find it. If SDC finds more than one directory with the same name, it will display all directories found and prompt you to choose one. A new menu has been installed with both a selector bar and a speed search feature. To use speed search, enter the next letter of the directory name to narrow the search or use the backspace key to widen the search. SDC will locate directories on any hard drive without using a drive spec. To change to a directory on a floppy drive, or just to speed things up, you can enter the drive spec along with the directory name with no space or slash between them. For example if you are currently using drive C and you wish to change to B:\GAMES\BOARD\CHECKERS you can enter: sdc b:checkers or sdc b:check A drive spec can be terminated by a semicolon as well as a colon. This allows you to change drives without hitting the shift key. For example: sdc b;check To install SDC, copy SDC.EXE to the root directory of your boot drive or to any directory pointed to by the DOS PATH parameter. Then enter: sdc /s SDC will scan all hard drives for directories and store them in a file named PATH.SDC which is maintained in the root directory of drive C. Because SDC refers to this file to find directories, it should not be removed. To scan floppy drives you can enter: sdc /s d: where "d" is the letter of the drive you are scanning. If you are are using SDC with floppy disks it is sometimes more convenient to scan and change the directory in one step. For example: sdc /s a:text will scan the floppy disk in drive A and change to a directory named TEXT. SDC will automatically check for C:\PATH.SDC and scan your drives if it is not found. The /s switch can be used for updates. You can lock out undesired drives by setting the environment variable SDNOSCAN to the letters of the drives that you want to ignore. For example: set sdnoscan=df will cause SDC to ignore drives D and F. You can still change to these drives and SDC will work like the CD command. If a full path name or one of the standard DOS directory symbols ("\", "." or "..") is given, SDC will change directories immediately without checking PATH.SDC. If the /t switch is used, SDC will display the directory tree on your screen. The screen will pause after displaying each page of information and give you an opportunity to choose a directory. For redirection to non-IBM printers, the /n switch will display the directory tree without using graphics characters. The /l switch will display a list of directories instead of a tree. PATH.SDC will not be updated in these modes. The /l, /n, and /t switches are different from the /s switch in one other respect. If no drive is specified only the current drive will be scanned. If the /s switch is combined with any of these switches all hard drives will be scanned. If none of your directory names have extensions you can use the /q switch with any of the above switches for quicker scans. For example: sdc /sq or sdc /tq The /m and /r switches can be used to create and remove directories. Rules for path names are the same as for DOS and PATH.SDC will be updated after each change. If other commands are used to create and remove directories you will have to rescan the affected drive. The /r switch will clean out the directory and recursively remove all subdirectories before removing the directory itself. A /mv switch has been added to relocate directories. Old and new directories no longer need to be in the same parent directory but still need to be on the same drive. You can move directories to a different drive by using XCOPY to copy the directory and then using SDC to remove the old directory. NOTE: SDC uses the MSDOS LASTDRIVE parameter to determine the number of available drives on your system. For best performance insert the following line in CONFIG.SYS: LASTDRIVE = x where x is the letter of your last logical drive. NAME: SDL Slick Directory Lister. SYNTAX: sdl [/switches] [dir] Displays contents of dir SWITCHES: 2 Display two entries per line with size and date. 4 Display four entries per line showing size only. a Display hidden and system files. c Continuous scroll, no highlights. e Sort file names by extension. f Display files only. Omit directories. k Do not pause when screen is full. l Display files in long format, showing name, attributes, size, time and date. n Display file names in lower case. r Reverse order of sort. t Sort files by time and date. u Do not sort files. x Display files sorted across screen. z Sort files by size. ? Display help screen. DESCRIPTION: SDL displays the contents of a directory sorted down the screen in five columns. The arguments can be either files or directories. If wildcards are used, all matching files will be listed. Multiple arguments are accepted and more than one directory can be displayed. If no arguments are used, the contents of the current directory will be displayed. File totals will be displayed at the bottom of the listing. The /x switch will display files sorted across the screen and is useful when there are too many files for one page. If the /l switch is used, one entry per line is displayed, showing name, attributes, size of file in bytes, and time and date of last modification. Attributes displayed in this format are: <DIR> Subdirectory. A Archive bit is set. R File is read only. H File is hidden. S File is system. At the end of each display the size of the directory in bytes is shown. The size of any subdirectories is not included in this figure. Also shown is the remaining disk space. SDL now has two new display formats. The /2 switch will display two entries per line showing file size and date and the /4 switch will display four entries per line showing size only. In these two modes the files are sorted down each column. The /x switch can be combined with either of these switches to display files sorted horizontally. SDL will pause after displaying one page of information. Typing "q" at this point will terminate the program. Typing any other key will continue the display. The /c switch will suppress this feature and provide a continuous output which can be redirected. In addition, the /c switch will eliminate any graphics characters, allowing the output to be redirected to a non-IBM printer. If the /a switch is used, any hidden or system files contained in the directory are also displayed. The /f switch will display file names only and omit any subdirectories. The /t switch will will sort files by time and date and can be used with the /r switch to display newest files first. The /e switch will sort file names by extension and the /u switch will provide unsorted output if so desired. The /n switch will provide lower case output if needed. SDL will accept either directory names or file names as arguments. If a directory name is given SDL will display the contents of that directory. If a file name is given, SDL will display only the given file name. This feature can be used with wild cards. For example: sdl *.txt will display all files in the given directory with an ex- tension of .TXT. More than one file or directory name can be given as an argument. For example: sdl *.c *.exe will display all files with an extension of .C or .EXE while sdl \bin \pdq will first display the contents of \BIN then the contents of \PDQ. SDL can be custom configured by setting the environment variable "SDL" to the desired switches. For example: set sdl=le will cause SDL to default to the long format, with files sorted by extension, unless a switch is specified on the command line. SDL is SDC compatible and, if SDC is installed, SDL will accept partial directory names. SDL will first look for an immediate directory with the specified name. If no directory is found it will check PATH.SDC for any matches. If no matches are found it will then check for a file with the given name. When using this feature the user is limited to one argument. If more than one directory is specified on the command line, PATH.SDC will not be searched. This feature has been made invisible so that SDL can still be used as a stand-alone directory lister. As a result no error messages relating to SDC or PATH.SDC will be displayed. SDL will not recursively list subdirectories but the Gonzo File Finder can be used to obtain the same result. For example: gff /lm dirname *.* gff /m . *.* ABOUT SHAREWARE Shareware distribution gives users a chance to try software before buying it. If you try a Shareware program and continue using it, you are expected to register. Individual programs differ on details -- some request registration while others require it, some specify a maximum trial period. With registration, you get anything from the simple right to continue using the software to an updated program with printed manual. Copyright laws apply to both Shareware and commercial software, and the copyright holder retains all rights, with a few specific exceptions as stated below. Shareware authors are accomplished programmers, just like commercial authors, and the programs are of comparable quality. (In both cases, there are good programs and bad ones!) The main difference is in the method of distribution. The author specifically grants the right to copy and distribute the software, either to all and sundry or to a specific group. For example, some authors require written permission before a commercial disk vendor may copy their Shareware. Shareware is a distribution method, not a type of software. You should find software that suits your needs and pocketbook, whether it's commercial or Shareware. The Shareware system makes fitting your needs easier, because you can try before you buy. And because the overhead is low, prices are low also. Shareware has the ultimate money-back guarantee -- if you don't use the product, you don't pay for it. DISCLAIMER - AGREEMENT Users of PDQ must accept this disclaimer of warranty: "PDQ Utilities 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 conse- quential, which may result from the use of PDQ Utilities." PDQ Utilities is a "shareware program" and is provided at no charge to the user for evaluation. Feel free to share it with your friends, but please do not give it away altered or as part of another system. The essence of "user-supported" software is to provide personal computer users with quality software without high prices, and yet to provide incentive for programmers to continue to develop new products. If you find this program useful and find that you are using PDQ Utilities and continue to use PDQ Utilities after a reasonable trial period, you must make a registration payment of $25.00 to the author. The $25.00 registration fee will license one copy for use on any one computer at any one time. You must treat this software just like a book. An example is that this software may be used by any number of people and may be freely moved from one computer location to another, so long as there is no possibility of it being used at one location while it's being used at another. Just as a book cannot be read by two different persons at the same time. Commercial users of PDQ Utilities must register and pay for their copies of PDQ Utilities within 30 days of first use or their license is withdrawn. Site-License arrangements may be made by contacting the author. Anyone distributing PDQ Utilities for any kind of remuneration must first contact the author at the address below for authorization. This authorization will be automatically granted to distributors recognized by the Association of Shareware Professionals as adhering to its guidelines for shareware distributors, and such distributors may begin offering PDQ Utilities immediately (However the author must still be advised so that the distributor can be kept up-to-date with the latest version of PDQ Utilities.). You are encouraged to pass a copy of PDQ Utilities along to your friends for evaluation. Please encourage them to register their copy if they find that they can use it. Fully registered users will receive a copy of the latest version of PDQ Utilities along with several free bonus utilities. To register your copy of PDQ Utilities or to purchase a site license, fill out the form and mail it to the author at the address below: Gerald M. Vrooman 6400 NY Rt 79 Chenango Forks, NY 13746 PDQ REGISTRATION (ver. 1.40) NAME: ____________________________________________________________ ADDRESS: ____________________________________________________________ ____________________________________________________________ ____________________________________________________________ ____ Full registration @ $25.00 (Includes a copy of the latest version and free bonus utilities.) ____________ ____ Basic Site License @ $65.00 (Up to three computers) ____________ ____ Additional computers @ $20.00 ____________ Total amount enclosed ____________ Please circle one: 5.25" disk 3.5" disk