CP/M PLUS SCB

CP/M 3 System Control Block

Übersicht

SCB Zugriff

SCB Aufbau

Original:	Jim Lopushinsky	24.Juni 1986
Zusatz:	Werner Cirsovius	23.Juni 1993
Mehr Hinweise:	Simeon Cran (ZPM3)
	John Elliott	3.November 1995

Hier folgt die komplette Beschreibung der Felder im CP/M 3.1 System Control Block, soweit ich es ermitteln kann. Die undokumentierten Felder wurden gefunden beim Disassemblieren des CCP, des residenten BDOS und der BDOS-Bank. Digital Research dokumentiert den SCB als 100 (dezimal) Bytes, aber ist er 152, oder in hexadezimal 98, Bytes lang. Der SCB belegt die letzen 152 Bytes des residenten BDOS (direkt vor dem BIOS). Es beginnt bei xx68h, wobei xx die letzte Page im BDOS darstellt; deshalb liegt der Offset 62h-63h (Höchste Adresse der TPA) auf xxFEh, direkt vor dem 'JMP BOOT' BIOS Beginn. Die Adresse des SCB kann auch wie folgt ermittelt werden:

	LXI	D,SCBPB
	MVI	C,49
	CALL	BDOS	;Page Adresse des SCB im Reg H
	..
	..
SCBPB:	DB	3AH	;Dies ist der Offset fuer die SCB-Adresse
	DB	0	;Lade-Operation

Um auf ein Feld im SCB zuzugreifen, wird die obige Routine benutzt. Dann wird das Register L mit dem Feld-Zeiger aus untenstehender Tabelle geladen. Register HL beinhaltet dann die Adresse des Feldes.
Natürlich ust auch ein Zugriff auf die SCB-Felder mit der BDOS Funktion 49 möglich, wie oben gezeigt. Der Control Block hat folgenden allgemeinen Aufbau:

SCBPB:	DB	Offset
	DB	Modus
{	DB	Lo	}
{	DB	Hi	}

Wenn der Modus 00H ist, hält das Register HL den 16 Bit-Wert des gewählten Feldes und der Akkumulator hält den Byte-Wert, welcher dem Inhalt des Registers L entspricht.
Wenn der Modus FFH ist, dann wird in das gewählte Feld der Byte-Wert Lo gespeichert.
Wenn der Modus FEH ist, dann werden in das gewählte Feld die Byte-Werte Lo und Hi gespeichert.

Um RSXen anzupassen, die die BIOS Sprungvektoren für die Zeichenausgabe verändern (GET und PUT RSX), steht eine zweite Gruppe Sprungvektoren für WBOOT, CONST, CONIN, CONOUT und LIST in der SCB zur Verfügung. Nur die Bankversionen des BDOS nutzen diese Vektoren. Jeder Eintrag besteht aus zwei drei Byte langen Einträgen mit normalerweise JMP Instruktionen. Eine RSX kann den ersten JMP ändern in LXI H,addr, wobei addr die umgeleitete Adresse der jeweiligen Routine in Bank 1 ist. Die zweite JMP Instruktion zeigt immer auf eine Routine zum Umschalten der Bänke im residenten BDOS-Teil, welche auf Bank 1 umschaltet, die Routine, die im Register HL geladen ist, ausführt, bei Beendigung zurück auf Bank 0 schaltet und zum Bank-BDOS zurückkehrt. Das Bank-BDOS ruft diese 5 BIOS Routinen immer über die SCB Sprungtabelle auf. Diese Einrichtung kann bei BYE RSXen genutzt werden zum sicheren Umleiten von Konsol-Ein/Ausgabe in RCP/M Systemen.

[Erweiterungsbereich]
[CLP Abschnitt]
[Geräte I/O Abschnitt]

[BIOS Abfangvektoren]

FELD-ZEIGER

OFFSET

TYP

Beschreibung

BIOS Warmstart

68H

Inst.

Sprungvektor zum Warmstart für das Bank-BDOS. Im Normalfall ein Sprung zum BIOS WBOOT Vektor, der aber geändert werden kann in LXI H,wboot-addr zur Umleitung des Warmstarts in Bank 1.

6BH

Inst.

JMP Instruktion zur residenten BDOS Bankumschaltungsroutine zum Umleiten von WBOOT.

BIOS Konsolstatus

6EH

Inst.

Sprungvektor zum Konsolstatus für das Bank-BDOS. Im Normalfall ein Sprung zum BIOS CONST Vektor, der aber geändert werden kann in LXI H,const-addr zur Umleitung des Konsolstatus in Bank 1.

71H

Inst.

JMP Instruktion zur residenten BDOS Bankumschaltungsroutine zum Umleiten von CONST.

BIOS Konsoleingabe

74H

Inst.

