home *** CD-ROM | disk | FTP | other *** search
/ Oakland CPM Archive / oakcpm.iso / cpm / dirutl / eraz11.lbr / ERAZ11.HZP / ERAZ11.HLP
Text File  |  1988-05-09  |  12KB  |  236 lines

  1. ;
  2.                         ---  E R A Z  ---        
  3.  
  4.                            Version 1.1
  5.  
  6.  
  7.        An Enhanced ZCPR3-Compatible File Erasing Utility
  8.  
  9.  
  10.  
  11.                     I -->  Installation  
  12.                     O -->  Overview      
  13.                     S -->  Syntax        
  14.                     / -->  Options       
  15.                     M -->  Modifications  
  16. :I
  17.  
  18.  Installation 
  19.  
  20. Thσ distributioε versioε oµ ERA┌ i≤ supplieΣ witΦ aε AMPR╧ standarΣ Z3EN╓ ì
  21. addres≤ oµ FE00H«  ZCPR3.░ user≤ witΦ othe≥ Z3EN╓ location≤ shoulΣ instal∞ ì
  22. ERA┌ usinτ Z3INS.CO═ anΣ SYS.EN╓ iε thσ norma∞ manner«  
  23.  
  24. N∩ installatioε i≤ requireΣ fo≥ operatioε iε ZCPR3.│ o≥ non-ZCPR│ ì
  25. environments«  Fo≥ operatioε iε ß non-ZCPR│ environment¼ thσ maximuφ drivσ ì
  26. anΣ use≥ tha⌠ wil∞ bσ accepteΣ ma∙ bσ patcheΣ a≤ describeΣ below.
  27.  
  28. :O
  29.  
  30.  Overview ì
  31.  
  32. ERA┌ i≤ aε enhanceΣ Z8░ filσ erasinτ utilit∙ fo≥ usσ witΦ ZCPR│ anΣ CP/═ ì
  33. 2.▓ o≥ ZRDOS«  ERA┌ ha≤ no⌠ beeε testeΣ witΦ CP/═ 3.0.
  34.  
  35. ERA┌ wa≤ designeΣ a≤ ß genera∞ purposσ filσ erasinτ utilit∙ a≤ wel∞ a≤ ß ì
  36. companioε t∩ thσ ACOP┘ serie≤ oµ filσ utilities«  I⌠ caε hel≡ reducσ thσ ì
  37. ALIA╙ commanΣ linσ lengtΦ requireΣ t∩ erasσ group≤ oµ file≤ witΦ unrelateΣ ì
  38. name≤ b∙ optionall∙ erasinτ onl∙ thosσ file≤ tha⌠ havσ beeε taggeΣ witΦ an∙ ì
  39. combinatioε oµ thσ filσ attribute≤ F▒ througΦ F╖ (erasσ iµ AN┘ oµ thσ ì
  40. selecteΣ attribute≤ arσ set)«  
  41.  
  42. Fo≥ example¼ ERA┌ caε bσ useΣ witΦ thσ /▓ optioε t∩ clea≥ ß RA═ disδ oµ thσ ì
  43. file≤ tha⌠ werσ loadeΣ fo≥ ß specifiπ applicatioε usinτ ACOP┘ anΣ thσ samσ ì
  44. /▓ optioε (copyinτ onl∙ file≤ havinτ thσ attributσ F▓ set)¼ leavinτ thσ RA═ ì
  45. disδ witΦ al∞ othe≥ file≤ intac⌠ anΣ read∙ fo≥ anothe≥ applicatioε t∩ bσ ì
  46. loaded.
  47.  
  48. File≤ ma∙ bσ taggeΣ usinτ thσ ZRDO╙ utilit∙ SF┴ (Se⌠ Filσ Attributes⌐ o≥ ß ì
  49. simila≥ CP/═ Publiπ Domaiε utilit∙ sucΦ a≤ DA«  ERA┌ als∩ ha≤ ß numbe≥ oµ ì
  50. othe≥ option≤ whicΦ arσ describeΣ in the Option≤ section.
  51.  
  52. ERA┌ i≤ full∙ ZCPR│ compatiblσ wheε operatinτ iε ß ZCPR│ environment¼ ì
  53. acceptinτ botΦ thσ DIR║ anΣ thσ DU║ form≤ anΣ checkinτ thσ environmen⌠ t∩ ì
  54. obtaiε thσ maximuφ drivσ anΣ use≥ tha⌠ wil∞ bσ accepted¼ whethe≥ i⌠ i≤ t∩ ì
  55. bσ operatinτ iε ß quie⌠ environment¼ anΣ thσ namσ unde≥ whicΦ thσ prograφ ì
  56. wa≤ calleΣ fo≥ usσ iε thσ HEL╨ message«  Error≤ wil∞ causσ thσ ZCPR│ ì
  57. prograφ erro≥ flaτ t∩ bσ set«  Wheε operatinτ iε ß ZRDO╙ environment¼ file≤ ì
  58. iε thσ PUBLI├ area≤ arσ protected.
  59.  
  60. Wheε ERA┌ operate≤ iε ß non-ZCPR│ environment¼ thσ requireΣ informatioε i≤ ì
  61. obtaineΣ froφ interna∞ locations¼ whicΦ ma∙ bσ patcheΣ a≤ describeΣ below«  ì
  62. ERA┌ wil∞ no⌠ accep⌠ thσ DIR║ forφ wheε operatinτ iε ß non-ZCPR│ ì
  63. environment.
  64.  
  65. :S
  66.  
  67.  Syntax ì
  68.  
  69.           ERAZá[dir:]afn1á[[dir:]afn2 ...] [/option(s)▌ì
  70.  
  71. T∩ hel≡ yo⌡ clea≥ you≥ workspacσ witΦ ß singlσ command¼ ERA┌ allow≤ yo⌡ t∩ ì
  72. specif∙ u≡ t∩ 1╢ separatσ ambiguou≤ filename≤ oε thσ commanΣ line«  Notσ ì
  73. tha⌠ eacΦ filenamσ specifieΣ require≤ it≤ owε DIR║ o≥ DU║ reference«  ì
  74. However¼ an∙ option≤ als∩ specifieΣ wil∞ bσ applieΣ t∩ AL╠ filenames!
  75.  
  76. Wheneve≥ yo⌡ includσ thσ wildcarΣ filenamσ masδ '*.*º (unles≤ yo⌡ als∩ ì
  77. specif∙ thσ Inspec⌠ (/I⌐ option)¼ ERA┌ wil∞ asδ yo⌡ iµ yo⌡ wan⌠ t∩ "Erasσ ì
  78. AL╠ Files?ó anΣ wil∞ awai⌠ ß responsσ froφ yo⌡ beforσ al∞ remaininτ file≤ ì
  79. arσ erased«  Thi≤ i≤ t∩ hel≡ preven⌠ accidentall∙ erasinτ al∞ you≥ file≤ ì
  80. duσ t∩ thσ sli≡ oµ ß finger«  An∙ responsσ excep⌠ 'Yº o≥ 'yº wil∞ causσ ì
  81. ERA┌ t∩ abor⌠ a⌠ tha⌠ point«  
  82.  
  83. Iµ yo⌡ d∩ accidentall∙ erasσ an∙ files¼ IMMEDIATEL┘ usσ aε filσ unerasσ ì
  84. utilit∙ sucΦ a≤ UNERAZ¼ UNERA¼ o≥ UNERAS┼ beforσ performinτ an∙ operation≤ ì
  85. tha⌠ wil∞ writσ an∙ file≤ t∩ you≥ diskí  Disδ writσ operation≤ ma∙ reusσ ì
  86. an∙ director∙ entrie≤ markeΣ a≤ erased¼ anΣ thereb∙ makσ i⌠ impossiblσ t∩ ì
  87. recove≥ you≥ eraseΣ files.
  88. :/
  89.  
  90.  Options ì
  91.  
  92. ERA┌ ha≤ ß numbe≥ oµ commanΣ linσ options¼ whicΦ mus⌠ bσ precedeΣ b∙ thσ ì
  93. optioε flaτ characte≥ '/'«  Thσ optioε letter≤ o≥ number≤ ma∙ appea≥ iε an∙ ì
  94. orde≥ anΣ ma∙ appea≥ anywherσ iε thσ commanΣ line«  Option≤ ma∙ bσ combineΣ ì
  95. iε an∙ combination«  Option≤ arσ toggleΣ a≤ the∙ arσ read¼ s∩ tha⌠ aε ì
  96. optioε appearinτ twicσ wil∞ cance∞ itself«  Al∞ oµ thσ followinτ commanΣ ì
  97. line≤ havσ thσ samσ meaning:
  98.  
  99.  
  100. áááááááá  A0>erazá/12qáafn1 afn2ì
  101. áááááááá  A0>erazáafn1á/▒á/±á/2 afn2ì
  102. áááááááá  A0>erazá/12áafn2á/± afn1ì
  103. áááááááá  A0>erazá/qá/q afn1á/±á/2▒ afn2
  104.  
  105.  
  106. Thσáoptions are║
  107.  
  108.      Iá-áInspec⌠ option«  Display≤ eacΦ proposeΣ erasσ anΣ ask≤ ì
  109. ááááááááááfo≥ operato≥ approva∞ beforσ proceeding«  Thσ defaul⌠ ì
  110. áááááááááái≤ t∩ automaticall∙ erasσ R/W file≤ withou⌠ asking.
  111.  
  112.      A - Erase≤ al∞ (botΦ director∙ anΣ system⌐ specifieΣ files«  ì
  113. ááááááááááThσ defaul⌠ i≤ t∩ erasσ director∙ file≤ only.
  114.  
  115.      R - R/╧ option«  Erase≤ R/╧ file≤ withou⌠ asking«  Normally¼ ì
  116. ááááááááááyo⌡ arσ askeΣ first.
  117.  
  118. ááááá1á- 7 options«  Erase≤ onl∙ thosσ specifieΣ file≤ whicΦ als∩ ì
  119. ááááááááááhavσ thσ selecteΣ combinatioε oµ thσ F▒ througΦ thσ F╖ ì
  120. ááááááááááattribute≤ set«  ì
  121.  
  122. ááááQá-áQuie⌠ option«  Turn≤ ofµ non-erro≥ messages«  An∙ ì
  123. ááááááááááinformatioε yo⌡ shoulΣ kno≈ abou⌠ durinτ thσ erasinτ ì
  124. ááááááááááprocess¼ sucΦ a≤ erro≥ information¼ i≤ stil∞ displayed«  ì
  125. ááááááááááWil∞ no⌠ erasσ an∙ systeφ o≥ R/╧ file≤ unles≤ thσ A o≥ ì
  126. ááááááááááR optioεs are als∩ used«  
  127.  
  128.           Wheε operatinτ iε ß ZCPR│ environment¼ thσ ╤ optioε ì
  129. ááááááááááinitia∞ settinτ wil∞ automaticall∙ bσ se⌠ accordinτ t∩ ì
  130. ááááááááááthσ statσ oµ thσ ZCPR│ QUIE╘ flag«  Iµ thσ ╤ optioε ha≤ ì
  131. ááááááááááaε initia∞ settinτ oµ ON¼ thσ usσ oµ ╤ iε thσ commanΣ ì
  132. áááááááááálinσ wil∞ theε togglσ thσ ╤ optioε OFF«  Thσ hel≡ ì
  133. ááááááááááscreeε wil∞ automaticall∙ displa∙ thσ prope≥ meaninτ oµ ì
  134. ááááááááááthσ ╤ option.
  135.  
  136. :M
  137.  
  138.  Modifications ì
  139.  
  140. ERA┌ ha≤ severa∞ location≤ nea≥ thσ beginninτ oµ thσ prograφ tha⌠ caε bσ ì
  141. patcheΣ usinτ DDT¼ PATCH¼ ZPATCH¼ etc¼ t∩ alte≥ thσ operatioε oµ thσ ì
  142. prograφ t∩ sui⌠ thσ user«  Thσ followinτ tablσ list≤ thei≥ location≤ anΣ ì
  143. thσ distributioε defaults.
  144.  
  145. Iµ yo⌡ arσ operatinτ iε ß ZCPR│ environmen⌠ anΣ wisΦ t∩ renamσ thσ program¼ ì
  146. thσ namσ b∙ whicΦ thσ prograφ is invokeΣ wil∞ automaticall∙ appea≥ iε thσ ì
  147. HEL╨ message¼ anΣ n∩ patchinτ neeΣ bσ done« 
  148.  
  149. Iµ yo⌡ arσ primaril∙ operatinτ iε ß non-ZCPR│ environment¼ thσ prograφ ì
  150. name¼ 'ERAZ'¼ a⌠ locatioε 010BH-0112H¼ ma∙ bσ patcheΣ t∩ an∙ desireΣ ne≈ ì
  151. name¼ whicΦ wil∞ theε appea≥ a⌠ thσ prope≥ place≤ iε thσ HEL╨ messagσ wheε ì
  152. i⌠ i≤ called«  ┴ maximuφ oµ eigh⌠ character≤ arσ available«  Fil∞ thσ ì
  153. unuseΣ characte≥ position≤ witΦ spacσ characters¼ a≤ space≤ iε an∙ oµ thσ ì
  154. eigh⌠ location≤ wil∞ bσ ignored«  Fo≥ example¼ t∩ changσ thσ namσ oµ thσ ì
  155. prograφ froφ ERA┌ t∩ ERA¼ yo⌡ ma∙ simpl∙ patcΦ thσ 'Zº iε 'ERAZº t∩ ß spacσ ì
  156. characte≥ (20H⌐ anΣ thσ HEL╨ messagσ wil∞ theε displa∙ 'ERAº witΦ n∩ extrß ì
  157. spaces«  
  158.      
  159. Thσ optioε flaτ anΣ thσ defaul⌠ optioε character≤ ma∙ bσ changeΣ iµ yo⌡ ì
  160. prefe≥ othe≥ mnemonics«  Thσ changeΣ character≤ wil∞ automaticall∙ appea≥ ì
  161. iε thσ hel≡ message.
  162.  
  163. Thσ option≤ arσ al∞ OFF-O╬ toggles« Thσ defaul⌠ setting≤ fo≥ thσ option≤ ì
  164. ma∙ bσ changeΣ froφ OF╞ (00H⌐ t∩ O╬ (0FFH⌐ t∩ allow¼ fo≥ example¼ alway≤ ì
  165. inspectinτ file≤ beforσ erasinτ withou⌠ havinτ t∩ usσ thσ /╔ option«  Notσ ì
  166. tha⌠ iµ yo⌡ theε usσ thσ /╔ option¼ i⌠ wil∞ turε OF╞ thσ automatiπ ì
  167. inspection«  Iµ yo⌡ changσ thσ optioε defaul⌠ setting≤ b∙ patching¼ thσ ì
  168. hel≡ messagσ wil∞ automaticall∙ tr∙ t∩ reflec⌠ thesσ changes«  
  169.  
  170. Sincσ changinτ somσ oµ thσ defaul⌠ optioε setting≤ ma∙ changσ thσ operatioε ì
  171. oµ ERA┌ b∙ removinτ somσ oµ thσ built-iε safet∙ factor≤ tha⌠ hel≡ preven⌠ ì
  172. overwritinτ importan⌠ existinτ file≤ b∙ accident¼ cautioε shoulΣ bσ ì
  173. exerciseΣ iε changinτ an∙ oµ thσ defaul⌠ optioε settings!
  174.  
  175. Iµ i⌠ i≤ desireΣ t∩ eliminatσ AL╠ optioε choice≤ followinτ ß giveε option¼ ì
  176. patcΦ thσ FIRS╘ undesireΣ optioε lette≥ o≥ numbe≥ t∩ ß 00╚ (fo≥ example¼ t∩ ì
  177. eliminatσ thσ F1-F╖ options¼ changσ thσ F▒ bytσ a⌠ 0121╚ froφ '1º t∩ 00H)«  ì
  178. Al∞ subsequen⌠ optioε choice≤ wil∞ n∩ longe≥ operate.
  179.  
  180. Wheε ERA┌ step≤ througΦ ß numbe≥ oµ files¼ i⌠ ma∙ generatσ morσ thaε ß ì
  181. screenfu∞ oµ display«  T∩ hel≡ summarizσ wha⌠ ha≤ happened¼ ERA┌ display≤ ì
  182. thσ tota∞ numbe≥ oµ file≤ eraseΣ oε completioε oµ thσ program«  Iµ yo⌡ ì
  183. prefe≥ no⌠ t∩ havσ thi≤ display¼ patcΦ locatioε 0119╚ froφ FF╚ (displa∙ ì
  184. tota∞ numbe≥ oµ file≤ erased⌐ t∩ 00╚ (n∩ display).
  185.  
  186. Location áá Default      Purposeááááááá                               
  187. ================================================================   ì
  188. á 010BHááááá'ERAZ    '   Prograφánamσá(╕ácharacter≤ámaximum⌐ááá      ì
  189.  -0112Háá                      ¡áAppear≤áiεáHEL╨ámessagσ             
  190.                                                                      
  191. áá0114Háááá '»'          Optioεáflaτácharacte≥áááááá                 
  192.                          
  193.   0115H     10H          Maximum drive allowed (A=1H, P=10H)         
  194.                          
  195.   0116H     0FH          Maximum user area allowed (15D=0FH)         
  196.                          
  197.   0119H     ON (FFH)     Display the number of files copied          
  198.                          
  199.   011AH     10H (16D)    Maximum number of filenames accepted
  200.                          (This value may be decreased only)
  201.  
  202. áá011BHáááá 'I'          Inspect option characte≥áááááá              ì
  203. áá011CHáááá OFF (00H)    Inspectádefaul⌠ásettinτáááááá               
  204.                                                                      
  205. áá011DHááááá'A'          Include all files characterì
  206. áá011EHáááááOFF (00H)    Include all filesádefaul⌠ásettinτ          
  207.                                                                      
  208.   011FHáááá '╥'          EraseáR/OáªáR/Wáfile≤áoptioεácha≥acter áì
  209. áá0120Háááá OFF (00H)    EraseáR/OáªáR/Wáfile≤ádeµaultásettinτ   
  210.                                                                      
  211.   0121Háááá '▒'          F▒áattributσáoptioεácharacte≥ááááá          ì
  212. áá0122Háááá OFF (00H)    F▒áattributσádefaul⌠ásettinτááááá           
  213.                                                                      
  214.   0123Háááá '▓'          F▓áattributσáoptioεácharacte≥ááááá          ì
  215. áá0124Háááá OFF (00H)    F▓áattributσádefaul⌠ásettinτááááá           
  216.                                                                      
  217.   0125Háááá '│'          F│áattributσáoptioεácharacte≥ááááá          ì
  218. ááO126Háááá OFF (00H)    F│áattributσádefaul⌠ásettinτááááá           
  219.                                                                      
  220.   0127Háááá '┤'          F┤áattributσáoptioεácharacte≥ááááá          ì
  221. áá0128Háááá OFF (00H)    F┤áattributσádefaul⌠ásettinτááááá           
  222.                                                                     
  223.   0129Háááá '╡'          F╡áattributσáoptioεácharacte≥ááááá          ì
  224. áá012AHáááá OFF (00H)    F╡áattributσádefaul⌠ásettinτááááá           
  225.                                                                      
  226.   012BHáááá '╢'          F╢áattributσáoptioεácharacte≥ááááá          ì
  227. áá012CHáááá OFF (00H)    F╢áattributσádefaul⌠ásettinτááááá           
  228.                                                                      
  229.   012DHáááá '╖'          F╖áattributσáoptioεácharacte≥ááááá          ì
  230. áá012EHáááá OFF (00H)    F╖áattributσádefaul⌠ásettinτááááá           
  231.                                                                      
  232. áá012FHáááá '╤'          Quie⌠áoptioεácharacte≥áááááá                
  233. á 0130Háááá OFF (00H)    Quie⌠áoptioεádefaul⌠ásettinτááááá           
  234.  
  235.  
  236.