home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 11 Util / 11-Util.zip / DSA2.ZIP / DSA.DOC next >
Text File  |  1991-05-31  |  3KB  |  81 lines
  1.         Directory Size Analyzer v1.0 for OS/2
  2.            Copyright (C) TJD Software 1991
  3.              All rights reserved.
  4.  
  5. This useful program tells you how much space files are occupying in
  6. the current directory and, optionally, in sub directories. It can
  7. report the number of bytes occupied in megabytes (1mb = 1024 x 1024
  8. bytes) or kilobytes (1kb = 1024 bytes) by setting a return code
  9. (sometimes called the ERRORLEVEL) which may be used by, for example, a
  10. REXX program.
  11.  
  12. Usage:
  13.     DSA [path] [switches]
  14.  
  15. [path] is the drive and/or directory that you wish to process. By
  16. specifying a path of '\' in conjunction with the '/S' switch (see
  17. below), a whole drive may be reported on.
  18.  
  19. [switches] controls how DSA will report its findings and are
  20. documented below:
  21.  
  22.  
  23. /H will display usage instructions.
  24.  
  25. /R recurse (include sub-directories).
  26. This switch tells DSA that it is to process any subdirectories that
  27. it finds during processing.
  28.  
  29. /L display LOGICAL space utilisation (default is PHYSICAL).
  30. This switch tells DSA to report the number of occupied bytes that are
  31. LOGICALLY used. Remember that a 1 byte file actually requires MORE
  32. than one byte of disk space because of the way that space is
  33. allocated. If you omit this switch, DSA reports on the actual number
  34. of bytes used.
  35.  
  36. /M Report in Megabytes.
  37. This switch divides the number of bytes by 1048576 and sets the
  38. return code from the result. It is useful if the number of KILOBYTES
  39. is greater than can be accomodated by the return code (approx 32000).
  40. You will almost certainly need to use this switch if you are
  41. processing entire drives. A result of less than 1Mb is reported as 0.
  42.  
  43. /K Report in Kilobytes.
  44. This switch divides the number of bytes by 1024 and sets the return
  45. code from the result. It is useful if the number of KILOBYTES is
  46. relatively small. A result of less than 1kb is reported as 0.
  47.  
  48. If neither the /K nor the /M switch is specified, ERRORLEVEL will be
  49. set to 0 for a successful run.
  50.  
  51. *  1 MEGABYTE = 1048576 bytes.
  52. ** 1 KILOBYTE = 1024 bytes.
  53.  
  54. /S Suppress displays.
  55. This switch is useful if you are running DSA from, for example, a
  56. REXX program and have used the /K or /M switch to obtain a report.
  57.  
  58. DSA will process HPFS drives correctly. Note that the switch
  59. character may be specified as '/' or '-'.
  60.  
  61. TJD Software may be contacted at the following address:
  62.  
  63.     TJD Software, 
  64.     PO Box 61, 
  65.     Keighley, 
  66.     West Yorkshire, 
  67.     BD20 5DY 
  68.     United Kingdom. 
  69.  
  70. Those of you who prefer to contact TJD Software electronically (via
  71. MODEM) should ring the following BBSes:
  72.  
  73.     The TJD Software Support BBS (UK) on +44 (0535) 665345. 
  74.     Contact name Phil Tuck (the SYSOP). 
  75.  
  76.     The TJD Software Support BBS (NL) on +31 (01720) 38558. 
  77.     Contact name Dave Jones (the SYSOP). 
  78.  
  79.     The Mainframe BBS (UK) on +44 (0274) 602788.
  80.     Contact name Steve Mullarkey (the SYSOP).
  81.