home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / lambda / soundpot / p / sstat19.lbr / SSTAT.WZ / SSTAT.WS
Encoding:
Text File  |  1993-10-25  |  6.6 KB  |  174 lines
  1. .op
  2. .heSSTAT.WS                    02/06/86                    Page #
  3. -----------------------------------------------------------------
  4.                 Information on the SSTAT program
  5. -----------------------------------------------------------------
  6.  
  7. Description
  8. -----------
  9. SSTAT is a substitute for the program STAT.COM that Digital 
  10. Research supplies with the CP/M operating system.  It does most 
  11. of the things that STAT.COM does and has some additional 
  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.      - see the SIZE of each file in Records, Kilobytes, 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.      - change file attributes interactively.  The archive 
  35.        attribute is supported.
  36.  
  37. Lacking in SSTAT is the capability to change the IOBYTE.  You'll 
  38. need STAT.COM or a system configuration program to do this.
  39.  
  40.  
  41. Operation
  42. ---------
  43. With SSTAT you "log-on" to a drive and user area, just like you 
  44. do with the popular SWEEP-style utilities.   A drive/user (DU:) 
  45. and file mask can be entered from the system prompt at startup or 
  46. can be entered after the program is running.  Here are some 
  47. command examples:
  48.  
  49.      A0>sstat //     (prints a short usage message)
  50.  
  51.      A0>sstat        (no argument, logs 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. Once the program has started you have the following commands at 
  60. your disposal:
  61.  
  62.             Command Key             Function
  63.          -------------------  ----------------------
  64.      <Ctrl-E> or <CR>     move forward one file
  65.      <Ctrl-X> or <B>      move back one file
  66.      <Ctrl-S> or <Ctrl-H> move the cursor left
  67.      <Ctrl-D> or <SPACE>  move cursor right
  68.      <Ctrl-T> or <T>      toggle file attribute
  69.      <Ctrl-A> or <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. The first four commands above are self explanatory as are the 'I' 
  79. , 'S' and '?' commands.
  80.  
  81. The Ctrl-T and 'T' keys allow you to "toggle" the file attri
  82. butes.  This means that each successive use of the command flip-
  83. flops the attribute on/off/on, etc.  This works on all eight 
  84. filename attributes as well as the R/O, System, and Archive 
  85. attributes.  If the program has been properly installed (see 
  86. below) the attributes that are ON will be displayed on your CRT 
  87. with a special video attribute.  Attributes are not actually SET 
  88. until you use the Ctrl-A or 'A' command.  When you do so, all 
  89. changes you have made are written to the disk directory.
  90.  
  91. The display uses special "attribute strings" to show the status 
  92. of the R/O, SYS, and ARC attributes.  These strings reflect the 
  93. directory status of the attributes, not the tagged status, so 
  94. they will only be updated when you use the Ctrl-A or 'A' 
  95. commands.
  96.  
  97. The program may auto-advance to the next file after you use the 
  98. toggle command.  You can use the 'N' command to turn this feature 
  99. on or off.
  100.  
  101. The 'F' key allows you to find a particular file in the 
  102. directory.  This is useful if you have a very big directory.  You 
  103. don't need to enter a complete file name for this to work.  For 
  104. instance you could simply enter the letter 'S' in response to the 
  105. "Enter filespec: " prompt, and SSTAT would move you to the first 
  106. file it finds beginning with the letter 'S.'
  107.  
  108. The 'L' command allows you to change the logged drive/user/file 
  109. mask.  It works just like the command argument file spec 
  110. described above.  You may enter a drive letter, user number, 
  111. and/or file name (with wild cards), in any combination.  
  112. IMPORTANT:  if you enter a bad DU: or a file mask for which there 
  113. èis no match, SSTAT will insist that you enter a good filespec 
  114. before proceeding.   If in doubt, enter *.*.
  115.  
  116. You may use 'X' to return to CP/M.  No warm boot will occur.  You 
  117. may also use control-C to abort the program at any time.
  118.  
  119. Installation
  120. ------------
  121. SSTAT can be run "right out of the can."  You will find it most 
  122. useful, however, if you take the trouble to install it for your 
  123. terminal.  An overlay file, SS-OVRxx.ASM, has been provided to 
  124. assist you.  Use it as follows:
  125.  
  126.      1) with a text editor, load SS-OVRxx.ASM.  Find the labels 
  127. ATTON: and ATTOFF: and install the codes necessary to turn your 
  128. terminal's video attributes on and off.  You have four bytes to 
  129. use for each of these strings.  You cannot use more space than 
  130. that.  Fill any unused bytes with zeros.  INVERSE VIDEO is the 
  131. most suitable video function to use.
  132.  
  133.     While you're at it you can also change:
  134.  
  135.     MAXDRV:  -- your maximum accessible drive
  136.     MAXUSR:  -- your maximum accessible user
  137.     MAXNARG: -- the maximum number of DIRECTORY EXTENTS
  138.             that will be loaded.  Each extent takes
  139.             17 bytes of RAM
  140.         ADVANC:  -- determines the default status of the
  141.                     "auto-advance to next line" feature
  142.  
  143.      2) assemble the SS-OVR file with M80 or ZAS, etc.
  144.  
  145.      3) overlay the SSTAT.HEX file with the SS-OVRxx.HEX file.
  146.  
  147.     For example, using MLOAD:
  148.  
  149.         A>mload sstat.com=sstat18.hex,ss-ovr14.hex
  150.  
  151.  
  152.     Or using DDT:
  153.  
  154.     A>ddt sstat18.obj<cr> 
  155.     DDT VERS 2.2
  156.     NEXT  PC
  157.     1280 0100
  158.     -iss-ovr14.hex<cr>
  159.     -r<cr>
  160.     NEXT  PC
  161.     1280 0100
  162.     -^C
  163.  
  164.     A>save 18 sstat.com<cr>
  165.  
  166. That's all there is to installation!
  167.  
  168. è                 Copyright Notice and Disclaimer
  169. -----------------------------------------------------------------
  170. SSTAT is Copyright (C) by David Jewett, III - 1986.  You shall 
  171. not use this program for commercial purposes or for monetary gain 
  172. without written permission from the author.
  173.  
  174. The author will assume no liability for any loss or damage 
  175. sustained through the use of this program.
  176. -----------------------------------------------------------------
  177.