home *** CD-ROM | disk | FTP | other *** search
/ Oakland CPM Archive / oakcpm.iso / cpm / cpm3 / bankrsx.lbr / BANK.DQC / BANK.DOC
Text File  |  1986-01-19  |  2KB  |  108 lines
  1.     BANK.RSX
  2.     --------
  3.  
  4. Jim Lopushinsky
  5. October 15, 1985
  6. 403-435-6579 (300 & 1200 baud) (after 11/01/85)
  7.  
  8. An interactive RSX for SID and other debuggers that adds the ability
  9. to examine and modify memory that is not in the TPA bank (bank 1).
  10. This is only for the Banked version of CP/M Plus.
  11.  
  12. To use, attach the RSX to SID:
  13.  
  14. A>GENCOM SID BANK
  15.  
  16. To access the RSX, use the Call command under SID at the designated
  17. address (currently set to 30 hex, or RST 6):
  18.  
  19. #C30
  20.  
  21. *  <-- this prompt indicates that BANK is ready for a command.
  22.  
  23. BANK will take control and prompt with an '*' to indicate it is
  24. waiting for a command.  To get back to SID, use the X command.
  25. BANK accepts 4 commands whose syntax and meaning are the same
  26. as SID's:
  27.  
  28. D - dump memory.
  29.  
  30.     D[W][b:][start][,end]
  31.  
  32.     W - optional.  if included, dump in word format
  33.  
  34.     b: - optional bank number.  If not specified, bank
  35.         defaults to previous dump or if first dump,
  36.         bank 0.
  37.  
  38.     start - optional start address. If not specified,
  39.         defaults to continuation of previous dump,
  40.         or if first dump, address 0.
  41.  
  42.     end - optional end address.  If not specified,
  43.         defaults to start+7F hex (dumps 128 bytes).
  44.  
  45.  
  46. S - substitute memory (change memory locations)
  47.  
  48.     S[W][b:]address
  49.  
  50.     W - optional.  if included, substitute in word format
  51.  
  52.     b: - optional bank number.  If not specified,
  53.         defaults to previous dump or substitute,
  54.         or if first, bank 0.
  55.  
  56.     address - substitute address.
  57.  
  58.  
  59. M - inter-bank move
  60.  
  61.     M[b:]start,end,[b:]dest
  62.  
  63.     b: - optional source bank.  If not specified,
  64.         defaults to bank 0.
  65.  
  66.     start - source beginning address
  67.  
  68.     end - source ending address
  69.  
  70.     b: - optional destination bank.  If not specified,
  71.         defaults to bank 1.
  72.  
  73.     dest - destination beginning address
  74.  
  75.  
  76. X - back to SID
  77.  
  78.  
  79. To change the call address to access BANK, run BANKMOD.SUB with a
  80. parameter that is the new call address in hex.  For example, to
  81. change the call address to 28 hex, do the following:
  82.  
  83. A>bankmod.sub 28    <-- this is what you enter
  84.  
  85. A>SID BANK.RSX
  86.  
  87. Inter-Bank RSX Active
  88. CP/M 3 SID - Version 3.0
  89. NEXT MSZE  PC  END
  90. 0880 0880 0100 B9FF
  91. #SW21B
  92. 021B 0030 28
  93. 021D BAC3 .
  94. #WBANK.RSX
  95. 000Fh record(s) written.
  96. #G0
  97.  
  98. A>GENCOM SID BANK
  99.  
  100. ERROR: Duplicate RSX in header. Replacing old by new.
  101. FILE:     BANK.RSX
  102.  
  103. GENCOM completed.
  104.  
  105. A>
  106.  
  107. --------------------------
  108.