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