Sprungvektor zur Konsoleingabe für das Bank-BDOS. Im Normalfall ein Sprung zum BIOS CONIN Vektor, der aber geändert werden kann in LXI H,conin-addr zur Umleitung der Konsoleingabe in Bank 1.

77H

Inst.

JMP Instruktion zur residenten BDOS Bankumschaltungsroutine zum Umleiten von CONIN.

BIOS Konsolausgabe

7AH

Inst.

Sprungvektor zur Konsolausgabe für das Bank-BDOS. Im Normalfall ein Sprung zum BIOS CONOUT Vektor, der aber geändert werden kann in LXI H,conout-addr zur Umleitung der Konsolausgabe in Bank 1.

7DH

Inst.

JMP Instruktion zur residenten BDOS Bankumschaltungsroutine zum Umleiten von CONOUT.

BIOS Druckerausgabe

80H

Inst.

Sprungvektor zur Druckerausgabe für das Bank-BDOS. Im Normalfall ein Sprung zum BIOS LIST Vektor, der aber geändert werden kann in LXI H,list-addr zur Umleitung der Druckerausgabe in Bank 1.

83H

Inst.

JMP Instruktion zur residenten BDOS Bankumschaltungsroutine zum Umleiten von LIST.

86H-8FH

Unbekannt.

90H

Wort

Bitdarstellung des Laufwerkvektors mit offenen Dateien.

92H

Wort

Bitdarstellung des Vektors auf zugegriffene Laufwerke.

94H-97H

Unbekannt.

98H

Wort

Startadresse des BDOS.

9AH

Wort

Reserviert für den Gebrauch des nicht Bank-BDOS

[System Control Block]

[Erweiterungsbereich - 6 Bytes]

FELD-ZEIGER

OFFSET

TYP

Beschreibung

9CH

00H

Byte

Hash-Länge 0, 2, oder 3

9DH-A0H

01H

2 Worte

Hash-Eintrag

A1H

05H

Byte

CP/M Version. Enthält 31H.

[Betriebsabschnitt - 8 Bytes]

FELD-ZEIGER

OFFSET

TYP

Beschreibung

A2H-A5H

06H

4 Bytes zur freien Benutzung.

A6H-A9H

0AH

Unbekannt.

[CLP Abschnitt - 4 Bytes]

FELD-ZEIGER

OFFSET

TYP

Beschreibung

AAH

0EH

Unbekannt.

ABH

0FH

Byte

Laufwerk für Submit.

ACH

10H

Wort

Programm Return-Kode.

[CCP Abschnitt - 8 Bytes]

FELD-ZEIGER

OFFSET

TYP

Beschreibung

AEH

12H

Byte

Basis-Page der RSX, die das zweite von mehreren Kommandos enthält (wird als nächstes ausgeführt).

AFH

13H

Byte

Laufwerk des CCP.

B0H

14H

Byte

Nutzernummer des CCP.

B1H

15H

Wort

Wenn nicht 0, Adresse des zweiten von mehreren Kommandos.

B3H

17H

Byte

Darstellung von CCP Bits:

0	Merker für Submit
1	Merker für RSX
2-5	Unbekannt
6	CCP Laufwerk/Nutzer auf aktuelles Laufwerk/Nutzer setzen.
7	Merker für Verkettung. Das nächste Kommando wird aus dem Default-DMA-Puffer (80H) geholt.

B4H

18H

Byte

Darstellung von CCP Bits:

0-1

Anzeige Laufwerk/Nutzer.

Unbekannt

3-4

Reihenfolge zum Suchen von Dateien:

00	Nur .COM
01	Erst .COM, dann .SUB
10	Erst .SUB, dann .COM
11	Erst .PRL, dann .COM

Alle Laufwerke rücksetzen

Merker für die GET RSX. Gesetzt, wenn die GET RSX umleitet.

Der CCP wird ausgeführt (genutzt beim ^W Aufruf)

B5H

19H

Byte

Darstellung von CCP Bits:

0	Unbekannt
1	Merker für Kaltstart (0=Kalt)
2-7	Unbekannt

[Geräte I/O Abschnitt - 32 Bytes]

FELD-ZEIGER

OFFSET

TYP

Beschreibung

B6H

1AH

Byte

Konsolbreite [z.B. 79 für Konsole mit 80 Zeichen]

B7H

1BH

Byte

Aktuelle Position der Konsolspalte

B8H

1CH

Byte

Konsolseitenlänge [z.B. 23 für Konsole mit 24 Zeilen]

B9H

1DH

Unbekannt

BAH

1EH

Wort

Wenn nicht Null, dann Adresse der umgeleiteten Konsoleingabe.

BCH

20H

Wort

Wenn nicht Null, dann Adresse der nächsten Zeile der umgeleiteten Konsoleingabe.

BEH

22H

Wort

Bitdarstellung der physikalischen Geräte für die Konsoleingabe.

C0H

24H

Wort

