MAC-Befehl
Format:
Zweck:
Der CP/M 3.0 Macro-Assembler MAC liest Anweisungen in Assemblersprache aus einer Eingabedatei vom Typ ASM, assembliert diese Anweisungen und erstellt drei Ausgabedateien mit dem Eingabedateinamen und den Typenbezeichnungen HEX, PRN und SYM.
FILENAME.HEX enthält den Objektcode im INTEL-Hexadezimal-Format.
FILENAME.PRN enthält das kommentierte Quell-Listing, das entweder ausgedruckt oder auf der Konsole angezeigt werden kann.
FILENAME.SYM enthält die sortierte Tabelle der im Programm definierten Symbole.
Optionen:
Mit den optionellen Angaben können die Eingabe- und Ausgabelaufwerke oder -einheiten bestimmt werden. Die möglichen Optionen sind in den folgenden Tabellen aufgeführt.
| Option | Bedeutung |
|---|---|
| A | Quell-Laufwerk für die ASM-Datei (A – E). |
| H | Ziel-Laufwerk für die HEX-Datei (A – E). |
| L | Quell-Laufwerk für die LIB-Dateien, die mit dem MACLIB Statement aufgerufen werden (A – E). |
| P | Zieleinheit für die PRN-Datei (A – E, X, P, Z). |
| S | Zieleinheit für die SYM-Datei (A – O, X, P, Z). |
A – E sind die möglichen Laufwerke (sofern vorhanden),
X leitet die entsprechende Ausgabe auf die Konsole,
P auf den Drucker und Z unterdrückt die Ausgabe.
| Modifikation | Bedeutung |
|---|---|
| +L | Input-Zeilen, die von Makrobibliotheksdateien LIB gelesen werden, auflisten. |
| -L | Auflistung der Input-Zeilen, die von Makrobibliotheksdateien LIB gelesen werden, unterbinden (Voreinstellung). |
| +M | Alle Makrozeilen, die beim Assemblieren erzeugt werden, auflisten. |
| -M | Die Auflistung der Makrozeilen, die beim Assemblieren erzeugt werden, unterbinden. |
| *M | Makroerweiterungen nur im HEX-Format auflisten. |
| +Q | Alle LOCAL-Symbole in der Symboltabelle auflisten. |
| -Q | Die Auflistung aller LOCAL-Symbole in der Symboltabelle unterbinden. |
| +S | Symboldatei an die PRN-Datei anhängen. |
| -S | Die Erzeugung der Symboldatei unterbinden. |
| +1 | Erzeugung eines Pass-1-Listings für „macro debugging“ in der PRN-Datei. |
| -1 | Pass-1-Listing unterdrücken (Voreinstellung). |
Beispiele:
Der Makroassembler MAC wird vom Laufwerk A aufgerufen und bearbeitet eine Datei SAMPLE.ASM, die auch auf der Diskette im Laufwerk A sein muss. Die Ausgabedateien SAMPLE.OBJ, SAMPLE.PRN und SAMPLE.SYM werden auch im Laufwerk A abgelegt.
In diesem Beispiel folgt dem MAC-Aufruf und dem Quelldateinamen eine optionelle Parameterliste. Die PRN-Datei wird auf das Laufwerk B geleitet, die ASM-Datei vom Laufwerk A gelesen, die HEX-Datei wird auf Laufwerk B abgelegt und die Symboltabelle wird auf der Konsole gelistet. Als Trennzeichen zwischen einzelnen Parametern werden Leerstellen benutzt.