home *** CD-ROM | disk | FTP | other *** search
/ High Voltage Shareware / high1.zip / high1 / DIR2 / DTA21.ZIP / DTA.DOC < prev   
Text File  |  1993-12-21  |  19KB  |  363 lines
  1.  
  2.                                    DTA.DOC
  3.                                    -------
  4.                            Instructions for DTA.COM
  5.                            Version 2.1 (21 Dec 1993)
  6.  
  7.                              (c)1987-93 E. Meyer
  8.  
  9.  
  10.      DTA.COM is a versatile directory utility that will run on any PC with DOS 
  11. 2.x or higher.  "DTA" stands for Directory-Tree-Attributes; it is a 
  12. replacement for the DIR, TREE, and ATTRIB commands of DOS, as well as a file 
  13. finder and viewer.  Though small, DTA has many features including:
  14.  
  15.     *  alphabetized color directory with file sizes and free space
  16.     *  optional wide mode or full mode (with attributes and time/date)
  17.     *  select items by exclusion, attributes, time/date, or file size
  18.     *  display several groups of files, or all except certain files
  19.     *  change attribute or time/date data for items selected
  20.     *  treat directories either separately or together with files
  21.     *  alphabetized compact directory tree; optional full mode with sizes
  22.     *  search entire drive (all directories) for files
  23.     *  view initial text in readable files to help identify contents
  24.     *  user-customizable with desired options, colors, etc
  25.  
  26.      The syntax and options of DTA are compatible with my ARCOPY (archive/ 
  27. copy), DIRCMP (directory compare), and DLT (delete) file utilities, which work 
  28. well together.
  29.  
  30.  
  31. --------------------------------- USING DTA ----------------------------------
  32.  
  33. SYNTAX:    A>dta {fspec1} {{,}fspec2...} {/options}           ("{}"=optional)
  34.  
  35.         where  each "fspec" may include a drive, path, or wildcards;
  36.                either spaces or commas may separate multiple filespecs;
  37.                "/" is the delimiter for option letters.
  38.  
  39.      If the drive or path is omitted from the first filespec, it defaults to 
  40. the current DOS value; for subsequent ones, to the same as the previous one.  
  41. If the filespec is omitted it defaults to "*.*".  If it is a directory name, 
  42. the contents of the directory are displayed.
  43.      Options are discussed in detail below.  If none are specified, you will 
  44. get a compact, informative directory display.
  45.  
  46.      While running, DTA ignores keystrokes like ^S or ^C, except when paused 
  47. at the end of the page, when you can use ^C to abort if desired.  Output can 
  48. be directed to a file or other device in the standard fashion:
  49.                 A>DTA FILESPEC /OPTIONS >DEVICE.
  50. But if you are using color output, you must disable it with the /M option or 
  51. redirection will not work.
  52.  
  53.  
  54. -------------------------- INTERPRETING THE DISPLAY --------------------------
  55.  
  56.      SIZES are measured in kilobytes (1k is 1024 bytes) or megabytes (1m is 
  57. 1024k, or 1,048,576 bytes).  Directory entries are identified as "Dir"; sizes 
  58. are reported for files only.  DTA displays them in kilobytes up to 999k; 
  59. beyond that, to the nearest tenth of a megabyte (1.0m, etc).  The "items 
  60. total" amount is simply the sum of the individual file sizes shown; the "items 
  61. use" amount is the total disk space those files actually occupy.  If any 
  62. directories are shown, the sizes of their contents are not included.
  63.      Because allocation clusters on a disk can vary from 128 bytes (on a 
  64. RAMdisk) to 4k (on a hard disk), the space consumed by each file can be a 
  65. fraction of a k less or several k more than its displayed size; thus, 
  66. depending on disk media, the "use" amount may be a bit less, or significantly 
  67. more, than the "total" of the displayed sizes.  The "used/free" space shown by 
  68. DTA is for the entire drive.
  69.  
  70.      ATTRIBUTES, when displayed, show as a letter ("A,H,R,S") if set, or as 
  71. "." if clear.  The Archive attribute indicates to a backup utility that a file 
  72. has been changed recently, and needs to be backed up; the bit is cleared by 
  73. the utility when it does so.  (Simple backup utilities that work well with DTA 
  74. include the DOS XCOPY command, and my own ARCOPY.COM.)
  75.      The Read-only attribute prevents a file from being changed or deleted, 
  76. though it can be read and copied.  The Hidden and System attributes both 
  77. exclude items from normal searches: they cannot be accessed at all by ordinary 
  78. MSDOS file commands.  The DOS DIR command does not show hidden files like 
  79. MSDOS.SYS and IO.SYS, but DTA will (unless you use the options "/hs").
  80.  
  81.      TIME/DATE, when displayed, appear in the appropriate format for your DOS 
  82. country setting, unless you have customized DTA.COM, or used a different entry 
  83. format (Euro,Num) with the /B,/L,/@ options.
  84.  
  85.      FILE TEXT, when displayed, appears in an abbreviated format with many 
  86. duplicate or non-alphabetic characters filtered out.  If the initial part of a 
  87. file contains a sizable proportion of binary (non-alphabetic) data, DTA will 
  88. not attempt to display it, reporting "Bin" instead.
  89.  
  90.                                SAMPLE DISPLAYS
  91. C:\WORK>dta dta.* /fn
  92.  
  93. Volume HDRIVE-C       created  5/23/90   Directory C:\WORK
  94. DTA     .COM   7k A... 11:33p  8/29/92   DTA     .DOC  17k A... 11:42p  8/29/92
  95. 2 items total 24k, use 26k.  Drive has 27.1m used, 4.8m free (15%)
  96.  
  97. C:\WORK>dta dta.* /v
  98.  
  99. Volume HDRIVE-C       created  5/23/90   Directory C:\WORK
  100. DTA     .COM   7k  uDTA 1.8 (c) E. Meyer 29 Aug 1992HSYNTAX: A>dta {fspec1} {,}
  101. DTA     .DOC  17k  DTA.DOC - Instructions for DTA.COM Version 1.8 (29 Aug 1992)
  102. 2 items total 24k, use 26k.  Drive has 27.1m used, 4.8m free (15%)
  103.  
  104.  
  105. -------------------------------- DTA OPTIONS ---------------------------------
  106.  
  107.      By default, DTA will display a list of all files specified, along with 
  108. their sizes, and some disk space information.  However, options are available 
  109. to do a wide variety of other things.  One slash "/" must precede any options; 
  110. further slashes may be used or not, as desired.
  111.  
  112.      /? = help.  Gives version message, brief summary of usage and options.
  113.  
  114. These options scan an entire drive, instead of the contents of one directory:
  115.      /T = tree: display tree, starting at specified or current directory.
  116.      /G = global: search for specified files throughout the tree.
  117.  
  118. These options affect the contents of the display:
  119.      /F = full: for directory display, show attributes and time/date also.
  120.                 for tree/global search, show file size information also.
  121.                 for text view, show a second line of text.
  122.      /W = wide: just like DIR /W, five columns of filenames only (no sizes).
  123.      /V = view: show single column display with view of initial file text.
  124.  
  125. These options affect the format of the display:
  126.      /O = order: order items by row instead of column.
  127.      /N = narrow: use only half the usual number of columns.
  128.      /M = mono: use monochrome output instead of color.
  129.      /P = no pause: don't pause for keystroke after each full screen.
  130.  
  131. These options determine which items are selected:
  132.      /X = except: select only items other than those named.
  133.      /D = directories: select directories instead of files.
  134.      /U = universal: select both directories and files.
  135.      /B = before: select files before specified date,time.
  136.      /L = later: select files later than specified date,time.
  137.      /K = size: select files by specified size ("+"=greater, "-"=less).
  138.      /A,H,R,S = select only items with the specified attributes:
  139.                  Archive; Hidden; Read-only; System.
  140.      /a,h,r,s = select only items WITHOUT these attributes.
  141.  
  142. These options change the DOS directory information for items selected:
  143.      /@ = set time stamp on items to date,time.
  144.      /C = change items to have the following specified attributes.
  145.  
  146.                               MORE ABOUT OPTIONS
  147.  
  148.      When you use an argument without wildcards, the /F option is assumed, and 
  149. the single item displays with full information.  When multiple items are 
  150. displayed, DTA defaults to vertical (column) ordering, which many prefer for 
  151. short lists that will fit on one screen; a vertical bar separates the columns.  
  152. The alternative, horizontal (row) ordering, may be less confusing for a long 
  153. listing that will continue onto another screen; some people may prefer 
  154. horizontal in any case.  The /O option gives you your choice.
  155.  
  156.      The view option /V is useful when it's difficult to remember exactly 
  157. what's in files from the filenames alone; it produces a single column of 
  158. output, with a compact display (one line, or two if /F was used) from the 
  159. initial text of each file that appears readable.  Note that some "text" files 
  160. created by word processors actually contain lots of binary data, and therefore 
  161. won't display; whereas some "binary" files, especially in .COM format, may 
  162. contain a sufficient amount of displayable text.
  163.  
  164.      With the /B,/L,/@ options, the date and/or time should follow the option 
  165. letter; if both are specified, separate them with a comma.  If the time is 
  166. omitted, it defaults to 0 hours (12am); if the date is omitted, it defaults to 
  167. TODAY.  If both are omitted, /@ defaults to today, now; /B,/L default to 
  168. today, 0 hours.  DTA recognizes U.S., European, and Numeric formats for 
  169. entering each, by the punctuation used:
  170.        U.S.(M/D/Y,H:MMa-p)    Euro (D.M.Y,H:MM)     Num (Y-M-D,HHMM)
  171.           3/25/90,1:45p    =    25.3.90,13:45    =    90-3-25,1345
  172. (If you add the /A or /P option after a Euro format time, insert a slash or 
  173. space so it doesn't look like a U.S. format time.)  The date "00/00/00" may be 
  174. used to set a null timestamp; otherwise the year must be 80 or above.
  175.      To make selecting files by age more convenient, you can specify a time so 
  176. many days or hours AGO simply by using a "-" sign: thus "-3" means 3 DAYS ago, 
  177. "-,2" means 2 HOURS ago.
  178.  
  179.      With the /K option, the file size in kilobytes (from 0 to 999) should 
  180. follow the option letter; files of that size only will be listed.  Add a "-" 
  181. after the size to include smaller files as well, or a "+" to include larger 
  182. ones (for example, "/K100+").
  183.  
  184.      Note that the file attribute options are case sensitive (uppercase=set, 
  185. lower=clear).  Those listed alone, or before the "C" option letter, are used 
  186. for file selection; those after it, represent changes to be made.  The /C 
  187. option can also be used alone, with NO following attributes, simply to cause 
  188. attributes to display instead of file sizes (no attributes will be changed).
  189.  
  190.      Options /T,G,X do not allow multiple filename arguments.  If you specify 
  191. contradictory selection or formatting options like /U and /D, the later one 
  192. will override the earlier one.  Certain other combinations of options are 
  193. simply not supported and will produce an error message: /G with /X, etc.
  194.  
  195.      Be careful with the /@,/C options, because they actually CHANGE the DOS 
  196. time stamp and attributes for files!  Time stamps, especially, provide 
  197. valuable information about the age and revision of a file, and should not be 
  198. changed without good reason.  (Note: if you are using the DOS FASTOPEN 
  199. feature, /@ may fail to change the time stamp of a file.)
  200.      /C can change the attributes of directories as well as files, but /@ 
  201. cannot change a directory's creation time stamp.
  202.  
  203.  
  204.      The best way to make DTA usage clear will be by a series of examples:
  205.  
  206.                        EXAMPLES: FILES and DIRECTORIES
  207. C>dta a:\*.doc *.txt /v
  208.   Show all files *.DOC and *.TXT in the root directory on A:, with text view.
  209. C>dta a:\*.sys /xf
  210.   Show all files EXCEPT *.SYS, with "full" display (attributes and time/date).
  211. C>dta \work /uo
  212.   Show all files AND subdirectories in C:\WORK, ordered by row.
  213. C>dta /d
  214.   Show all subdirectories in the current directory.
  215.  
  216.                         EXAMPLES: SIZES and TIMESTAMPS
  217. C>dta d: e: /k0
  218.   Show only empty (0k) files in the current directory on drives D: and E:.
  219. C>dta \work /l-2
  220.   Show only files in directory C:\WORK dated in the past two days.
  221. C>dta /b9/1/89
  222.   Show only files in current directory dated before 9/1/89.
  223. C>dta *.doc /l/b1700
  224.   Show only files *.DOC dated today before 5:00pm.
  225. C>dta log /@1.9.89,13:20
  226.   Change the timestamp of file C:LOG to 9/1/89, 1:20pm.
  227.  
  228.                              EXAMPLES: ATTRIBUTES
  229. C>dta /cp
  230.   Show all files *.* with their attributes, without pausing after each screen.
  231. C>dta /A
  232.   Show only files in current directory marked with the Archive attribute.
  233. C>dta a: /SH
  234.   Show only files in current directory on A: which are System and Hidden.
  235. C>dta a:*.sys /Hca
  236.   Select only Hidden files *.SYS on A: and clear their Archive attribute.
  237.  
  238.                        EXAMPLES: TREE and GLOBAL SEARCH
  239. C>dta \work /tf
  240.   Show the directory tree starting from C:\WORK, including size information.
  241. C>dta /gl
  242.   Find all files on drive C: that have been modified today.
  243. C>dta *.bak /gk100+f
  244.   Find all files *.BAK of 100k or larger on drive C:, and show total sizes.
  245.  
  246.                         A NOTE ON DIRECTORY ARGUMENTS
  247.  
  248.      As explained above, if you give a directory name alone as an argument, 
  249. DTA looks at its contents -- so "DTA \MYDIR" is the same as "DTA \MYDIR\*.*".  
  250. Therefore, if you want DTA to act on the directory itself, for example to 
  251. change its attributes, you must resort to a subterfuge: add a superfluous 
  252. wildcard to the name and use the /D option, so DTA will go looking for 
  253. directories with such names, and find that one.  Thus, to make the directory 
  254. \MYDIR hidden, you must type something like "DTA \MYDIR? /DCH".  (Without the 
  255. "?", DTA would look for something in \MYDIR, instead of in the root directory; 
  256. without the "/D", it would look for files but not directories.)
  257.  
  258.  
  259. ------------------------------ CUSTOMIZING DTA -------------------------------
  260.  
  261.  
  262.      You can use DEBUG or a similar utility (like the Norton disk editor) to 
  263. change DTA's default options, time/date format, and text colors (on IBM PC 
  264. compatibles).  All values below are in hexadecimal.  (Note: addresses shown 
  265. are for DEBUG; for most disk editors, subtract 0100.)
  266.  
  267.    ADDRESS    ORIGINAL
  268.  IN DTA.COM    VALUE     FUNCTION                POSSIBLE VALUES
  269.     0108         FF    Default format      FF=ask DOS, 00=US, 01=Euro, 02=Num
  270.     0109         FF    Use color output?   00=no, FF=yes
  271.     010A         07    Message color       00-FF \
  272.     010B         0F    File/text color     00-FF  >see below
  273.     010C         07    Attrib/date color   00-FF /
  274.     0110-011F    00    Default options     Any
  275.  
  276.      DEFAULT FORMAT:  With this set to FF, DTA will use the current DOS 
  277. country code to determine its default time/date format.  If you need to 
  278. override this, you can specify another format.  In any case, if you enter any 
  279. time options (/B,L,@) DTA will adopt whatever format you use.
  280.  
  281.      COLOR OUTPUT:  With this set to FF, DTA will use PC BIOS output for a 
  282. color display, and its page pause will recognize any current screen size.  Use 
  283. of contrasting colors can make the display more easily readable.  If you set 
  284. this to 00, DTA will use standard DOS output and assume a 25 line screen.  
  285. Whichever setting you choose can be reversed with the /M option.
  286.  
  287.      COLORS:  Specify each color by a pair of hex digits for background and 
  288. foreground, according to the following codes:
  289.          0 = BLACK   4 = red       8 = GREY           C = bright red
  290.          1 = blue    5 = magenta   9 = bright blue    D = bright magenta
  291.          2 = green   6 = brown     A = bright green   E = yellow
  292.          3 = cyan    7 = WHITE     B = bright cyan    F = BRIGHT WHITE
  293. For example, "17" means "blue background, white text".
  294.      All monochrome screens can display black, white, and bright white; in 
  295. some cases, grey may also be visible.
  296.      Colors 8-F should generally be avoided as background colors because they 
  297. produce blinking video.  On EGA/VGA displays, if blinking video is disabled, 
  298. the whole range of background colors will be available.
  299.  
  300.      DEFAULT OPTIONS: DTA checks this area for a 16-character string of 
  301. default option selections.  Thus, if you'd like DTA to display in its wide 
  302. format by default, and ordered by row instead of column, place the ASCII 
  303. values "WO" (57 4F hex) followed by 00 at this address.  If you'd like DTA to 
  304. display more or less the way the DOS DIR command does, use "FNUhs" instead.  
  305. (Full information, narrow output, directories along with files, skip hidden 
  306. and system files.)
  307.      Any options you type that conflict with these defaults will supersede 
  308. them.  Thus if your defaults are "FNUhs", you can still specify "/HS" to show 
  309. (only) hidden and system items, overriding "hs"; or "/D" to show only 
  310. directories, overriding "U"; or "/W" for wide display, overriding "FN".
  311.      You can also cancel any individual default option by repeating it.  Thus 
  312. if defaults are "FNUhs", you can display files only by specifying "/U" again, 
  313. or all items regardless of attributes by specifying "/hs" again.
  314.      When you display the help message with "DTA /?", any default options 
  315. installed will be reported.
  316.      (Note that options "C,@,X,G,T,B,L,K" may not be specified as defaults.)
  317.  
  318.      EXAMPLES:  To change to numeric time/date format as default, type "DEBUG 
  319. DTA.COM", then "E0108 02", then "W", then "Q".  To install default options 
  320. "WO", use "E0110 57 4F 00".
  321.  
  322.      Please distribute copies of DTA with original settings only, to avoid 
  323. confusing other users.
  324.  
  325.  
  326. ------------------------------- ERROR MESSAGES -------------------------------
  327.  
  328.      "<out of memory>" - Not enough free memory to run DTA, or over 1000 items 
  329. to list (try a more restrictive filespec).
  330.  
  331.      "<invalid argument>" - Invalid or conflicting option, bad path, illegal 
  332. character in filename, that sort of thing.  Think and try again.
  333.  
  334.      "0 items" - No such file (or directory) was found.  (If you expected 
  335. there to be some, check your arguments again...)
  336.  
  337.  
  338. ---------------------------------- HISTORY -----------------------------------
  339.  
  340.  DA 1.0 (Sep87) - First release, based on my previous CP/M utility DA.
  341.     1.1 (Aug88) - Improved parsing; select AND change attributes; new options.
  342. DTA 1.2 (Oct88) - New /T tree option; DA is now called DTA.
  343.     1.3 (Sep89) - New /G search, /E,L,@ options for time/date.
  344.     1.4 (Mar90) - New /X (except) option; removed /V (version) option.
  345.     1.5 (May91) - US/Euro/Numeric date,time; /E changed to /B(efore).
  346.     1.6 (Sep91) - Multiple filespecs; new /K (size) option; file selection
  347.                     options work with /G; improved, color display.
  348.     1.7 (Jan92) - New /M (mono) option; /B,L,@ accept "-" for "ago";
  349.                     handles drive sizes over 64meg; uses DOS country code.
  350.     1.8 (Aug92) - New /V (view) option; changeable /P default.
  351.     2.0 (Nov92) - New /O (ordering); environment variable for default options.
  352.     2.1 (Dec93) - Fixed "% free" on drives >64meg; default options in DTA.COM.
  353.  
  354.      DTA and its documentation are (c)1987-93 Eric Meyer, all rights reserved.  
  355. They may be freely distributed, but not modified or sold for profit without my 
  356. written consent.  (Exception: Libraries may charge up to $6 for a disk.)  The 
  357. user takes full responsibility for any damages resulting from the use of this 
  358. program.  For a disk with the latest versions of all my programs send $10 to:
  359.  
  360.                  Eric Meyer
  361.               3541 Smuggler Way              CompuServe [74415,1305]
  362.            Boulder, CO  80303  USA
  363.