SDF-Metasyntax

In den folgenden Tabellen werden die metasprachlichen Konventionen für die SDF-Aufruf-Kommandos und -Anweisungen des C/C++-Compilers und des globalen Listengenerators dargestellt.

Tabelle 1: Metazeichen

In den Anweisungsformaten werden bestimmte Zeichen und Darstellungsformen verwendet, deren Bedeutung in der folgenden Tabelle erläutert wird.

Kennzeichnung

Bedeutung

Beispiele

GROSSBUCHSTABEN

Großbuchstaben bezeichnen Schlüs-
selwörter (Kommando-, Anweisungs-,
Operandennamen, Schlüsselwortwerte).

Schlüsselwortwerte beginnen mit *.

START-CPLUS-COMPILER

COMPILE

ELEMENT = *STD-ELEMENT

=

Das Gleichheitszeichen verbindet
einen Operandennamen mit den
dazugehörenden Operandenwerten.

LISTING = *NONE

< >

Spitze Klammern kennzeichnen Vari-
ablen, deren Wertevorrat durch Daten-
typen und ihre Zusätze beschrieben
wird (siehe folgende Tabellen).

VERSION = <text 1..24>

Unterstreichung

Die Unterstreichung kennzeichnet den
Standardwert eines Operanden, der
automatisch eingesetzt wird, wenn keine
Angabe gemacht wird.

SUMMARY = *YES / *NO

/

Der Schrägstrich trennt alternative
Operandenwerte.

TEST-SUPPORT = *YES / *NO

(...)

Runde Klammern kennzeichnen
Operandenwerte, die eine Struktur
einleiten.

LIBRARY = *LINK(...)

[ ]

Eckige Klammern kennzeichnen struk-
tureinleitende Operandenwerte, deren
Angabe optional ist. Die nachfolgende
Struktur kann ohne den einleitenden
Operandenwert angegeben werden.

SOURCE = [*YES](...)

Einrückung

Die Einrückung kennzeichnet die
Abhängigkeit zu dem jeweils überge-
ordneten Operanden.

LIBRARY = <filename> / *LINK(...)
	*LINK(...)
		|	LINK-NAME =

|

Der Strich kennzeichnet zusammen-
gehörende Operanden einer Struktur.

Sein Verlauf zeigt Anfang und Ende
einer Struktur an. Innerhalb einer Struktur
können weitere Strukturen auftreten.

Die Anzahl senkrechter Striche vor einem
Operanden entspricht der Strukturtiefe.

	*LIBRARY-ELEMENT(...)
		|	LIBRARY =
		|	,ELEMENT =
		|		|	VERSION =

,

Das Komma steht vor weiteren
Operanden der gleichen Strukturstufe.

,SOURCE = *NO

,SUMMARY = *NO

list-poss(n):
list-poss:

Aus den auf list-poss folgenden Ope-
randenwerten kann eine Liste gebildet
werden. (n) bedeutet, dass maximal n
Elemente in der Liste vorkommen können.

Enthält die Liste mehr als ein Element,
muss sie in runde Klammern einge-
schlossen werden.

Im Handbuch wird (n) nur angegeben,
wenn es sich um eine Compilerspezifi-
sche Maximalanzahl handelt.

list-poss ohne (n) bedeutet, dass für
die Maximalanzahl der SDF-Defaultwert
2000 gilt.

list-poss (127): *STD / BY-SOURCE /

<c-string>

list-poss: <filenname> / *LINK(...)

 

Tabelle 2: Datentypen

Variable Operandenwerte werden in SDF durch Datentypen dargestellt. Jeder Datentyp repräsentiert einen bestimmten Wertevorrat. Die Anzahl der Datentypen ist beschränkt auf die in Tabelle 2 beschriebenen Datentypen.

Die Beschreibung der Datentypen gilt für alle Anweisungen. Deshalb werden bei den entsprechenden Operandenbeschreibungen nur noch Abweichungen von Tabelle 2 erläutert.

Datentyp	Zeichenvorrat	Bedeutung
alphanum-name	A...Z 0...9 $, #, @
c-string	EBCDIC-Zeichen	In Hochkommata eingeschlossene Folge von EBCDIC-Zeichen. Der Buchstabe C kann vorangestellt werden. Hochkommata innerhalb des c-string müssen verdoppelt werden. Der Datentyp c-string ist mit dem Zusatz with-low versehen, d.h. es werden Groß- und Kleinbuchstaben unterschieden. Beispiele für gültige Darstellungen: 'abc' , C'_abc' , 'ABC' , 'printf("Makrotext\ n")'.
composed-name	A...Z 0...9 $,#,@ Bindestrich Punkt	Name oder Version eines PLAM-Bibliothekselements. composed-name ist mit dem Zusatz underscore (Unterstrich) versehen (vgl. Tabelle 3).
filename	A...Z 0...9 $,#,@ Bindestrich Punkt	Linkname oder vollqualifizierter Name einer katalogisierten Datei oder PLAM-Bibliothek. Die maximale Länge von Linknamen beträgt 8 Zeichen, von vollqualifizierten Namen einschließlich cat-id und user-id 54 Zeichen, ohne cat-id und user-id 41 Zeichen.
		Eingabeformat:
		linkname
		:cat:$user.{ datei / datei(nr) / gruppe / gruppe{ (*abs) / (+rel) / (-rel) } }
		linkname erstes und letztes Zeichen darf kein Bindestrich oder Punkt sein; max. 8 Zeichen; muss mindestens A...Z enthalten.
