The Zero Page (or Base Page) is a data structure used in CP/M systems for programs to communicate with the operating system. In 8-bit CP/M versions it is located in the first 256 bytes of memory, hence its name.
The equivalent structure in DOS is the Program Segment Prefix (PSP), a 256-byte structure, which, however, is by default located at offset 0 in the program's load segment (rather than in segment 0) immediately preceding a loaded program.
In 8-bit CP/M, it has the following structure:
| Offset | Size | Contents |
|---|---|---|
| 00–02 | Code | Exit program (jumps to the BIOS, and is also used to find BIOS entry points).[1] |
| 03 | Byte | I/O byte, an optional feature allowing device reassignment in CP/M 2. |
| 04 | Byte | Current command processor drive (low 4 bits) and user number (high 4 bits). |
| 05–07 | Code | Jump to CP/M BDOS entry - main system call entry point. This is also the address of the first byte of memory not usable by the program.[1] |
| 08–3A | Code | 8080 restart/interrupt vectors. |
| 3B–3F | Bytes | Reserved |
| 40–4F | Bytes | Reserved for use by the BIOS[2] |
| 50 | Byte | The drive from which the program was loaded (CP/M 3) |
| 51–52 | Word | Address of the password for the first FCB (CP/M 3) |
| 53 | Byte | Length of the password for the first FCB (CP/M 3) |
| 54–55 | Word | Address of the password for the second FCB (CP/M 3) |
| 56 | Byte | Length of the password for the second FCB (CP/M 3) |
| 57–5B | Bytes | Reserved |
| 5C–6B | Default FCB 1 | |
| 6C–7F | Default FCB 2 (overwritten if FCB 1 is opened) | |
| 80 | Byte | Number of characters in command tail. |
| 81–FF | Bytes | Command tail (everything after the program name). |
In CP/M-86, the structure is:
| Offset | Size | Contents |
|---|---|---|
| 00–02 | Bytes | Length of code group in bytes |
| 03–04 | Word | Segment address of code group |
| 05 | Byte | 8080 model flag - set if program only has one segment |
| 06–08 | Bytes | Length of data group in bytes |
| 09–0A | Word | Segment address of data group |
| 0B | Byte | Reserved |
| 0C–11 | Descriptor for extra group - same format as for data | |
| 12–17 | Descriptor for stack group | |
| 18–1D | Descriptor for X1 group | |
| 1E–23 | Descriptor for X2 group | |
| 24–29 | Descriptor for X3 group | |
| 2A–2F | Descriptor for X4 group | |
| 30–4F | Bytes | Reserved |
| 50 | Byte | The drive from which the program was loaded (CP/M 3) |
| 51–52 | Word | Address of the password for the first FCB (CP/M 3) |
| 53 | Byte | Length of the password for the first FCB (CP/M 3) |
| 54–55 | Word | Address of the password for the second FCB (CP/M 3) |
| 56 | Byte | Length of the password for the second FCB (CP/M 3) |
| 57–5B | Bytes | Reserved |
| 5C–6B | Default FCB 1 | |
| 6C–7F | Default FCB 2 (overwritten if FCB 1 is opened) | |
| 80 | Byte | Number of characters in command tail. |
| 81–FF | Bytes | Command tail (everything after the program name). |
See also
editReferences
edit- ^ a b Taylor, Roger; Lemmons, Phil (June 1982). "Upward migration - Part 1: Translators - Using translation programs to move CP/M-86 programs to CP/M and MS-DOS" [Using translation programs to move CP/M programs to CP/M-86 and MS-DOS] (PDF). BYTE. Vol. 7, no. 6. BYTE Publications Inc. pp. 321–322, 324, 326, 328, 330, 332, 334, 336, 338, 340, 342, 344 [342, 344]. ISSN 0360-5280. CODEN BYTEDJ. Archived (PDF) from the original on 2020-01-16. Retrieved 2020-01-15.
[…] Gaining Access to CP/M-86 […] Gaining access to CP/M-86 requires placing the function code in the CL register, placing the byte parameter in the DL register or placing the word parameter in the DX register, placing the data segment in the DS register (the data segment is usually not changed for a converted program), and executing a software interrupt, INT #224. The result is returned in the AL register if it is a byte value; if the result is a word value, it is returned in both the AX and BX registers. Double-word values are returned with the offset in the BX registers and the segment in the ES register. Conversion of programs from CP/M-80 to CP/M-86, then, requires replacing the call to location 5 with the software interrupt INT #224. Another necessary change involves the warm boot. Under CP/M-80, the warm boot may be accessed by a system call with a function code of 0 for a jump to location 0. CP/M-86, however, does not support the jump to location 0. As a result, you must change this program exit in the translated program if the program is to run correctly. Provided that the call to location 5 is replaced with INT #224, that the warm boot change is made, and that the registers are mapped correctly, there should be little problem in getting the translated program to access the CP/M-86 system functions. […] Gaining Access to MS-DOS […] Although MS-DOS has a "preferred" mechanism through a soft-ware interrupt, INT #33, for accessing the system, an additional mechanism is provided for "preexisting" programs that is compatible with CP/M-80 calling conventions, at least for functions in the range of 0-36. As far as system calls within the allowed function range are concerned, the programmer doesn't have to do anything to translated programs to get them to run under MS-DOS other than to correctly map the registers. MS-DOS also supports the warm boot function of CP/M-80. A jump to location 0 under MS-DOS executes a software interrupt, INT #32, which is functionally a program end and the normal way to exit from a program. […]
[1] [2][3][4][5][6][7][8][9][10][11][12][13][14] (13 pages) - ^ CP/M 2.0 Alteration Guide (PDF). Digital Research. 1979. p. 23.
Further reading
edit- "Tim Olmstead Memorial CP/M library". Archived from the original on 2017-08-20. Retrieved 2017-08-20. - in particular:
- "CP/M 3 Programmers' Manual" (PDF). Archived (PDF) from the original on 2017-08-20. Retrieved 2017-08-20.
- "CP/M-86 System Guide" (PDF). Archived (PDF) from the original on 2005-05-17. Retrieved 2017-08-20.