home *** CD-ROM | disk | FTP | other *** search
/ Oakland CPM Archive / oakcpm.iso / sigm / vol200 / z3util3.hqp / Z3UTIL3.HLP
Text File  |  1985-02-09  |  7KB  |  237 lines
  1. Note      ZCPR3 Utilities
  2. CLEANDIR  Physical Directory Cleanup
  3. CMD       Input Command Line
  4. MU        Memory Utility RCP
  5. SHSET     Define Shell Sequence
  6. :Note      ZCPR3 Utilities
  7.  
  8.      Thi≤á se⌠á oµá ZCPR│ utilitie≤ arσá general-purposσá iε ì
  9. naturσá anΣá havσá beeεá provideΣ witΦá thσá ZCPR│á Phasσá ▓ ì
  10. release«  Al∞ utilitie≤ excep⌠ thσ RC╨ caε bσ installeΣ oε ß ì
  11. targe⌠ ZCPR│ Systeφ b∙ runninτ Z3INS.
  12.  
  13. :CLEANDIR  Physical Directory Cleanup
  14. Command: CLEANDIR 1.0
  15.  
  16. Syntax:
  17.      CLEANDIR dir: o
  18. or
  19.      CLEANDIR o
  20.  
  21. Function:
  22.      CLEANDI╥ "cleansó ß physica∞ disδ directory«á  I⌠ load≤ ì
  23. thσá director∙á oµ thσ targe⌠ disδá int∩á memory¼á sort≤á i⌠ ì
  24. alphabeticall∙á withiεá eacΦ use≥ areß (ascendinτá orde≥á b∙ ì
  25. default)¼á anΣá write≤ i⌠ ou⌠ t∩ disδ witΦ E╡ fil∞ oµ unuseΣ ì
  26. director∙ entries.
  27.  
  28.      ┴ DIR║á prefi° i≤ allowed¼á bu⌠ onl∙ thσ disδ referencσ ì
  29. i≤ meaningful¼á s∩ iµ "CLEANDI╥ ROOT:ó i≤ issueΣ wherσ ROOT║ ì
  30. is A15:, then disk A is cleaned.
  31.  
  32. Options:
  33.      D - sort user areas and files in Descending Order
  34.  
  35. Comments:
  36.  
  37.      CLEANDIR'≤á sor⌠á oε thσ disδ director∙ buy≤á thσá use≥ ì
  38. several advantages:
  39.  
  40.           1«á Utilitie≤ whicΦ sor⌠ thσ disδ director∙á afte≥ ì
  41. loadinτá it¼á likσ XDIR¼á ruε faste≥ sincσ thσ director∙á i≤ ì
  42. already sorted.
  43.  
  44.           2«á  Thσá possibilit∙ oµ recoverinτ file≤á b∙á thσ ì
  45. UNERAS┼ commanΣ i≤ increaseΣ iµ CLEANDI╥ ha≤ beeε ruε oε thσ ì
  46. director∙ recentl∙ beforσ thσ file≤ werσ erased«á  Notσ tha⌠ ì
  47. an∙á eraseΣ file≤ absolutel∙ canno⌠ bσ recovereΣ b∙á UNERAS┼ ì
  48. iµá CLEANDI╥á wa≤ ruε betweeε thσ timσ the∙ werσ eraseΣá anΣ ì
  49. UNERASE was executed.
  50.  
  51.           3«á  Usσá oµ DU2/DU│ t∩ looδ a⌠ thσá director∙á i≤ ì
  52. facilitated if the directory is already sorted by CLEANDIR.
  53.  
  54.  
  55. Selected Error Messages:
  56.  
  57.      Self-Explanatory
  58.  
  59. Examples of Use:
  60.  
  61.      CLEANDIR
  62.           -- clean current disk in ascending order
  63.  
  64.      CLEANDIR A: D
  65.           -- clean disk A in descending order
  66.  
  67.      CLEANDIR TEXT:
  68.           -- clean the disk which the directory named TEXT
  69.              is defined for in ascending order
  70.  
  71.      CLEANDIR D
  72.           -- clean current disk in descending order
  73.  
  74. :CMD      Input Command Line
  75. Command: CMD 1.0
  76.  
  77. Syntax:
  78.  
  79.      CMD cmd1;cmd2;...
  80. or
  81.      CMD or CMD;cmd2;...
  82.  
  83. Function:
  84.  
  85.      Iµá CM─ ha≤ aε argument¼á i⌠ build≤ ß ne≈ commanΣá linσ ì
  86. whicΦá begin≤ witΦ thi≤ argumen⌠ anΣ proceed≤ witΦ thσá res⌠ ì
  87. oµ thσ commanΣ line«  Fo≥ example¼ thσ firs⌠ form:
  88.  
  89.      CMD cmd1;cmd2;...
  90.  
  91. is translated into:
  92.  
  93.      cmd1;cmd2;...
  94.  
  95.  
  96.      Thi≤á i≤á gooΣá becausσ source≤ sucΦá a≤á MENU¼á VMENU¼ ì
  97. anΣá VFILE╥á caεá ente≥ thσ "cmd1ó variablσá froφá thσá use≥ ì
  98. selection manually.
  99.  
  100.      Iµ CM─ ha≤ n∩ argument¼ thσ use≥ i≤ prompteΣ fo≥ input¼ ì
  101. anΣá thi≤ inpu⌠ i≤ inserteΣ int∩ thσ commanΣ streaφá a⌠á thσ ì
  102. poin⌠ oµ thσ CM─ command«  Thi≤ i≤ mucΦ morσ useful¼ sucΦ a≤ ì
  103. wheεá SHSE╘á i≤ useΣ t∩ definσ ß shel∞á sequence¼á anΣá thi≤ ì
  104. sequencσá i≤ t∩ bσ exiteΣ a⌠ somσ time«á  Fo≥á example¼á thσ ì
  105. second form:
  106.  
  107.      CMD;cmd2;...
  108.  
  109. is translated into:
  110.  
  111.      mycmd;cmd2;...
  112.  
  113. if the user typed in "mycmd" in response to the prompt.
  114.  
  115.      CM─ set≤ thσ erro≥ messagσ wheneve≥ i⌠ runs«á  ERRO╥ i≤ ì
  116. turned on if no line was input to CMD.
  117.  
  118. Options: None
  119.  
  120. Comments:
  121.  
  122.      CM─á wa≤á buil⌠á fo≥ usσ specificall∙á witΦá thσá SHSE╘ ì
  123. command¼á alth∩ i⌠ ma∙ finΣ othe≥ applications«  Thσ probleφ ì
  124. tha⌠ CM─ addresse≤ i≤ thσ casσ wherσ thσ maiε prograφ iε thσ ì
  125. shel∞ sequencσ know≤ nothinτ abou⌠ shells¼ anΣ i⌠ i≤ desireΣ ì
  126. to leave the sequence sometime.  CMD provides this out.
  127.  
  128.      Fo≥á instance¼á iµ MU│ i≤ t∩ bσ useΣ a≤ thσ maiε shell¼ ì
  129. then:
  130.           SHSET MU3;CMD
  131.  
  132. wil∞ ruε MU3¼á allo≈ thσ use≥ t∩ d∩ wha⌠ hσ wants¼á anΣ theε ì
  133. reenter MU3.  If the user entered the command
  134.  
  135.  
  136.      SHCTRL POP
  137.  
  138. thσ shel∞ stacδ woulΣ bσ poppeΣ anΣ thσ "MU3;CMDó loo≡ woulΣ ì
  139. be broken.
  140.  
  141.      Additionally¼á CM─ set≤ thσ ERRO╥ messagσ oµ ZCPR3¼á s∩ ì
  142. tha⌠á program≤á oε dowε thσ linσ caε determinσ iµ inpu⌠á wa≤ ì
  143. madσ wheε CM─ wa≤ run«á  Iµ thσ use≥ simpl∙ strike≤ ß RETUR╬ ì
  144. iε responsσ t∩ thσ CM─ prompt¼ aε erro≥ i≤ indicated«  Test≤ ì
  145. caε late≥ bσ made¼ likσ I╞ ERROR¼ t∩ checδ thi≤ anΣ makσ thσ ì
  146. command flow change depending on the outcome.
  147.  
  148. Selected Error Messages:
  149.  
  150.      None - self-explanatory
  151.  
  152. Examples of Use:
  153.  
  154.      See above
  155. :MU       Memory Utility RCP
  156. Command: MU RCP 1.0A
  157.  
  158. Syntax:
  159.  
  160.      MU             <-- invoke MU at 100H
  161. or   MU address     <-- invoke MU at indicated address
  162.  
  163. Function:
  164.  
  165.      M╒ i≤ identica∞ t∩ MU│ iε function¼á witΦ thσ exceptioε ì
  166. tha⌠áá thσá ╚á commanΣá (Hexadecima∞á Calculator⌐áá i≤áá no⌠ ì
  167. supported«á  Thσá differencσá betweeε M╒ anΣ MU│ i≤ tha⌠á M╒ ì
  168. execute≤ a≤ aε RC╨ anΣ MU│ execute≤ a≤ ß transient«á  A≤á aε ì
  169. RCP¼á M╒á allow≤ thσ use≥ t∩ examinσ thσ TP┴ withou⌠ concerε ì
  170. fo≥ sidσ effects¼á s∩ debugginτ transient≤ i≤ simplifieΣá b∙ ì
  171. thi≤ command«á  I⌠ i≤ thσ onl∙ maiε commanΣ iε thσ DEBUG.RC╨ ì
  172. provided in the ZCPR3 release.
  173.  
  174.  
  175. Options: None
  176.  
  177. Comments:
  178.  
  179.      M╒ ma∙ bσ invokeΣ a≤ ß Shel∞ b∙ thσ SHSE╘ command«  Thσ ì
  180. ├á commanΣ caε bσ useΣ froφ withiε M╒ t∩ executσ an∙ desireΣ ì
  181. commanΣ line¼á includinτ thσ "SHCTR╠ POPó commanΣ whicΦ pop≤ ì
  182. M╒á froφá thσ Shel∞ Stack¼á terminatinτ it≤ operatioεá a≤á ß ì
  183. Shell.
  184.  
  185. Selected Error Messages: None
  186.  
  187. Examples of Use:
  188.  
  189.      MU        <-- run MU
  190.      MU 0F400  <-- run MU but position at 0F400H
  191.  
  192. :SHSET    Define Shell Sequence
  193. Command: SHSET 1.0
  194.  
  195. Syntax:
  196.  
  197.      SHSET cmd1;cmd2;...
  198.  
  199. Function:
  200.  
  201.      SHSE╘á define≤á thσá command≤ whicΦ follo≈á i⌠á a≤á thσ ì
  202. commanΣ sequencσ t∩ bσ placeΣ oε thσ to≡ oµ thσ shel∞ stack«  ì
  203. I⌠ place≤ thi≤ sequencσ there«á  Consequently¼ oncσ SHSE╘ i≤ ì
  204. executeΣá oε ß sequencσ oµ commands¼á thesσ command≤ wil∞ bσ ì
  205. cycleΣá thr⌡á timσ anΣ timσ agaiε unti∞ thσ shel∞á stacδá i≤ ì
  206. cleared or popped.
  207.  
  208. Options:
  209.  
  210.      None
  211.  
  212.  
  213. Comments:
  214.  
  215.      SHSE╘á provide≤ aε eas∙ mechanisφ t∩ makσá an∙á commanΣ ì
  216. sequencσá int∩ ß shell«á  Consequently¼á non-ZCPR│ programs¼ ì
  217. likσá MBASIC¼á DBAS┼ II¼á WOR─ STAR¼á anΣ other≤ caεá becomσ ì
  218. shells under ZCPR3.
  219.  
  220.      Carσá shoulΣ bσ takeε witΦ SHSE╘ iε allowinτ thσá shel∞ ì
  221. t∩á bσá exiteΣá iµ i⌠ i≤ s∩ desired«á  Thσá utilit∙á CM─á i≤ ì
  222. sometimes useful for this.
  223.  
  224. Selected Error Messages:
  225.  
  226.      None - self-explanatory
  227.  
  228.  
  229. Examples of Use:
  230.  
  231.      SHSET MBASIC;CMD
  232.           -- define the sequence MBASIC;CMD to be a shell
  233.  
  234.      SHSET WS
  235.           -- define Word Star to be a shell
  236.  
  237.