filename (Fortsetzung)		:cat: wahlfreie Angabe der Katalogkennung; Zeichenvorrat auf A...Z und 0...9 eingeschränkt; max. 4 Zeichen; ist in Doppelpunkte einzuschließen; Standardwert ist die Katalogkennung, die der Benutzerkennung laut Eintrag im Benutzerkatalog zugeordnet ist.
		$user. wahlfreie Angabe der Benutzerkennung; Zeichenvorrat ist A...Z, 0...9, $, #, @; max. 8 Zeichen; darf nicht mit einer Ziffer beginnen; $ und Punkt müssen angegeben werden; Standardwert ist die eigene Benutzerkennung.
		$. (Sonderfall) System-Standardkennung
		datei Datei- oder Jobvariablenname; letztes Zeichen darf kein Bindestrich oder Punkt sein; max. 41 Zeichen; muss mindestens ein Zeichen aus A...Z enthalten.
		#datei @datei (Sonderfall) # oder @ als erstes Zeichen kennzeichnet je nach Systemgenerierung temporäre Dateien und Jobvariablen.
		datei(nr) Banddateiname nr: Versionsnummer; Zeichenvorrat ist A...Z, 0...9, $, #, @. Klammern müssen angegeben werden.
filename (Fortsetzung)		gruppe Name einer Dateigenerationsgruppe (Zeichenvorrat siehe unter "datei")
		gruppe{ (*abs) / (+rel) / (-rel) }
		(*abs): absolute Generationsnummer (1-9999); * und Klammern müssen angegeben werden.
		(+rel) / (-rel): relative Generationsnummer (0-99); Vorzeichen und Klammern müssen angegeben werden.
integer	0...9,+,	+ bzw. - kann nur erstes Zeichen sein.
name	A...Z 0...9 $,#,@	In der Anweisung MODIFY-SOURCE- PROPERTIES C/C++-Name für DEFINE / UNDEFINE. Der Datentyp name ist mit dem Zusatz underscore (Unterstrich) versehen (vgl. Tabelle 3). Kleinbuchstaben können mit name nicht abgebildet werden. Hierfür muss der Datentyp c-string verwendet werden. Maximale Länge: 125 Zeichen
posix-filename	A...Z 0...9 Sonderzeichen	Zeichenfolge, die maximal 255 Zeichen lang ist. Besteht entweder aus einem oder zwei Punkten, oder aus alphanumerischen Zeichen und Sonderzeichen; Sonderzeichen sind mit dem Zeichen \ zu entwerten. Nicht erlaubt ist das Zeichen /. Zwischen Groß- und Kleinschreibung wird unterschieden.
posix-pathname	A...Z 0...9 Sonderzeichen Strukturkennzeichen: Schrägstrich	Eingabeformat: [/]part1[/.../partn] wobei part 1 ein posix-filename ist; maximal 1023 Zeichen; für Source-und Include- Dateien maximal 247 Zeichen; ist mit dem Zusatz mandatory-quotes versehen und muss deshalb generell in Hochkommata eingeschlossen werden.
x-string	Sedezimal: 00...FF	In Hochkomma eingeschlossene Folge von Sedezimalwerten. Der Buchstabe X muss vorangestellt werden.

Tabelle 3: Zusätze zu Datentypen

Zusätze zu Datentypen kennzeichnen weitere Eingabevorschriften für Datentypen. Die Zusätze schränken den Wertevorrat ein oder erweitern ihn. Im Handbuch werden folgende Zusätze in gekürzter Form dargestellt:

cat-id	cat
correction-state	corr
generation	gen
lower-case	low
manual-release	man
underscore	under
user-id	user
version	vers

Die Beschreibung der Zusätze zu den Datentypen gilt für alle Anweisungen. Deshalb werden bei den entsprechenden Operandenbeschreibungen nur noch Abweichungen von Tabelle 3 erläutert.

Zusatz	Bedeutung
x..y	beim Datentyp integer: Intervallangabe x: Mindestwert, der für integer erlaubt ist. x ist eine ganze Zahl, die mit einem Vorzeichen versehen werden darf. y: Maximalwert, der für integer erlaubt ist. y ist eine ganze Zahl, die mit einem Vorzeichen versehen werden darf. bei den übrigen Datentypen: Längenangabe x: Mindestlänge für den Operandenwert; x ist eine ganze Zahl ohne Vorzeichen. y: Maximallänge für den Operandenwert; y ist eine ganze Zahl ohne Vorzeichen.
with	Erweitert die Angabemöglichkeiten für einen Datentyp.
-low	Groß- und Kleinbuchstaben werden unterschieden.
-under	Der Unterstrich _ ist als zusätzliches Zeichen erlaubt.
without	Schränkt die Angabemöglichkeiten für einen Datentyp ein.
-cat	Die Angabe einer Katalogkennung ist nicht erlaubt.
-corr	Eingabeformat: [[C]' ][V][m]m.na[' ] Angaben zum Datentyp product-version dürfen den Korrekturstand nicht enthalten.
-gen	Die Angabe einer Dateigeneration oder Dateigenerationsgruppe ist nicht erlaubt.
-man	Eingabeformat: [[C]' ][V][m]m.n[' ] Angaben zum Datentyp product-version dürfen weder Freigabe- noch Korrekturstand enthalten.
-user	Die Angabe einer Benutzerkennung ist nicht erlaubt.
-vers	Die Angabe der Version (siehe datei(nr)) ist bei Banddateien nicht erlaubt.
mandatory	Bestimmte Angaben sind für einen Datentyp zwingend erforderlich
-quotes	Angaben zu den Datentypen posix-filename bzw. posix-pathname müssen in Hochkommata eingeschlossen werden.