home *** CD-ROM | disk | FTP | other *** search
/ Oakland CPM Archive / oakcpm.iso / cpm / database / db110.lbr / M2DB110.DZC / M2DB110.DOC
Text File  |  1989-02-28  |  19KB  |  442 lines

  1. .oΩ off
  2. .c≈ 10
  3. .p∩ 12
  4. .rm 65
  5. ****************************************************************
  6. ¬                                                              *
  7. ¬         Documentatioε fo≥ M2-D┬ (Modula-▓ Database⌐          *
  8. ¬                         Release 1.1░                         *
  9. ¬                           02/18/8╣                           *
  10. ¬             Copyrigh⌠ 198╣ b∙ JosepΦ I« Mortenseε            *
  11. ¬                      Al∞ Right≤ ReserveΣ                     *
  12. ¬                                                              *
  13. ****************************************************************
  14.  
  15.                          I« Introduction
  16.  
  17. M▓-D┬ i≤ thσ produc⌠ oµ thσ author'≤ wisΦ fo≥ aε eas∙ t∩ usσ namσ ì
  18. anΣ addres≤ filσ program«  It≤ mos⌠ importan⌠ feature≤ are:
  19.      ¬  Add¼ edit¼ delete¼ search¼ browse¼ sort¼ o≥ prin⌠ witΦ ì
  20. onσ-ke∙ mnemoniπ commands.
  21.      ¬  SearcΦ record≤ oε an∙ oµ seveε fields.
  22.      ¬  PrinteΣ outpu⌠ oµ eithe≥ label≤ o≥ envelopes«  
  23.      ¬  Prin⌠ selecteΣ grou≡ oµ label≤ (al∞ oµ onσ zi≡ codσ fo≥ ì
  24. example).
  25.      ¬  Disδ outpu⌠ oµ label≤ anΣ aε ASCI╔ commß-delimiteΣ ì
  26. datafilσ usablσ b∙ WordStar'≤ MergePrin⌠ feature«  
  27.      ¬  ┴ grea⌠ companioε t∩ WordStar«  Run≤ froφ WS'≤ n∩ filσ ì
  28. men⌡ witΦ ╥ command.
  29.      ¬  Use≥-selecteΣ printe≥ font≤ froφ withiε M▓-D┬ (iµ yo⌡ ì
  30. havσ aε Epsoε F╪ compatiblσ printer).
  31.      ¬  Read∙ t∩ ruε oε an∙ Kaypr∩ CP/═ computer«  Caε bσ ì
  32. installeΣ t∩ ruε oε othe≥ Z8░ CP/═ machine≤ witΦ 8░ columε b∙ 2┤ ì
  33. ro≈ monitor«  T∩ instal∞ i⌠ fo≥ othe≥ Z8░ CP/═ machine≤ seσ thσ ì
  34. appendix.
  35.  
  36. M2-D┬ i≤ issueΣ a≤ SHAREWARE«  Yo⌡ arσ welcomσ t∩ copy¼ use¼ anΣ ì
  37. freel∙ distributσ copie≤ oµ DB.CO═ anΣ thi≤ documentatioε file«  ì
  38. Iµ yo⌡ likσ i⌠ anΣ decidσ t∩ usσ it¼ pleasσ senΣ $10.0░ (US⌐ to:
  39.  
  40.                        JosepΦ I« Mortensen
  41.                          421┤ Chelseß Ct.
  42.                         Midland¼ M╔ 48640
  43.                           51╖  835-6923
  44.                       CompuServσ 70037,3161
  45.                        GEniσ J.MORTENSEN3
  46.  
  47. M2-D┬ wa≤ compileΣ anΣ linkeΣ witΦ Z8░ Turb∩ Modula-▓ (Copyrigh⌠ ì
  48. 198╢ BorlanΣ International)«  Thosσ wh∩ reques⌠ i⌠ ma∙ havσ thσ ì
  49. Modulß-▓ sourcσ codσ includinτ suppor⌠ modules«  Update≤ wil∞ bσ ì
  50. ≤en⌠ t∩ thosσ wh∩ senΣ thei≥ $10.
  51.  
  52. ****              Specia∞ Notσ oε Versioε 1.1░               ****
  53.  
  54. Versioε 1.1░ ha≤ ß slightl∙ differen⌠ filσ forma⌠ thaε previou≤ ì
  55. version≤ anΣ wil∞ no⌠ worδ properl∙ witΦ datß file≤ createΣ witΦ ì
  56. them«  ┴ conversioε utilit∙ DBCONVRT.CO═ i≤ supplieΣ t∩ conver⌠ ì
  57. t∩ thσ ne≈ format«  I⌠ i≤ iε thσ thσ librar∙ filσ whicΦ contain≤ ì
  58. thi≤ documentatioε file.
  59. è                       II«  Startinτ M2-DB
  60.  
  61. Afte≥ makinτ ß backu≡ oµ you≥ origina∞ cop∙ oµ M2-D┬ inser⌠ you≥ ì
  62. workinτ disδ iε Drivσ ┴ anΣ enter:   A╛ D┬ <[du:]filename>
  63.  
  64. Thσ drive/use≥ designatioε anΣ thσ filenamσ arσ optiona∞ oε thσ ì
  65. commanΣ line«  Iµ yo⌡ omi⌠ thσ filename¼ M▓-D┬ wil∞ promp⌠ yo⌡:
  66. ______________________________________________________________
  67. ⁿ  << M2-DB 1.10 >> 02/18/8╣                                 |
  68. ⁿ                                                            |
  69. ⁿ  Copyright 1989 by Joseph I. Mortenseε                     |
  70. ⁿ                                                            |
  71. ⁿ  Enter filename║                                           |
  72. |____________________________________________________________|ì
  73.  
  74. Iµ M▓-D┬ doe≤ no⌠ finΣ thσ filσ yo⌡ specify¼ yo⌡ wil∞ ge⌠ thi≤ ì
  75. message:
  76.  
  77.   NEWFIL┼ not found.  Create new file? Y/N
  78.  
  79. Iµ yo⌡ entereΣ ß filσ namσ oε thσ commanΣ line¼ thσ firs⌠ screeε ì
  80. yo⌡ seσ look≤ likσ thi≤ (iµ you'rσ usinτ ß previousl∙ openeΣ ì
  81. file):
  82. ______________________________________________________________
  83. ⁿ   <╝ M▓-D┬ 1.10 >╛ 02/18/8╣                                |
  84. ⁿ                                                            |
  85. ⁿ  Copyrigh⌠ 198╣ b∙ JosepΦ I« Mortenseε                     ⁿ
  86. ⁿ                                                            |
  87. ⁿ  NAMEADDR.FI╠ opeε fo≥ processing¼ las⌠ useΣ oε 01/11/89«  |
  88. ⁿ                                                            |
  89. ⁿ                                                            |
  90. ⁿ                                                            |
  91. ⁿ  Ente≥ Today'≤ Date║  <mm/dd/yy╛  [<CR╛ skip≤ datσ entry▌  |
  92. |____________________________________________________________|
  93.  
  94. Yo⌡ wil∞ als∩ bσ askeΣ fo≥ thσ datσ sincσ M▓-D┬ wil∞ ì
  95. automaticall∙ pu⌠ thσ datσ entereΣ oε eacΦ entr∙ yo⌡ adΣ t∩ thσ ì
  96. file«  Iµ yo⌡ ente≥ <RETURN╛ a⌠ thσ datσ prompt¼ M▓-D┬ wil∞ ski≡ ì
  97. thσ res⌠ oµ thσ datσ entr∙ anΣ usσ whateve≥ datσ i⌠ ha≤ storeΣ ì
  98. froφ prio≥ uses.
  99.  
  100. Iµ you≥ filσ contain≤ an∙ activσ records¼ thσ firs⌠ onσ wil∞ bσ ì
  101. displayeΣ likσ this:
  102. .paèSAMPLE.FIL-01/11/89             << M2-DB 1.10 >>                     2 records
  103. -------------------------------------------------------------------------------
  104.  
  105. LAST> Farwell                 FIRST> Geoffrey          MID> L.
  106.  
  107. SPOUSE> Erma             TITLE> Mr.              SALUTATION> Jeff
  108.  
  109. ADDRESS> 9006 Emery Way                 ADDR2>
  110.  
  111. CITY> Donaldson Corner                  STATE> CO   ZIP> 80386
  112.  
  113. PHONE NOS> 285-6478
  114.  
  115. BIRTHDAY> 12/22/38  ANNIVERSARY> 09/05/60
  116.  
  117. COMMENT>
  118.  
  119. DATE ENTERED> 01/11/89
  120.  
  121. -------------------------------------------------------------------------------
  122. A>dd  D>el  E>dit  F>ind  N>ext  P>rev  O>utput  S>ort  C>fτ  Q>uit
  123.  
  124. Thσ filσ namσ anΣ datσ arσ displayeΣ iε thσ uppe≥ lef⌠ corne≥ oµ ì
  125. thσ display«  ┴ coun⌠ oµ activσ record≤ iε thσ filσ appear≤ iε ì
  126. thσ uppe≥ righ⌠ corner«  Thσ namσ anΣ curren⌠ versioε oµ M▓-D┬ ì
  127. sho≈ iε thσ uppe≥ cente≥ oµ thσ screen.
  128.  
  129.                        III«  Thσ Commands
  130.  
  131. M▓-D┬ use≤ singlσ lette≥ command≤ whicΦ arσ alway≤ showε iε thσ ì
  132. men⌡ linσ a⌠ thσ bottoφ oµ thσ screen:
  133.  
  134. ¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡-¡¡¡¡¡¡¡¡¡¡¡¡¡¡-
  135. A>dΣ  D>e∞  E>di⌠  F>inΣ  N>ex⌠  P>re÷  O>utpu⌠  S>or⌠  C>fτ  Q>ui⌠ 
  136.  
  137. Thσ maiε command≤ arσ explaineΣ iε thσ followinτ sections.
  138.  
  139.                         A«  A>dΣ ß Record
  140.  
  141. Thσ firs⌠ timσ yo⌡ usσ M▓-D┬ ß blanδ forφ wil∞ comσ oε thσ screeε ì
  142. witΦ ß men⌡ oε thσ bottoφ linσ oµ thσ screen«  T∩ makσ ß ne≈ ì
  143. entr∙ yo⌡ pres≤ ┴ fo≥ Add«  Thσ curso≥ jump≤ t∩ thσ firs⌠ fielΣ ì
  144. iε thσ datß forφ anΣ await≤ you≥ input«  WordSta≥-likσ editinτ ì
  145. command≤ (^A,^S,^D,^F⌐ movσ thσ cursor«  TAB¼ CR¼ o≥ ^╪ move≤ t∩ ì
  146. thσ nex⌠ field«  ^┼ wil∞ bacδ u≡ onσ field«  ^┘ delete≤ froφ ì
  147. curso≥ t∩ thσ enΣ oµ thσ field«  T∩ finisΦ thσ entr∙ typσ ^┌ iε ì
  148. an∙ fielΣ o≥ typσ ß carriagσ returε a⌠ thσ enΣ oµ thσ las⌠ fielΣ ì
  149. iε thσ datß form«  Oε ß ne≈ entr∙ yo⌡ d∩ no⌠ neeΣ t∩ fil∞ iε ì
  150. "Datσ Entered;ó  M▓-D┬ doe≤ i⌠ automatically.
  151.  
  152. .paèThσ datß entr∙ screeε look≤ likσ this:
  153.  
  154. SAMPLE.FI╠-01/11/8╣             <╝ M▓-D┬ 1.10 >╛                   ▓ records
  155. ¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡-¡¡¡¡¡¡¡¡¡¡¡¡¡-
  156.  
  157. LAST╛ ___________________▀    FIRST╛                   MID>
  158.  
  159. SPOUSE╛                  TITLE╛                  SALUTATION>
  160.  
  161. ADDRESS╛                                ADDR2>
  162.  
  163. CITY╛                                   STATE╛      ZIP>
  164.  
  165. PHON┼ NOS>
  166.  
  167. BIRTHDAY╛           ANNIVERSARY>
  168.  
  169. COMMENT>
  170.  
  171. DAT┼ ENTERED>
  172.  
  173.   WordStar-typσ [^A,^S,^D,^F▌ key≤ movσ cursor«  TAB¼ CR¼ o≥ ^╪ move≤ to
  174.   nex⌠ field«   ^┼ back≤ up«   ^┘ delete≤ froφ curso≥ t∩ end«   ^┌ exits.
  175. -------------------------------------------------------------------------------
  176. A>dΣ  D>e∞  E>di⌠  F>inΣ  N>ex⌠  P>re÷  O>utpu⌠  S>or⌠  C>fτ  Q>ui⌠  A
  177.  
  178. Wheε yo⌡ finisΦ aε entry¼ yo⌡ caε abor⌠ it¼ savσ i⌠ anΣ continuσ ì
  179. addinτ ne≈ entries¼ o≥ savσ anΣ qui⌠ addinτ ne≈ ones«  Thσ numbe≥ ì
  180. oµ entrie≤ i≤ limiteΣ b∙ thσ 64╦ oµ memor∙ oµ mos⌠ Z8░ computers«  ì
  181. M▓-D┬ limit≤ thσ numbe≥ oµ record≤ whicΦ caε bσ sorteΣ t∩ 1200«  ì
  182. However¼ yo⌡ arσ limiteΣ b∙ disδ capacit∙ a≤ follows:
  183.      SSD─ (191K⌐ -¡  60░ records
  184. Seσ sectioε ╟ belo≈ fo≥ furthe≥ informatioε oε sorting«  
  185.  
  186.                        B«  E>di⌠ ß Record
  187.  
  188. T∩ edi⌠ ß recorΣ pres≤ ┼ anΣ thσ curso≥ jump≤ (exactl∙ a≤ witΦ ì
  189. addinτ ne≈ records⌐ t∩ thσ firs⌠ field«  Thσ samσ editinτ key≤ ì
  190. appl∙ iε editinτ a≤ iε addinτ ne≈ records«  Pres≤ ^┌ t∩ exi⌠ anΣ ì
  191. savσ thσ changes.
  192. .paèEditinτ ß record:
  193.  
  194. SAMPLE.FIL-01/11/8╣             <╝ M2-D┬ 1.10 >╛                     ▓ records
  195. -------------------------------------------------------------------------------
  196.  
  197. LAST╛ Alfredson__________▀    FIRST╛ Ear∞              MID╛ R.
  198.  
  199. SPOUSE╛ Aimeσ            TITLE╛ Mr«              SALUTATION╛ Earl
  200.  
  201. ADDRESS╛ 864▓ W« Inne≥ Drivσ            ADDR2>
  202.  
  203. CITY╛ Elbertß                           STATE╛ M╬   ZIP╛ 50876
  204.  
  205. PHONE NOS╛ 432-8698
  206.  
  207. BIRTHDAY╛ 08/18/4│  ANNIVERSARY╛ 08/23/66
  208.  
  209. COMMENT>
  210.  
  211. DAT┼ ENTERED╛ 01/11/89
  212.  
  213.   WordStar-typσ [^A,^S,^D,^F▌ key≤ movσ cursor«  TAB¼ CR¼ o≥ ^╪ move≤ to
  214.   nex⌠ field«   ^┼ back≤ up«   ^┘ delete≤ froφ curso≥ t∩ end«   ^┌ exits.
  215. -------------------------------------------------------------------------------
  216. A>dΣ  D>e∞  E>di⌠  F>inΣ  N>ex⌠  P>re÷  O>utpu⌠  S>or⌠  C>fτ  Q>ui⌠  E
  217.  
  218.  
  219.                       C«  D>eletσ ß Record
  220.  
  221. T∩ deletσ ß recorΣ pres≤ ─ froφ thσ menu«  M2-D┬ wil∞ asδ yo⌡ iµ ì
  222. yo⌡ reall∙ meaε i⌠ beforσ deletinτ thσ record.
  223.  
  224.                        D«  F>inΣ ß Record
  225.  
  226. M2-D┬ allow≤ searche≤ oε seven differen⌠ fields║  las⌠ name¼ firs⌠ ì
  227. name¼ city¼ state¼ birtΦ month¼ anniversar∙ month¼ o≥ zipcode« T∩ ì
  228. finΣ ß giveε recorΣ yo⌡ pres≤ ╞ froφ thσ menu«  Yo⌡ wil∞ theε bσ ì
  229. prompteΣ fo≥ thσ searcΦ iteφ  anΣ thσ searcΦ string«  
  230.  
  231. A≤ oµ releasσ 1.0│ M▓-D┬ doe≤ ambiguou≤ searche≤ fo≥ las⌠ name¼ ì
  232. firs⌠ name¼ city¼ o≥ zi≡ codσ witΦ a≤ littlσ a≤ ß singlσ lette≥ ì
  233. o≥ number«  T∩ ge⌠ t∩ thσ "Só sectioε oµ you≥ filσ merel∙ ente≥ ì
  234. "só a≤ you≥ searcΦ string«  Fo≥ zi≡ code≤ beginninτ 46..«  ente≥ ì
  235. "46ó a≤ thσ string«  Thi≤ featurσ give≤ yo⌡ thσ maximuφ flexΘ-ì
  236. bilit∙ iε searching«  Iε mos⌠ case≤ thσ firs⌠ threσ o≥ fou≥ ì
  237. letter≤ oµ thσ las⌠ namσ wil∞ givσ yo⌡ thσ onσ yo⌡ want«  Don'⌠ ì
  238. worr∙ abou⌠ uppe≥ o≥ lowe≥ case«  Thσ searcΦ routinσ convert≤ ì
  239. everythinτ t∩ uppe≥ case«  M▓-D┬ wil∞ star⌠ thσ searcΦ anΣ ì
  240. displa∙ thσ firs⌠ recorΣ tha⌠ matche≤ thσ searcΦ string«  Iµ i⌠ ì
  241. i≤ no⌠ thσ onσ yo⌡ want¼ pres≤ "Nó (fo≥ "no"⌐ anΣ thσ searcΦ goe≤ ì
  242. on«  Pres≤ 'Yº iµ it'≤ thσ onσ yo⌡ wan⌠ t∩ edi⌠ o≥ print«  Iµ thσ ì
  243. searcΦ strinτ i≤ no⌠ found¼ M▓-D┬ tell≤ yo⌡ so«  Duσ t∩ thσ ì
  244. fairl∙ unsophisticateΣ searcΦ routinσ useΣ iε M▓-D┬ searche≤ iε ì
  245. ver∙ largσ file≤ wil∞ bσ ß bi⌠ slow.
  246. è          E«  Browsσ Mode¼ thσ N>ex⌠ anΣ P>re÷ Commands
  247.  
  248. Onσ oµ thσ nicσ feature≤ oµ M▓-D┬ i≤ thσ abilit∙ t∩ browsσ recorΣ ì
  249. b∙ recorΣ througΦ thσ file«  ╬ (fo≥ next⌐ move≤ t∩ thσ nex⌠ ì
  250. recorΣ iε thσ file«  ╨ (fo≥ previous⌐ move≤ backwarΣ througΦ thσ ì
  251. file«  EacΦ timσ yo⌡ opeε aε existinτ recorΣ filσ thσ firs⌠ ì
  252. recorΣ iε thσ filσ i≤ displayed«  Yo⌡ caε browsσ througΦ thσ ì
  253. entirσ filσ usinτ thσ ╬ anΣ ╨ commands.
  254.  
  255.                        F«  O>utpu⌠ Options
  256.  
  257. M2-D┬ offer≤ severa∞ outpu⌠ options«  I⌠ i≤ preconfigureΣ t∩ ì
  258. producσ onσ incΦ b∙ 3.╡ incΦ continuou≤ feeΣ labels¼ singlσ ì
  259. envelope≤ (smal∞ o≥ large)¼ o≥ ß datafilσ iε ASCI╔ commß ì
  260. delimiteΣ forma⌠ fo≥ usσ witΦ WordSta≥ MergePrint¼ dBII/III¼ anΣ ì
  261. othe≥ programs«  Thσ abilit∙ t∩ writσ aε ASCI╔ datafilσ open≤ thσ ì
  262. extensivσ option≤ oµ mergσ printinτ t∩ thσ user«  ┴ specia∞ ì
  263. printe≥ men⌡ (seσ belo≈ oε thσ C>fτ command⌐ allow≤ ß choicσ oµ ì
  264. printe≥ font≤ (Epsoε FX8╡ compatible≤ only)«  Yo⌡ caε continuσ ì
  265. makinτ selection≤ froφ thσ printe≥ men⌡ (combininτ elitσ witΦ ì
  266. widσ anΣ italic¼ fo≥ example)«  Thσ configuratioε i≤ saveΣ witΦ ì
  267. you≥ datß filσ unti∞ yo⌡ choosσ t∩ changσ it«  Yo⌡ caε als∩ havσ ì
  268. ß defaul⌠ returε addres≤ prin⌠ oε envelopes.
  269.  
  270. Outpu⌠ oµ label≤ caε bσ multiplσ copie≤ oµ ß singlσ namσ anΣ ì
  271. address¼ singlσ copie≤ oµ name≤ yo⌡ picδ one b∙ one¼ ß selecteΣ ì
  272. se⌠ (onl∙ thosσ matchinτ unambiguou≤ searcΦ strings¼ ß giveε ì
  273. zipcode¼ fo≥ example)¼ o≥ thσ entirσ file«  Iµ yo⌡ selec⌠ ì
  274. individua∞ label≤ o≥ envelopes¼ yo⌡ caε usσ thσ F>inΣ anΣ N>ex⌠ ì
  275. command≤ t∩ browsσ thσ filσ unti∞ yo⌡ finΣ thσ recorΣ t∩ print«  ì
  276. Wheε yo⌡ havσ thσ onσ yo⌡ want¼ pres≤ ╨ t∩ prin⌠ it.
  277.  
  278. Iµ yo⌡ selec⌠ Datafile¼ M2-D┬  write≤ ou⌠ thσ entirσ filσ witΦ ì
  279. al∞ field≤ iε comma-delimiteΣ format.
  280.  
  281.                         G« S>or⌠ thσ File
  282.  
  283. Wheε yo⌡ givσ thσ S>or⌠ command¼ M▓-D┬ sort≤ thσ filσ oµ record≤ ì
  284. b∙ las⌠ namσ anΣ theε firs⌠ name«   Afte≥ thσ filσ i≤ sorted¼ i⌠ ì
  285. i≤ rewritteε iε sorteΣ forφ oε thσ disδ drivσ yo⌡ specify«  Memor∙ ì
  286. limitation≤ oµ Z8░ computer≤ (anΣ thσ programminτ limitation≤ oµ ì
  287. thσ author!⌐ restric⌠ thσ sortinτ t∩ 120░ record≤ iε M▓-DB«  ì
  288. Previou≤ version≤ oµ M▓-D┬ limiteΣ thσ sor⌠ t∩ 600«  T∩ allo≈ fo≥ ì
  289. thσ increasσ t∩ 120░ releasσ 1.0┤ changeΣ thσ sor⌠ routinσ b∙ ì
  290. truncatinτ las⌠ name≤ t∩ teε letter≤ anΣ firs⌠ name≤ t∩ four«  Iε ì
  291. al∞ bu⌠ ß fe≈ case≤ thσ sor⌠ wil∞ worδ properly«  Ver∙ largσ ì
  292. file≤ wil∞ takσ timσ t∩ sort«  Fo≥ example¼ ß 10░ recorΣ filσ ì
  293. take≤ 7░ second≤ t∩ sor⌠ anΣ rewritσ oε ß 5MH· Kaypr∩ '8│ usinτ ì
  294. quaΣ densit∙ drive≤ anΣ TurboROM«  Sincσ thσ sortinτ anΣ ì
  295. rewritinτ arσ disδ-intensivσ operations¼ slowe≥ CPU'≤ (2.╡ o≥ ┤ ì
  296. MHz⌐ takσ ver∙ littlσ longer«  Unles≤ yo⌡ arσ constantl∙ addinτ ì
  297. entrie≤ t∩ you≥ file¼ yo⌡ won'⌠ neeΣ t∩ sor⌠ ver∙ often«  Thσ ì
  298. sor⌠ routinσ automaticall∙ remove≤ deleteΣ record≤ froφ thσ filσ ì
  299. s∩ i⌠ doe≤ no⌠ gro≈ fa⌠ oε unuseΣ bytes.
  300. .paèREA─ TH┼ FOLLOWIN╟ CAUTION╙ O╬ SORTING!
  301.  
  302.                           *¬ CAUTIO╬ *¬  ì
  303.  
  304. Wheε M▓-D┬ doe≤ ß sort¼ i⌠ need≤ ß lo⌠ oµ RAM«  I⌠ use≤ ß 20+╦ ì
  305. arra∙ t∩ creatσ thσ inde° fo≥ thσ sort«  Thσ sor⌠ routinσ check≤ ì
  306. thσ amoun⌠ oµ freσ memor∙ beforσ beginninτ thσ sor⌠ t∩ preven⌠ aε ì
  307. ou⌠ oµ memor∙ error«  Iµ yo⌡ havσ 21╦ o≥ morσ oµ freσ memory¼ ì
  308. you'l∞ havσ n∩ problem«  M▓-D┬ ha≤ ß commanΣ no⌠ showε oε thσ ì
  309. men⌡ whicΦ tell≤ ho≈ mucΦ freσ memor∙ i≤ available«  Beforσ yo⌡ ì
  310. sort¼ pres≤ 'Mº a⌠ thσ maiε menu«  Thσ amoun⌠ oµ freσ memor∙ wil∞ ì
  311. bσ displayeΣ oε thσ men⌡ line«  M▓-D┬ wil∞ d∩ ß sor⌠ witΦ n∩ ì
  312. probleφ wheε ruε froφ WordSta≥ 4.0'≤ maiε men⌡ witΦ Xtrake∙ 2.╢ ì
  313. residen⌠ oε ß 63╦ Kaypro« 
  314.  
  315. A≤ ß precautioε yo⌡ ma∙ wisΦ t∩ makσ ß backu≡ cop∙ oµ you≥ ì
  316. datafilσ oε ß separatσ diskettσ beforσ doinτ ß sort«  Thσ sor⌠ ì
  317. routinσ automaticall∙ create≤ ß backu≡ filσ froφ thσ origina∞ ì
  318. file«  Yo⌡ wil∞ finΣ i⌠ a≤ "BACKUP.DTAó oε thσ disk.
  319.  
  320.                        *¬ CAUTIO╬ NO« ▓ **
  321.  
  322. Beforσ yo⌡ d∩ ß sort¼ decidσ wherσ thσ ne≈ sorteΣ filσ wil∞ go«  ì
  323. Sincσ M▓-D┬ write≤ ß ne≈ filσ durinτ thσ sor⌠ operation¼ yo⌡ mus⌠ ì
  324. havσ disδ spacσ enougΦ fo≥ thσ seconΣ file«  Fo≥ tha⌠ reason¼ thσ ì
  325. sor⌠ routinσ ask≤ yo⌡ whicΦ drivσ t∩ pu⌠ thσ ne≈ filσ on«  
  326.  
  327. Onσ furthe≥ note║  tryinτ t∩ sor⌠ aε empt∙ filσ (░ records⌐ ¡¡ ì
  328. yes¼ someonσ ha≤ trieΣ i⌠ ¡¡ wil∞ causσ ß ruε-timσ error.
  329.  
  330.                        H«  C>onfiguration
  331.  
  332. Thσ C>fτ commanΣ let≤ yo⌡ se⌠ printinτ default≤ fo≥ label≤ anΣ ì
  333. envelopes«  Wheε yo⌡ opeε ß ne≈ file¼ thσ configuratioε prograφ ì
  334. run≤ automatically«  Yo⌡ ma∙ changσ thσ configuratioε anytimσ b∙ ì
  335. pressinτ 'Cº a⌠ thσ maiε menu«  Yo⌡ wil∞ seσ ß onσ linσ men⌡ oµ ì
  336. variou≤ prin⌠ mode≤ whicΦ yo⌡ caε combinσ (e.g.¼ proportiona∞ anΣ ì
  337. nea≥ lette≥ quality⌐ t∩ thσ exten⌠ you≥ printe≥ allows«  Wheε ì
  338. you'vσ madσ you≥ selection¼ pres≤ 'Qº t∩ quit«  You≥ selectioε i≤ ì
  339. saveΣ iε ß bi⌠ patterε iε thσ data file«  C>fτ als∩ ask≤ iµ yo⌡ ì
  340. wan⌠ ß defaul⌠ returε addres≤ whicΦ wil∞ automaticall∙ prin⌠ oε ì
  341. envelopes«  Thi≤ i≤ als∩ storeΣ a≤ ß specia∞ par⌠ oµ thσ datß ì
  342. file«  I⌠ caε bσ changeΣ anytimσ yo⌡ wish« 
  343.  
  344.                         I« Miscellaneous
  345.  
  346. M2-D┬ recognize≤ thσ drive/use≥ area≤ availablσ iε CP/M«  Oµ ì
  347. course¼ b∙ usinτ uniquσ filσ name≤ yo⌡ caε havσ multiplσ datß ì
  348. file≤ iε an∙ onσ use≥ area.
  349.  
  350. Iµ yo⌡ havσ difficultie≤ witΦ M▓-DB¼ pleasσ advisσ thσ autho≥ oµ ì
  351. thσ bugs«  Iµ yo⌡ havσ idea≤ t∩ improvσ it¼ d∩ likewise«  ╔ ma∙ ì
  352. o≥ ma∙ no⌠ d∩ anythinτ witΦ thσ suggestions¼ bu⌠ I'Σ likσ t∩ hea≥ ì
  353. froφ thosσ wh∩ arσ usinτ it....alonτ witΦ you≥ teε bucks¼ oµ ì
  354. course«  ╔ havσ incorporateΣ somσ usersº suggestion≤ int∩ ìèrevision≤ oµ thσ code.
  355.  
  356.                             Appendix
  357.  
  358. T∩ instal∞ M2-D┬ oε computer≤ othe≥ thaε Kaypr∩ (anΣ othe≥ ADM-3┴ ì
  359. typσ displays⌐ usσ ß disδ edito≥ o≥ debugginτ too∞ (DD╘ o≥ ì
  360. SuperZap¼ fo≥ example⌐ t∩ patcΦ thσ followinτ locations:
  361.  
  362.      036╕      Screeε widtΦ (usuall∙ 50H⌐ [addres≤ correcteΣ froφ ì
  363.                earlie≥ versioε oµ documentation]
  364.      036╣      Screeε heigh⌠ (usuall∙ 18H)
  365.      038┴      Curso≥ positioninτ sequence«  Firs⌠ bytσ i≤ thσ ì
  366. ááááááááááááááálengtΦ oµ thσ string« (1B╚ 2D╚ [Esc=▌ fo≥ ADM-3A)
  367.      039┴      Ro≈ o≥ Columε first┐  0░ fo≥ column¼ 0▒ fo≥ row
  368.      039├      Ro≈ offse⌠     (20╚ fo≥ ADM-3A)
  369.      039─      Columε offse⌠  (20╚ fo≥ ADM-3A)
  370.      03A▓      CommanΣ t∩ clea≥ screen«  Firs⌠ bytσ i≤ lengtΦ oµ ì
  371. áááááááááááááááthσ string« (1A╚ fo≥ ADM-3A)
  372.      03A┼      Inser⌠ linσ string«  Firs⌠ bytσ i≤ length.
  373.      03B╕      Deletσ linσ string«  Firs⌠ bytσ i≤ length.
  374.      03C░      Clea≥ t∩ enΣ oµ linσ string«  Firs⌠ bytσ i≤ ì
  375. áááááááááááááááááááááááááááááálength.
  376.  
  377. Yo⌡ ma∙ als∩ usσ thσ followinτ patcΦ filσ (M2PAT.ASM⌐ writteε b∙ ì
  378. Jiφ Lil∞ wh∩ sen⌠ i⌠ t∩ mσ viß GEnie«  I⌠ wil∞ providσ termina∞ ì
  379. installatioε fo≥ an∙ program≤ writteε unde≥ Turb∩ Modulß-▓ ì
  380. includinτ M▓-DB.
  381.  
  382. ╗ TM2PAT.AS═    Turb∩ Modula-▓ Termina∞ Attributσ Patcher
  383. ;
  384. ╗ re÷ 1.░  -Jiφ Lil∞   │ Jaε 8╣   Vecto≥ BoarΣ RCP/═  716-544-1863
  385. ;
  386. ╗ Thi≤ filσ wil∞ overla∙ an∙ TM▓ compileΣ codσ t∩ worδ witΦ you≥ terminal.
  387. ╗ I⌠ wa≤ inspireΣ b∙ Joσ Mortensen'≤ M2-db10┤ Databasσ prograφ whicΦ was
  388. ╗ supplieΣ witΦ ß .CO═ filσ anΣ ß lis⌠ oµ patches« Hσ suggesteΣ thσ use
  389. ╗ oµ DDT« ╔ finΣ thi≤ techniquσ les≤ tedious« ╔ examineΣ othe≥ TM▓ .COM
  390. ╗ file≤ anΣ founΣ tha⌠ hσ haΣ madσ aε erro≥ oε thσ firs⌠ address« ╔ also
  391. ╗ havσ addeΣ ß patcΦ t∩ thσ termina∞ namσ fo≥ completeness.
  392. ;
  393. ╗ N∩ guaranteσ tha⌠ al∞ thσ stufµ i≤ herσ fo≥ al∞ terminal≤ bu⌠ i⌠ certainly
  394. ╗ fill≤ thσ ga≡ lef⌠ bu⌠ therσ beinτ n∩ GINS╘ fo≥ TM▓ likσ therσ wa≤ fo≥ TP3.
  395. ;
  396. ╗ Usage║ 1¡ edi⌠ fo≥ you≥ terminal
  397. ╗        2¡ assemble¼ AS═ M2PAT
  398. ╗        3¡ overla∙ file¼ MLOA─ db110.COM,M2PAT
  399. ;
  400. ;
  401.     org    0353h        ;makσ thσ patcΦ completσ witΦ ne≈ name!
  402.     db    'Applσ CP/═    ';you≥ termina∞ name
  403. ╗               123456789012345<---¡ fifteeε char≤ ma° t∩ bσ safe
  404.  
  405.     orτ      0368h    
  406.     db    80        ;Screeε width
  407.     db    2┤               ;screeε height
  408. è    orτ      038Ah        ;Curso≥ positioninτ sequence.
  409.     db    4        ;Firs⌠ bytσ i≤ thσ lengtΦ oµ thσ string.
  410.     db    1Bh
  411.     db    3Dh        
  412.  
  413.     orτ      039AΦ         ;Ro≈ o≥ Columε first?
  414.     db    1        ;░ fo≥ column¼ ▒ fo≥ row
  415.  
  416.     orτ      039Ch
  417.     db    20h        ;Ro≈ offset
  418.     db    20h        ;Columε Offset
  419.  
  420.     orτ      03A2Φ         ;CommanΣ t∩ clea≥ screen.
  421.     db    2        ;Firs⌠ bytσ is lengtΦ oµ thσ string.
  422.     db    1Bh,2Ah
  423.  
  424.  
  425.     orτ      03AEΦ         ;Inser⌠ linσ string.
  426.     db    0        ;Firs⌠ bytσ i≤ length.
  427.  
  428.     orτ      03B8h        ;Deletσ linσ string.
  429.     db    0        ;Firs⌠ bytσ i≤ length.
  430.  
  431.     orτ      03C0Φ         ;Clea≥ t∩ enΣ oµ linσ string.
  432.     db    2        ;Firs⌠ bytσ i≤ length.
  433.     db    1Bh,54h
  434.  
  435.     enΣ  ì
  436.  
  437.  
  438. Thi≤ documentatioε writteε Septembe≥ 19¼ 1988.
  439. ReviseΣ 02/18/89
  440.  
  441.  
  442.