home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / mbug / mbug028.arc / D.DOC < prev    next >
Text File  |  1979-12-31  |  5KB  |  172 lines
  1.  
  2.               D.ASM ver 2.7A
  3.         RESTRICTED DIRECTORY LIST PROGRAM
  4.             (revised 06/19/81)
  5.  
  6. D.COM is a directory list program, which writes
  7. 4 or 5 entries on a line, separated by colons.
  8.  
  9. The command contains an internal table of file names,
  10. which are not to be shown when just "D" is typed.
  11. (NOTE typing "D *.*" always shows all files)
  12.  
  13. Why is this useful:  A typical CP/M disk contains many
  14. utility files: ed.com, asm.com, submit.com, etc.  When
  15. you do a directory listing, you typically aren't interested
  16. in seeing all those files, but rather just the "current"
  17. or "active" files.  This is what "D.COM" can do.
  18.  
  19. NOTE: Direct CBIOS calls are used for input and output
  20.       in order to avoid echoing of inputted characters.
  21.       This keeps a noisy phone line from causing garbage
  22.       characters in the display.
  23.  
  24. ===============================================================
  25.  
  26. Use:    D *.*    prints all names, 5 across.
  27.  
  28.     D *.ASM prints selected files just like DIR.
  29.  
  30.     D SET    builds a table (in D.COM) of all
  31.         names currently on the disk. (see *NOTE).
  32.  
  33.     D SET <DATE>  adds the date for printing whenever
  34.         D is called by 'A>D<CR>' with no options.
  35.         If the date field is left blank, it will
  36.         be ignored. Note that the date must be 8
  37.         characters or less (see *NOTE).
  38.  
  39.     D ADD FN.FT  adds a name to the table in
  40.         D.COM, so FN.FT won't be listed
  41.         by the 'D' command (see *NOTE).
  42.  
  43.     D DEL FN.FT  deletes a name from the table
  44.         in D.COM, so if FN.FT is in the
  45.         directory, it will be listed by 'D'
  46.         (see *NOTE).
  47.  
  48.     D    lists the directory 5 across, listing
  49.         only those files NOT in D.COM, as
  50.         put there by 'D SET' or 'D ADD FN.FT'
  51.         command.
  52.  
  53. *NOTE: the program must write itself back to disk,
  54. modified, so your disk must not be write protected.
  55.  
  56. ------------------------------------------------------------
  57.  
  58. Examples:  Suppose your disk has: 
  59.     D.COM
  60.     ASM.COM
  61.     ED.COM        on it initially.
  62.     LOAD.COM
  63.     DDT.COM
  64.  
  65. You would type:  D SET
  66. to set these names into the D.COM program.
  67.  
  68. Typing "D" would then list:
  69.  
  70.     -->New files
  71.     A: ++NONE++
  72.  
  73.     -->Deleted files
  74.     A: ++NONE++
  75.  
  76. Suppose you ED TEST.ASM, ASM it, and LOAD it.
  77. Typing D would then list:
  78.  
  79.     -->New files
  80.     A: TEST    ASM : TEST    BAK : TEST    HEX : TEST    COM
  81.  
  82.     -->Deleted files
  83.     A: ++NONE++
  84.  
  85. i.e. it tells you of the "current" files on the disk.
  86.  
  87. Now, supposing you wanted to add TEST.COM as a "regular"
  88. file on your disk.  Type:
  89.  
  90.     D ADD TEST.COM
  91.  
  92. Now, typing D will show:
  93.  
  94.     -->New files
  95.     A: TEST    ASM : TEST    BAK : TEST    HEX
  96.  
  97.     -->Deleted files
  98.     A: ++NONE++
  99.  
  100. i.e. TEST.COM is now considered a "permanent" file.
  101.  
  102. --------------------------------------------------------------
  103.  
  104. Now, suppose you accidentally erased ASM.COM from your
  105. disk.  Typing D gives:
  106.  
  107.     -->New files
  108.     A: TEST    ASM : TEST    BAK : TEST    HEX
  109.  
  110.     -->Deleted files
  111.     A: ASM     COM
  112.  
  113. showing you are missing one of the "regular" files.
  114.  
  115. If, in fact, you didn't want ASM.COM to be on the disk,
  116. type:
  117.  
  118.     D DEL ASM.COM
  119.  
  120. which will delete the name from the D.COM table, so ASM.COM
  121. won't show up as "deleted".
  122.  
  123. ====================================================================
  124.  
  125.     SPECIAL NOTES FOR REMOTE SYSTEM USE:
  126.  
  127. If you keep a dedicated copy of this program on each drive of
  128. your remote system, you can 'dedicate' each copy of this program
  129. to a drive by filling in the byte at 103H with the drive number.
  130. This prevents such things as:
  131.  
  132.     A>D B:
  133.         or
  134.     B>A:D
  135.  
  136. Do this by using the command:
  137.  
  138.     A>D LOK A:    to lock to a drive
  139.         or
  140.     A>D LOK     to unlock
  141.  
  142. If the conditional 'NOSYS' is set TRUE, $SYS files in CP/M 2.x
  143. will be ignored in both directory listings and when the "ADD"
  144. option is invoked, unless the override char is specified.  This
  145. allows D.COM to be used as a "WHAT'S NEW" program for remote CP/M
  146. systems, where the $SYS files must not be listed.
  147.  
  148. Examples:
  149.     A>D *.* S     displays everything
  150.     A>D SET S     puts ALL files in table
  151.     A>D SET 12/23/80 sets date for reference
  152.         (if you use 'D SET S', you lose the date option..
  153.         ..sorry about that).
  154.  
  155. If you use this program on a remote system, you will likely
  156. want to change the commands (ADD, DEL, and SET) for security.
  157. You will also want to change the $SYS suppress override character.
  158. You may also want to change the name of the program to make the
  159. name itself more informative, e.g. "WHATSNEW.COM".
  160.  
  161. -->IMPORTANT: If you want the program to be 'TAG'ed after every
  162. D SET (so it cannot be taken by XMODEM), see the note at label
  163. "WRBACK" for setting the F1 bit in the filename itself.
  164.  
  165. Note that this program defines its own name for write-back
  166. purposes under the label "WRBACK".
  167.  
  168. =====================================================================
  169.  
  170.  
  171.  
  172.