Bitdarstellung der physikalischen Geräte für die Konsolausgabe.

C2H

26H

Wort

Bitdarstellung der physikalischen Geräte für die AUX-Eingabe.

C4H

28H

Wort

Bitdarstellung der physikalischen Geräte für die AUX-Ausgabe.

C6H

2AH

Wort

Bitdarstellung der physikalischen Geräte für die Druckausgabe.

C8H

2CH

Byte

Seitenausgabe der Konsole (0 = Pause nach Seitenausgabe).

C9H

2DH

Byte

Voreinstellung der Seitenausgabe.

CAH

2EH

Byte

Ctrl-H Einstellung (Backspace, Cursor ein Zeichen zurück). [0 => Backspace, sonst Ausgabe des gelöschten Zeichens]

CBH

2FH

Byte

Korrektur-/Löschzeichen Einstellung (Rubout/Delete) [0 => Ausgabe des gelöschten Zeichens, sonst Backspace]

CCH

30H

Byte

Ist das Byte 0FFh, dann testet BDOS nicht die Eingabe von Control-S beim Konsolen-Status-Aufruf.

CDH

31H

Wort

Nutzung durch Konsolen-Routinen. Nutzung Unbekannt.

CFH

33H

Wort

Konsolen-Einstellung.

D1H

35H

Wort

Adresse eines 128 Byte Puffers im Common Memory. Dieser Puffer wird nur während BDOS-Aufrufen durch das System benutzt, so dass er beliebig zwischen BDOS-Aufrufen als Arbeitsspeicher genutzt werden kann. Das BIOS nutzt diesen Puffer ebenfalls während eines Warm-Starts.

D3H

37H

Byte

Endezeichen für Zeichenkettenausgabe. [normalerweise '$']

D4H

38H

Byte

Merker für List Echo (ungleich Null = Echo der Konsolausgabe).

D5H

39H

Byte

Merker für das Scrollen (benutzt von den Konsol-Routinen), Darstellung der Bits:

7	Gesetzt, wenn der nächste Aufruf von CONST Control-C prüft.
6	Gesetzt, wenn der nächste Aufruf von CONST oder CONIN Control-S oder Control-Q prüft.

[BDOS Abschnitt - 42 Bytes]

FELD-ZEIGER

OFFSET

TYP

Beschreibung

D6H

3AH

Wort

Adresse des System Control Blocks.

D8H

3CH

Wort

Aktuelle DMA Adresse.

DAH

3EH

Byte

Aktuelles Laufwerk.

DBH

3FH

Wort

Aktuelle FCB Adresse (im Common Memory).

DDH

41H

Byte

Merker für FCB Fehler. Wenn dieses Byte FFH ist, dann ist das Wort in 3FH eine gültige FCB Adresse.

DEH

42H

Byte

Merker für gleiches Laufwerk.

DFH

43H

Byte

Aktuelle BDOS Funktionsnummer.

E0H

44H

Byte

Aktuelle Nutzernummer.

E1H

45H

Wort

Letzter Sucheintrag für Dateisuche (Erster = 0)

E3H

47H

Wort

Adresse des FCB für Funktion 18 (Suche nächsten Eintrag).

E5H

49H

Byte

Art der Suche für Funktionen 17, 18 (0 = ? in Laufwerksangabe, 0FH = normale Suche).

E6H

4AH

Byte

Anzahl Multisektoren.

E7H

4BH

Byte

BDOS Fehlereinstellung.

E8H

4CH

4 Bytes

Kette der zu durchsuchenden Laufwerke 1..4. [0=Aktuell, 1-16 = Laufwerk A-P, 255=Ende der Kette]

ECH

50H

Byte

Temporäres Laufwerk. [0=Aktuell, 1-16 = Laufwerk A-P]

EDH

51H

Byte

Laufwerk für Fehler.

EEH-EFH

52H

Unbekannt.

F0H

54H

Byte

Merker für geöffnetes Laufwerk.

F1-F2H

55H

Unbekannt.

F3H

57H

Byte

Bitdarstellung für BDOS:

0-5	Unbekannt.
6	Einzelne Belegungsvektoren.
7	Erweiterte Fehlermeldungen.

F4H

58H

Wort

Datum (in Tagen seit dem 1.Januar 1978).

F6H

5AH

Byte

Stunden (BCD).

F7H

5BH

Byte

Minuten (BCD).

F8H

5CH

Byte

Sekunden (BCD).

F9H

5DH

Wort

Basisadresse des Common Memory (keine Bankversion = 0).

FBH

5FH

Inst.

JMP Instruktion zu einer Routine zur Fehlerausgabe im Bank-BDOS.

FDH

61H

Byte

BDOS Seite in Bank 0.

FEH

62H

Wort

Aktuelle höchste TPA-Adresse (zeigt auf den Einsprung der untersten RSX).

Letzte Änderung: 17.Mai 2004