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 / KAYPRO / SSTAT-KP.LBR / SSTAT.WZ / SSTAT.WS
Text File  |  2000-06-30  |  7KB  |  175 lines
  1. .op
  2. .heSSTAT.WS                    02/06/86                    Page #
  3. -----------------------------------------------------------------
  4.                 Information on the SSTAT program
  5. -----------------------------------------------------------------
  6.  
  7. Description
  8. -----------
  9. SSTA╘ i≤ ß substitutσ fo≥ thσ prograφ STAT.CO═ tha⌠ Digita∞ ì
  10. ResearcΦ supplie≤ witΦ thσ CP/═ operatinτ system«  I⌠ doe≤ mos⌠ ì
  11. oµ thσ thing≤ tha⌠ STAT.CO═ doe≤ anΣ ha≤ somσ additiona∞ ì
  12. capabilities.  Particularly, SSTAT allows you to:
  13.  
  14.      - view a disk DIRECTORY in "ring" format and move
  15.        forward or backward, from file to file
  16.  
  17.      - seσ thσ SIZE oµ eacΦ filσ iε Records¼ Kilobyte≤, Kilobytes
  18.        allocated (rounded to disk block size), and directory
  19.        extents
  20.  
  21.      - get disk space information including:
  22.  
  23.           1) number  of files on the current user area
  24.           2) K bytes occupied on the current user area
  25.           3) K bytes occupied on the current drive
  26.           4) K bytes free on the current drive
  27.  
  28.      - display disk characteristics (just like STAT DSK:)
  29.  
  30.      - display the IOBYTE: (like STAT DEV:)
  31.  
  32.      - show the system memory map
  33.  
  34.      - changσ filσ attribute≤ interactively«  Thσ archivσ ì
  35.        attribute is supported.
  36.  
  37. Lackinτ iε SSTA╘ i≤ thσ capabilit∙ t∩ changσ thσ IOBYTE«  You'l∞ ì
  38. need STAT.COM or a system configuration program to do this.
  39.  
  40.  
  41. Operation
  42. ---------
  43. WitΦ SSTA╘ yo⌡ "log-onó t∩ ß drivσ anΣ use≥ area¼ jus⌠ likσ yo⌡ ì
  44. d∩ witΦ thσ popula≥ SWEEP-stylσ utilities«   ┴ drive/use≥ (DU:⌐ ì
  45. anΣ filσ masδ caε bσ entereΣ froφ thσ systeφ promp⌠ a⌠ startu≡ o≥ ì
  46. caε bσ entereΣ afte≥ thσ prograφ i≤ running«  Herσ arσ somσ ì
  47. command examples:
  48.  
  49.      A0>sstat ?      (prints a short usage message)
  50.  
  51.      A0>ssta⌠        (n∩ argument¼ log≤ all files on A0:)
  52.  
  53.      A0>sstat B15:   (logs all files on drive B:, user 15:)
  54.  
  55.      A0>sstat C:*.ASM    (logs all .ASM files on C0:)
  56.  
  57.      A0>sstat 8:SSTAT.*  (logs all SSTAT files on A8:)è
  58. Oncσ thσ prograφ ha≤ starteΣ yo⌡ havσ thσ followinτ command≤ a⌠ ì
  59. your disposal:
  60.  
  61.             Command Key             Function
  62.          -------------------  ----------------------
  63.      <Ctrl-E> or <CR>     move forward one file
  64.      <Ctrl-X> or <B>      move back one file
  65.      <Ctrl-S> or <Ctrl-H> move the cursor left
  66.      <Ctrl-D> or <SPACE>  move cursor right
  67.      <Ctrl-T> or <T>      toggle file attribute
  68.      <Ctrl-A> or <A>      set file attributes
  69.                  <F>      find a file
  70.                  <I>      print disk information
  71.                  <L>      log new DU:
  72.              <N>      next line auto-advance on/off
  73.                  <S>      print free space
  74.                  <X>      quit and return to CP/M
  75.                  <?>      print this help menu
  76.  
  77. Thσ firs⌠ fou≥ command≤ abovσ arσ selµ explanator∙ a≤ arσ thσ 'Iº ì
  78. , 'S' and '?' commands.
  79.  
  80. Thσ Ctrl-╘ anΣ 'Tº key≤ allo≈ yo⌡ t∩ "toggleó thσ filσ attriì
  81. butes«  Thi≤ mean≤ tha⌠ eacΦ successivσ usσ oµ thσ commanΣ flip-ì
  82. flop≤ thσ attributσ on/off/on¼ etc«  Thi≤ work≤ oε al∞ eigh⌠ ì
  83. filenamσ attribute≤ a≤ wel∞ a≤ thσ R/O¼ System¼ anΣ Archivσ ì
  84. attributes«  Iµ thσ prograφ ha≤ beeε properl∙ installeΣ (seσ ì
  85. below⌐ thσ attribute≤ tha⌠ arσ O╬ wil∞ bσ displayeΣ oε you≥ CR╘ ì
  86. witΦ ß specia∞ vide∩ attribute«  Attribute≤ arσ no⌠ actuall∙ SE╘ ì
  87. unti∞ yo⌡ usσ thσ Ctrl-┴ o≥ 'Aº command«  Wheε yo⌡ d∩ so¼ al∞ ì
  88. change≤ yo⌡ havσ madσ arσ writteε t∩ thσ disδ directory.
  89.  
  90. Thσ displa∙ use≤ specia∞ "attributσ stringsó t∩ sho≈ thσ statu≤ ì
  91. oµ thσ R/O¼ SYS¼ anΣ AR├ attributes«  Thesσ string≤ reflec⌠ thσ ì
  92. director∙ statu≤ oµ thσ attributes¼ no⌠ thσ taggeΣ status¼ s∩ ì
  93. the∙ wil∞ onl∙ bσ updateΣ wheε yo⌡ usσ thσ Ctrl-┴ o≥ 'Aº ì
  94. commands.
  95.  
  96. Thσ prograφ ma∙ auto-advancσ t∩ thσ nex⌠ filσ afte≥ yo⌡ usσ thσ ì
  97. togglσ command«  Yo⌡ caε usσ thσ 'Nº commanΣ t∩ turε thi≤ featurσ ì
  98. oε o≥ off.
  99.  
  100. Thσ 'Fº ke∙ allow≤ yo⌡ t∩ finΣ ß particula≥ filσ iε thσ ì
  101. directory«  Thi≤ i≤ usefu∞ iµ yo⌡ havσ ß ver∙ biτ directory«  Yo⌡ ì
  102. don'⌠ neeΣ t∩ ente≥ ß completσ filσ namσ fo≥ thi≤ t∩ work«  Fo≥ ì
  103. instancσ yo⌡ coulΣ simpl∙ ente≥ thσ lette≥ 'Sº iε responsσ t∩ thσ ì
  104. "Ente≥ filespec║ ó prompt¼ anΣ SSTA╘ woulΣ movσ yo⌡ t∩ thσ firs⌠ ì
  105. filσ i⌠ find≤ beginninτ witΦ thσ lette≥ 'S.'
  106.  
  107. Thσ 'Lº commanΣ allow≤ yo⌡ t∩ changσ thσ loggeΣ drive/user/filσ ì
  108. mask«  I⌠ work≤ jus⌠ likσ thσ commanΣ argumen⌠ filσ speπ ì
  109. describeΣ above«  Yo⌡ ma∙ ente≥ ß drivσ letter¼ use≥ number¼ ì
  110. and/o≥ filσ namσ (witΦ wilΣ cards)¼ iε an∙ combination«  ì
  111. IMPORTANT║  iµ yo⌡ ente≥ ß baΣ DU║ o≥ ß filσ masδ fo≥ whicΦ therσ ìèi≤ n∩ match¼ SSTA╘ wil∞ insis⌠ tha⌠ yo⌡ ente≥ ß gooΣ filespeπ ì
  112. before proceeding.   If in doubt, enter *.*.
  113.  
  114. Yo⌡ ma∙ usσ 'Xº t∩ returε t∩ CP/M«  N∩ warφ boo⌠ wil∞ occur«  Yo⌡ ì
  115. may also use control-C to abort the program at any time.
  116.  
  117. Installation
  118. ------------
  119. SSTA╘ caε bσ ruε "righ⌠ ou⌠ oµ thσ can.ó  Yo⌡ wil∞ finΣ i⌠ mos⌠ ì
  120. useful¼ however¼ iµ yo⌡ takσ thσ troublσ t∩ instal∞ i⌠ fo≥ you≥ ì
  121. terminal«  Aε overla∙ file¼ SS-OVRxx.AS═, ha≤ beeε provideΣ t∩ ì
  122. assist you.  Use it as follows:
  123.  
  124.      1⌐ witΦ ß tex⌠ editor¼ loaΣ SS-OVRxx.ASM«  FinΣ thσ label≤ ì
  125. ATTON║ anΣ ATTOFF║ anΣ instal∞ thσ code≤ necessar∙ t∩ turε you≥ ì
  126. terminal'≤ vide∩ attribute≤ oε anΣ off«  Yo⌡ havσ fou≥ byte≤ t∩ ì
  127. usσ fo≥ eacΦ oµ thesσ strings«  Yo⌡ canno⌠ usσ morσ spacσ thaε ì
  128. that«  Fil∞ an∙ unuseΣ byte≤ witΦ zeros«  INVERS┼ VIDE╧ i≤ thσ ì
  129. mos⌠ suitablσ vide∩ functioε t∩ use.
  130.  
  131.     While you're at it you can also change:
  132.  
  133.     MAXDRV:  -- your maximum accessible drive
  134.     MAXUSR:  -- your maximum accessible user
  135.     MAXNARG: -- the maximum number of DIRECTORY EXTENTS
  136.             that will be loaded.  Each extent takes
  137.             17 bytes of RAM
  138.         ADVANC:  -- determine≤ the default status of the
  139.                     "auto-advance to next line" feature
  140.  
  141.      2) assemble the SS-OVR file with ASM, MAC, etc.
  142.  
  143.      3) overlay the SSTAT.OBJ file with the SS-OVRxx.HEX file.
  144.  
  145.     For example, using MLOAD:
  146.  
  147.         A>mload sstat.com=sstat12.obj,ss-ovr11.hex
  148.  
  149.  
  150.     Or using DDT:
  151.  
  152.     A>ddt sstat12.obj<cr>
  153.     DDT VERS 2.2
  154.     NEXT  PC
  155.     1280 0100
  156.     -iss-ovr11.hex<cr>
  157.     -r<cr>
  158.     NEXT  PC
  159.     1280 0100
  160.     -^C
  161.  
  162.     A>save 18 sstat.com<cr>
  163.  
  164. That's all there is to installation!
  165. è
  166.                  Copyright Notice and Disclaimer
  167. -----------------------------------------------------------------
  168. SSTA╘ i≤ Copyrigh⌠ (C⌐ b∙ DaviΣ Jewett¼ II╔ - 1986«  Yo⌡ shal∞ ì
  169. no⌠ usσ thi≤ prograφ fo≥ commercia∞ purpose≤ o≥ fo≥ monetar∙ gaiε ì
  170. withou⌠ writteε permissioε froφ thσ author.
  171.  
  172. Thσ autho≥ wil∞ assumσ n∩ liabilit∙ fo≥ an∙ los≤ o≥ damagσ ì
  173. sustaineΣ througΦ thσ usσ oµ thi≤ program.
  174. -----------------------------------------------------------------
  175.