home *** CD-ROM | disk | FTP | other *** search
/ Oakland CPM Archive / oakcpm.iso / cpm / sysutl / sstat18x.lbr / SSTAT.WQ / SSTAT.WS
Encoding:
Text File  |  1986-04-08  |  6.6 KB  |  175 lines
  1. .op
  2. .heSSTAT.WS                    02/06/86                    Page #
  3. -----------------------------------------------------------------
  4.                 Information on the SSTAT program
  5. -----------------------------------------------------------------
  6. NOTE: ALL FILES IN THIS VERSION ARE FIXED FOR XEROX 820-II & 16/8
  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. è
  59. Oncσ thσ prograφ ha≤ starteΣ yo⌡ havσ thσ followinτ command≤ a⌠ ì
  60. your disposal:
  61.  
  62.             Command Key             Function
  63.          -------------------  ----------------------
  64.      <Ctrl-B> or <CR>     move forward one file
  65.      <Ctrl-A> or <B>      move back one file
  66.      <Ctrl-D> or <Ctrl-H> move the cursor left
  67.      <Ctrl-C> or <SPACE>  move cursor right
  68.      <Ctrl-T> or <T>      toggle file attribute
  69.                  <A>      set file attributes
  70.                  <F>      find a file
  71.                  <I>      print disk information
  72.                  <L>      log new DU:
  73.              <N>      next line auto-advance on/off
  74.                  <S>      print free space
  75.                  <X>      quit and return to CP/M
  76.                  <?>      print this help menu
  77.  
  78. Thσ firs⌠ fou≥ command≤ abovσ arσ selµ explanator∙ a≤ arσ thσ 'Iº ì
  79. , 'S' and '?' commands.
  80.  
  81. Thσ Ctrl-╘ anΣ 'Tº key≤ allo≈ yo⌡ t∩ "toggleó thσ filσ attriì
  82. butes«  Thi≤ mean≤ tha⌠ eacΦ successivσ usσ oµ thσ commanΣ flip-ì
  83. flop≤ thσ attributσ on/off/on¼ etc«  Thi≤ work≤ oε al∞ eigh⌠ ì
  84. filenamσ attribute≤ a≤ wel∞ a≤ thσ R/O¼ System¼ anΣ Archivσ ì
  85. attributes«  Iµ thσ prograφ ha≤ beeε properl∙ installeΣ (seσ ì
  86. below⌐ thσ attribute≤ tha⌠ arσ O╬ wil∞ bσ displayeΣ oε you≥ CR╘ ì
  87. witΦ ß specia∞ vide∩ attribute«  Attribute≤ arσ no⌠ actuall∙ SE╘ ì
  88. unti∞ yo⌡ usσ thσ  'Aº command«  Wheε yo⌡ d∩ so¼ al∞ ì
  89. change≤ yo⌡ havσ madσ arσ writteε t∩ thσ disδ directory.
  90.  
  91. Thσ displa∙ use≤ specia∞ "attributσ stringsó t∩ sho≈ thσ statu≤ ì
  92. oµ thσ R/O¼ SYS¼ anΣ AR├ attributes«  Thesσ string≤ reflec⌠ thσ ì
  93. director∙ statu≤ oµ thσ attributes¼ no⌠ thσ taggeΣ status¼ s∩ ì
  94. the∙ wil∞ onl∙ bσ updateΣ wheε yo⌡ usσ thσ 'Aº command.   
  95.  
  96.  
  97. Thσ prograφ ma∙ auto-advancσ t∩ thσ nex⌠ filσ afte≥ yo⌡ usσ thσ ì
  98. togglσ command«  Yo⌡ caε usσ thσ 'Nº commanΣ t∩ turε thi≤ featurσ ì
  99. oε o≥ off.
  100.  
  101. Thσ 'Fº ke∙ allow≤ yo⌡ t∩ finΣ ß particula≥ filσ iε thσ ì
  102. directory«  Thi≤ i≤ usefu∞ iµ yo⌡ havσ ß ver∙ biτ directory«  Yo⌡ ì
  103. don'⌠ neeΣ t∩ ente≥ ß completσ filσ namσ fo≥ thi≤ t∩ work«  Fo≥ ì
  104. instancσ yo⌡ coulΣ simpl∙ ente≥ thσ lette≥ 'Sº iε responsσ t∩ thσ ì
  105. "Ente≥ filespec║ ó prompt¼ anΣ SSTA╘ woulΣ movσ yo⌡ t∩ thσ firs⌠ ì
  106. filσ i⌠ find≤ beginninτ witΦ thσ lette≥ 'S.'
  107.  
  108. Thσ 'Lº commanΣ allow≤ yo⌡ t∩ changσ thσ loggeΣ drive/user/filσ ì
  109. mask«  I⌠ work≤ jus⌠ likσ thσ commanΣ argumen⌠ filσ speπ ì
  110. describeΣ above«  Yo⌡ ma∙ ente≥ ß drivσ letter¼ use≥ number¼ ì
  111. and/o≥ filσ namσ (witΦ wilΣ cards)¼ iε an∙ combination«  ì
  112. IMPORTANT║  iµ yo⌡ ente≥ ß baΣ DU║ o≥ ß filσ masδ fo≥ whicΦ therσ ìèi≤ n∩ match¼ SSTA╘ wil∞ insis⌠ tha⌠ yo⌡ ente≥ ß gooΣ filespeπ ì
  113. before proceeding.   If in doubt, enter *.*.
  114.  
  115. Yo⌡ ma∙ usσ 'Xº t∩ returε t∩ CP/M«  N∩ warφ boo⌠ wil∞ occur«  Yo⌡ ì
  116. may also use control-C to abort the program at any time.
  117.  
  118. Installation
  119. ------------
  120. SSTA╘ caε bσ ruε "righ⌠ ou⌠ oµ thσ can.ó  Yo⌡ wil∞ finΣ i⌠ mos⌠ ì
  121. useful¼ however¼ iµ yo⌡ takσ thσ troublσ t∩ instal∞ i⌠ fo≥ you≥ ì
  122. terminal«  Aε overla∙ file¼ SS-OVRxx.AS═, ha≤ beeε provideΣ t∩ ì
  123. assist you.  Use it as follows:
  124.  
  125.      1⌐ witΦ ß tex⌠ editor¼ loaΣ SS-OVRxx.ASM«  FinΣ thσ label≤ ì
  126. ATTON║ anΣ ATTOFF║ anΣ instal∞ thσ code≤ necessar∙ t∩ turε you≥ ì
  127. terminal'≤ vide∩ attribute≤ oε anΣ off«  Yo⌡ havσ fou≥ byte≤ t∩ ì
  128. usσ fo≥ eacΦ oµ thesσ strings«  Yo⌡ canno⌠ usσ morσ spacσ thaε ì
  129. that«  Fil∞ an∙ unuseΣ byte≤ witΦ zeros«  INVERS┼ VIDE╧ i≤ thσ ì
  130. mos⌠ suitablσ vide∩ functioε t∩ use.
  131.  
  132.     While you're at it you can also change:
  133.  
  134.     MAXDRV:  -- your maximum accessible drive
  135.     MAXUSR:  -- your maximum accessible user
  136.     MAXNARG: -- the maximum number of DIRECTORY EXTENTS
  137.             that will be loaded.  Each extent takes
  138.             17 bytes of RAM
  139.         ADVANC:  -- determine≤ the default status of the
  140.                     "auto-advance to next line" feature
  141.  
  142.      2) assemble the SS-OVR file with ASM, MAC, etc.
  143.  
  144.      3) overlay the SSTAT.OBJ file with the SS-OVRxx.HEX file.
  145.  
  146.     For example, using MLOAD:
  147.  
  148.         A>mload sstat.com=sstat12.obj,ss-ovr11.hex
  149.  
  150.  
  151.     Or using DDT:
  152.  
  153.     A>ddt sstat12.obj<cr>
  154.     DDT VERS 2.2
  155.     NEXT  PC
  156.     1280 0100
  157.     -iss-ovr11.hex<cr>
  158.     -r<cr>
  159.     NEXT  PC
  160.     1280 0100
  161.     -^C
  162.  
  163.     A>save 18 sstat.com<cr>
  164.  
  165. That's all there is to installation!
  166.  
  167. è
  168.                  Copyright Notice and Disclaimer
  169. -----------------------------------------------------------------
  170. SSTA╘ i≤ Copyrigh⌠ (C⌐ b∙ DaviΣ Jewett¼ II╔ - 1986«  Yo⌡ shal∞ ì
  171. no⌠ usσ thi≤ prograφ fo≥ commercia∞ purpose≤ o≥ fo≥ monetar∙ gaiε ì
  172. withou⌠ writteε permissioε froφ thσ author.
  173.  
  174. Thσ autho≥ wil∞ assumσ n∩ liabilit∙ fo≥ an∙ los≤ o≥ damagσ ì
  175. sustaineΣ througΦ thσ usσ oµ thi≤ program.
  176. -----------------------------------------------------------------
  177.