Monitor Main Panel Editor and Program Disassembly

ZX Land #06

PROMETHEUS

Monitor user manual (continued)

Main panel editor

SS+W — call up the main panel editor

Control keys:

CS+1 (Edit) — return to the monitor
4 — move to the next panel item
3 — move to the previous panel item
5 — move the given panel item left
6 — move the given panel item down
7 — move the given panel item up
8 — move the given panel item right
A..Z — set the amount of data in the given item
SS+D — enable or disable display of the given item in decimal mode
SS+H — the same for hexadecimal mode
SS+B — the same for binary mode
SS+C — the same for character mode
SS+T — enable or disable display of data from the addresses contained in the SP, BC, DE, HL, IX and IY registers, in single-byte or double-byte form
SS+S — change the display format of an item from column to line, and vice versa

To conclude the article, a few words about the SS+D function, i.e. disassembling a compiled program into source text. When we call this function, we get source text in a form that cannot be assembled. You might ask: what use is this function if we can’t do anything with the program afterwards? Well, we can do something with it—we just need to know how. Here’s a brief example.

Using the SS+D function, we disassembled the following section of memory:

50000  xor   a
50001  ld    b,a
50002  inc   a
50003  and   7
50005  out   (254),a
50007  djnz  50002
50009  ret

After returning to the assembler, we find that an error occurs when we try to compile the resulting source text: it is at the djnz 50002 instruction. This is not surprising, since instructions such as djnz and jr require an argument in the range from -128 to +127. So we need to return to the monitor, start the memory editing option by pressing Space, and enter the line:

loop   equ  50002

As a result, the name “loop” will be displayed instead of the number 50002.

After returning to the assembler, our unfortunate program can now be compiled without any problems.

This is how you should proceed with all jump instructions in the section of the program you want to disassemble.

...and that’s the end. All that remains is for me to wish you pleasant work with Prometheus.

Jordan of Exodus

Share your thoughts about the article