CP/M 3.0 GENCOM.COM

GENCOM

Art: transienter Befehl

Mit dem GENCOM-Befehl kann man folgende Funktionen ausführen:

RSX-Module an eine COM-Datei anfügen
Eine "leere" COM-Datei erzeugen (Dummy-Datei), die nur RSX-Module enthält
Header-Einträge an eine COM-Datei anfügen, die keine RSX-Module besitzt
Zusätzliche RSX-Module zu einer bereits mit GENCOM bearbeiteten COM-Datei hinzufügen oder austauschen
RSX-Module und Header-Einträge aus einer mit GENCOM bearbeiteten COM-Datei entfernen

Was ist ein RSX-Modul ?

RSX-Module erweitern oder verändern die Funktionsweise der CP/M-Systemroutinen. Wenn von einem Programm eine BDOS-Routine aufgerufen wird und RSX-Module sich im RAM-Speicher befinden, dann wird der Funktionsaufruf zunächst an die RSX-Module weitergeleitet. Jedes RSX-Modul prüft für sich, ob die Nummer der aufgerufenen BDOS-Routine identisch ist mit der Nummer, die für das jeweilige RSX-Modul vorgesehen ist. Sind die Nummern nicht identisch, wird der Funktionsaufruf an das nächste RSX-Modul weitergegeben. Ist kein weiteres RSX-Modul mehr vorhanden, gelangt der Funktionsaufruf direkt zu der gewünschten BDOS-Funktion. Stimmt die Nummer eines RSX-Moduls mit der Nummer des Funktionsaufrufs jedoch überein, dann wird diese Funktion zunächt einmal nur von dem betreffenden RSX-Modul ausgeführt. Danach kann dann der Funktionsaufruf zur weiteren Behandlung dann noch an die ursprüngliche BDOS-Funktion weitergeleitet werden.

Das LOADER-Modul ist immer dann resident im Speicher vorhanden, wenn RSX-Module aktiv sind. RSX-Module gelangen in den RAM-Speicher, wenn ein Programm (.COM-Datei) geladen wird, das RSX-Module beinhaltet.

Optionen des GENCOM-Befehls

Option	Beschreibung
LOADER	Ein Flag wird gesetzt, um den Programm-Loader zu aktivieren
NULL	Zeigt an, daß nur RSX-Dateien angegeben worden sind. GENCOM generiert ein leere COM-Datei für die RSX-Module ("Dummy-Datei"). Der Name der zu erstellenden COM-Datei wird vom Datei-Namen des ersten, angegebenen RSX-Moduls übernommen.
*SCB=(offset, value)*	Der System-Control-Block wird von dem Programm gesetzt unter Verwendung der Hex-Codes die bei "offset" und "value" angegeben worden sind.

Format-Schablone

GENCOM COM-Datei RSX-Datei .... RSX-Datei {[LOADER | SCB=(offset, value)]}
GENCOM RSX-Datei .... RSX-Datei {[NULL | SCB=(offset, value)}
GENCOM COM-Datei
GENCOM COM-Datei [SCB=(offset,value)]

Beispiele

GENCOM PROGRAMM MODUL01 MODUL02

Es werden die RSX-Module MODUL01.RSX und MODUL02.RSX an die Datei PROGRAMM.COM angehängt.

GENCOM RES1 RES2 [NULL]

Es wird eine neue, leere COM-Datei mit dem Namen RES1.COM erstellt, an welche die beiden RSX-Module RES1.RSX und RES2.RSX angefügt werden.

GENCOM MEINPRG

GENCOM läd die Datei MEINPRG.COM und entfernt alle RSX-Module sowie den Header aus dieser Datei.