home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / jsage / zsus / z3help / a.lbr / ACOPY.HLP < prev    next >
Encoding:
Text File  |  1991-11-18  |  23.1 KB  |  467 lines

  1. ;
  2.                                                   
  3.                             ---  A C O P Y  ---          
  4.                                                   
  5.                                 Version 3.3
  6.  
  7.               An Enhanced ZCPR3-Compatible File Copy Utility
  8.         With Optional Source and Destination Disk Directory Caching
  9.  
  10.  
  11.  
  12.             I -->  Installation       A -->  File Attributes        
  13.             O -->  Overview           D -->  DOS Datestamping       
  14.             S -->  Syntax             F -->  Dest Free Space        
  15.             W -->  Wildcard Use       E -->  Error Flag             
  16.             C -->  Caching            B -->  Backing Up Files 
  17.             / -->  Options            
  18.  
  19. :I                       
  20. Installation
  21.  
  22. Thσ distributioε versioε oµ ACOP┘ i≤ supplieΣ witΦ ß Z3EN╓ addres≤ oµ ì
  23. 0000H¼ read∙ fo≥ usσ iε ZCPR33½ o≥ non-ZCPR│ environments«  
  24.  
  25. ZCPR3░ user≤ shoulΣ instal∞ ACOP┘ usinτ thei≥ regula≥ installatioε methods«  
  26.  
  27.  
  28. Configurationì
  29.  
  30. ZCNFG17.CO═ anΣ thσ configuratioε filσ ACOPY.CF╟ ma∙ bσ useΣ t∩ changσ ì
  31. ACOPY.COM'≤ user-configurablσ setting≤ t∩ configurσ ACOPY'≤ operatioε t∩ ì
  32. sui⌠ thσ use≥, althougΦ thσ defaul⌠ value≤ shoulΣ bσ satisfactor∙ fo≥ mos⌠ ì
  33. users«
  34. :O
  35. Overview - 1/2ì
  36.  
  37. ACOP┘ (Attributσ COPY⌐ i≤ aε enhanceΣ Z8░ filσ cop∙ utilit∙ fo≥ usσ witΦ ì
  38. CP/═ 2.2¼ CP/M+¼ o≥ ZCPR│ CCP'≤ runninτ unde≥ CP/═ 2.2¼ CP/M+¼ Z80DOS¼ ì
  39. ZRDOS¼ ZSDOS/ZDDO╙ o≥ othe≥ extendeΣ DOS's«  
  40.  
  41. ACOPY¼ originall∙ baseΣ oε DaviΣ Jewett¼ III'≤ PPIP12¼ wa≤ developeΣ a≤ ß ì
  42. fast¼ genera∞ purposσ filσ cop∙ utilit∙ witΦ flexiblσ commanΣ linσ optioε ì
  43. contro∞ ove≥ man∙ aspect≤ oµ thσ cop∙ process¼ anΣ morσ specificall∙ t∩ ì
  44. hel≡ simplif∙ thσ commanΣ linσ scrip⌠ requireΣ t∩ cop∙ group≤ oµ file≤ witΦ ì
  45. unrelateΣ name≤ t∩ ß RA═ disk«  I⌠ doe≤ thi≤ b∙ optionall∙ copyinτ onl∙ ì
  46. thosσ file≤ tha⌠ havσ an∙ oµ thσ specifieΣ filenamσ attribute≤ (thσ higΦ ì
  47. bit≤ oµ thσ filenamσ anΣ filetypσ bytes⌐ F▒ througΦ F╖ set«  Filenamσ ì
  48. attribute≤ ma∙ bσ se⌠ usinτ ß ZCPR│ utilit∙ sucΦ a≤ DF┴ (Display/Definσ ì
  49. Filσ Attributes⌐ o≥ ß simila≥ CP/═ Publiπ Domaiε utilit∙ sucΦ a≤ DA«  Seσ ì
  50. thσ 'Optionsº sectioε fo≥ informatioε oε thσ res⌠ oµ ACOPY'≤ commanΣ linσ ì
  51. options.
  52. Overview - 2/2
  53.  
  54. ACOP┘ automaticall∙ support≤ DO╙ datestampinτ wheε i⌠ operate≤ unde≥ CP/M+¼ ì
  55. Z80DO╙ o≥ ZSDOS«  Seσ thσ 'DO╙ Datestampingº sectioε fo≥ morσ information.
  56.  
  57. ACOP┘ i≤ full∙ ZCPR│ compatiblσ wheε operatinτ iε ß ZCPR│ environment¼ ì
  58. acceptinτ botΦ thσ DU║ anΣ DIR║ form≤ anΣ checkinτ thσ environmen⌠ fo≥ thσ ì
  59. validit∙ oµ thσ drivσ anΣ use≥ specified¼ whethe≥ i⌠ i≤ t∩ bσ operatinτ iε ì
  60. ß quie⌠ environmen⌠ anΣ thσ namσ thσ prograφ wa≤ calleΣ b∙ fo≥ usσ iε thσ ì
  61. commanΣ linσ HEL╨ message«  ACOP┘ wil∞ operatσ usinτ thσ ZCPR│ G╧ command«  ì
  62. Error≤ wil∞ causσ thσ ZCPR│ prograφ erro≥ flaτ t∩ bσ set«  Wheε operatinτ ì
  63. unde≥ ZRDOS¼ file≤ iε thσ ZRDO╙ PUBLI├ area≤ arσ protected.
  64.  
  65. Wheε ACOP┘ operate≤ iε ß non-ZCPR│ environment¼ thσ informatioε i⌠ need≤ i≤ ì
  66. obtaineΣ froφ interna∞ locations¼ whicΦ ma∙ bσ configureΣ t∩ sui⌠ you≥ ì
  67. need≤ usinτ ZCNF╟ anΣ ACOPY.CFG«  ACOP┘ wil∞ no⌠ accep⌠ thσ DIR║ forφ wheε ì
  68. operatinτ iε ß non-ZCPR│ environment.
  69. :C
  70. Disk Directory Caching - 1/2
  71.  
  72. ACOP┘ caε bσ configureΣ s∩ tha⌠ i⌠ cache≤ botΦ thσ sourcσ anΣ destinatioε ì
  73. disδ directorie≤ iε RA═ t∩ speeΣ u≡ thσ copyinτ proces≤ wheε i⌠ run≤ unde≥ ì
  74. CP/═ 2.2-compatiblσ systems«  Becausσ CP/M½ handle≤ director∙ operation≤ ì
  75. differently¼ director∙ cachinτ i≤ automaticall∙ turneΣ ofµ wheε ACOP┘ run≤ ì
  76. unde≥ CP/M+«  ACOP┘ i≤ distributeΣ witΦ director∙ cachinτ turneΣ off¼ bu⌠ ì
  77. i⌠ ma∙ bσ activateΣ b∙ usinτ ZCNF╟ and ACOPY.CFG.ì
  78.  
  79. ACOP┘ adapt≤ thσ idea≤ developeΣ b∙ Ha∞ Bowe≥ iε hi≤ SPEEDU╨ director∙ ì
  80. buffe≥ RS╪ t∩ cachσ botΦ sourcσ anΣ destinatioε disδ directorie≤ iε RAM«  ì
  81. Al∞ reference≤ t∩ sourcσ anΣ destinatioε director∙ entries¼ u≡ t∩ ß maximuφ ì
  82. oµ 25╢ entrie≤ pe≥ directory¼ arσ madσ t∩ thσ cacheΣ RA═ copies¼ ì
  83. eliminatinτ thσ timσ requireΣ t∩ movσ thσ disδ drivσ heaΣ t∩ thσ director∙ ì
  84. track¼ reaΣ thσ requireΣ director∙ recorΣ anΣ theε movσ thσ heaΣ bacδ t∩ ì
  85. thσ requireΣ disδ tracδ eacΦ timσ ß director∙ referencσ i≤ made«  Al∞ ì
  86. reference≤ t∩ director∙ entrie≤ no⌠ iε thσ RA═ cachσ arσ madσ t∩ thσ mediß ì
  87. disδ directorie≤ a≤ usual«  Wheε thσ cop∙ proces≤ i≤ complete¼ al∞ changeΣ ì
  88. cacheΣ sourcσ anΣ director∙ director∙ record≤ arσ writteε bacδ t∩ thσ ì
  89. sourcσ anΣ destinatioε disks«  
  90. Disk Directory Caching - 2/2
  91.  
  92. Disδ director∙ cachinτ i≤ mos⌠ effectivσ witΦ flopp∙ disks¼ bu⌠ i⌠ i≤ als∩ ì
  93. slightl∙ faste≥ witΦ RA═ disk≤ anΣ harΣ disks«  I⌠ i≤ no⌠ a≤ effectivσ wheε ì
  94. datestamper-typσ datestampinτ i≤ beinτ done¼ a≤ thσ requireΣ accesse≤ t∩ ì
  95. thσ !!!TIME&.DA╘ filσ offse⌠ mucΦ oµ thσ timσ saveΣ oε director∙ accesses«  ì
  96. Iµ yo⌡ routinel∙ usσ datestampe≥ datestamping¼ cachinτ may not providσ mucΦ ì
  97. advantage«  
  98.  
  99. Whilσ copyinτ usinτ disδ director∙ cachinτ iε RA═ i≤ faster¼ thσ director∙ ì
  100. oε thσ disδ i≤ no⌠ updateΣ unti∞ al∞ copyinτ i≤ completed«  Thi≤ make≤ ì
  101. copyinτ usinτ director∙ cachinτ les≤ robus⌠ thaε copyinτ usinτ jus⌠ thσ ì
  102. mediß disδ directories¼ anΣ les≤ toleran⌠ oµ flake∙ media«  
  103. :S
  104. Syntax - 1/3ì
  105.  
  106. ACOP┘ support≤ thσ usσ oµ botΦ CP/═ (destination=source⌐ anΣ MS-DO╙ (sourcσ ì
  107. destination⌐ syntax«  Thσ commanΣ linσ synta° is:
  108.  
  109.      ACOPYá[dir:]sourceá[[dir:]dest▌á[excluded] [/option(s)▌ì
  110.   o≥ ACOPYá[[dir:]dest=][dir:]sourceá[excluded] [/option(s)▌
  111.  
  112. Both     
  113.           A0>acopyáfilename.ty≡áb11║áì
  114.       anΣáA0>acopyáb11:=filename.ty≡á
  115.  
  116. wil∞ácop∙áthσáfilσáFILENAME.TYPáfroφáA░át∩áB1▒.ì
  117. Syntax - 2/3ì
  118.  
  119. Wheε onl∙ onσ filenamσ i≤ given¼ i⌠ assumeΣ t∩ bσ thσ sourcσ file¼ anΣ wil∞ ì
  120. bσ copieΣ t∩ ß destinatioε filσ oµ thσ samσ namσ oε thσ loggeΣ drive«  Fo≥ ì
  121. example:
  122.  
  123. áááááááá  B11:SAMPLE>acopyáwork:filename.ex⌠
  124.  
  125. wil∞ cop∙ thσ sourcσ filσ WORK:FILENAME.EX╘ t∩ ß filσ oµ thσ samσ namσ oε ì
  126. B11:SAMPLE«  
  127.  
  128. Yo⌡ ma∙ sometime≤ wisΦ t∩ cop∙ ß grou≡ oµ file≤ specifieΣ b∙ ß ì
  129. filename/attributσ masδ whicΦ als∩ include≤ somσ file≤ yo⌡ don'⌠ wan⌠ ì
  130. copied«  Yo⌡ caε optionall∙ usσ u≡ t∩ threσ filenamσ mask≤ t∩ specif∙ file≤ ì
  131. tha⌠ yo⌡ wisΦ t∩ excludσ froφ copying¼ eveε iµ the∙ otherwisσ matcΦ thσ ì
  132. sourcσ filσ specification«  Iµ yo⌡ choosσ t∩ usσ them¼ thσ exclusioε ì
  133. filename≤ mus⌠ bσ specifieΣ afte≥ botΦ thσ sourcσ anΣ destinatioε ì
  134. filenames«  Thσ exclusioε filename≤ arσ filenamσ mask≤ only¼ anΣ an∙ ì
  135. drive/use≥ specifieΣ wil∞ bσ ignored.
  136. Syntax - 3/3 
  137.  
  138. Iε situation≤ wherσ yo⌡ woulΣ normall∙ onl∙ neeΣ t∩ specif∙ thσ sourcσ ì
  139. filenamσ anΣ yo⌡ als∩ wisΦ t∩ specif∙ aε exclusioε filename¼ yo⌡ mus⌠ ì
  140. providσ a⌠ leas⌠ ß minimuφ destinatioε filσ specificatioε sucΦ a≤ thσ ì
  141. destinatioε drive¼ user¼ o≥ *.*¼ s∩ tha⌠ yo⌡ havσ specifieΣ botΦ sourcσ anΣ ì
  142. destinatioε filename≤ iε somσ way«  Fo≥ example:
  143.  
  144.      A0:WORK>acopyáb:filename.* a: /nes *.doc *.hlp *.ws 
  145.  
  146. wil∞ cop∙ al∞ unarchiveΣ file≤ B:FILENAME.*¼ excep⌠ fo≥ DOC¼ HLP¼ o≥ W╙ ì
  147. files¼ t∩ existinτ file≤ oµ thσ samσ name≤ oε A0:WORK¼ automaticall∙ ì
  148. overwritinτ thσ existinτ file≤ anΣ archivinτ thσ sourcσ file≤ afte≥ ì
  149. copying«  Thσ excludeΣ filenamσ mask≤ mus⌠ appea≥ afte≥ thσ sourcσ anΣ ì
  150. destinatioε filenamσ specification≤ anΣ whilσ the∙ don'⌠ havσ t∩ bσ placeΣ ì
  151. afte≥ thσ options¼ thσ samplσ synta° abovσ ma∙ bσ easie≥ t∩ remember.
  152. :W
  153. Wildcards - 1/2ì
  154.  
  155. Source¼ destinatioε anΣ exclusioε filename≤ a≤ wel∞ a≤ sourcσ anΣ ì
  156. destinatioε use≥ number≤ ma∙ al∞ contaiε wildcards«  Sourcσ anΣ exclusioε ì
  157. filenamσ wildcard≤ arσ expandeΣ iε thσ usua∞ way«  ACOP┘ attempt≤ t∩ ì
  158. resolvσ destinatioε filσ wildcard≤ b∙ ß matchinτ process«  Fo≥ example:
  159.  
  160. áááááááá  A0>acopyáfile.z80áb:??????10.¬
  161.  
  162. wil∞áresul⌠áiεáßádestinatioεáfilenamσáoµáFILE10.Z80«áá
  163.  
  164. Sincσ i⌠ i≤ possiblσ tha⌠ thi≤ proces≤ ma∙ resul⌠ iε thσ creatioε oµ ì
  165. duplicatσ files¼ ACOP┘ store≤ thσ user¼ drivσ anΣ filenamσ oµ thσ las⌠ filσ ì
  166. copieΣ anΣ compare≤ i⌠ t∩ thσ curren⌠ destinatioε file«  Iµ the∙ match¼ ì
  167. ACOP┘ print≤ ß 'Duplicate!º erro≥ message¼ anΣ thσ curren⌠ filσ i≤ skipped«  ì
  168. Iµ tw∩ file≤ witΦ thσ samσ name≤ arσ no⌠ copieΣ iε sequence¼ ß duplicatσ ì
  169. filenamσ ma∙ stil∞ bσ created«  Carσ shoulΣ bσ exerciseΣ iε usinτ ì
  170. destinatioε filσ wildcards¼ bu⌠ iµ yo⌡ arσ carefu∞ anΣ awarσ oµ thσ ì
  171. limitation≤ oµ thσ process¼ yo⌡ caε d∩ copyinτ anΣ renaminτ oµ multiplσ ì
  172. file≤ iε onσ ste≡ witΦ minima∞ typing.
  173. Wildcards - 2/2
  174.  
  175. ACOP┘ als∩ accept≤ wildcarΣ sourcσ anΣ destinatioε use≥ numbers¼ primaril∙ ì
  176. fo≥ harΣ disδ backu≡ purposes«  Iµ yo⌡ specif∙ ß wildcarΣ sourcσ use≥ ì
  177. number¼ ACOP┘ wil∞ cop∙ file≤ froφ al∞ use≥ area≤ a≤ lonτ a≤ the∙ otherwisσ ì
  178. matcΦ thσ filename/attributσ mask«  Iµ ß wildcarΣ destinatioε use≥ numbe≥ ì
  179. i≤ als∩ specified¼ thσ file≤ wil∞ bσ copieΣ t∩ thei≥ origina∞ use≥ area≤ oε ì
  180. thσ destinatioε drive«  Iµ ß specifiπ destinatioε use≥ numbe≥ i≤ specified¼ ì
  181. al∞ sourcσ file≤ wil∞ bσ copieΣ t∩ thσ specifieΣ destinatioε use≥ area«  
  182.  
  183. Yo⌡ shoulΣ bσ carefu∞ abou⌠ blindl∙ copyinτ file≤ froφ al∞ sourcσ use≥ ì
  184. area≤ t∩ ß singlσ destinatioε use≥ area¼ however«  Iµ file≤ witΦ duplicatσ ì
  185. filename≤ exis⌠ iε severa∞ oµ thσ sourcσ use≥ areas¼ i⌠ i≤ possiblσ tha⌠ ì
  186. somσ o≥ al∞ oµ theφ ma∙ bσ invertentl∙ overwritteε oε ß singlσ destinatioε ì
  187. filσ oµ thσ samσ name¼ especiall∙ wheε usinτ thσ 'Oº o≥ 'Rº option≤ tha⌠ ì
  188. automaticall∙ overwritσ existinτ destinatioε files«  Oε thσ othe≥ hand¼ iµ ì
  189. thσ sourcσ director∙ i≤ sorted¼ duplicatσ filename≤ iε differen⌠ use≥ area≤ ì
  190. wil∞ appea≥ iε sequentia∞ orde≥ iε thσ sourcσ director∙ anΣ wil∞ trigge≥ ì
  191. thσ 'Duplicate!º messagσ wheε aε attemp⌠ i≤ madσ t∩ cop∙ theφ t∩ thσ samσ ì
  192. destinatioε use≥ area«  A≤ previousl∙ discussed¼ onl∙ thσ firs⌠ sucΦ filσ ì
  193. wil∞ bσ copied.
  194. :/
  195. Options - 1/8ì
  196.  
  197. ACOP┘ ha≤ ß numbe≥ oµ commanΣ linσ options¼ whicΦ mus⌠ bσ precedeΣ b∙ thσ ì
  198. optioε flaτ characte≥ '/'«  Thσ optioε letter≤ o≥ number≤ ma∙ appea≥ iε an∙ ì
  199. orde≥ anΣ ma∙ appea≥ anywherσ iε thσ commanΣ line«  Option≤ ma∙ bσ combineΣ ì
  200. iε an∙ combination«  Option≤ arσ toggleΣ a≤ the∙ arσ read¼ s∩ tha⌠ aε ì
  201. optioε appearinτ twicσ wil∞ cance∞ itself«  Fo≥ example¼ al∞ oµ thσ ì
  202. followinτ commanΣ line≤ havσ thσ samσ meaning:
  203.  
  204. áááááááá  A0>acopyá/12q≥ásource.ex⌠ádest.ex⌠ excluded.ft
  205. áááááááá  A0>acopyásource.ex⌠ádest.ex⌠á/▒á/≥áexcluded.ft /±á/2
  206. áááááááá  A0>acopyá/12ádest.ext=source.ex⌠áexcluded.ft /r±
  207. áááááááá  A0>acopyá/rqá/q source.ex⌠á/±ádest.ex⌠á/2▒ excluded.ft
  208.  
  209. Excep⌠ fo≥ thσ attributσ option≤ (1-7)¼ individua∞ option≤ ma∙ bσ disableΣ ì
  210. usinτ ZCNF╟ anΣ ACOPY.CF╟ iµ you'Σ rathe≥ no⌠ havσ theφ available.
  211.  
  212. Thσ followinτ description≤ oµ thσ option≤ reflec⌠ thσ defaul⌠ optioε ì
  213. setting≤ iε thσ distributioε version«  Yo⌡ ma∙ configurσ thσ defaul⌠ optioε ì
  214. character≤ and setting≤ t∩ sui⌠ you≥ owε need≤ usinτ ZCNF╟ anΣ ACOPY.CFG«  ì
  215. Thσ commanΣ linσ HEL╨ screeε wil∞ automaticall∙ displa∙ thσ prope≥ ì
  216. selectioε messagσ fo≥ eacΦ optioε baseΣ oε whethe≥ i⌠ ha≤ beeε se⌠ t∩ O╬ o≥ ì
  217. OFF.
  218. Options - 2/8 
  219.  
  220. Thσ default option≤ are:
  221.  
  222. ááááá1á- 7 options«  Copie≤ onl∙ thosσ specifieΣ file≤ whicΦ als∩ havσ thσ ì
  223. ááááááááááselecteΣ combinatioε oµ thσ F▒ througΦ thσ F╖ attribute≤ set«  
  224.  
  225.           Unde≥ Z80DO╙ anΣ ZSDOS¼ PUBLI├ file≤ havσ thσ F▓ attributσ set¼ ì
  226. ááááááááááanΣ yo⌡ caε usσ thσ '2º optioε t∩ selec⌠ onl∙ PUBLI├ file≤ fo≥ ì
  227. áááááááááácopying«  Iε thi≤ case¼ thσ operatinτ systeφ wil∞ preven⌠ yo⌡ ì
  228. ááááááááááfroφ creatinτ morσ thaε onσ PUBLI├ filσ oµ thσ samσ namσ oε ß ì
  229. áááááááááádisk«  Iµ yo⌡ tr∙ copyinτ ß PUBLI├ filσ t∩ ß differen⌠ use≥ area¼ ì
  230. ááááááááááACOP┘ wil∞ tel∞ yo⌡ tha⌠ i⌠ alread∙ exists«  Iµ yo⌡ tr∙ t∩ ì
  231. ááááááááááoverwritσ thσ 'existingº file¼ thσ DO╙ wil∞ preven⌠ i⌠ b∙ ì
  232. ááááááááááabortinτ witΦ ß Filσ W/╨ BDO╙ error«  
  233. Options - 3/8 
  234.  
  235.      Ná-áCopie≤ onl∙ non-archiveΣ (changed⌐ files«  Unde≥ ZRDOS¼ ZSDO╙ anΣ ì
  236. ááááááááááothe≥ extendeΣ DOS's¼ thσ 'Nº optioε allow≤ yo⌡ t∩ limi⌠ copyinτ ì
  237. áááááááááát∩ non-archiveΣ file≤ (thosσ file≤ tha⌠ havσ beeε openeΣ o≥ ì
  238. áááááááááámodifieΣ sincσ thσ archivσ attributσ wa≤ set)«  Thσ destinatioε ì
  239. ááááááááááfile≤ arσ createΣ a≤ non-archiveΣ file≤ unles≤ thσ 'Dº optioε i≤ ì
  240. ááááááááááselecteΣ t∩ archivσ thσ destinatioε files.
  241.  
  242.           Unde≥ CP/═ 2.2¼ thσ archivσ attributσ i≤ no⌠ rese⌠ wheε ß filσ i≤ ì
  243. ááááááááááupdated¼ s∩ thi≤ optioε i≤ no⌠ to∩ usefu∞ unles≤ yo⌡ usσ ß ì
  244. ááááááááááutilit∙ prograφ t∩ 'manuallyº se⌠ o≥ rese⌠ thσ archivσ attribute«  
  245. Options - 4/8
  246.  
  247.      U - Updatσ olde≥ destinatioε file≤ wheε doinτ datestampinτ unde≥ ì
  248. ááááááááááZ80DO╙ o≥ ZSDOS«  Allow≤ yo⌡ t∩ automaticall∙ overwritσ anΣ ì
  249. ááááááááááupdatσ olde≥ destinatioε file≤ b∙ copyinτ onl∙ wheε thσ sourcσ ì
  250. ááááááááááfilσ modificatioε datσ i≤ newe≥ thaε thσ destinatioε filσ ì
  251. áááááááááámodificatioε date¼ iµ n∩ destinatioε filσ alread∙ exists¼ oµ iµ ì
  252. ááááááááááthσ destinatioε filσ ha≤ n∩ datestamp«  I⌠ ma∙ als∩ bσ useΣ witΦ ì
  253. ááááááááááthσ 'Eº optioε t∩ updatσ onl∙ existinτ files«  Set≤ 'Cº anΣ 'Oº ì
  254. ááááááááááoption≤ t∩ ON«  Wheε operatinτ unde≥ an∙ othe≥ DO╙ o≥ wheε n∩ ì
  255. ááááááááááclocδ i≤ found¼ thi≤ optioε become≤ inactivσ anΣ wil∞ no⌠ appea≥ ì
  256. ááááááááááiε thσ commanΣ linσ HEL╨ message«  
  257.  
  258.           Wheε overwritinτ (updating⌐ aε existinτ olde≥ filσ unde≥ thσ 'Uº ì
  259. ááááááááááoption¼ thσ '(Dated)º statu≤ messagσ i≤ replaceΣ b∙ '(Updated)'«   ì
  260. ááááááááááWheε n∩ updatσ take≤ place¼ thσ statu≤ messagσ display≤ thσ ì
  261. ááááááááááreason.
  262. Options - 5/8
  263.  
  264.     A - Cop∙ al∞ (director∙ AN─ system⌐ files«  Thi≤ caε bσ usefu∞ iµ yo⌡ ì
  265. áááááááááákee≡ utilit∙ file≤ a≤ systeφ file≤ anΣ wan⌠ t∩ excludσ theφ froφ ì
  266. áááááááááábeinτ copieΣ wheε usinτ wildcarΣ filenamσ masks«  Ma∙ bσ patcheΣ ì
  267. áááááááááát∩ normall∙ cop∙ onl∙ director∙ files«  ACOP┘ i≤ distributeΣ witΦ ì
  268. ááááááááááthi≤ optioε disabled¼ bu⌠ i⌠ ma∙ bσ enableΣ witΦ ZCNF╟ o≥ b∙ ì
  269. áááááááááápatching«  
  270.  
  271.      E - Cop∙ anΣ automaticall∙ overwritσ (R/W⌐ file≤ onl∙ iµ destinatioε ì
  272. ááááááááááfile≤ oµ thσ samσ namσ alread∙ exist«  Set≤ thσ 'Oº optioε  t∩ O╬ ì
  273. ááááááááááanΣ thσ 'Xº optioε t∩ OFF.
  274.  
  275. áááááXá-áAutomaticall∙ skip≤ copyinτ iµ destinatioε file≤ oµ thσ samσ namσ ì
  276. ááááááááááalread∙ exist«  Normally¼ yo⌡ arσ askeΣ first«  Overriddeε b∙ thσ ì
  277. áááááááááá'Eº (Exists)¼ 'Oº (Overwrite⌐ o≥ 'Rº (R/O⌐ options.
  278. Options - 6/8 
  279.  
  280.      Oá-áOverwrite≤ R/╫ destinatioε file≤ oµ thσ samσ namσ withou⌠ asking«  ì
  281. ááááááááááNormally¼ yo⌡ arσ askeΣ first.
  282.  
  283.      Rá-áOverwrite≤ R/╧ (anΣ R/W⌐ destinatioε file≤ oµ thσ samσ namσ ì
  284. ááááááááááwithou⌠ asking«  Normally¼ yo⌡ arσ askeΣ first.
  285.  
  286.      M - Move≤ files«  Delete≤ thσ sourcσ file≤ wheε thσ copyinτ operatioε ì
  287. ááááááááááha≤ beeε successfull∙ completeΣ anΣ display≤ thσ statu≤ messagσ ì
  288. áááááááááá'Sourcσ Deleted'.
  289.  
  290.      Y - Mark≤ destinatioε file≤ a≤ systeφ files«  Normally¼ destinatioε ì
  291. ááááááááááfile≤ arσ markeΣ a≤ director∙ files«  
  292. Options - 7/8
  293.  
  294.      C - Control≤ whethe≥ thσ sourcσ filσ datestamp≤ wil∞ bσ copieΣ t∩ thσ ì
  295. áááááááááádestinatioε filσ datestamp≤ wheε operatinτ unde≥ Z80DO╙ o≥ ZSDO╙ ì
  296. áááááááááá(defaul⌠ i≤ t∩ cop∙ datestamps)«  Wheε operatinτ unde≥ an∙ othe≥ ì
  297. ááááááááááDO╙ o≥ wheε n∩ clocδ i≤ found¼ thi≤ optioε i≤ inactivσ anΣ wil∞ ì
  298. ááááááááááno⌠ appea≥ iε thσ commanΣ linσ HEL╨ message«  
  299.  
  300.           Iµ datestamp≤ arσ copied¼ thσ destinatioε file≤ wil∞ havσ thσ ì
  301. áááááááááásamσ creatioε anΣ modificatioε date≤ a≤ thσ sourcσ files«  Iµ ì
  302. áááááááááádatestam≡ copyinτ i≤ suppressed¼ destinatioε file≤ wil∞ bσ dateΣ ì
  303. ááááááááááa≤ newl∙ created.
  304.  
  305.      D - Set≤ thσ archivσ attribute≤ iε thσ destinatioε files¼ markinτ theφ ì
  306. ááááááááááa≤ archived«  Speed≤ settinτ u≡ RA═ disk≤ b∙ copyinτ anΣ markinτ ì
  307. ááááááááááthσ copie≤ a≤ archiveΣ iε thσ samσ operation«  N∩ messagσ i≤ ì
  308. áááááááááádisplayeΣ iε thσ statu≤ line.
  309.  
  310.      S - Set≤ thσ archivσ attribute≤ iε thσ sourcσ file≤ afte≥ copying¼ ì
  311. áááááááááámarkinτ theφ a≤ archiveΣ anΣ display≤ thσ statu≤ messagσ 'Sourcσ ì
  312. ááááááááááArchived'.
  313. Options - 8/8
  314.  
  315.      V - Toggle≤ CR├ verification«  Thσ distributioε defaul⌠ i≤ t∩ alway≤ ì
  316. ááááááááááverif∙ copies«  
  317.  
  318. áááááQá-áQuiet«  Usuall∙ useΣ onl∙ iε alia≤ environments¼ thσ 'Qº optioε ì
  319. ááááááááááturn≤ ofµ non-erro≥ statu≤ messages«  An∙ informatioε yo⌡ shoulΣ ì
  320. áááááááááákno≈ abou⌠ durinτ thσ copyinτ process¼ sucΦ a≤ erro≥ information¼ ì
  321. áááááááááái≤ stil∞ displayed«  N∩ existinτ file≤ wil∞ bσ overwritteε unles≤ ì
  322. ááááááááááthσ 'O'¼ 'Rº o≥ 'Uº option≤ arσ als∩ used«  Iµ yo⌡ attemp⌠ t∩ ì
  323. áááááááááácop∙ ß filσ t∩ ß disδ whicΦ doesn'⌠ havσ enougΦ freσ spacσ whilσ ì
  324. ááááááááááiε thσ QUIE╘ mode¼ ACOP┘ wil∞ cance∞ QUIE╘ operatioε s∩ tha⌠ yo⌡ ì
  325. áááááááááácaε vie≈ subsequen⌠ statu≤ information.
  326.  
  327.           Wheε operatinτ iε ß ZCPR│ environment¼ thσ defaul⌠ 'Qº optioε ì
  328. áááááááááásettinτ wil∞ automaticall∙ bσ se⌠ accordinτ t∩ thσ statσ oµ thσ ì
  329. ááááááááááZCPR│ QUIE╘ flag.ì
  330. :A
  331. File Attributes
  332.  
  333. Ne≈ destinatioε file≤ wil∞ normall∙ havσ thσ samσ filenamσ attribute≤ a≤ ì
  334. thσ sourcσ files«  Iµ ß destinatioε filσ overwrite≤ aε existinτ filσ oµ thσ ì
  335. samσ name¼ thσ ne≈ filσ wil∞ takσ oε thσ attribute≤ oµ thσ previou≤ file«  
  336.  
  337. Destinatioε file≤ wil∞ normall∙ bσ markeΣ a≤ changeΣ (no⌠ archived)«  T∩ ì
  338. hel≡ se⌠ u≡ RA═ disδ workspace≤ anΣ a≤ aε aiΣ iε somσ backu≡ schemes¼ thσ ì
  339. 'Dº optioε ma∙ bσ useΣ t∩ marδ destinatioε file≤ a≤ archived«  Sourcσ file≤ ì
  340. ma∙ bσ archiveΣ afte≥ thσ file≤ havσ beeε copieΣ b∙ usinτ thσ 'Sº option«  ì
  341. Thi≤ help≤ yo⌡ bacδ u≡ file≤ anΣ marδ thσ sourcσ and/o≥ destinatioε file≤ ì
  342. a≤ archiveΣ iε onσ step«  
  343.  
  344. Destinatioε file≤ arσ normall∙ se⌠ a≤ director∙ files«  Thσ 'Yº optioε ì
  345. allow≤ thσ optioε oµ copyinτ file≤ anΣ settinτ theφ a≤ systeφ file≤ iε onσ ì
  346. step¼ ß usefu∞ abilit∙ wheε loadinτ RA═ disδ workspaces«  Seσ thσ 'Optionsº ì
  347. sectioε fo≥ morσ information.
  348. :D
  349. DOS Datestamping - 1/2
  350.  
  351. Wheε ACOP┘ operate≤ unde≥ CP/M+¼ Z80DO╙ o≥ ZSDOS¼ i⌠ take≤ advantagσ oµ thσ ì
  352. appropriatσ extendeΣ DO╙ call≤ t∩ automaticall∙ cop∙ thσ sourcσ filσ ì
  353. datestamps¼ iµ the∙ exist¼ t∩ thσ destinatioε filσ datestamp≤ s∩ tha⌠ ì
  354. destinatioε file≤ havσ thσ samσ creatioε anΣ modificatioε date≤ a≤ thσ ì
  355. sourcσ files«  Seσ thσ 'Optionsº sectioε fo≥ morσ information.
  356.  
  357. Therσ i≤ arσ tw∩ datestampinτ option≤ availablσ unde≥ Z80DO╙ o≥ ZSDOS«  ì
  358. Wheε operatinτ unde≥ othe≥ DOS's¼ thesσ option≤ arσ no⌠ activσ anΣ d∩ no⌠ ì
  359. appea≥ iε thσ commanΣ linσ HEL╨ message«  
  360.  
  361. Thσ 'Cº optioε allow≤ yo⌡ t∩ suppres≤ datestam≡ copyinτ s∩ tha⌠ destinatioε ì
  362. file≤ arσ dateΣ a≤ newl∙ created«  Thσ 'Uº optioε allow≤ yo⌡ t∩ updatσ ì
  363. existinτ olde≥ file≤ b∙ copyinτ anΣ overwritinτ onl∙ wheε ß destinatioε ì
  364. filσ oµ thσ samσ namσ ha≤ aε olde≥ modificatioε datσ thaε thσ sourcσ filσ ì
  365. o≥ iµ n∩ destinatioε filσ exists«  Seσ thσ 'Optionsº sectioε fo≥ morσ ì
  366. information.
  367. DOS Datestamping - 1/2
  368.  
  369. Wheε operatinτ unde≥ Z80DO╙ o≥ ZSDOS¼ successfu∞ datestam≡ copyinτ i≤ ì
  370. indicateΣ b∙ displayinτ '(Dated)º iε thσ copyinτ statu≤ message«  N∩ ì
  371. datestampinτ messagσ wil∞ bσ displayeΣ wheε clocδ suppor⌠ i≤ no⌠ present¼ ì
  372. wheε therσ i≤ ß datestampinτ error¼ wheε destinatioε file≤ arσ stampeΣ a≤ ì
  373. newl∙ created¼ o≥ wheε datestampinτ i≤ donσ unde≥ CP/M+.
  374. :F
  375. Destination Disk Free Space - 1/2
  376.  
  377. ACOP┘ check≤ t∩ makσ surσ tha⌠ enougΦ freσ spacσ fo≥ thσ destinatioε filσ ì
  378. exist≤ oε thσ destinatioε disδ beforσ attemptinτ thσ copy«  Iµ ß filσ t∩ bσ ì
  379. overwritteε alread∙ exist≤ oε thσ destinatioε disk¼ it≤ sizσ wil∞ bσ ì
  380. alloweΣ fo≥ anΣ i⌠ wil∞ no⌠ bσ deleteΣ unles≤ therσ wil∞ bσ iε enougΦ freσ ì
  381. spacσ fo≥ thσ ne≈ filσ oε thσ disδ afte≥ thσ deletion«  Iµ insufficien⌠ ì
  382. spacσ exists¼ ACOP┘ wil∞ displa∙ ß 'Disδ to∩ full!º messagσ iε thσ copyinτ ì
  383. statu≤ message¼ thσ ZCPR│ prograφ erro≥ flaτ wil∞ bσ se⌠ t∩ ╖ anΣ thσ ì
  384. consolσ bel∞ wil∞ bσ sounded«  
  385.  
  386. Iµ ß wildcarΣ sourcσ filenamσ wa≤ specified¼ ACOP┘ wil∞ continuσ t∩ ste≡ ì
  387. througΦ thσ lis⌠ oµ sourcσ files¼ copyinτ an∙ file≤ tha⌠ wil∞ fi⌠ anΣ ì
  388. givinτ erro≥ message≤ fo≥ eacΦ filσ tha⌠ won't«  Eveε iµ yo⌡ usσ thσ 'Oº o≥ ì
  389. 'Rº optioε t∩ specif∙ automaticall∙ overwritinτ existinτ files¼ n∩ ì
  390. destinatioε disδ filσ wil∞ bσ deleteΣ unles≤ doinτ s∩ wil∞ creatσ enougΦ ì
  391. spacσ t∩ allo≈ copyinτ oµ thσ replacemen⌠ file«  
  392. Destination Disk Free Space - 2/2
  393.  
  394. Iµ yo⌡ arσ operatinτ iε thσ QUIE╘ modσ anΣ attemp⌠ t∩ cop∙ ß filσ t∩ ß disδ ì
  395. tha⌠ doesn'⌠ havσ enougΦ freσ space¼  ACOP┘ wil∞ cance∞ QUIE╘ operation¼ a≤ ì
  396. yo⌡ wil∞ probabl∙ bσ interesteΣ iε whicΦ file≤ werσ copieΣ anΣ whicΦ ì
  397. weren't«  Thi≤ wil∞ givσ yo⌡ thσ informatioε yo⌡ neeΣ t∩ takσ appropriatσ ì
  398. correctivσ measures¼ sucΦ a≤ changinτ disk≤ anΣ repeatinτ thσ command¼ o≥ ì
  399. erasinτ enougΦ file≤ oε thσ destinatioε disδ t∩ creatσ enougΦ freσ spacσ ì
  400. fo≥ thσ file≤ yo⌡ stil∞ wan⌠ t∩ copy«  
  401. :E
  402. ZCPR3 Program Error Flag
  403.  
  404. Iµ thσ ZCPR│ prograφ erro≥ flaτ exists¼ ACOP┘ set≤ i⌠ wheε aε erro≥ occur≤ ì
  405. durinτ prograφ operation«  Fo≥ morσ flexiblσ usσ b∙ alia≤ anΣ ZE╪ script≤ ì
  406. usinτ flo≈ control¼ ACOP┘ follow≤ anΣ extend≤ thσ conventioε se⌠ b∙ Ricδ ì
  407. Charne≤ b∙ settinτ thσ erro≥ flaτ t∩ thσ followinτ value≤ fo≥ thσ indicateΣ ì
  408. erro≥ conditions║ 
  409.  
  410.      0 = Program operation successful - no errors.
  411.  
  412.      6 = Somσ file≤ weren'⌠ copieΣ - correspondinτ destinatioε ì
  413. ááááááááááfile≤ didn'⌠ exis⌠ (EXIS╘ optioε only).
  414.      7 = Somσ file≤ weren'⌠ copieΣ - destinatioε disδ wa≤ to∩ ì
  415. ááááááááááfull« 
  416.  
  417.      8 = Program abort - user abort command.
  418.      ╣ ╜ Prograφ abor⌠ - destinatioε disδ director∙ wa≤ full« 
  419.   0FFh = Program abort - fatal error. 
  420. :B
  421. Backing Up Files - 1/3
  422.  
  423. ACOP┘ caε hel≡ yo⌡ 'packº ß backu≡ disδ b∙ checkinτ whethe≥ therσ i≤ spacσ ì
  424. fo≥ eacΦ specifieΣ filσ oε thσ destinatioε disδ anΣ copyinτ i⌠ iµ therσ is«  ì
  425. Iµ i⌠ find≤ insufficien⌠ space¼ i⌠ set≤ thσ ZCPR│ erro≥ flaτ t∩ ╖ anΣ ì
  426. continue≤ througΦ thσ lis⌠ oµ sourcσ file≤ testinτ fo≥ file≤ smal∞ enougΦ ì
  427. t∩ fit¼ anΣ copyinτ thosσ tha⌠ will«  Iµ yo⌡ usσ thσ 'Sº optioε (archivσ ì
  428. sourcσ file≤ afte≥ copying⌐ t∩ marδ a≤ archiveΣ thosσ file≤ successfull∙ ì
  429. copied¼ yo⌡ wil∞ bσ ablσ t∩ cop∙ thσ uncopieΣ (anΣ non-archived⌐ file≤ t∩ ì
  430. anothe≥ backu≡ disδ usinτ thσ ACOP┘ 'Nº optioε (cop∙ onl∙ non-archiveΣ ì
  431. files)«  Aε alia≤ o≥ ZE╪ scrip⌠ caε als∩ tes⌠ thσ valuσ oµ thσ ZCPR│ erro≥ ì
  432. flaτ anΣ inforφ yo⌡ oµ thσ naturσ oµ thσ erro≥ conditioε anΣ thσ neeΣ t∩ ì
  433. inser⌠ anothe≥ disk.
  434. Backing Up Files - 2/3
  435.  
  436. ┴ simplσ commanΣ linσ fo≥ backinτ u≡ al∞ non-archiveΣ file≤ oε ß disδ is:
  437.  
  438.           A0>acopy m:*.* b: /nos     
  439.  
  440. whicΦ wil∞ cop∙ al∞ non-archiveΣ file≤ froφ M0║ t∩ B0:¼ automaticall∙ ì
  441. overwritinτ destinatioε file≤ oµ thσ samσ namσ anΣ archivinτ thσ sourcσ ì
  442. file≤ afte≥ copying«  Thσ ZCPR│ erro≥ flaτ wil∞ bσ se⌠ t∩ ╖ iµ an∙ oµ thσ ì
  443. specifieΣ sourcσ file≤ couldn'⌠ bσ copieΣ becausσ oµ insufficien⌠ spacσ oε ì
  444. thσ destinatioε disδ anΣ wil∞ bσ se⌠ t∩ ╣ iµ thσ destinatioε disδ director∙ ì
  445. i≤ full.
  446. Backing Up Files - 3/3
  447.  
  448. ┴ variatioε fo≥ harΣ disδ backu≡ usinτ wildcarΣ sourcσ anΣ destinatioε use≥ ì
  449. number≤ is:
  450.  
  451.           A0>acopy m?:*.* b?: /nos     
  452.  
  453. whicΦ wil∞ cop∙ al∞ non-archiveΣ file≤ froφ al∞ use≥ area≤ oε drivσ M║ t∩ ì
  454. thσ correspondinτ use≥ area≤ oε drivσ B:¼ automaticall∙ overwritinτ ì
  455. destinatioε file≤ oµ thσ samσ namσ anΣ archivinτ thσ sourcσ file≤ afte≥ ì
  456. copying«  
  457.  
  458. Iµ yo⌡ arσ updatinτ existinτ backu≡ disks¼ ß simila≥ commanΣ linσ tha⌠ ì
  459. copie≤ changeΣ file≤ onl∙ iµ file≤ oµ thσ samσ namσ alread∙ exis⌠ oε thσ ì
  460. destinatioε disδ anΣ archive≤ thσ sourcσ file≤ afte≥ copyinτ is:
  461.  
  462.           A0>acopy m?:*.* b?: /nes
  463.  
  464. Iε thi≤ case¼ thσ ZCPR│ erro≥ flaτ wil∞ bσ se⌠ t∩ ╢ iµ an∙ oµ thσ specifieΣ ì
  465. sourcσ file≤ don'⌠ exis⌠ oε thσ destinatioε disk«  Simila≥ aliase≤ ma∙ bσ ì
  466. writteε usinτ thσ datestampinτ options.
  467.