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 / ZCPR33 / S-Z / ZSSTAT19.LBR / SSTAT.WZ / SSTAT.WS
Text File  |  2000-06-30  |  7KB  |  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. Once the program has started you have the following commands at 
  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. The first four commands above are self explanatory as are the 'I' 
  78. , 'S' and '?' commands.
  79.  
  80. The Ctrl-T and 'T' keys allow you to "toggle" the file attri
  81. butes.  This means that each successive use of the command flip-
  82. flops the attribute on/off/on, etc.  This works on all eight 
  83. filename attributes as well as the R/O, System, and Archive 
  84. attributes.  If the program has been properly installed (see 
  85. below) the attributes that are ON will be displayed on your CRT 
  86. with a special video attribute.  Attributes are not actually SET 
  87. until you use the Ctrl-A or 'A' command.  When you do so, all 
  88. changes you have made are written to the disk directory.
  89.  
  90. The display uses special "attribute strings" to show the status 
  91. of the R/O, SYS, and ARC attributes.  These strings reflect the 
  92. directory status of the attributes, not the tagged status, so 
  93. they will only be updated when you use the Ctrl-A or 'A' 
  94. commands.
  95.  
  96. The program may auto-advance to the next file after you use the 
  97. toggle command.  You can use the 'N' command to turn this feature 
  98. on or off.
  99.  
  100. The 'F' key allows you to find a particular file in the 
  101. directory.  This is useful if you have a very big directory.  You 
  102. don't need to enter a complete file name for this to work.  For 
  103. instance you could simply enter the letter 'S' in response to the 
  104. "Enter filespec: " prompt, and SSTAT would move you to the first 
  105. file it finds beginning with the letter 'S.'
  106.  
  107. The 'L' command allows you to change the logged drive/user/file 
  108. mask.  It works just like the command argument file spec 
  109. described above.  You may enter a drive letter, user number, 
  110. and/or file name (with wild cards), in any combination.  
  111. IMPORTANT:  if you enter a bad DU: or a file mask for which there èis no match, SSTAT will insist that you enter a good filespec 
  112. before proceeding.   If in doubt, enter *.*.
  113.  
  114. You may use 'X' to return to CP/M.  No warm boot will occur.  You 
  115. may also use control-C to abort the program at any time.
  116.  
  117. Installation
  118. ------------
  119. SSTAT can be run "right out of the can."  You will find it most 
  120. useful, however, if you take the trouble to install it for your 
  121. terminal.  An overlay file, SS-OVRxx.ASM, has been provided to 
  122. assist you.  Use it as follows:
  123.  
  124.      1) with a text editor, load SS-OVRxx.ASM.  Find the labels 
  125. ATTON: and ATTOFF: and install the codes necessary to turn your 
  126. terminal's video attributes on and off.  You have four bytes to 
  127. use for each of these strings.  You cannot use more space than 
  128. that.  Fill any unused bytes with zeros.  INVERSE VIDEO is the 
  129. most suitable video function to 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:  -- determines the default status of the
  139.                     "auto-advance to next line" feature
  140.  
  141.      2) assemble the SS-OVR file with M80 or ZAS, etc.
  142.  
  143.      3) overlay the SSTAT.HEX file with the SS-OVRxx.HEX file.
  144.  
  145.     For example, using MLOAD:
  146.  
  147.         A>mload sstat.com=sstat18.hex,ss-ovr14.hex
  148.  
  149.  
  150.     Or using DDT:
  151.  
  152.     A>ddt sstat18.obj<cr> 
  153.     DDT VERS 2.2
  154.     NEXT  PC
  155.     1280 0100
  156.     -iss-ovr14.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. è                 Copyright Notice and Disclaimer
  166. -----------------------------------------------------------------
  167. SSTAT is Copyright (C) by David Jewett, III - 1986.  You shall 
  168. not use this program for commercial purposes or for monetary gain 
  169. without written permission from the author.
  170.  
  171. The author will assume no liability for any loss or damage 
  172. sustained through the use of this program.
  173. -----------------------------------------------------------------
  174.