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 / MBUG / MBUG077.ARC / SETATT.DOC < prev    next >
Text File  |  1979-12-31  |  3KB  |  84 lines
  1.             SETATT.DOC
  2.  
  3. For CP/M 80 
  4.  
  5. Despite what it says in the assembler file, this is a short doc file on SETATT.
  6.  
  7. Purpose of the program is:
  8.  
  9. To provide a quick means (ie an alternative to 'STAT') to change attributes on
  10. files .     -- ie, to allow changes from R/O to R/W, R/W to R/O, DIR to SYS and
  11. SYS to DIR etc    by allowing for multiple-file access via ambiguous filenames
  12. but with the additional facility to select or reject specific files under a
  13. query system (a la XERA, ERAQ etc, but simply setting or resetting the relevant
  14. file attributes).
  15.  
  16.  
  17. SETATT was originally published in 'Microcomputing' by Ian Ashdown, (vol VIII,
  18. no 5, May, 1984.
  19.  
  20. COPYRIGHT IN THE PROGRAM RESIDES IN:
  21.  
  22.         Ian Ashdown,
  23.         byHeart Software,
  24.         2 - 2016 West 1st Avenue,
  25.         Vancouver,B.C. V6J 1G8
  26.         Canada
  27.  
  28. AND IT HAS BEEN RELEASED INTO THE PUBLIC DOMAIN FOR NON-COMMERCIAL USE.
  29.  
  30. This version, arbitrarily called version 1.1, contains modifications by Peter
  31. Martin to allow access to the 'archive' bit (ie, bit 7 of the 3rd filetyp
  32. character).   
  33.  
  34. Arbitrarily, and without knowledge of convention to the contrary -- the ARCHIVE
  35. bit is referred to as such, and its states are referred to as 'ARC' for
  36. 'ARCHIVED' (ie, the bit is set)     and 'NRC' for 'NON-ARCHIVED'.
  37.  
  38. Some modifications beyond expansion of use were made to the code in
  39. version 1.1 also.
  40.  
  41. USAGE is:
  42.  
  43.     SETATT <afn.typ> (specifier)
  44.  
  45. where filenames/types can be ambiguous, and (specifier) must be present, and be
  46. one (and not more than one ) of six possibilities:
  47.  
  48.     R/W        for setting all found and matching files to READ/WRITE
  49.     R/O         "    "     "    "       "     "     "    " READ-ONLY
  50.     DIR         "    "     "    "       "     "     "    " DIRECTORY
  51.     SYS         "    "     "    "       "     "     "    " SYSTEM
  52.     NRC         "    "     "    "       "     "     "    " NON-ARCHIVED
  53.     ARC         "    "     "    "       "     "     "    " ARCHIVED
  54.  
  55. Files are checked when found to see what attribute settings they have, and
  56. these are displayed in all cases (cf version 1.0 ). If none are found requiring
  57. the change sought, the program exits with a message to that effect.
  58.  
  59. As each file matching the search pattern is found, the state of attributes is
  60. shown on the screen, and where a change is required, an option is given on the
  61. console to either have the particular file changed to the status nominated, or
  62. skipped.
  63.  
  64. Files requiring no changes (ie, which match the desired attribute status) are
  65. flagged as already set to the required status.
  66.  
  67. A closing option permits an exit with NO CHANGE of attributes on any files, ie,
  68. the program double-checks with the user at the end, and aborts with NO changes
  69. if the request for changes is not confirmed.
  70.  
  71. May be of use when you are also using BU from BU.C which is by the same author.
  72.  
  73.  
  74. Peter Martin
  75. 16/14 Royston Street,
  76. KINGS CROSS 2011
  77. Sydney , N.S.W.,
  78. Australia
  79. (02) 331-3549
  80.  
  81. 11 June 1985
  82.  
  83. /* end of setatt.doc */
  84.