Alias-Name: SET-LISTING-PROPERTIES
Mit dieser Anweisung kann man auswählen, welche Listen der Listengenerator erzeugen soll. Außerdem kann man das Layout beinflussen und den Ausgabeort der Listen festlegen. Die Syntax der Anweisung ist bis auf Abweichungen in der OUTPUT-Option identisch mit der gleichnamigen Anweisung des Compilers.
MODIFY-LISTING-PROPERTIES | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
OPTIONS = *UNCHANGED / *YES / *NO
*YES: Der Listengenerator erzeugt eine Liste aller voreingestellten und vom Benutzer angegebenen Compiler-Optionen.
SOURCE = *UNCHANGED
Es gilt die Angabe der letzten MODIFY-LISTING-PROPERTIES-Anweisung.
SOURCE = *NO
Es wird keine Quellprogramm-/Fehlerliste erzeugt.
SOURCE = *YES(...)
Es wird eine Quellprogramm-/Fehlerliste erzeugt.
MINIMAL-MSG-WEIGHT = *NOTE / *WARNING / *ERROR / *FATAL
Mit diesem Operanden lässt sich bestimmen, ab welchem Gewicht die Fehlermeldungen in der Quellprogrammliste stehen sollen.
Achtung:
Bei der Generierung der CIF-Informationen wurden nur die Meldungen gespeichert, die auch ausgegeben wurden. Dies folgte der Compiler-Anweisung MODIFY-DIAGNOSTIC-PROPERTIES während der Übersetzung. Mit dieser Suboption kann die Menge der ausgegebenen Meldungen gegenüber den CIF-Informationen nur eingeschränkt werden, z. B. von WARNING auf ERROR.
Falls während der Übersetzung bei MODIFY-DIAGNOSTIC-PROPERTIES für MINIMAL-MSG-WEIGHT = *WARNING (Defaulteinstellung) angegeben wurde, kann mit MODIFY-LISTING-PROPERTIES nicht erreicht werden, dass Notes ausgegeben werden.
Beispiele siehe Compiler-Anweisung MODIFY-DIAGNOSTIC-PROPERTIES.
PREPROCESSING-RESULT = *UNCHANGED
Es gilt die Angabe der letzten MODIFY-LISTING-PROPERTIES-Anweisung.
PREPROCESSING-RESULT = *NO
Der Listengenerator erzeugt keine Präprozessorliste.
PREPROCESSING-RESULT = *YES
Der Compiler erzeugt eine Präprozessorliste.
DATA-ALLOCATION-MAP = *UNCHANGED
Es gilt die Angabe der letzten MODIFY-LISTING-PROPERTIES-Anweisung.
DATA-ALLOCATION-MAP = *NO
Der Listengenerator erzeugt keine Adressliste.
DATA-ALLOCATION-MAP = *YES(...)
Der Listengenerator erzeugt eine Adressliste.
STRUCTURE-LEVEL = *UNCHANGED
Es gilt die Angabe der letzten MODIFY-LISTING-PROPERTIES-Anweisung.
STRUCTURE-LEVEL = *NONE
Strukturelemente werden in der Adressliste nicht abgebildet.
STRUCTURE-LEVEL = *MAX
Es werden Strukturelemente bis zu maximalen Schachtelungstiefe (256) in der Adressliste abgebildet.
STRUCTURE-LEVEL = <integer 0..256>
Es werden Strukturelemente bis zu der mit <integer> angegebenen Schachtelungstiefe in der Adressliste abgebildet. Bei Angabe der Schachtelungstiefe 0 werden keine Strukturelemente ausgegeben (entspricht STRUCTURE-LEVEL=*NONE).
CROSS-REFERENCE = *UNCHANGED
Es gilt die Angabe der letzten MODIFY-LISTING-PROPERTIES-Anweisung.
CROSS-REFERENCE = *NO
Der Listengenerator erzeugt keine Querverweisliste.
CROSS-REFERENCE = *YES(...)
Der Listengenerator erzeugt eine globale, d.h. modulübergreifende Querverweisliste. Die Querverweisliste enthält in jedem Fall ein FILETABLE-Teil mit den Namen aller Dateien, Bibliotheken und Elemente, die der Compiler als Quellen verwendet.
PREPROCESSING-INFO = *UNCHANGED / *YES / *NO
Die Querverweisliste enthält wahlweise eine Liste der vom Präprozessor bearbeiteten Namen.
TYPES = *UNCHANGED / *YES / *NO
Die Querverweisliste enthält wahlweise eine Liste der benutzerdefinierten Typen (typedefs, Struktur-, Union-, Klassen- und Aufzählungstypen).
VARIABLES = *UNCHANGED / *YES / *NO
Die Querverweisliste enthält - mit *NO unterdrückbar - eine Liste der Variablen.
FUNCTIONS = *UNCHANGED / *YES / *NO
Die Querverweisliste enthält - mit *NO unterdrückbar - eine Liste der Funktionen.
LABELS = *UNCHANGED / *YES / *NO
Die Querverweisliste enthält - mit *NO unterdrückbar - eine Liste der Labels.
TEMPLATES = *UNCHANGED / *YES / *NO
Die Querverweisliste enthält wahlweise eine Liste der Templates.
ORDER = *UNCHANGED / *STD / list-poss(6): *PREPROCESSING-INFO / *TYPES /*VARIABLES / *FUNCTIONS / *LABELS / *TEMPLATES
Mit diesem Operanden kann die Reihenfolge festgelegt werden, in der die einzelnen Teile in der Querverweisliste aufgeführt werden.
*STD: Voreingestellt ist die oben nach list-poss angegebene Reihenfolge.
PROJECT-INFORMATION = *UNCHANGED / *YES / *NO
*YES: Der Listengenerator erzeugt eine globale, d.h. modulübergreifende Projektliste. Sie enthält eine Gegenüberstellung aller im Quellprogramm original verwendeten externen Namen und den Namen, die der Compiler für den Binder intern generiert.
ASSEMBLER-CODE = *UNCHANGED / *YES / *NO
*YES: Der Listengenerator erzeugt eine Objektcodeliste.
SUMMARY = *UNCHANGED / *YES / *NO
*YES: Der Listengenerator erzeugt eine Liste mit statistischen Angaben über den Compilerlauf.
LAYOUT =
Mit dieser Option kann die Seitenbreite (Anzahl Zeichen pro Zeile) und die Seitenhöhe (Anzahl Zeilen pro Seite) für die Compilerlisten bestimmt werden.
Bei Auswahl einer Zeilenbreite von 120 Zeichen erhalten alle Listen einen schmaleren Listenkopf und -fuß. Die Textzeilen werden nur bei den tabellarischen Listen (Optionen-, Querverweis- und Adressliste) entsprechend umbrochen. Überlange Textzeilen in der Quellprogramm-, Präprozessor- und Objectcode-Liste werden beim Ausdruck abgeschnitten.
Bei Angabe einer BS2000-Ausgabedatei ist in jeder Zeile die erste Spalte für die Vorschubsteuerung reserviert.
Bei Ausgabe in eine POSIX-Datei werden die für POSIX passenden Kontrollzeichen für Zeilen- bzw. Seitenvorschub generiert. Dadurch wird die Zeilenlänge in der POSIX-Ausgabedatei bis zu 3 Zeichen größer als die gewählte Angabe für die Zeilenbreite.
LAYOUT = *UNCHANGED
Es gilt die Angabe der letzten MODIFY-LISTING-PROPERTIES-Anweisung.
LAYOUT = *FOR-NORMAL-PRINT(...)
Listen im Querformat.
LINE-SIZE = *UNCHANGED
Es gilt die Angabe der letzten MODIFY-LISTING-PROPERTIES-Anweisung.
Dies gilt auch dann, wenn diese Angabe bei *FOR-ROTATION-PRINT gemacht wurde.
LINE-SIZE = *STD
Es werden 132 Zeichen pro Zeile ausgegeben.
LINE-SIZE = <integer 120..255>
Es werden 120 bis 255 Zeichen pro Zeile ausgegeben.
LINES-PER-PAGE = *UNCHANGED
Es gilt die Angabe der letzten MODIFY-LISTING-PROPERTIES-Anweisung.
Dies gilt auch dann, wenn diese Angabe bei *FOR-ROTATION-PRINT gemacht wurde.
LINES-PER-PAGE = *STD
Es werden 64 Zeilen pro Seite ausgegeben.
LINES-PER-PAGE = <integer 11..255>
Pro Seite werden 11 bis 255 Zeilen ausgegeben.
Als Untergrenze sind 11 Zeilen festgelegt, damit pro Seite mindestens der Listenkopf und -fuß sowie eine Textzeile ausgegeben werden kann.
LAYOUT = *FOR-ROTATION-PRINT(...)
Listen im Hochformat.
Um solche Listen auszudrucken, muss im PRINT-DOCUMENT-Kommando der ROTATION-Parameter angegeben werden.
LINE-SIZE = *UNCHANGED
Es gilt die Angabe der letzten MODIFY-LISTING-PROPERTIES-Anweisung.
Dies gilt auch dann, wenn diese Angabe bei *FOR-NORMAL-PRINT gemacht wurde.
LINE-SIZE = *STD
Es werden 120 Zeichen pro Zeile ausgegeben.
LINE-SIZE = <integer 120..255>
Es werden 120 bis 255 Zeichen pro Zeile ausgegeben.
LINES-PER-PAGE = *UNCHANGED
Es gilt die Angabe der letzten MODIFY-LISTING-PROPERTIES-Anweisung.
Dies gilt auch dann, wenn diese Angabe bei *FOR-NORMAL-PRINT gemacht wurde.
LINES-PER-PAGE = *STD
Es werden 84 Zeilen pro Seite ausgegeben.
LINES-PER-PAGE = <integer 11..255>
Pro Seite werden 11 bis 255 Zeilen ausgegeben.
Als Untergrenze sind 11 Zeilen festgelegt, damit pro Seite mindestens der Listenkopf und -fuß sowie eine Textzeile ausgegeben werden kann.
INCLUDE-INFORMATION = *UNCHANGED / *ALL / *NONE / *USER-INCLUDES-ONLY
Mit dieser Option lässt sich steuern, ob und welche Include-Dateien in der Quellprogramm-, Präprozessor- und Querverweisliste abgebildet werden. Standardmäßig werden die benutzereigenen Include-Dateien und nicht die Standard-Include-Dateien abgebildet. Bitte beachten Sie, dass Sie mit dieser Option die bei der Übersetzung erzeugte Information über Include-Dateien, die explizit oder implizit durch den gleichnamigen Operanden der MODIFY-CIF-PROPERTIES-Anweisung bestimmt ist, nur einschränken können.
LISTING-PRAGMAS =
Mit dieser Option lässt sich steuern, ob und welche im Quelltext vorhandenen #pragma-Anweisungen zur Gestaltung der Quellprogramm- und Präprozessorliste berücksichtigt werden sollen.
Die Beschreibung der #pragma-Anweisungen finden Sie im Abschnitt „Pragmas zum Steuern des Listenbildes“ .
LISTING-PRAGMAS = *UNCHANGED
Es gilt die Angabe der letzten MODIFY-LISTING-PROPERTIES-Anweisung.
LISTING-PRAGMAS = *INTERPRETED / *IGNORED
Es werden alle #pragma-Anweisungen berücksichtigt (*INTERPRETED) bzw. ignoriert (*IGNORED).
LISTING-PRAGMAS = *SELECT(...)
Eine oder mehrere der folgenden #pragma-Anweisungen zur Listensteuerung werden berücksichtigt (*YES) oder ignoriert (*NO).
PAGE = *UNCHANGED / *YES / *NO
Anweisung #pragma PAGE [text]:
Seitenvorschub und wahlweise Zeile im Listenkopf
TITLE = *UNCHANGED / *YES / *NO
Anweisung #pragma TITLE text:
Zeile im Listenkopf
SPACE = *UNCHANGED / *YES / *NO
Anweisung #pragma SPACE [n]:
Einfügen von Leerzeilen
LIST = *UNCHANGED / *YES / *NO
Anweisung #pragma LIST[ING] ON oder #pragma LIST[ING] OFF:
Unterdrücken der Ausgabe von Quelltextzeilen
INITIAL-TITLE-TEXT = *UNCHANGED / *NONE / <c-string 1..256>
Mit dieser Option kann angegeben werden, ob im Listenkopf eine zusätzliche Zeile erscheinen und welcher Text dort stehen soll. Die INITIAL-TITLE-TEXT-Option bezieht sich, im Unterschied zu den Pragmas (nur Quellprogramm- und Präprozessorliste), auf alle Compilerlisten. Wenn der Text länger als die mit der LINE-SIZE-Option (siehe Compiler-Anweisung "MODIFY-LISTING-PROPERTIES" ) definierte Zeilenlänge ist, wird er in mehrere Zeilen entsprechender Länge aufgeteilt.
Bei der Quellprogramm- und Präprozessorliste haben ggf. vorhandene TITLE- und PAGE-Pragmas Vorrang vor der INITIAL-TITLE-TEXT-Angabe.
OUTPUT = *UNCHANGED
Es gilt die Angabe der letzten MODIFY-LISTING-PROPERTIES-Anweisung.
OUTPUT = *SYSLST
Die Listen werden standardmäßig in die temporäre Systemdatei SYSLST geschrieben, von wo aus sie nach Ende der Task (LOGOFF) auf den Drucker ausgegeben werden.
OUTPUT = *SYSOUT
Die Listen werden auf die Systemdatei SYSOUT geschrieben, die im Dialogbetrieb der Datensichtstation zugeordnet ist.
OUTPUT = <filename 1..54>
Die Listen werden in eine katalogisierte BS2000-Datei mit dem angegebenen Namen geschrieben.
OUTPUT = <posix-pathname>
Die Listen werden in eine POSIX-Datei geschrieben.
Als <posix-pathname> ist nur ein Dateiname zugelassen. Zur Beschreibung des Begriffs <posix-pathname> siehe "Compiler-Ein-/Ausgaben im POSIX-Dateisystem".
OUTPUT = *LIBRARY-ELEMENT(...)
Es wird angegeben, in welcher PLAM-Bibliothek (LIBRARY=) und unter welchem Elementnamen (ELEMENT=) die Listen abgelegt werden sollen. Das Element wird unter dem Typ P abgespeichert.
LIBRARY = *STD-LIBRARY
Die Listen werden standardmäßig in die Bibliothek SYS.PROG.LIB geschrieben.
LIBRARY = <filename 1..54>
Die Listen werden in die PLAM-Bibliothek mit dem angegebenen Namen geschrieben.
LIBRARY = *LINK(...)
LINK-NAME = <filename 1..8>
Statt des Bibliotheksnamens kann auch ein Linkname angegeben werden.<filename> ist der Linkname der zugewiesenen Bibliothek. Er muss vor Aufruf des Listengenerators mit dem ADD-FILE-LINK-Kommando der PLAM-Bibliothek zugewiesen worden sein.
ELEMENT = <composed-name 1..64 with-under>(...)
Die Listen werden in ein Bibliothekselement (Typ P) mit dem angegebenen Namen geschrieben.
VERSION = *UPPER-LIMIT
Enthält die Elementangabe keine Versionsbezeichnung, verwendet der Listengenerator die höchstmögliche Version.
VERSION = *INCREMENT
Das Element erhält die gegenüber der höchsten vorhandenen Version um 1 inkrementierte Versionsnummer, vorausgesetzt, die höchste vorhandene Versionsbezeichnung endet mit einer inkrementierbaren Zahl. Ist die Versionsbezeichnung nicht inkrementierbar, wird die Listenerzeugung mit Fehler abgebrochen.
Beispiel siehe COMPILE-Anweisung ("COMPILE").
VERSION = <composed-name 1..24 with-under>
Das Element erhält die angegebene Versionsbezeichnung.