home *** CD-ROM | disk | FTP | other *** search
/ ftp.barnyard.co.uk / 2015.02.ftp.barnyard.co.uk.tar / ftp.barnyard.co.uk / cpm / walnut-creek-CDROM / CPM / C128 / SIGMV801.ARK / SD.DOC < prev    next >
Text File  |  1986-02-01  |  10KB  |  182 lines
  1.  
  2.                           v79A 03/17/84
  3.  
  4.                   The SD Super Directory Program
  5.  
  6.      This documentation file concerns SD-79A.ASM.  This is a signifi-
  7. cant upgrade of the standard "super-directory" program that most RCP/M
  8. systems are now using as their "DIR" executor.
  9.  
  10.      The most significant improvement is the support of the DU: form for
  11. drive-spec, similar to that used by ZCPR2 and its various utilities.
  12. This is concurrent with the $U option.  The filename of the file for the
  13. $F option has been altered to SD.DIR, as it was originally.  Other op-
  14. tions such as multi-drive search remain as before.  Now, in place of the
  15. $U option, you may specify the Drive/User with the filename, such as:
  16. SD A1:*.*, SD 1:*.*, SD B:FN.FT, SD B4:FN.FT $AD, etc.  You may still
  17. use the $U option if desired, although it seems the DU: form is a much
  18. easier and more logical method.
  19.  
  20.      Files  may be  shown in vertical or horizontal listings, although
  21. this must be set when the program is assembled for a particular system.
  22.  
  23.      SD-79A has support for .LBR files, (an 'L' option to list their
  24. member files); and support for the NZCPR/ZCPR2 "WHEEL" byte option.
  25. (SD-79A.COM set up for ZCPR2 use with WHEEL at 3EH.)  Size of library
  26.  member files  are shown in 'k'.
  27.  
  28.      The basic operation of SD is as in previous releases.  You merely
  29. type "SD", followed by an optional ambiguous or nonambiguous filename
  30. (as you would with the CCP directory command).  Omitting the filename
  31. (i.e., "SD <cr>"), will be interpreted as "SD *.*".  Similarly, "SD A:"
  32. would imply "SD A:*.*" and "SD B:" would  imply "SD B:*.*".
  33.  
  34.      In addition to the filename option, up to 11 command line options
  35. may be specified.   Option fields are preceded by a single dollar sign
  36. as with most Digital Research programs such as MAC, and may be essen-
  37. tially free-form in format.  Example:  SD B:$ADnU0fpS.  Spaces within
  38. the option field are insignificant i.e., "$ SADN U0FP" is equivalent to
  39. "$  S A D N  U0  F P").  The only exception concerns the "USER" option
  40. which will be explained later.
  41.  
  42.      Users should also be aware of two restrictions on the command line
  43. format.  SD scans the entire command line for a dollar sign preceded by
  44. at least 1 blank to delimit the beginning of the option field.  Forthis
  45. reason, invoking SD with a command line such as:  "SD $ $AR" is illegal,
  46. since SD will consider the first dollar sign to be the option field de-
  47. limiter.  If you need to specify a filename whose first  character is a
  48. dollar sign precede it with a drive code as in "SD A:$ $AR".  In this
  49. instance, SD will consider the first dollar sign insignificant as it is
  50. not preceded by a blank.
  51.  
  52.      Starting with SD-75 there is an assembly time option which, if set,
  53. allows the use of options without requiring the filename to be preceded
  54. with a drive code so long as you wish to look on the default drive.
  55.  
  56.      You give up the ability to specifically search for a filename whose
  57. name begins with a '$'.  However, such files will be listed, along with
  58. others, if the command line "SD $CU3" (or any other options) were speci-
  59. fied.  The "COM" file is configured with this option set.   Setting the
  60. option to 'NO' and reassembling will cause operation to revert to that
  61. of previous versions (see paragraph above).
  62.  
  63.      The second restriction is that command line options may be specified
  64. once and only once per invocation.   That is, "SD A:$SDS" would be il-
  65. legal since the 'S' option is specified twice.  This shortcoming is due
  66. to the fact that options can be made into defaults at assembly time.
  67. Note that if an option is made default, with zero as option flag, it
  68. cannot be specified without generation an error message.  The eleven re-
  69. cognized options:
  70.  
  71.   "S" - system option:  System files will be included in the
  72.     output     rather than being suppressed.
  73.  
  74.   "F" - file  option:  The directory output  will be echoed to
  75.     a disk file named "SD.DIR" on the DEFAULT drive.
  76.     If this name already exists then the directory output
  77.     will be APPENDED to the end of the file.  "SD.DIR"
  78.     will otherwise start as a new file.  The append fea-
  79.     ture allows you to build up one massive file on the de-
  80.     fault drive containing the directories of all of your
  81.     disks, without having to concantenate a swarm of indi-
  82.     vidual directory  files.  If you plan to use this fea-
  83.     ture often,it will be simpler for you to have a dedi-
  84.     cated version  on  your  MAST.CAT disk with  AUTOR set
  85.     'YES'.  The advantage of this is that you can work thru
  86.     a pile of disks without having to CTL-C or specify the
  87.     'R' option every time you SD a new disk.  Failing to do
  88.         this will result in the allocation  vector being inval-
  89.     id, and FREE size will be wrong.
  90.  
  91.   "U" - user option:  Allows the specification of the user num-
  92.     ber for the directory of the form "Uxx" where the user
  93.     # is greater than 0, but not greater than a specified
  94.     value not to exceed 15.  The user option specification
  95.     will be illegal if the user # is out of range, omitted,
  96.     or if 'U' is specified on a pre-CP/M 2 system.  Since
  97.     the user option requires a parameter (i.e., the user
  98.     number), the user number must immediately follow the 'U'
  99.     option on the command field.  That is, "U1" is legal,
  100.     but "U  1" is not.  In this respect, the 'U' option
  101.     differs from the other options in that embedded spaces
  102.     ARE significant. 
  103.  
  104.   "A" - all users:  Causes SD to display directories of all
  105.     user areas starting at the user area specified in the
  106.     'U' option or, if the 'U' option is omitted, user area
  107.     0 and continuing up through the MAXUSR value from the
  108.     LODRV-HIDRV table.  (If ZPR2/WHLUSR=TRUE and the WHEEL
  109.     byte set, 0-MXZUSR.)
  110.  
  111.   "L" - LBR list option:  Allows for listing of ".LBR" file
  112.     members.  ".LBR" file members are shown followed by
  113.     their length  in 'k'.  The total length of the entire
  114.     library is also shown.
  115.  
  116.   "V" - If included, SD version number is displayed.
  117.  
  118.   "C" - If  included, clear  screen  performed before directory
  119.     information is displayed.
  120.  
  121.   "N" - no page  option:  Unconditionally disables the page
  122.     pause option.  Useful when running SD in the 'F' and/or
  123.     'A' modes when you don't want the page prompt slowing
  124.     you  down.  SD-79A will not put the page-pause prompt
  125.     into the output file or to printer if either enabled.
  126.  
  127.   "P" - printer option:  Forces all console output to be echoed
  128.     to the CP/M list device, with the most significant bit
  129.     set to 0.
  130.  
  131.   "D" - all disk option:  Allows SD to search all disk drives
  132.     on-line starting with the disk drive specified or im-
  133.     plied with the command line filename.  For example,
  134.     "SD B:$D" will result in SD searching all drives begin-
  135.     ning with drive B.  "SD $D" will result in SD searching
  136.     all drives automatically beginning with the A drive, 
  137.     regardless what drive you started on.
  138.  
  139.   "R" - Reset disk system:  A disk system reset is done before
  140.     directory information is accumulated.
  141.  
  142.      If an unrecognized option (or illegal user option specification) is
  143. detected, then the command line will be played back to the console up to
  144. the point where the error was detected.  However, if the REPERR option
  145. is disabled, then SD will keep its mouth shut and ignore everything on
  146. the command line past the illegal field.  In this situation, an illegal-
  147. ly specified user number would default back to the current user number.
  148. The option of DISABLING error reporting was included primarily for sys-
  149. tems with hidden doors and secret passageways.  Shooting off rockets and
  150. clanging bells everytime a twit starts "experimenting" just calls atten-
  151. tion to the fact that there really IS something behind that hollow-
  152. sounding  wall after all.
  153.  
  154.      As an added convenience, it is possible to "hard-wire" some or all
  155. of the command line options.  For example, if you want SD to ALWAYS list
  156. system files, you can do that.  For details, see the comments preceding
  157. the option field lookup table in the assembler source file.
  158.  
  159.      Finally, if the all-disk and/or all-user options are enabled, it may
  160. be  desirable to restrict searches.  To facilitate this, a table is in-
  161. cluded in SD (beginning at label "LODRV" and continuing through "HIDRV").
  162. The table consists of a single byte for each drive to be searched begin-
  163. ning with 'A'.  Each byte may be in the range of 0-15 mod 15 and defines
  164. the highest user number that SD will search for that particular drive.
  165. The highest drive number to search is defined by the length of the table.
  166. If four DBs are present between LODRV and HIDRV, then drives A-D can be
  167. searched.  The source file includes the LODRV-HIDRV table in its maximum
  168. configuration for 16 drives.  However, delete DBs referencing drives that
  169. aren't available on your system.  Although SD will intercept attempts to
  170. search non-existant drives, there really isn't any point in allowing SD
  171. to always search drive C when you only have 2 logical drives; and de-
  172. pending on how your BIOS is constructed and how long it monkeys around
  173. before advising the BDOS of the select error, it could save some time.
  174.  
  175.      You don't really have to be running NZCPR or ZCPR2 to use the wheel
  176. byte feature, just get the WHEEL program and add code to BYE to make
  177. sure WHEEL byte is cleared when a remote user logs on, (before entering
  178. CP/M).
  179.             - Written by Kim Levitt
  180.             - Updated by Irv Hoff
  181.                         - Further updates by Dennis Vallianos
  182.