home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / enterprs / cpm / utils / a / da22.lzh / DA22.DOC < prev   
Encoding:
Text File  |  1992-11-06  |  6.8 KB  |  158 lines
  1.                                     DA.DOC
  2.                                     ------
  3.                      Documentation for DA.COM v2.2 (1/87)
  4.                                (c)1987 E. Meyer
  5.  
  6.  
  7.      DA is a super directory utility ("DA" stands for Directory-Attributes)
  8. that will run on any Z80 CP/M system (2.2 or 3.0).  It is like XDIR and STAT
  9. (or SET and SHOW) rolled into one, but takes just 2k of disk space.  DA can:
  10.  
  11.     *  show the files on a disk, the space they take, and free space
  12.     *  give an alphabetized directory with file sizes
  13.     *  select on, display, or change file attributes
  14.  
  15.  
  16.                                    USING DA
  17.  
  18. SYNTAX:    A>da {du:}{filespec} {[}{op}{attributes}}     ("{}"=optional)
  19.  
  20.         where  "du:" may include a drive and/or user number, eg "B14:";
  21.                "filespec" may include wildcards ("*", "?");
  22.                "[" is a delimiter before any operands or attributes;
  23.                "op" may be one or two of the operands "#?~+-";
  24.                "attributes" are any or all of: "RSA1234".
  25.  
  26.        If you are specifying operands/attributes, they must be separated from
  27.        the filespec by either a space or "["; if the filespec was omitted, the
  28.        "[" is mandatory.  Generally, only one operand should be specified; the
  29.        exception is that "~" may be used after "?" or "#".
  30.  
  31. ATTRIBUTES:   If attributes are specified, only files WITH them are shown.
  32.        There are 7 attributes a file may have:
  33.          R = READ/ONLY -- the file cannot be erased or modified.
  34.          S = SYSTEM -- the file will not appear in an ordinary DIR.
  35.          A = ARCHIVE -- the file has not been changed since last archived.
  36.                        (Note: only CP/M 3.0 fully supports this attribute.)
  37.          1,2,3,4 -- no established meaning, use for your own purposes.
  38.  
  39. OPERANDS:  "~"... Show only files WITHOUT following attributes.
  40.            "#"... Show file sizes in RECORDS as well as K.
  41.            "?"... Show file ATTRIBUTES instead of sizes.
  42.            "+"... SET and show following attributes on specified files.
  43.            "-"... CLEAR and show following attributes on specified files.
  44.  
  45.  
  46.                                    EXAMPLES
  47.  
  48.      Suppose we have a fictitious 183k disk with five files.  First we'll try
  49. the different DA display modes.  (Note: all the following assumes that alpha-
  50. betization is horizontal, and "*.*" defaulting is on.)
  51.  
  52. A>da
  53. A0:    86k in   5 files use   86k  (  95k free)
  54. ALPHA   .FIL   6k > BETA    .FIL  51k > DA      .COM   2k > GAMMA   .FIL  18k
  55. OMEGA   .COM   9k
  56.  
  57. A>da [#
  58. A0:    86k in   5 files use   86k  (  95k free)
  59. ALPHA   .FIL   47r   6k > BETA    .FIL  402r  51k > DA      .COM   14r   2k
  60. GAMMA   .FIL  140r  18k > OMEGA   .COM   72r   9k
  61.  
  62. A>da [?
  63. A0:ALPHA   .FIL  RS----- > BETA    .FIL  ------- > DA      .COM  -S-----
  64. A0:GAMMA   .FIL  --A---- > OMEGA   .COM  -S-1--4
  65.  
  66. A>da a1:
  67. A1:     0k in   0 files use    0k  (  95k free)
  68.  
  69. A>da *.xyz [?
  70. A0:NO FILE
  71.  
  72.      Now we try getting selective lists, by specifying attributes.
  73.  
  74. A>da [s
  75. A0:    17k in   3 files use   17k  (  95k free)
  76. ALPHA   .FIL   6k > DA      .COM   2k > OMEGA   .COM   9k
  77.  
  78. A>da [?rs
  79. A0:ALPHA   .FIL  RS-----
  80.  
  81. A>da *.fil[~a
  82. A0:    57k in   2 files use   57k  (  97k free)
  83. ALPHA   .FIL   6k > BETA    .FIL  51k
  84.  
  85.      Now we start changing some attributes.
  86.  
  87. A>da *.fil[+3
  88. A0:ALPHA   .FIL  RS---3- > BETA    .FIL  -----3- > GAMMA   .FIL  --A--3-
  89.  
  90. A>da *.com[-1234
  91. A0:OMEGA   .COM  -S----- > DA      .COM  -S-----
  92.  
  93.  
  94.  
  95.                                   ADVANTAGES
  96.  
  97.      DA gives a more convenient way to set attributes than the usual CP/M
  98. commands.  It displays attributes in an intuitive way, instead of using video
  99. bits or lowercase on filename characters as do other programs.  And it is the
  100. only utility I know of that can give selective lists of files by attributes.
  101.      DA is careful to give accurate statistics.  The disk involved will be
  102. reset before it is accessed, so you can change disks and use DA without fear. 
  103. The file sizes are exact, rather than rounded up to your block size: DA will
  104. show a 1k file as 1k, even on a hard disk with 4k blocks; most other programs
  105. would report 4k.  The disk statistics message gives the actual space taken up
  106. on your drive (the "use" figure) as well as the total of the real file sizes,
  107. in case these differ.
  108.      (Note: a "record" is 128 bytes; a "K" is 8 records, 1024 bytes.  A
  109. "block" is a unit typically from 1K to 4K, depending on your disk format.)
  110.  
  111.  
  112.                                  LIMITATIONS
  113.  
  114.      When DA is used on unusual "media", such as ROM or tape "drives" on some
  115. lap portables, the disk statistics may be inaccurate.  This is a general
  116. problem, due to the implementation of CP/M on these machines.
  117.      DA has a few numerical limits.  It can only cope with up to 255 files,
  118. 999k filesizes, and 8190k free space.  This should be adequate for all floppy
  119. and some hard disks.
  120.  
  121.  
  122.                             OPTIONAL: User Patches
  123.  
  124.       0108h : directory columns             010Ah : default to "*.*"?
  125.       0109h : vertical alphabetization?     010Bh : maximum drive
  126.  
  127.      You can vary the number of columns in which DA displays the directory. 
  128. Patch address 0108h in DA.COM (with DDT, SID etc) to the number you want. 
  129. Each column is 18 characters wide.  The default is 4 columns for an 80-column
  130. screen; 3 works well on a 52-column Osborne; 2 works with 40-column screens. 
  131. (Note that in the attribute or records mode, the number of columns in the
  132. display will be one less in each case.)
  133.      You can choose whether you want the directory alphabetized horizontally
  134. or vertically.  Patch address 0109h to FF for vertical (the default is 00 for
  135. horizontal).  DA will use ">" as a file separator in horizontal mode, and "|"
  136. in vertical mode.
  137.      You can choose whether to default to "*.*" when you use DA without a
  138. filename.  Ordinarily this is so; typing "DA" is the same as "DA *.*".  If you
  139. prefer to get just the disk statistics when you type "DA" alone, patch address
  140. 010Ah to 00.  (The default is FF.)
  141.      The maximum drive allowed is stored at 010Bh (default is 0F, for CP/M's
  142. upper limit, drive P:).  If you want, you can decrease this to reflect the
  143. actual number of drives on your system (01 would be B:).  Any attempt to
  144. access a higher drive will be ignored, avoiding BDOS select errors.
  145.  
  146.  
  147.                                VERSION HISTORY
  148.  
  149.   Versions 1.0-1.6: gradual improvements (still only 1K).
  150.  
  151.   Version 2.0: completely rewritten, now 2K.  New multiple display formats,
  152. user number support, much faster.
  153.   v2.1-2.1c: more user patches, small bug fixes.
  154.   v2.2: "[" allows options without filename; new option "#" shows records.
  155.  
  156.  
  157.        ---  Eric Meyer, 427 N. Washington #4, Bloomington IN 47401  ---
  158.