home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / mbug / mbug120.arc / MTEK.LBR / README.DOC < prev   
Text File  |  1979-12-31  |  4KB  |  74 lines
  1.               Getting a .SYM file (usable by Mitek ZBUG)
  2.                  with a minimum number of keystrokes
  3.                            By Ian Johnstone
  4.  
  5. Thσá advantage≤á oµá beinτ ablσ t∩ usσ ß .SY═ filσá iεá thσá debugginτ ì
  6. proces≤á arσá considerablσ but¼á witΦ thσ numbe≥ oµ bug≤ ╔á managσá t∩ ì
  7. inser⌠á int∩ ß sourcσ file¼á thσ neeΣ t∩ usσ Harr∙ Purvisº SYMBOL.COM¼ ì
  8. whicΦ involve≤ quitσ ß numbe≥ oµ keystrokes¼á make≤ thσ joΓ almos⌠á a≤ ì
  9. tediou≤á a≤á doinτ i⌠ withou⌠ ß .SY═ file«á T∩ easσ thσ tediuφ ╔á havσ ì
  10. writteεá MTKSYM.CO═ whicΦ load≤ ZBUG.COM¼á read≤ iε ß filσá A.SY═á anΣ ì
  11. anothe≥ filσ A.COM¼ theε executeΣ thσ  commanΣ ^╥ which¼ ╔ suppose¼ i≤ ì
  12. what XSUB would do if we could use it on the Bee.
  13.  
  14. T∩á usσá MTKSY═á yo⌡ wil∞ neeΣ you≥ sourcσ filσ nameΣ A.Z8░ oεá thσá ┬ ì
  15. drive and the following on the A drive.
  16.      WordStar
  17.      USR.COM   ;or ASUB.COM 
  18.      ZIP.COM   ;Mitek file
  19.      ZAS.COM   ;   do
  20.      ZBUG.COM  ;   do
  21.      PAUSE.COM ;Gives a beep & prompts for a keystroke
  22.      MTKSYM.COM
  23.  
  24. Iµá yo⌡á haven'⌠ go⌠ ZIP.COM¼á ╔ aφ surσ tha⌠ i⌠ wil∞ bσ iεá SMU╟á BB╙ ì
  25. library«á ╔á prefe≥á t∩á speeΣ thing≤ u≡ b∙ copyinτ a≤ man∙á file≤á a≤ ì
  26. possiblσá t∩ thσ ═ drivσ anΣ usinτ thσ Bee'≤ USR.COM«á Iµ yo⌡á haven'⌠ ì
  27. go⌠á USR¼á usσ ASUB«á Fo≥ thosσ unfamilia≥ witΦ USR¼á ╔ wil∞á g∩á int∩ ì
  28. details.
  29.      Seect Icon 4 and press <CR> when offered that option
  30.      Select option E (edit)
  31.      Select command 3 (if vacant)
  32.      Enter:
  33.           ZI╨á USR.CO═ M:;ZI╨ ZAS.CO═ M:;ZI╨ ZBUG.CO═ M:;ZI╨ PAUSE.CO═ ì
  34.           M:;ZIP MTKSYM.COM M:;USR 4 <CR>
  35.      Select option S
  36.      Select option A
  37.      Select option E (edit)
  38.      Select command 4 (if vacant)
  39.      Enter:
  40.           M:;WS B:A.Z80;ZAS B:A $SM;PAUSE;WS B:A.Z80;ZAS B:A;ZLINK A;
  41.           MTKSYM ZBUG.COM <CR>
  42.      Select option S
  43.      Select option A
  44.      Selec⌠á commanΣ 3 anΣ yo⌡ arσ away«á Yo⌡ wil∞ bσá presenteΣá witΦ ì
  45. a WordStar screen displaying B:A.Z80:
  46.      Enter as a first line `ORG 100H'
  47.      Make corrections (if any) to source file
  48.      Exit from WS
  49.      Oε sounΣ oµ beep¼ examinσ screeε fo≥ assemble≥ erro≥ message≤ anΣ ì
  50.       press a key
  51.      W╙ screeε wil∞ appea≥ again«á Deletσ 'OR╟ 100Hº anΣ makσ alteratì
  52.       ion≤ (iµ any⌐ arisinτ froφ erro≥ message≤ anΣ exi⌠ froφ WS
  53. Thσ nex⌠ thinτ yo⌡ seσ wil∞ bσ ß ZBU╟ displa∙ oµ you≥ sourcσ filσ witΦ ì
  54. al∞á label≤á shown«á Futurσ passe≤ througΦ thi≤ serie≤á (excep⌠á afte≥ ì
  55. powe≥á up¼á wherσá thσ command≤ wil∞ bσ ┤ 3⌐ wil∞ bσ initiateΣ b∙á tw∩ ìèshar≡ tap≤ oµ ke∙ `4'«á Oµ course¼ thσ copyinτ oµ file≤ t∩ thσ ═ drivσ ì
  56. need only be done once.
  57.  
  58. Thσ MTKSY═ sourcσ filσ i≤ prett∙ eas∙ t∩ follo≈ through«á I⌠á consist≤ ì
  59. of three subroutines:
  60.      REA─á load≤ ZBUG.COM¼á redirect≤ BDO╙ call≤ froφ BDO╙ entr∙ poin⌠ ì
  61.       to TEMP and executes ZBUG
  62.      TEM╨á Check≤ returε addresse≤ fo≥ ß returε t∩ ZBU╟á BDO╙á callinτ ì
  63.       subroutine¼á redirect≤ tha⌠ cal∞ t∩ TRAP¼á restore≤ thσ origina∞ ì
  64.       BDOS entry point and jumps to TRAP
  65.      TRA╨ Iµ thσ cal∞ i≤ ß direc⌠ keyboarΣ request¼ returε ß characte≥ ì
  66.       from thetext buffer. Tidy up at end of text. The text buffer is:
  67.       'RA.SYM',CR,CR,ControlR,'RA.COM',CR,ControlR,0
  68. Therσá arσ n∩ erro≥ messages«á I⌠ i≤ u≡ t∩ thσ use≥ t∩ seσ tha⌠á file≤ ì
  69. arσ oε thσ righ⌠ disk«á Afte≥ onσ hiccup¼á ╔ go⌠ thσ righ⌠ result witΦ ì
  70. the command `MTKSYM d:ZBUG.COM' where d: is the correct drive.
  71.  
  72. Hoping that this will relieve som of the boredom in debugging.
  73.  
  74.