Black Box 4

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

/ Black Box 4 / BlackBox.cdr / dskstruc / hd_util.arj / HD_U.ZIP / HDUHLP.DOC < prev next >

Wrap

Text File | 1991-09-16 | 28.2 KB | 684 lines

* -------- Hard Disk ----- - Documentation ----- Utilities ------- Copyright 1986, 1987 Philip Karras/Circle Software 1988, 1989 P.O. Box 74 1990, 1991 Mt. Airy, MD 21771 To get on line help, type: "hduhlp" & the name of the program you need help with. phelp FORM: hduhlp utility-name (RETURN) UTILITY NAMES: ap | chkfile | dsptxt | find_ | log | pcopy | adp | clrcrt | dt | findf | mode80 | rdf | ats | cursor | eof | fk | mmd | run_it | cdd | dele | fe | kf | pcomp | view | | dsd | finda | | | | | | | | | | ═════════╧═══════════╧═══════════╧═══════════╧═══════════╧═══════════╛ ADP: Adds Delete (rearrange) PATH, paths. ATS: Changes or reads file atributes. CDD: Changes drive and directory with one command. CHKFILE: Runs DOS CHKDSK to fix unlinked clusters; views, deletes, or saves found files. CLRCRT: Clears the CRT, prevents burn-in. CURSOR: Allows one to set cursor on/off and size, except DOS 3.3X. DELE: Deletes all file(s) except file(s) named. DSD: Deletes Sub-Directory. DSPTXT: Displays a text file, can find text in the file. DT: Sets, re-sets a file's date and time. EOF: Places DOS EOF char (dec 26) at the end of a file. FE: Front End Circle Software searches can be added to any other program. FINDA: This is a combination of FINDF and PFIND. It will first locate all the files it can and then check each of them for the string of interest. FINDF: This program finds files on a disk. It finds all files whose names contain the string of interest, irrespective of their location in the file name. It has a BATCH switch to help in backing up sub-dirs. FIND_: Finds lines that have the searched-for string and prints them as they are in the file. The case ignore mode is the default mode. (FINDL is the interactive version of FIND_.) FK: Fast Key changes delay and repetition rates. KF: Kills Files - ANY files, even protected files. LOG: Keeps log of date and time. Password to protect computer. MMD: Make and Move to Directory. MODE80: Switches the screen back to 80(characters) x 25 lines. PCOMP: Compares files using partial file names and/or dates. PCOPY: Copies files using partial file names and/or dates. RDF: Redirects files between drives:\paths. Uses RED, DOS COPY, and DOS COMP. RED is NOT supplied by Circle Software. RUN_IT: Finds a program in any DIR and runs it. (Path not needed) VIEW: Allows the displaying of ASCII files; uses DSPTXT or your display/editor program. * ------------------------- ADP - Documentation ------------------------ ------------------------- AP - Documentation ------------------------- ADP - Add Delete Path. Uses the DOS PATH= command to set up the DOS programs path. This is the path(s) searched for executable programs. (See your DOS manual for more information on PATH=.) FORM: adp drive:\path [switch(es)] or adp SWITCHES: /k - Kill, (remove) this path from PATH. If only "adp (RETURN)" is used, adp enters into its interactive mode. One may enter new paths, delete paths, and rearrange paths in this mode. NOTE: ADP is a batch file (ADP.BAT) that runs AP.EXE & then PTH.BAT which is created by AP.EXE. It then deletes PTH.BAT. * ---------------------- ATS - Documentation ------------------------ ATS - File Attributes program. This program allows one to view and change file (and sub-directory) attributes. The four file attributes are: Archive, System, Hidden, and Read Only. FORM: ats drive:\path\file-name [switch(es)] SWITCHES: /all- Set ALL the attributes. /c - Clear ALL the attributes. /a? - Archive attribute is set or cleared when ? is + = Set Archive attribute - = Clear Archive attribute /d - Two meanings: /d = check sub-directories /d?YYMMDD = the normal date type checking switch. /h? - Hidden attribute is set or cleared on ?. /r? - Read Only attribute is set or cleared on ?. /s? - System attribute is set or cleared on ?. /w - Wait for key-press if 20 lines on screen. If none of the attribute switches are set, then a listing will be made of the files and an indication of which attributes are set will be displayed beside each file name. * ---------------------- CDD - Documentation --------------------- CDD: Change Drive and Directory. This program will change both in one operation. Also, it will do its best to find the path given, even if only a partial path was given. It first searches the present path, and moves down one step at a time until the ROOT directory is reached. Then it initiates a complete search for the unfound path. switches: /a - find all matching paths & allow selection. /D? - Multiple DRIVE switch, /Dabc = find on drive A, B & C. EXAMPLE: to switch to \WP\MY\DOC from \WP\MY\LETTERS\WORK type: CDD doc (RETURN) * -------------------- CHKFILE - Documentation ------------------- CHKFILE: This program (in conjunction with DSPTXT also on your Pfind Utilities disk) and CHKDSK which came with your copy of DOS, will allow you to check your disks, create files from the unlinked clusters found (if any) and view the files named: FILE####.CHK, delete them or rename them. Files named FILE0000.CHK through FILE9999.CHK are created by the DOS program CHKDSK when the /f fix-switch is used and if there are unassigned data sections on the disk, CHKFILE can run CHKDSK in this mode if you tell it to do so at the question "Run CHKDSK Y/N?". The CHKFILE program is an easy way to run CHKDSK and then review the created files and make your decision to save or delete these files on the spot. This saves typing in the file names if there are a number of these files. SWITCHES: /c#.# - color switch fore.back-ground colors (Will use AMSCRT.DAT colors or will attempt to use the colors set from your AUTOEXEC.BAT file if any.) FORM: chkfile [switch(es)] EXAMPLE: chkfile /c7.1 * -------------------- CLRCRT - Documentation ------------------- This program clears the CRT completely & waits fo almost any key to be pressed. This will help keep your CRT from suffering from "burn-in". The computer can be left on & the CRT will be blank. * -------------------- CURSOR - Documentation ------------------- If you have a program that returns to DOS & turns the cursor off, then use this program to turn it back on. FORM: cursor [ # # ] or [switch] (RETURN) switches: /n - turn cursor on /f - turn cursor off first # - starting scan line (to change cursor size) second# - ending scan line (to change cursor size) To turn cursor on: cursor /n To make block cursor: cursor 0 7 (for CGA) To make block cursor: cursor 0 15 (for MONO) NOTE: CURSOR will not work under DOS 3.3X, and under some BIOSes. Best advice, try it and see. * ---------------------- DELE - Documentation ----------------------- This program will DELete all files Except the file(s) named. Form: dele drive:path\filename(or part) switches Example: dele c:\temp\*.txt /q /db870717 In the above example files that do NOT have the extension "txt" and have dates AFTER July 17, 1987 will be deleted. Switches: /a - Delete files from ALL sub-paths of designated path. /as - As-is switch, delete all but this exact name. /d? - date switch, form: /d?YYMMDD ? = a or b a = (this date & above), b = (this date & below) /n - delete in the NORMAL fashion. Delete those files that DO have the filename given & or the date given as indicated. /q - ask question for each delete. /s - Skip main "ARE YOU SURE" question. * ---------------------- DSD - Documentation --------------------- Delete Sub-Directory - will delete the sub-directory named by deleting all files in all sub-directories within the named sub-dir and removes the now empty sub-directoies. (NEEDS DELE.EXE) Switches: /q - question each file to be deleted /d?YYMMDD - ? = a/b = above/below date given, including date. * --------------------- DSPTXT - Documentation ------------------ FORM: dsptxt drive:\path\file-name [[/c##,##]] [[/switches]] Switches: /a# -- Protect lines above this line number (lock titles.) /b#.#- Banner (#.# = colors, optional), if /a# used FIRST. /c#.#- Color, fore.back-ground colors , or . allowed. /f[text] - display file & auto FIND this "text". /l## - Protect columns to the left of the column. /nlr - No Left/Right movement /r## - Only active if /l## used: The is the RIGHT column to START at in the right-hand-left/right movement window. DSPTXT now allows lines up to 256 characters in length, lines longer than 256 characters wrapped. 80 columns will be showen at one time. Use of the Left/Right arrows moves the text from right to left. Pressing the SPACE-BAR will activate a second HELP line for left/right movement. Search inputs are limited to 70 characters. * ----------------------- DT - Documentation --------------------- DT - Date Time Stamp Changing program. This program allows one to correct an incorrect data and time stamp on any file. SWITCHES: /w - Wait for key-press after 20 lines on screen. FORM: dt drive:\path\file-name [MM/DD/YY] [HH:MM:SS] [switch(es)] NOTE: File-name: the file-name follows the same form as with all the other Pfind Utilities. That is, all files will be found that have the contiguous letters specified as "file-name". For example, specifing ADE as the file-name will cause files such as: ADEme.exe, coolADE.doc, and help.ADE to all be found. One can use the characters * and ? as with normal DOS type commands. HH: The hours must be given in 24-hour clock mode. Thus, 6 PM would need to be entered as: 18. * --------------------- EoF - Documentation --------------------- This program simply places a DOS EoF character (dec 26) at the end of a file. Switches: none Forms: eof filename.ext eof \path1\path2\name.ext * ------------------------ FE - Documentation ----------------------- FE - Front End. Use this to add Circle Software file finding methods to any other program. Switches: /a - ALL PATHS SEARCHED! /D?- Multiple DRIVE switch, /Dabc = find on drive A, B & C. /d - Date switch, form: /d?YYMMDD for July 14, 1987 and above it would be: /da870714 ? == a (above) - b (below) indicator. If two dates are given (above = & below =) then only files with dates between & = to these dates will be found. /e - Extension name search/match only. /p - Program to pass this stuff to switch. FORM: /p prgm-name [[any switches]] EVERYTHING after /p is passed to the program to be run by FE. /q - Question each operation to be performed. /s - switch to each path as match is found. Example: fe txt /a /da890901 /db890930 /p[dsptxt * ---------------------- FINDA - Documentation ---------------------- FINDA first locates a file whose name matches the given search name & then searches the files for the sting of interest. If found it then prints the drive: path\file.name & five (5) lines. The line of interest is in the middle. Switches: /A#.# - Auto goto list of finds. Put it at #.# = strt.end lines. /a - search for ALL matches in a file (not just one). /b - Beep off, a beep normally sounds when a match is found. /D? - Multiple DRIVE switch, /Dabc = find on drive A, B & C. /d? - Date Check switch, form: /d870714 == July 14, 1987. ? = a (date >= ), or b (date <= ). /E[name] = Enter name of editor or dispaly program. /E[edlin]. /E[editor /sw-/sw/-sw] /sw == a switch if needed. /e - Extensions (on the file name) checked ONLY. /f - List out all file names & paths for files searched. /h - Hi-light matching line. /i - case NOT Ignore - string search is case dependent. /k - Sequential KEYWORD search. /l - Relative Line number of matched line printed (###). /m - print more lines, 17 lines, 8 above & below. /m#.# - position line/col of "searching..." message. /n - Never mind - Print first lines no checking of string. /o - Bytes, date time information Off - not printed. /s - Print '*' between information blocks - delimeter/separator /w - Wait for key-press after 20 lines printed to screen. /z - Send DOS EoF indicator "ctrl-z" at end of program. /1 - Search only this (or indicated) directory. Example: finda d:\path\MSS The Congress Passed /e /a /b /l * ---------------------- FINDF - Documentation -------------------- The difference between this program and many others is that one need not enter any globals or wild cards to find EVERYTHING that matches! Example: findf d:\path\FI The above example will find all files on drive D:\path\ that have the letters FI in the file name. Irrespective of the location of these letters in the file name. switches: /a - Puts paths in front of ALL found files /b - BATCH file creator /D? - Multiple DRIVE switch, /Dabc = find on drive A, B & C. /d? - Check DATE >= in form: /d870714 == July 14, 1987. ? = a (date >= ), or b (date <= ). /e - Check EXTENSIONS only /f - List FREE bytes only /k - KILL switch, batch files: to DEL or ERASE files. /m - More lines to display switch, 43 lines for EGA screens. /n - No screen display. /o - Turns bytes/date/time stamp OFF, they are not printed. /p - PATHs only listed. /s - List SUB-DIRECTORIES too. /t - List ALL files and their attribute settings (More below). /v - View found file list, uses DSPTXT. /vs - Save found file list, after viewing it using DSPTXT. /w - WAIT! after 20 lines printed to screen for key-press. /y - YES auto erase - for KILL batch files only! /z - Send DOS EoF indicator "ctrl-z" at end of program. /1 - Search only ONE dir, the one named. /5 - List files five at a time then a blank line. /t? - List ALL files and their attribute settings. (optional) ? = r/h/s/a and [+/-] read only, hidden, system, archive. (optional) + = list only those that match with attribute set. (optional) - = list only those that match with attribute clear. EXAMPLE: /th+ = list files that are hidden. /ts+ = list system files. /tr- = list unprotected files (not read-only). * ---------------------- FINDL - Documentation ---------------------- Functions exactly like find_, or may be used in interactive mode by starting the program with just its name on the DOS command line. (Not in the Shareware Version to conserve disk space) * ---------------------- FIND_ - Documentation ---------------------- This file is functionally like the DOS find program. It finds a line that has the searched for string in it. It then prints this line to the CRT. The differences are: The first input is the file name & the second is the string to match up. The third + positions are for the optional switches: SWITCHES: /c - Count the lines that have a match - NO printing. /i - Case NOT Ignored switch. /k - Sequential KEYWORD search. /n - Relative number of line precedes printed line. /o - Beep Off - no beep sounds when a match is found. /r - Send RETURN between lines. /v - Prints lines that do NOT match string. /w - wait - pause after 20 lines (for a key press). /z - Send DOS EoF indicator "ctrl-z" at end of program. EXAMPLE: find_ file.txt this is the string to match /c /i * ------------------------ FK - Documentation ---------------------- FK - The FAST KEY utility will allow you to change the repeat speed of your keyboard, as well as the delay factor. Normally a held down key will start repeating after a delay of half a second, and repeat the key 10 times a second. To use FK the form is: FL ## # (RETURN) The first ## is the number of repeats per second wanted (in increments of 5, from 5 to 30). The second # is for the number of quarter seconds in the delay. EXAMPLE: We want 25 repeats per second after a delay of three quarters of a second, use: FK 25 3 (RETURN) * -DANGER-*-*-*-*-------- KF - Documentation --------*-*-*-*-DANGER- * DANGER * DANGER * DANGER * DANGER * DANGER * DANGER * DANGER * DANGER * KF: This program will KILL any file or sub-directory! EVEN if they are PROTECTED by the normal DOS protection attributes! The DOS protection ATTRIBUTES are called: Read Only, System, and Hidden. These protection bits WILL NOT PROTECT a file being deleted by KF (KILL FILE). There is only ONE exception to this statement, and that is that KF will NOT KILL a sub-directory that is not empty first. SWITCHES: /d?YYMMDD - date switch ? = a/b after/before. /a - all subsequent sub-directories. /s - sort file names alphabetically. /x - group file names by extension. FORM: KF drive:\path\file-type /d?YYMMDD /a EXAMPLE: KF b:\tmp\my /a This will list all files in all paths starting with B:\TMP which have "MY" in the file name. You may exit the program without deleting any file, and you get three chances to get it right. WARNING: Once you press ''K'' to KILL the files, they are GONE! NOTE: There are utilities that allow recovery of deleted files KF (Kill File) does NOT overwrite the deleted data areas so these programs may be able to recover the Killed data. ATTRIBUTES: D - Directory s - System h - Hidden r - Read Only a - Archive (NOT a protection bit, but tells if it needs to be backed up or not.) * ----------------------- LOG - Documentation -------------------- LOG: This program keeps a log file (called: "LOG") of every time it is run. It will normally request a password from the user and if it is not correct, it will lock up the computer so that it must be re-booted. It can also be used in BATCH files (like AUTOEXEC.BAT) and along with the Advanced Menu System (also by Circle Software) to allow only qualified persons access to various sections of the hard disk. SWITCHES: /c#.# - color switch fore.back-ground colors (will use AMSCRT.DAT if it is found. This is the Advanced Menu System screen file) /npw - No PassWord required, just keeps a log /fwr - Fail with return (used in BATCH files, will fail on the first false password entry and return an ERRORLEVEL of 254 to the BATCH file to act on.) /ncr - No Copyright display, no clearing the screen. FORM: log [drv:\path] [switch(es)] * ---------------------- MMD - Documentation --------------------- Make and Move to Directory: This program will make a directory on the present drive or on the directed drive and then move to it unless told NOT to. FORM: mmd drv:\path (RETURN) EXAMPLE: mmd d:\wp\joe\memos if \wp\joe is not a valid directory mmd will make: d: d:\wp d:\wp\joe d:\wp\joe\memos and then switch to drive d & the directory just made. SWITCHES: /s - If making a new directory on the present drive, do NOT switch to it. If making it on a different drive, do NOT switch to the drive but switch the active directory on that drive to the new one made. /ss- If making a directory on a different drive do NOT switch to that drive AND do NOT change that drives active directory. * -------------------- MODE80 - Documentation -------------------- Mode80 : To use type mode80 (RETURN) Will change the screen back to the 80 character wide color mode. Switch: /m - monochrome mode If Pmenu has been run in the 40 Character SAVE mode & you then use the DOS "mode 80" command & a program that should run in color is not doing so, try using this program. type: mode80 To force the 80 character monochrome mode type: mode80 /m DOS comes with a command called "MODE" - it can set 40/80 characters, color or Black & White, or MONO. Look in you DOS manual for its use. * -------------------- PCOMP - Documentation -------------------- This program will compare files like the DOS comp function. It is different in that one can give it simply a few letters that are in the file name & it will then find all files with those letters in the file name & compare them. Note: PCOMP uses the DOS function COMP. Switches: /a - Compare files in ALL PATHS from start. /b - beep when done. /c - Clear the screen after done. (Protects from burn in.) /d? - Date switch, MUST be followed by the date in the form: /da870714 which is July 14, 1987. ? = a or b, a: date = or After, b: = or before. /e - check file and EXTENSION only for match & compare. /f - Force file search ignor paths of same name. /h - here, copy to target drive:\path, don't make paths. /q - Question each copy to be. /l - List to disk all non-matches found. (This list can then be viewed later from file "NOMATCH") /n - No pause when non-match found. (Good to use in conjunction with /l above.) Forms: pcomp pc b: pcomp pc \utils pcomp \utils\pc b:\help * -------------------- PCOPY - Documentation -------------------- This program will copy files like the DOS copy function. It is different in that one can give it simply a few letters that are in the file name & it will then find all files with those letters in the file name & copy them. Note: PCOPY uses the DOS function COPY. Switches: /a - Copy files in ALL PATHS from start & make them on. target drive. /b - beep when done. /c - Clear the screen after done. (Protects from burn in.) /d? - Date switch, MUST be followed by the date in the form: /da870714 which is July 14, 1987. ? = a or b, a: date = or After, b: = or before. /e - check file and EXTENSION only for match & compare. /f - Force file search ignor paths of same name. /h - here, copy to target drive:\path, don't make paths. /q - Question each copy to be. /v - Verify /z - Place DOS EoF (26) at end of copied file Forms: pcopy pc b: pcopy pc \utils\ pcopy \utils\pc b:\help * ---------------------- RDF - Documentation --------------------- This program uses the RED program distributed through PC-Magazine and the DOS COPY and DOS COMP programs to help "redirect" files from one directory to another, and from one drive to another. RDF uses the Pfind Utilities file name matching methods, and will "move" entire directories and their sub-directories from drive to drive. FORM: rdf (file-name) (target drive:\path) [switches] () = MUST have, [] = optional SWITCHES: /a - All paths from designated one to same in target. /a1 - All paths from designated one to ONE target path. /d?# - date ? = a(bove) or b(elow) flags. (V1.30) /i - User interactive mode. /k - Keep these files, do NOT delete them. (only works between drives.) /s - Sort list alphabetically. /u - User interactive mode. /x - Group list by extensions. * -------------------- RUN_IT - Documentation ------------------- This program tries to run the given program. It searches ALL directories of the present disk drive. If the program is found, run_it will switch directories & run the program. When the running program terminates, run_it will switch back to the indicated, or present, sub-dir and exit. If NO program is found, run_it exits with ERRORLEVEL = 1, otherwise it exits with ERRORLEVEL = 0. Form: run_it filename.ext [path] [p/switch] [/switch] Filename: MUST have an extension! Extension MUST be either EXE or COM. path: MUST start with "\". This is the path to RETURN to. p/switch - are switches that are to be passed to the program to run. /switch are run_it switches. SWITCHES: /c##,## - color, foreground, background. Decimal #'s. /p - Print, to printer, the path where the program was found. * ---------------------- VIEW - Documentation ------------------- This program works like KF (Kill-File) except that it only allows the viewing of the found files. FORM: view (drive:\path\file-name) [switches] () = MUST have, [] = optional SWITCHES: /a - All paths from designated one. /d?# - date ? = a(bove) or b(elow) flags. (V1.30) /s - Sort list alphabetically. /x - Group list by extensions. *