ING_DB
This commit is contained in:
Oliver Lehmann
parent
48edad2e85
commit
f24cd0c773
|
|
@ -0,0 +1,797 @@
|
|||
AMX(DABA) DABA16 AMX(DABA)
|
||||
|
||||
NAME
|
||||
amx - Einbettung der Datenmanipulationssprache AMX in "C"
|
||||
|
||||
BESCHREIBUNG
|
||||
|
||||
Einleitung
|
||||
|
||||
Die Sprache AMX stellt ein Interface zur Einbettung von Da-
|
||||
tenbankzugriffen in "C"-Programme dar und ist leicht erlern-
|
||||
bar.
|
||||
|
||||
Es werden eine Laufzeitbibliothek, i.allg. .../lib/libamx.a,
|
||||
und DABA-MUTOS-Kommandos (i.allg. amx(mutos)) bereitge-
|
||||
stellt. Durch ein solches Kommando (z.B. amx) werden bei
|
||||
entsprechend spezifizierten Optionen (Flags) ein DABA-
|
||||
Praecompiler fuer AMX und der C-Compiler "cc" (einschliess-
|
||||
lich Linker) aufgerufen. Der Praecompiler erzeugt ein guel-
|
||||
tiges C-Programm, das mit dem C-Compiler uebersetzt wird.
|
||||
Anschliessend werden die fuer die Datenbankaktionen notwen-
|
||||
digen Objektmoduln aus der Laufzeitbibliothek eingebunden.
|
||||
|
||||
|
||||
|
||||
In AMX-Programmen ist das parallele Arbeiten mehrerer Nutzer
|
||||
in den gleichen Relationen unterstuetzt.
|
||||
|
||||
Die Vorteile bei der Benutzung dieser AMX-Sprache bestehen
|
||||
in der Moeglichkeit der Realisierung laufzeiteffektiver Pro-
|
||||
gramme, in der Formulierbarkeit von Transaktionen und in ei-
|
||||
ner rekursiven Anwendbarkeit. Letzteres bedeutet, dass z.B.
|
||||
Wiederfinden und Aendern geschachtelt benutzbar sind. Aus-
|
||||
serdem sind prozedurale Probleme, z.B. die totale
|
||||
Mengenbedarfsermittlung (totale Stuecklistenaufloesung),
|
||||
elegant loesbar.
|
||||
|
||||
Alle (auch temporaere) Relationen (einschliesslich aller da-
|
||||
tenbankspezifischen Namen), die in AMX-Programmen verarbei-
|
||||
tet werden sollen, muessen zur Uebersetzungszeit bereits
|
||||
existieren. Das bedeutet, dass sie vorher mit IQL, EQL oder
|
||||
"creater" (creater(mutos)) erstellt werden muessen.
|
||||
|
||||
Mit AMX-Programmen manipulierte Relationen sind mit IQL, EQL
|
||||
oder auch AMX weiterhin bearbeitbar.
|
||||
|
||||
Uebersicht
|
||||
|
||||
Alle tupelorientierten AMX-Anweisungen sind ausschliesslich
|
||||
auf eine einzige Relation anwendbar.
|
||||
|
||||
Die Sprache AMX hat als maechtigste Operation das Bereit-
|
||||
stellen von Werten spezifizierter Domaenen aus einer u.U.
|
||||
selektierten Tupelmenge einer Relation (Wiederfinden) (re-
|
||||
trieve).
|
||||
|
||||
Die Recherche (Wiederfinden) kann alle Daten der Relation
|
||||
umfassen oder durch Selektionsbedingungen (Qualifiktionen)
|
||||
eingeschraenkt werden.
|
||||
|
||||
In einer retrieve-Anweisung kann eine Qualifikation und muss
|
||||
eine Auswahl spezifizierter oder aller Domaenen als
|
||||
target_list (Ergebnis- oder Zielliste) angegeben werden.
|
||||
Eine solche Ergebnisliste besitzen ausser der retrieve nur
|
||||
die append und die replace Anweisung.
|
||||
|
||||
Nach einer erfolgreichen Recherche, die eine Tupelmenge
|
||||
(mindestens ein Tupel) bereitstellt, wird fuer jedes dieser
|
||||
Tupel eine Aktion ausgefuehrt.
|
||||
|
||||
Die anderen tupelorientierten AMX-Anweisungen beziehen sich
|
||||
immer nur auf ein Tupel.
|
||||
|
||||
|
||||
|
||||
Es sind das Ersetzen der Werte der Domaenen eines Tupels
|
||||
(Ersetzen) (replace), das Loeschen eines Tupels (Loeschen)
|
||||
(delete), das Anzeigen eines Tupels (print) bzw. das Erzeu-
|
||||
gen eines neuen Tupels (Zufuegen zu einer Relation) (ap-
|
||||
pend), aus der Menge vorher mit "retrieve" selektierter Tu-
|
||||
pel, moeglich.
|
||||
|
||||
Des weiteren ist das Zufuegen eines neuen Tupels zur Rela-
|
||||
tion ohne vorherige Selektion nutzbar (append).
|
||||
|
||||
Es gibt weiterhin AMX-Anweisungen fuer das Eroeffnen einer
|
||||
spezifizierten Datenbank entweder mit exklusiver (alleini-
|
||||
ger) Benutzung (daba oder exclusive), ohne Sperrung oder mit
|
||||
geteilter Benutzung (shared) sowie fuer das Eroeffnen (open)
|
||||
bzw. das Schliessen (close) einer Relation.
|
||||
|
||||
Sollen in einem AMX-Programm miteinander in logischer Bezie-
|
||||
hung stehende Datenmanipulationen (i.allg. in mehreren Rela-
|
||||
tionen) ausgefuehrt werden, ist es zur Erhaltung der Date-
|
||||
nintegritaet erforderlich, Transaktionen zu formulieren.
|
||||
Eine Transaktion ist eine Folge von AMX-Anweisungen als lo-
|
||||
gische Arbeitseinheit. Es gibt jeweils eine Anweisung zur
|
||||
Spezifikation des Transaktionsbeginns (use), des Transak-
|
||||
tionsendes (commit), sowie des Abbrechens einer Transaktion
|
||||
und das Ruecksetzen (abort) und fuer das Behandeln einer
|
||||
Verklemmung (if (deadlock)).
|
||||
|
||||
Bei Transaktionsbeginn sind die beteiligten Relationen und
|
||||
die Art ihrer Benutzung (alleinig (exclusive), geteilt
|
||||
(shared) oder ohne Sperrung (nolock)) spezifizierbar. Aus-
|
||||
serdem ist u.a. das Sperrniveau (Seitensperrung (page) oder
|
||||
Relationssperrung (table)) angebbar.
|
||||
|
||||
Des weiteren sind Anweisungen zur vorzeitigen Beendigung
|
||||
eine Wiederfindungszyklusses (endretrieve), zur vorzeitigen
|
||||
Beendigung einer Tupelverarbeitung im Wiederfindungszyklus
|
||||
(nextretrieve), zum Bereitstellen der Gesamt-Tupelanzahl ei-
|
||||
ner Relation (tuplecount) sowie der maximalen Tupellaenge
|
||||
der Relation (tuplelength), und eine Leeranweisung (;) ver-
|
||||
fuegbar.
|
||||
|
||||
Neben den durch "C" bereitgestellten und von AMX unter-
|
||||
stuetzten Datentypen short (2), int (2 bei 16 Bit- und 4 bei
|
||||
32-Bit Rechnern), long(4) , float(4), double(8), char * und
|
||||
char [] (1-255) sind durch AMX zusaetzlich die mit den
|
||||
DABA-Datentypen uebereinstimmenden Typen
|
||||
|
||||
i1, i2, i4, f4, und f8
|
||||
|
||||
verfuegbar.
|
||||
|
||||
Einschraenkungen
|
||||
|
||||
Die Geschwindigkeit der AMX-Zugriffe erfordert einige Ein-
|
||||
schraenkungen. AMX gestattet Datenveraenderungen und Wie-
|
||||
derfinden ausschliesslich in Basis-Nutzerrelationen (nicht
|
||||
in Sichten!). Das Wiederfinden in Index-Nutzerrelationen
|
||||
wird unterstuetzt. Die Katalogrelationen sind, entsprechend
|
||||
definierte Befugnisse vorausgesetzt, lesbar.
|
||||
|
||||
Da nur die in einem AMX-Programm konkret benoetigten Zu-
|
||||
griffsroutinen eingebunden werden, sind keine Universallo-
|
||||
esungen, z.B. universelle Druckprogramme, realisierbar.
|
||||
|
||||
Aus dem Dargelegten ergibt sich ebenfalls, dass die Nutzer-
|
||||
relationen nicht mit AMX erstellt werden koennen. Bevor ein
|
||||
AMX-Programm uebersetzt werden kann, muessen die in diesem
|
||||
Programm spezifizierten Relationen bereits mit IQL, EQL oder
|
||||
dem DABA-MUTOS-Kommandos "creater" (creater(mutos)) erstellt
|
||||
worden sein.
|
||||
|
||||
Da nur die in einem AMX-Programm benoetigten Zugriffsrouti-
|
||||
nen zu den Relationen, entsprechend den konkreten Bedingun-
|
||||
gen, zugriffsoptimiert in das ausfuehrbare Programm einge-
|
||||
bunden werden, ist nach jeder Modifikation der Relations-
|
||||
struktur (modify(ql), modifyr(mutos), index(ql) bzw.
|
||||
indexr(mutos), destroy(ql) bzw. destroyr(mutos) und crea-
|
||||
te(ql) bzw. creater(mutos), eine Neuuebersetzung des AMX-
|
||||
Programmes notwendig!
|
||||
|
||||
Eine Relation, die durch ein AMX-Programm verarbeitet werden
|
||||
soll, darf keine definierten Integritaetsbedingungen besit-
|
||||
zen! Als Befugnisse einer solchen Relation duerfen aus-
|
||||
schliesslich operationelle Befugnisse (append, retrieve, de-
|
||||
lete, replace oder all) ohne jede Qualifikation definiert
|
||||
worden sein!
|
||||
|
||||
Werden mehrere Objektmodule zu einem ausfuehrbaren Programm
|
||||
verbunden, darf nur einer dieser Objektmodule AMX-
|
||||
Anweisungen enthalten!
|
||||
|
||||
Konvertierungen zwischen numerischen und Zeichenkettenwerten
|
||||
(und umgekehrt) werden nicht unterstuetzt. Numerische Kon-
|
||||
vertierungen erfolgen ohne Unter- bzw. Ueberlaufkontrolle.
|
||||
|
||||
Vergleiche von Zeichenkettenwerten zwischen Domaenen und Va-
|
||||
riablen werden in der Laenge der Domaene ausgefuehrt, z.B.
|
||||
liefert der Variablenwert "Automat" den Wert "Auto" fuer die
|
||||
Datenbankaktion, wenn die zugehoerige Domaene den DABA-
|
||||
Datentyp "c4" hat.
|
||||
|
||||
Uebersetzung
|
||||
|
||||
AMX-Anweisungen, im Anwendungsprogramm durch ein besonde-
|
||||
res Praefixsymbol "##" gekennzeichnet, werden durch den
|
||||
Voruebersetzer (Praeprozessor) syntaktisch und semantisch
|
||||
ueberprueft und in Prozeduraufrufe der hoeheren Programm-
|
||||
iersprache uebersetzt. Vorbild fuer diesen Loesungsansatz
|
||||
war EQL des DABA.
|
||||
|
||||
"C"-Anweisungen werden unveraendert in das "C"-Programm ko-
|
||||
piert.
|
||||
|
||||
Damit ein AMX-Quellprogramm vom AMX-Compiler verarbeitet
|
||||
werden kann, muss das File, in dem es enthalten ist, den
|
||||
File-Namenssuffix ".x" (z.B. prog.x) besitzen.
|
||||
|
||||
Der AMX-Compiler holt sich alle Informationen zu den Rela-
|
||||
tionen und Domaenen aus den Systemkatalogen (Katalogrelatio-
|
||||
nen) der Datenbank und entlastet somit den Anwender von der
|
||||
Angabe dieser Details und den Fehlern, die an dieser Stelle
|
||||
gemacht werden koennen. Durch diesen Ansatz ist eine weit-
|
||||
gehende Quelltextunabhaengigkeit von der Struktur der Daten-
|
||||
bank gesichert.
|
||||
|
||||
Bei der Zugriffspfadoptimierung werden die vorhandenen In-
|
||||
dizes voll herangezogen. Wenn der AMX-Programmierer es for-
|
||||
dert, ist eine davon abweichende Zugriffsgestaltung spezifi-
|
||||
zierbar.
|
||||
|
||||
Aenderungen sind nur in Nutzerrelationen gestattet, die Sy-
|
||||
stemkataloge und Indizes werden durch AMX aktualisiert.
|
||||
|
||||
Eine Aenderung der Speicherungsstruktur einer Relation er-
|
||||
fordert, wie bereits betont, keine Aenderung des AMX-
|
||||
Quellprogramms, wohl aber dessen neue Uebersetzung.
|
||||
|
||||
Wenn der AMX-Compiler ein AMX-Programm uebersetzen soll, ar-
|
||||
beitet dieser als Nutzer "daba". Damit das erzeugte "C"-
|
||||
Programm in das aktuelle Arbeits-Directory geschrieben wer-
|
||||
den kann, muss deshalb "daba" in diesem Directory die
|
||||
Schreiberlaubnis besitzen.
|
||||
|
||||
Die Spezifikation des AMX-Quell-Files erfolgt, wie ueblich,
|
||||
entweder als absoluter Pfadname oder relativ zum aktuellen
|
||||
Arbeit-Directory.
|
||||
|
||||
|
||||
|
||||
|
||||
Das durch den AMX-Compiler erzeugte AMX-Programm besitzt den
|
||||
Filemodus oktal "6755" und ist dem Nutzer daba und der Grup-
|
||||
pe daba zugeordnet. Es ist z.B. beim Kopieren eines AMX-
|
||||
Programmes darauf zu achten, dass dieser Filemodus erhalten
|
||||
bleibt.
|
||||
|
||||
Zur Fehlererkennung beimm Compilieren ist folgendes zu be-
|
||||
merken. Nach Erkennung eines Fehlers wird die Uebersetzung
|
||||
erst nach drei als richtig erkannten syntaktischen Einheiten
|
||||
(Token, Morpheme) fortgesetzt, sodass eine zweite Ueberset-
|
||||
zung Fehler erzeugen kann, die in der ersten nicht gemeldet
|
||||
wurden. Die zu jedem Fehler mit ausgegebene Zeilennummer ist
|
||||
nicht immer exakt. Sie kann sich auf eine der vorherigen
|
||||
Zeilen beziehen, wenn der Fehler am Zeilenende erkannt wur-
|
||||
de, da der Compiler immer eine syntaktische Einheit voraus
|
||||
liest.
|
||||
Wird ein Fehler festgestellt, ist in dem oben genannten Fall
|
||||
der Zeilenzaehler aber schon um eins (oder mehr, bei Zeilen
|
||||
ohne syntaktische Einheiten) hochgezaehlt. Bei einigen syn-
|
||||
taktischen Fehler ist eine Angabe der Fehlerursache aeus-
|
||||
serst schwierig.
|
||||
Aufgrund der einfachen Syntax von AMX wurde auf eine detail-
|
||||
lierte Fehlererkennung verzichtet und der Anwender muss den
|
||||
erzeugten Fehler
|
||||
|
||||
"syntax error"
|
||||
selbst deuten.
|
||||
|
||||
Namenskonventionen
|
||||
|
||||
Fuer Datenbankbegriffe (ql(iql)) und auch bezueglich der
|
||||
Grenzwerte gelten die gleichen Bedingungen wie in den an-
|
||||
deren DABA-Interfaces. Es sei nochmals daran erinnert, dass
|
||||
die Namen der Systemrelationen:
|
||||
|
||||
"relation" Verwaltung der Relationen
|
||||
"attribute" Verwaltung der Domaenen
|
||||
"indexes" Verwaltung der Indizes
|
||||
"integrities" Verwaltung der definierten Integritaeten
|
||||
"protect" Verwaltung der vergebenen Zugriffsrechte
|
||||
"tree" Verwaltung der voruebersetzten Datenbank-
|
||||
aktionen
|
||||
"references" Verwaltung von Beziehungen zwischen
|
||||
Relationen
|
||||
|
||||
als Namen von Nutzerrelationen gesperrt sind.
|
||||
|
||||
|
||||
|
||||
|
||||
Alle Namen (Datenbank, Relationen, Domaenen) sind maximal 12
|
||||
Zeichen lang und bestehen aus den Zeichen "[a-z_0-9]", wobei
|
||||
der Name nicht mit einer Ziffer "[0-9]" beginnen darf (siehe
|
||||
ql(iql)). Der AMX-Compiler konvertiert bei Namen grosse
|
||||
Buchstaben "[A-Z]" automatisch in kleine "[a-z]".
|
||||
|
||||
Durch die Laufzeitbibliothek werden eine Reihe von Objekten
|
||||
definiert, die alle mit "AA" beginnen. Der Anwendungspro-
|
||||
grammierer hat zu gewaehrleisten, dass diese Objekte nicht
|
||||
ueberdefiniert werden. Er sollte Namen, die mit "AA" begin-
|
||||
nen, generell vermeiden.
|
||||
|
||||
AMX-Programm
|
||||
|
||||
Jedes AMX-Programm besteht aus "C"-Anweisungen und eingebet-
|
||||
teten AMX-Anweisungen, die vom AMX-Praeprozessor verarbeitet
|
||||
werden.
|
||||
|
||||
Alle AMX-Anweisungen sind durch das AMX-Kommandopraefix, das
|
||||
aus zwei Nummernzeichen "##" am Zeilenanfang gebildet wird,
|
||||
gekennzeichnet.
|
||||
|
||||
|
||||
|
||||
|
||||
"C"-Variablen, die in AMX-Anweisungen verwendet werden, sind
|
||||
ebenfalls durch "##" zu kennzeichnen.
|
||||
|
||||
Wie bereits dargelegt, sind die "C"-Variablentypen und zu-
|
||||
saetzlich "i1", "i2", "i4", "f4" und "f8" verfuegbar.
|
||||
|
||||
Alle Variablen sind global zu deklarieren!
|
||||
|
||||
Die erste Anweisung im AMX-Quellprogramm muss eine der An-
|
||||
weisungen zum Eroeffnen der Datenbank (exclusive, daba, no-
|
||||
lock oder shared) sein.
|
||||
|
||||
Die erste auszufuehrende Funktion, anstelle von "main", muss
|
||||
die Funktion "amx" sein. Fuer diese Funktion sind die glei-
|
||||
chen Parameter wie bei "main" spezifizierbar (amx() ohne Pa-
|
||||
rameter).
|
||||
|
||||
Jede Relation muss vor ihrer Verwendung eroeffnet und kann
|
||||
nach Beendigung der Verarbeitung geschlossen werden. Durch
|
||||
die MUTOS Funktion "exit" werden alle noch eroeffneten Rela-
|
||||
tionen geschlossen, nachdem die entsprechenden noch ausste-
|
||||
henden Ausgaben erfolgt sind.
|
||||
|
||||
|
||||
|
||||
Zur Bildung syntaktischer Konstruktionen werden zur Darstel-
|
||||
lung einer Auswahl oder Wiederholung die folgenden Metasym-
|
||||
bole verwendet:
|
||||
|
||||
| : Alternative.
|
||||
|
||||
[ ] : wahlweiser Ausdruck, kann entfallen.
|
||||
|
||||
{ } : mindestens einmalige Wiederholung,
|
||||
mehrere Elemente werden durch ein Komma "," getrennt.
|
||||
|
||||
Als syntaktische Variable werden u.a. die folgenden verwen-
|
||||
det:
|
||||
|
||||
dbname = Datenbankname
|
||||
c_code = C-Anweisung
|
||||
c_decl = Deklaration einer C-Variablen
|
||||
relname = Relationsname
|
||||
c_var = C-Variablenname
|
||||
domname = Domaenenname bzw. Domaenennummer
|
||||
const = int-Konstante | long-Konstante
|
||||
| double-Konstante | "string"-Konstante
|
||||
|
||||
|
||||
|
||||
Sprachbeschreibung
|
||||
|
||||
Das Folgende ist eine Beschreibung der allgemeinen Syntax
|
||||
der Sprache AMX und der syntaktischen Klassen aus denen die
|
||||
Teile der AMX-Anweisungen gebildet werden. Die einzelnen
|
||||
Anweisungen werden ebenfalls hier erlaeutert.
|
||||
|
||||
Kennzeichnung der AMX-Anweisungen
|
||||
|
||||
Alle AMX-Anweisungen beginnen mit "##" am Zeilenanfang. Nur
|
||||
diese Anweisungen werden im folgenden behandelt. Alle an-
|
||||
deren Anweisungen sind "C"-Anweisungen die den Regeln des
|
||||
"C"-Compilers unterliegen.
|
||||
|
||||
Die erste AMX-Anweisung im Programm
|
||||
|
||||
Die erste AMX-Anweisung in einem AMX-Programm muss das Ero-
|
||||
effnen einer Datenbank sein.
|
||||
|
||||
Ist keine Sperrung der Datenbank vorgesehen, ist die Anwei-
|
||||
sung:
|
||||
|
||||
## nolock [ flags ] dbname [ with deadlock ]
|
||||
|
||||
zu verwenden.
|
||||
|
||||
Soll eine Datenbank alleinig benutzt werden, sind die Anwei-
|
||||
sungen:
|
||||
|
||||
## daba [ flags ] dbname [ with deadlock ]
|
||||
|
||||
oder
|
||||
|
||||
## exclusive [ flags ] dbname [ with deadlock ]
|
||||
|
||||
zu benutzen.
|
||||
|
||||
Bei geteilter Nutzung ist:
|
||||
|
||||
## shared [ flags ] dbname [ with deadlock ]
|
||||
|
||||
zu verwenden.
|
||||
|
||||
Die wahlweisen Flags haben folgende Bedeutung:
|
||||
|
||||
-uname Erlaubt es, sich als Nutzer mit dem Login-Namen
|
||||
name auszugeben. Das AMX-Programm arbeitet dann
|
||||
mit den Datenbankbefugnissen des entsprechenden
|
||||
Nutzers. Nur der DBA und der DABA-
|
||||
Systemverantwortliche duerfen dieses Flag benut-
|
||||
zen.
|
||||
|
||||
+bufno Ist die Spezifikation zusaetzlich verfuegbaren
|
||||
DABA-Puffer. Normalerweise werden nur insgesamt
|
||||
drei Puffer bereitgestellt. Bei paralleler Arbeit
|
||||
mit mehreren Relationen (Indexrelationen muessen
|
||||
mit gezaehlt werden!), sollte jeder Relation
|
||||
mindestens ein Puffer zugeordnet werden. Empfeh-
|
||||
lenswert sind zwei Puffer pro Relation.
|
||||
|
||||
Die Spezifikation with deadlock bedeutet, dass Deadlocks
|
||||
(Totsperren) auftreten koennen, die der Nutzer selbst abfan-
|
||||
gen will.
|
||||
|
||||
Kommentar
|
||||
|
||||
Kommentare sind innerhalb von AMX-Anweisungen in der C-
|
||||
ueblichen Notation zugelassen und duerfen nicht geschachtelt
|
||||
werden:
|
||||
|
||||
## . . . /* Kommentar */ . . .
|
||||
|
||||
|
||||
|
||||
|
||||
Deklaration von C-Variablen
|
||||
|
||||
"C"-Variable, die in einer AMX-Anweisung verwendet werden
|
||||
sollen, sind unbedingt durch "##" zu kennzeichnen. Folgende
|
||||
"C"-Typen werden unterstuetzt:
|
||||
|
||||
- short
|
||||
- int
|
||||
- long
|
||||
- float
|
||||
- double
|
||||
- char *
|
||||
- char []
|
||||
|
||||
|
||||
Ausserdem sind die DABA-Typen i1, i2, i4, f4 und f8 zugelas-
|
||||
sen.
|
||||
|
||||
Folgende Speicherklassen werden unterstuetzt:
|
||||
|
||||
- auto
|
||||
- extern
|
||||
- static
|
||||
|
||||
|
||||
Relationseroeffnung
|
||||
|
||||
Die Anweisung:
|
||||
|
||||
## open relation
|
||||
|
||||
eroeffnet die Relation relname fuer die weitere Verarbei-
|
||||
tung.
|
||||
Die Relation relname muss eine Primaer- bzw. Basisrelation
|
||||
sein, d.h. es ist nicht moeglich, explizit eine Indexrela-
|
||||
tion zu eroeffnen.
|
||||
|
||||
Durch die open Anweisung werden automatisch alle zur Rela-
|
||||
tion gehoerigen Indizes miteroeffnet.
|
||||
Die Relation relname darf keine Sicht (View) sein, und es
|
||||
duerfen keine Integritaetsbedingungen bzw. nur operationelle
|
||||
Befugnisse (append, replace, retrieve, delete oder all) ohne
|
||||
jede Qualifikation auf ihr definiert sein. Die Systemkata-
|
||||
loge relation , attribute und indexes werden durch den Start
|
||||
eines AMX-Programms automatisch eroeffnet. Sie duerfen vom
|
||||
Nutzer nicht explizit eroeffnet werden.
|
||||
Recherchen sind auf alle Relationen zugelassen, d.h. auf
|
||||
Basis-, Indexrelationen und Katalogen.
|
||||
Aenderungen und Einfuegungen sind nur auf Basisrelationen
|
||||
zulaessig, fuer die das Programm die Aenderungsbefugnis (de-
|
||||
lete, append, replace) hat.
|
||||
|
||||
## close relname
|
||||
|
||||
Die close Anweisung schliesst die Relation relname fuer die
|
||||
weitere Verarbeitung. Es koennen nur Relationen geschlossen
|
||||
werden, die zuvor durch die open Anweisung eroeffnet wurden.
|
||||
Die Beendigung eines Programms ( exit ) schliesst automati-
|
||||
sch alle eroeffneten Relationen und Kataloge.
|
||||
|
||||
## tuplecount relname c_var
|
||||
|
||||
Die tuplecount-Anweisung weist der C-Variable c_var als Wert
|
||||
die Anzahl der Tupel der Relation relname zu. C_var muss
|
||||
von numerischem Typ und als long (oder besser i4 ) definiert
|
||||
worden sein.
|
||||
|
||||
## tuplelength relname c_var
|
||||
|
||||
Die tuplelength-Anweisung weist der C-Variablen c_var als
|
||||
Wert die Laenge eines Tupels zu und sollte als short ( oder
|
||||
besser als i2 ) definiert sein.
|
||||
|
||||
|
||||
|
||||
Die Anzahl der Tupel einer Relation und ihre Laenge sind die
|
||||
einzigen verfuegbaren variablen Kataloginformationen fuer
|
||||
ein AMX-Programm. Auf Umwegen kann so die Anzahl der Aende-
|
||||
rungen in einer Relation bestimmt werden:
|
||||
|
||||
. . .
|
||||
## long old, new;
|
||||
. . .
|
||||
## tuplecount rel old
|
||||
{ Neueinfuegungen }
|
||||
## tuplecount rel new
|
||||
printf("# of updates", new - old);
|
||||
. . .
|
||||
|
||||
Ergebnisliste
|
||||
|
||||
In der retrieve, der replace und der append Anweisung kann
|
||||
eine Domaenenauswahl in Form einer target_list (Ergebnis-
|
||||
oder Zielliste) spezifiziert werden.
|
||||
|
||||
Die target_list ist eine durch Kommas separierte Liste von
|
||||
Domaenenzuordnungen (dom_assign). Sie muss in runde Klam-
|
||||
mern eingeschlossen werden und mindestens eine Domaenenspe-
|
||||
zifikation enthalten.
|
||||
|
||||
Eine Domaenenzuordnung der Ergebnisliste besteht aus:
|
||||
|
||||
$domname = value.
|
||||
|
||||
Sie weist der Domaene domname den Wert value zu. Dabei
|
||||
kennzeichnet das Dollar-Zeichen $ den Domaenennamen.
|
||||
Als domname kann auch eine Domaenennummer ( attid des attri-
|
||||
bute Kataloges) spezifiziert werden.
|
||||
Bei den Zuweisungen von numerischen zu numerischen Typen
|
||||
werden die notwendigen Konvertierungen ohne Ueberlauf- bzw.
|
||||
Unterlaufkontrolle vorgenommen.
|
||||
Zuweisungen von numerischen zu Zeichenkettenwerten und um-
|
||||
gekehrt sind nicht zulaessig.
|
||||
Durch die explizite Kennzeichnung von Domaenennamen durch
|
||||
das Zeichen "$" werden im Gegensatz zu EQL Konflikte mit dem
|
||||
Namen von C-Variablen vermieden.
|
||||
Die Referenzierung von Domaenen ueber ihre interne Nummer
|
||||
(Reihenfolge vom create(ql)) kann sinnvoll bei einer vekto-
|
||||
risierten Verarbeitung sein.
|
||||
|
||||
Ein Wert value kann der aktuelle Wert der C-Variablen c_var,
|
||||
eine in C uebliche Konstante const oder eine Domaenenzuord-
|
||||
nung sein. Ein Wert kann der aktuelle Wert der Domaene (Do-
|
||||
maenenzuordnung) (gekennzeichnet durch das Dollarzeichen)
|
||||
$domname sein. Diese Form des Wertes kann nur im Aktions-
|
||||
teil der Recherche angegeben werden und setzt eine ueber-
|
||||
geordnete retrieve Anweisung voraus, aus dem der Wert fuer
|
||||
die Domaene domname geholt werden kann.
|
||||
|
||||
Die retrieve-Anweisung
|
||||
|
||||
|
||||
## [ over over_relname ] retrieve ret_relname [ qual ] [ (
|
||||
target_list ) ]
|
||||
|
||||
Die retrieve Anweisung zur Recherche ist die maechtigste
|
||||
AMX-Anweisung, sie uebernimmt die Zugriffspfadoptimierung
|
||||
und ermoeglicht eine rekursive Verarbeitung, da innerhalb
|
||||
einer Recherche eine weitere Recherche aufgerufen werden
|
||||
kann.
|
||||
|
||||
Die over Klausel gestattet die Zuweisung des Zugriffspfades
|
||||
ueber die Relation over_relname fuer die Recherche und damit
|
||||
die Ausschaltung der Zugriffspfadoptimierung im AMX-
|
||||
Compiler.
|
||||
|
||||
Over_relname muss die wiederzufindende Relation selbst oder
|
||||
ein Index von ret_relname sein. Ist over_relname ein Index
|
||||
und wird durch die Selektion qual keinem Schluessel von
|
||||
over_relname ein Wert zugewiesen, wird der Zugriffspfad ue-
|
||||
ber die Primaerrelation rel_relname gewaehlt, da eine Re-
|
||||
cherche ueber die gesamte Relation und ueber einen Index un-
|
||||
sinning ist.
|
||||
|
||||
Die retrieve Klausel ( retrieve ret_relname ) adressiert die
|
||||
zu suchende Relation ret_relname.
|
||||
|
||||
Qualifikation
|
||||
|
||||
Die Recherche kann durch eine Qualifikation qual als Spezi-
|
||||
fikation einer Selektion eingeschraenkt werden, wodurch die
|
||||
relevanten Tupel selektiert werden.
|
||||
Die Selektion ist eine Einschraenkung des Wertebereichs ein-
|
||||
zelner (oder aller) Domaenen.
|
||||
Mehrere Einschraenkungen werden durch "and" getrennt.
|
||||
Eine Qualifikation qual hat maximal zwei Klausel pro Doma-
|
||||
enenname. Eine Klausel besteht aus einer Domaenenspezifika-
|
||||
tion (einem Domaenennamen domname, gekennzeichnet durch ein
|
||||
Dollarzeichen "$" davor), einem Vergleichsoperator und einem
|
||||
Wert value. Domname gibt die einzuschraenkende Domaene und
|
||||
value den Wert der Einschraenkung an. Fuer die Spezifika-
|
||||
tion von value gilt das in "Ergebnisliste" dargelegte.
|
||||
|
||||
|
||||
|
||||
Es sind die Vergleichsoperatoren:
|
||||
|
||||
"=", "==", "<", "<=", ">", ">=", "!="
|
||||
|
||||
zulaessig.
|
||||
Wird eine Domaene doppelt eingeschraenkt, sind folgende zu-
|
||||
laessige Kombinationen zu beachten:
|
||||
|
||||
"<[=]" und ">[=]"
|
||||
"<[=]" und "!="
|
||||
">[=]" und "!="
|
||||
|
||||
Die Reihenfolge der Einschraenkungen fuer eine Domaene ist
|
||||
in folgender Art einzuhalten:
|
||||
|
||||
"<[=]" --> ">[=]" --> "!="
|
||||
|
||||
Alle zugewiesenen Bedingungen und Werte der angebenen Ein-
|
||||
schraenkungen werden beim Einlauf in die Recherche gekel-
|
||||
lert, sodass z.B. eine Aenderung des Wertes einer verwende-
|
||||
ten C-Variablen keinen Einfluss auf die Selektion hat.
|
||||
|
||||
|
||||
|
||||
|
||||
Ergebnisliste der retrieve-Anweisung
|
||||
|
||||
Die Ergebnisliste ( target_list ) zur Spezifikation der Do-
|
||||
maenenauswahl (Projektionsoperation des DBBS) ist wahlweise.
|
||||
|
||||
Aktion
|
||||
|
||||
Die Aktion, die bei jedem gefundenen Tupel duchlaufen werden
|
||||
soll, ist durch den Einschluss der ##{ und der ##} Anweisun-
|
||||
gen, die unmittelbar der ## retrieve Anweisung folgen soll-
|
||||
ten, zu spezifizieren. Zwischen diesen Anweisungen koennen
|
||||
beliebige AMX-Anweisungen und C-Anweisungen stehen. Die Ak-
|
||||
tion kann leer sein, allerdings muessen die Klammern ange-
|
||||
geben sein.
|
||||
Es ist wichtig zu wissen, dass innerhalb der Aktion die Do-
|
||||
maenenwerte des gefundenen Tupel immer vorhanden sind und
|
||||
sich nicht aendern.
|
||||
Eine Aktion fuer ein Tupel kann vorzeitig beendet werden.
|
||||
Es ist moeglich, durch die Anweisung
|
||||
|
||||
## nextretrieve
|
||||
|
||||
zur Verabeitung des naechsten Tupels ueberzugehen oder durch
|
||||
|
||||
## endretrieve
|
||||
|
||||
die Aktion (Recherche) zu beenden.
|
||||
|
||||
Variablenzuweisung
|
||||
|
||||
Eine Zuweisung weist der C-Variablen c_var den aktuellen
|
||||
Wert der Domaene domname zu.
|
||||
|
||||
c_var = $domname
|
||||
|
||||
Bei den Zuweisungen von numerischen zu numerischen Typen
|
||||
werden die notwendigen Konvertierungen ohne Ueberlauf-
|
||||
bzw. Unterlaufkontrolle vorgenommen.
|
||||
Zuweisungen von numerischen zu Zeichenkettenwerten und um-
|
||||
gekehrt sind nicht zulaessig.
|
||||
|
||||
Die print-Anweisung
|
||||
|
||||
## print ([{ domname }])
|
||||
|
||||
Die print-Anweisung gibt die Werte der, durch eine oeffnende
|
||||
"(" und eine schliessende runde Klammer ")", begrenzten Li-
|
||||
ste der Domaenen in einem Standardformat nach Standardoutput
|
||||
aus.
|
||||
Die Liste enthaelt eine durch Kommas "," getrennte Aufza-
|
||||
ehlung der auszugebenden Domaenen. Eine leere Liste "()"
|
||||
gibt die Werte aller Domaenen aus.
|
||||
|
||||
Das Standardformat enthaelt den Namen und den Wert der Doma-
|
||||
ene in folgender Form:
|
||||
|
||||
"%12s: %?\n", domname, value
|
||||
|
||||
? == Format der auszugebenden Domaene
|
||||
|
||||
Die delete-Anweisung
|
||||
|
||||
## delete
|
||||
|
||||
Eine delete-Anweisung loescht das innerhalb der laufenden
|
||||
Recherche gefundene aktuelle Tupel aus der Relation. In-
|
||||
nerhalb der Aktion bleibt das aktuelle Tupel mit seinen Wer-
|
||||
ten erhalten.
|
||||
Eventuell vorhandene Indizes werden automatisch aktuali-
|
||||
siert.
|
||||
|
||||
Die replace-Anweisung
|
||||
|
||||
## replace (target_list)
|
||||
|
||||
Die replace Anweisung gestattet die Aenderung von Werten
|
||||
einzelner (oder aller) Domaenen eines wiedergefundenen Tu-
|
||||
pels.
|
||||
Eine Unterscheidung von Schluessel- und Nichtschluesseldoma-
|
||||
enen ist nicht zu beachten.
|
||||
Die Aenderungen werden durch die Projektions target_list
|
||||
spezifiziert.
|
||||
|
||||
Es ist zu beachten, dass die Aenderungen in einem gesonder-
|
||||
tem Puffer ausgefuehrt werden, das aktuell gefundene Tupel
|
||||
also innerhalb der Aktion unveraendert bleibt.
|
||||
Eventuell vorhandene Indizes werden, falls noetig, auto-
|
||||
matisch aktualisiert. Eine Aktualsierung entfaellt z.B.,
|
||||
wenn eine identische Aenderung (geaendertes == Ursprungstu-
|
||||
pel) ausgefuehrt wurde oder wenn die geaenderten Domaenen
|
||||
nicht Bestandteil des Index sind und sich die Tupeladresse
|
||||
TID nicht geaendert hat.
|
||||
|
||||
Die append-Anweisung
|
||||
|
||||
## append [ relname ] (target-list)
|
||||
|
||||
Die append Anweisung mit der Spezifikation relname fuegt ein
|
||||
neues Tupel in die Relation relname ein. Die nicht in der
|
||||
target_list spezifizierten Domaenen der Relation relname
|
||||
werden mit einem Nullwert initialisiert, alle numerischen
|
||||
Domaenen bekommen den Wert 0.
|
||||
Den Zeichenkettendomaenen wird eine mit Leerzeichen gefuell-
|
||||
te Zeichenkette zugewiesen.
|
||||
|
||||
Die append Anweisung ohne relname fuegt ein neues Tupel in
|
||||
die Relation ein. Sie kann nur innerhalb einer Recherche ge-
|
||||
nutzt werden. Durch die Projektion target_list werden den
|
||||
aufgefuehrten Domaenen Werte zugewiesen.
|
||||
Alle nicht angebenen Domaenen erhalten den Wert aus dem ak-
|
||||
tuell gefundenen Tupel der laufenden Recherche.
|
||||
|
||||
Es ist zu beachten, dass die Aenderungen in einem gesonder-
|
||||
ten Puffer ausgefuehrt werden, also das aktuell gefundene
|
||||
Tupel unveraendert bleibt. Eventuell vorhandene Indizes
|
||||
werden automatisch aktualisiert.
|
||||
|
||||
Arbeit mit Transaktionen
|
||||
|
||||
Zur Arbeit mit Transaktionen stehen die AMX-Anweisungen use,
|
||||
commit, abort und if (deadlock) bereit.
|
||||
|
||||
## use ( use_rel [, ...] )
|
||||
|
||||
Use spezifiziert den Beginn einer Transaktion. den Beginn
|
||||
einer Transaktion. Use_rel wird wie folgt angegeben:
|
||||
|
||||
[ exclusive | shared | nolock | + ] relname [
|
||||
|
||||
with [ level = page | table ]
|
||||
|
||||
[ readlock = exclusive | shared | nolock ]
|
||||
|
||||
[ maxlock = int ]
|
||||
|
||||
[ timeout = int ] ]
|
||||
|
||||
Exclusive oder + bedeuten exklusive (alleinige), das Weglas-
|
||||
sen oder shared eine geteilte Benutzung. Die geteilte Be-
|
||||
nutzung und nolock (kein Sperren) sind nur fuer Leseopera-
|
||||
tionen, exklusive Benutzung fuer Schreiboperationen anwend-
|
||||
bar.
|
||||
|
||||
Level kennzeichnet das Sperrniveau page (Seitensperren) oder
|
||||
table (Relationsperren).
|
||||
|
||||
Readlock ist nur fuer Leseoperationen anwendbar und kenn-
|
||||
zeichnet die Art der Lesesperren.
|
||||
|
||||
|
||||
Maxlock spezifiziert die maximale Anzahl der Sperren ( -1 :
|
||||
unbegrenzt) und timeout die Zeit (in Sekunden), bis eine
|
||||
Rueckkehr vom DBBS erfolgt sein muss ( - 1 : warten, bis
|
||||
verfuegbar).
|
||||
|
||||
Nur, wenn beim Eroeffnen der Datenbank with deadlock spezi-
|
||||
fiziert wurde, sind die folgenden Anweisungen nutzbar.
|
||||
|
||||
## if ( bd deadlock ) { stmt_list }
|
||||
|
||||
Mit dieser Anweisung kann abgetestet werden, ob ein Deadlock
|
||||
aufgetreten ist. Diese Anweisung ist unmittelbar nach use,
|
||||
retrieve, append, replace oder delete anzuordnen. Wenn ein
|
||||
Deadlock aufgetreten ist, wird die Anweisungsfolge stmt_list
|
||||
abgearbeitet werden, was i.allg. die Anweisung abort sein
|
||||
wird.
|
||||
|
||||
## abort
|
||||
|
||||
Diese Anweisung beendet eine Transaktion zwangsweise und
|
||||
setzt die Datenbank auf den Stand vor Beginn der Transaktion
|
||||
zurueck.
|
||||
|
|
@ -0,0 +1,68 @@
|
|||
EQC(MUTOS) DABA16 EQC(MUTOS)
|
||||
|
||||
NAME
|
||||
eqc - Aufruf des EQL-Praecompilers
|
||||
|
||||
UEBERSICHT
|
||||
eqc [ -d ] [ -f ] [ -r ] file.q {file.q}
|
||||
|
||||
BESCHREIBUNG
|
||||
EQL (Eingebettete QL) ist eine Sprache zur Einbettung von
|
||||
Datenbankanfragen der Sprache QL in eine Wirts-
|
||||
Programmiersprache.
|
||||
|
||||
EQL besteht aus der EQL-Laufzeitbibliothek, die die Schnitt-
|
||||
stelle zur Datenbank realisiert (Call- Interface), und einem
|
||||
Praecompiler zur Uebersetzung eines Programms mit eingebet-
|
||||
teten QL-Anweisungen in gueltige Anweisungen der Programm-
|
||||
iersprache C.
|
||||
Das Call-Interface ist fuer alle Programmiersprachen ver-
|
||||
fuegbar; ein Praecompiler existiert zur Zeit nur fuer die
|
||||
Programmiersprache C.
|
||||
|
||||
Compilation
|
||||
|
||||
Der Praecompiler wird durch das Kommando:
|
||||
|
||||
eqc {flags} file1.q {flags} file2.q ...
|
||||
|
||||
aufgerufen, wobei filen.q die Quelleingabe-Files sind, deren
|
||||
Namen mit .q enden muessen. Die Ausgabe wird auf das File
|
||||
`filen.c' geschrieben.
|
||||
|
||||
Folgende Flags koennen gesetzt werden:
|
||||
|
||||
-d Generiert Code zum Quelltext des Files mit Name und
|
||||
Zeilennummer, die bei auftretenden Laufzeit-Fehlern an-
|
||||
gezeigt werden. Das ist zum Analysieren der Fehler
|
||||
nuetzlich, benoetigt aber mehr Platz.
|
||||
|
||||
-f Erzeugt Code, bei dem "Output"- und "Input"-Files
|
||||
gewoehnlich die gleiche Zeilennummer haben, um die C-
|
||||
Diagnose-Mitteilungen leichter interpretieren zu ko-
|
||||
ennen. Manchmal muss EQL versuchen, Anfragen in mehrere
|
||||
Zeilen zu zerlegen, um einen Zeilenueberlauf des C-
|
||||
Praeprozessors zu vermeiden. Dann verschiebt es C-Code
|
||||
einige Zeilen nach vorn. Mit der -f Flagspezifikation
|
||||
erfolgt das nicht. C-Code steht in der richtigen Zeile
|
||||
und Reihenfolge. Entsprechend kann die Zeile des
|
||||
Quellcodes mit der Zeile der C-Diagnose uebereinstim-
|
||||
men.
|
||||
|
||||
-r Setzt Flags auf Standardwerte zurueck. Das wird
|
||||
verwendet, um andere Flags fuer Files aus der Argument-
|
||||
liste zu unterdruecken.
|
||||
|
||||
Die Ausgabe-Files koennen dann mittels des C-Compilers uebersetzt
|
||||
werden:
|
||||
|
||||
cc file1.c file2.c ... -lq
|
||||
|
||||
Die Schreibweise -lq fordert die EQL-Laufzeit-Bibliothek an.
|
||||
|
||||
Die Bibliothek libq.a muss zur Angabe der Option -lq in
|
||||
/lib/libq.a oder /usr/lib/libq.a vorhanden sein, d.h. sie muss
|
||||
bei der Installation aus
|
||||
|
||||
/.../daba/lib/libq.a
|
||||
dorthin kopiert werden.
|
||||
|
|
@ -0,0 +1,27 @@
|
|||
IQLI(DABA) DABA16 IQLI(DABA)
|
||||
|
||||
NAME
|
||||
IQLI - Interaktives QL-Interface von DABA
|
||||
|
||||
BESCHREIBUNG
|
||||
Das interaktive QL-Interface (IQL) von DABA ist nach dem
|
||||
Aufruf von iql (iql(mutos)) verfuegbar.
|
||||
|
||||
In IQL stehen die Datenbanksprache QL, die Terminal-
|
||||
Monitor-Kommando-Unterstuetzung und die Makro-Unterstuetzung
|
||||
bereit.
|
||||
|
||||
Die Sprache QL wird durch das DBBS, die Terminal-Monitor-
|
||||
Kommandos und die Makros werden durch den Terminal-Monitor
|
||||
realisiert.
|
||||
|
||||
Fuer eine Einarbeitung ist zu empfehlen, sich zuerst mit den
|
||||
Terminal-Monitor-Kommandos und der QL-Sprache zu beschaefti-
|
||||
gen.
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
SIEHE AUCH
|
||||
ql(iql), monitor(iql), macros(iql), iql(mutos)
|
||||
|
|
@ -0,0 +1,614 @@
|
|||
MONITOR(IQL) DABA16 MONITOR(IQL)
|
||||
|
||||
NAME
|
||||
monitor - interaktiver Terminal-Monitor
|
||||
|
||||
BESCHREIBUNG
|
||||
Der Terminal-Monitor realisiert zusammen mit dem DBBS das
|
||||
interaktive Interface (Nutzeroberflaeche) IQL von DABA.
|
||||
|
||||
Der Monitor stellt einen Monitor-Puffer, die Terminal-
|
||||
Monitor-Kommando-Unterstuetzung und die Makrounterstuetzung
|
||||
(Makroprozessor) (macros(iql)) nach seinem Start bereit.
|
||||
Die von der Monitor-Kommando-Unterstuetzung verarbeiteten
|
||||
Monitor-Kommandos erlauben u.a. in Zusammenarbeit mit einem
|
||||
Editor und dem Makro-Prozessor die Manipulation des Inhaltes
|
||||
des Monitor-Puffers. Dieser manipulierte Inhalt wird dem
|
||||
DBBS als QL-Anfragenstapel uebergeben und von diesem ver-
|
||||
arbeitet. Ausserdem gestatten die Kommandos einen vorueber-
|
||||
gehenden Wechsel der interaktiven Umgebung (Shell bzw. Edi-
|
||||
tor).
|
||||
|
||||
Die Monitor-Kommandos gestatten in vom Nutzer vorgefertigten
|
||||
Kommandofiles (Monitor-Programme als Include-Files) eine Ab-
|
||||
laufsteuerung. Diese Files (aber auch Terminal-Eingaben) ko-
|
||||
ennen Monitor-Kommandos, Makro-Anweisungen und als wichtig-
|
||||
ste QL-Anweisungen (bzw. Text, aus dem mittels Makro-
|
||||
Substitution QL-Anweisungen erzeugt werden) enthalten.
|
||||
|
||||
Zusammenstellung der Monitor-Kommandos
|
||||
|
||||
Der Monitor-Puffer kann mit Monitor-Kommandos:
|
||||
|
||||
- geloescht (\reset, \r),
|
||||
- editiert (Aufruf eines Editors) (\editor, \edit, \ed,
|
||||
\e),
|
||||
- angezeigt (\list, \l oder \print, \p),
|
||||
- durch Terminal-Eingaben ersetzt (Eingabe nach \go
|
||||
und Autoloeschfunktion "ein")
|
||||
oder ergaenzt (Eingabe nach \append, \a oder \e, \l
|
||||
bzw. \p),
|
||||
- durch den Inhalt eines MUTOS-File ersetzt (\include,
|
||||
\read, \i)
|
||||
oder ergaenzt (\include, \read, \i nach \a, \l bzw.
|
||||
\p) bzw.
|
||||
- in ein MUTOS-File geschrieben (\write, \w)
|
||||
|
||||
werden.
|
||||
|
||||
Ausserdem gibt es Monitor-Kommandos fuer:
|
||||
|
||||
- die Flucht in eine MUTOS-Shell (\shell, \sh, \s),
|
||||
- den Ausgang aus DABA (\quit, \q),
|
||||
- die Verarbeitung eines sich im Puffer befindlichen
|
||||
Monitor-Makros durch den Makroprozessor (\eval, \v),
|
||||
- das Anzeigen von Uhrzeit und Datum (\date, \time, \d),
|
||||
- das Anzeigen von Komponentenbeschreibungen des Handbuches
|
||||
in Lang- oder Kurzform (\H bzw. \h),
|
||||
- das Aendern des Arbeits-Directory (\chdir, \cd),
|
||||
- das Setzen von Sprungmarken (\mark, \k),
|
||||
- das Verzweigen zu einer Sprungmarke (\branch, \b)
|
||||
(bedingt oder unbedingt),
|
||||
- die Uebergabe des Inhaltes des Monitor-Puffers (QL-
|
||||
Anfragenstapel) zur Verarbeitung durch das DBBS (\go, \g)
|
||||
- und zur Aenderung des Kommandokennzeichens (\monitor, \m).
|
||||
|
||||
|
||||
Nachrichten und Eingabe-Aufforderungen (Prompts)
|
||||
|
||||
Um den Nutzer ueber den Status des Monitors und des Anfragenpuf-
|
||||
fers zu informieren, gibt der Terminal-Monitor verschiedene Nach-
|
||||
richten aus.
|
||||
|
||||
Wenn DABA bereit ist, Eingaben zu akzeptieren, wird die Nachricht
|
||||
"DABA>" angezeigt. Das bedeutet, dass der Anfragenpuffer leer
|
||||
ist.
|
||||
|
||||
Die Nachricht "DABA:" erscheint, wenn der Anfragenpuffer nicht
|
||||
leer ist.
|
||||
|
||||
In jedem Falle wird der Nutzer durch einen Stern "*" (Prompt) auf
|
||||
der naechsten Zeile zur Eingabe aufgefordert.
|
||||
|
||||
Die Ausgaben "DABA>" bzw. "DABA:" und "*" werden bei einer "-s"-
|
||||
Option unterdrueckt.
|
||||
|
||||
Der Monitor schreibt den Eingabetext in den Monitor-Puffer, je
|
||||
nach eingestelltem Terminalmodus entweder sofort (cbreak-Modus)
|
||||
oder erst nach <nl> (echo-Modus), dann sind Korrekturen vor <nl>
|
||||
mit <kill> oder <erase> moeglich.
|
||||
Bei der Eingabe werden alle Zeichen mit Ausnahme von <tab>, <nl>
|
||||
und <escape>, die kleiner als oktal 040 sind, in Blanks konver-
|
||||
tiert, wobei die Warnung:
|
||||
|
||||
Zeichen 0xx konvertiert in Blank
|
||||
|
||||
erscheint.
|
||||
|
||||
|
||||
|
||||
|
||||
Nachdem die Eingabe in den Monitor-Puffer uebernommen wurde, kann
|
||||
sie dort nur noch durch \edit editiert oder der gesamte Puffer
|
||||
durch \reset geloescht werden.
|
||||
|
||||
Bei der Uebernahme der Eingabe in den Monitor-Puffer filtert der
|
||||
Terminal-Monitor die Monitor-Kommandos aus und fuehrt diese so-
|
||||
fort aus.
|
||||
|
||||
Das Monitor-Kommando \go (oder \g) uebergibt den Inhalt des
|
||||
Monitor-Puffers an den Parser des DBBS, der die QL-Anweisungen
|
||||
analysiert und zur Ausfuehrung weitergibt. Bei einer Bearbeitung
|
||||
der Anfrage (bzw. Anfragenstapels) erscheint die Meldung:
|
||||
|
||||
DABA . . .
|
||||
|
||||
(nicht bei "-s"-Flag), wodurch signalisiert wird, dass der Moni-
|
||||
tor auf die Beantwortung der Anfrage wartet.
|
||||
|
||||
Wird ein \edit- oder ein \shell-Kommando spezifiziert, erscheint
|
||||
die Nachricht:
|
||||
|
||||
>>"Aufrufparameter"
|
||||
|
||||
So ergeben z.B. die Eingaben "\ed", "\sh" und "\sh ls -l die
|
||||
Nachrichten ">>/bin/ed", ">>sh" und ">>ls -l". Im interaktiven
|
||||
Modus des Editors (Eingabe: "\edit") bzw. der Shell (Eingabe:
|
||||
"\sh") erscheinen anschliessend die Standard-Prompts dieser Pro-
|
||||
gramme.
|
||||
|
||||
Nach einem \go-Monitor-Kommando (oder \eval) wird der Anfragen-
|
||||
puffer standardmaessig (Autoloeschfunktion "ein") zur Loeschung
|
||||
vorgemerkt. Wenn unmittelbar anschliessend eine andere Anfrage
|
||||
eingegeben wird, erfolgt das Loeschen des Puffers. Es erfolgt
|
||||
nicht, wenn unmittelbar nach der Bearbeitung des Anfragenstapels
|
||||
(\go) bzw. nach \eval die Vormerkung zum Loeschen durch die Kom-
|
||||
mandos \append, \print, \list oder \edit aufgehoben wurde.
|
||||
|
||||
Nach der Eingabe:
|
||||
help teile
|
||||
\go
|
||||
print teile
|
||||
enthaelt der Anfragenpuffer:
|
||||
print teile
|
||||
Die Eingabe :
|
||||
help teile
|
||||
\go
|
||||
\print
|
||||
print teile
|
||||
ergibt als Inhalt des Anfragenpuffer :
|
||||
help teile
|
||||
print teile
|
||||
|
||||
Ist die Autoloeschfunktion ausgeschaltet ("aus"), wird jede neue
|
||||
Anfrage an den Inhalt des Monitor-Puffers angehangen, sodass vor
|
||||
einer Neueingabe der Puffer stets explizit mit dem \reset-
|
||||
Kommando zu loeschen ist.
|
||||
|
||||
Monitor-Kommandos
|
||||
|
||||
Ein Monitor-Kommando besteht aus dem Kommandopraefix (Standard:
|
||||
\), dem Namen des Monitor-Kommandos und wahlweisen Parametern als
|
||||
Argument des Kommandos. Zwischen diesen Bestandteilen sind als
|
||||
Trennzeichen entweder Leerzeichen oder Tabulatorzeichen erlaubt
|
||||
(nach Kommandopraefix) bzw. notwendig (ansonsten).
|
||||
|
||||
Einige Terminal-Monitor-Kommandos enthalten nach dem Kommandona-
|
||||
men bis zum Zeilenende ein Argument (u.U. aus mehreren Woertern)
|
||||
(z.B. Filenamen). Diese Kommandos duerfen auf der Zeile kein
|
||||
weiteres Kommando beinhalten. Die maximale ausgewertete Laenge
|
||||
des Argumentes dieser Kommandos betraegt 100 Byte. Es ist zu be-
|
||||
achten, dass das Argument dieser Kommandos ueber den Makro-
|
||||
Prozessor ausgewertet wird!
|
||||
|
||||
|
||||
|
||||
Kommandos ohne Parameter koennen auf der Zeile aneinandergereiht
|
||||
werden.
|
||||
|
||||
Durch
|
||||
\date\go\date
|
||||
wird die Zeit vor und nach der Ausfuehrung des Inhaltes des An-
|
||||
fragenpuffers angezeigt.
|
||||
Nachfolgend werden die Kommandos im Detail beschrieben, wobei al-
|
||||
le Kommandos keinen Parameter haben duerfen, bei denen er in der
|
||||
Erlaeuterung nicht erwaehnt wird.
|
||||
|
||||
\h
|
||||
\help Anzeige einer Komponenten-Kurzbeschreibung (Name als
|
||||
Parameter) bzw. der Kurzfassung des Inhaltsver-
|
||||
zeichnisses der Komponenten (ohne Parameter).
|
||||
|
||||
\H
|
||||
\HELP Anzeige einer Komponentenbeschreibung (Name als Para-
|
||||
meter) bzw. des Inhaltsverzeichnisses der Kompo-
|
||||
nenten (ohne Parameter).
|
||||
|
||||
\m
|
||||
\monitor Ersetzen des \-Zeichens (Monitor-Kommandopraefix)
|
||||
Ein Parameter ist das neue Terminal-Monitor-
|
||||
Kommandopraefix. Wenn er fehlt, wird der Standard
|
||||
(\) eingestellt.
|
||||
|
||||
Nach einer Neudefinition des Monitor-Praefixes
|
||||
sind u.U. bestehende Kommando-Files (Include-
|
||||
Files) nicht mehr abarbeitbar!
|
||||
|
||||
\r
|
||||
\reset Loeschen des Monitor-Puffers (Ruecksetzen des Anfra-
|
||||
genpuffers). Danach ist der Inhalt des Anfragen-
|
||||
puffers unwiederbringlich verloren.
|
||||
|
||||
\p
|
||||
\print Anzeigen des Anfragenpuffers. Der Inhalt des Anfra-
|
||||
genpuffers wird (ohne Veraenderung durch den
|
||||
Makro-Prozessor) am Terminal des Nutzers ange-
|
||||
zeigt.
|
||||
|
||||
\l
|
||||
\list Anzeigen des aktuellen Anfragenstapels, nach der
|
||||
Makro-Verarbeitung. Nebeneffekte bei der Arbeit
|
||||
des Makro-Prozessors, wie z.B. die Makro-
|
||||
Definition, werden ausgefuehrt. Dem Makroprozes-
|
||||
sor wird der Inhalt des Monitor-Puffers ueberge-
|
||||
ben, dem der Makro {begintrap} vorangestellt und
|
||||
der Makro {endtrap} nachgestellt werden. Damit
|
||||
wird dem Nutzer angezeigt, welcher Text dem Parser
|
||||
des DBBS bei einem \go-Kommandos uebergeben werden
|
||||
wuerde. Es ist zu beachten, dass bei wiederholter
|
||||
Anwendung durch die vorherige Definition von Sub-
|
||||
stitutionsmakros andere Ergebnisse auftreten ko-
|
||||
ennen.
|
||||
|
||||
\v
|
||||
\eval Der Makro-Prozessor verarbeitet den Anfragenpuffer und
|
||||
ersetzt seinen Inhalt durch das Ergebnis der
|
||||
Makro-Verarbeitung. Definierte Makros werden in
|
||||
die Makro-Tabelle des Makro-Prozessors uebernommen
|
||||
und sind damit aktiviert.
|
||||
|
||||
Im Unterschied zum \list-Kommando erfolgen kein
|
||||
Einbeziehen der Makros {begintrap} und {endtrap}
|
||||
und keine Anzeige am Terminal. Auf Standard-
|
||||
Output wirkende Ausgaben der Makros {dump}, {type}
|
||||
und {read...} werden ausgefuehrt.
|
||||
|
||||
Das \eval-Kommando ist das fuer die Abarbeitung
|
||||
von Funktionsmakros zu bevorzugende Kommando.
|
||||
|
||||
\e
|
||||
\ed
|
||||
\edit
|
||||
\editor Eintritt in einen der MUTOS-Text-Editoren (z.B. "ed"
|
||||
als Standard-Text-Editor). Wird "ed" benutzt, ist
|
||||
ein "w"- gefolgt von einem "q"-ed-Kommando ein-
|
||||
zugeben, um die Steuerung an DABA zurueckzugeben.
|
||||
Wird ein File-Name als Parameter spezifiziert, er-
|
||||
folgt ein Aufruf zum Editieren dieses File und
|
||||
nicht der Aufruf eines anderen Editors!
|
||||
Wurde in einem der Start-Files der Makro
|
||||
"{editor}" definiert, wird er benutzt, um den
|
||||
Pfadnamen eines spezifizierten Editors (z.B. "vi"
|
||||
oder "em") einzugeben. Standardmaessig (ohne
|
||||
"{editor}"-Makro) wird als Pfadname "/bin/ed" be-
|
||||
nutzt.
|
||||
|
||||
Innnerhalb des Editors darf kein "e"-
|
||||
Kommandoaufruf erfolgen. Wenn er irrtuemlich doch
|
||||
erfolgte, geht der Name des Anfragenpuffers ver-
|
||||
loren.
|
||||
|
||||
\g
|
||||
\go Verarbeitet die aktuelle Anfrage (Anfragenstapel). Der
|
||||
Inhalt des Puffers wird vom Makro-Prozessor ver-
|
||||
arbeitet, DABA uebergeben und ausgefuehrt. Bei
|
||||
den tupelorientierten QL-Anweisungen "retrieve",
|
||||
"replace", "append" und "delete" wird der Makro
|
||||
{tuplecount} mit der Anzahl der bearbeiteten Tupel
|
||||
definiert (an den Nutzer zurueckgegeben). Dem
|
||||
Parser wird vom Makro-Prozessor der Inhalt des Mo-
|
||||
nitorpuffers uebergeben, dem der Makro {begintrap}
|
||||
voran und der Makro {endtrap} nachgestellt werden.
|
||||
Es ist darauf zu achten, dass nach der Verarbei-
|
||||
tung durch den Makro-Prozessor, dem DBBS aus-
|
||||
schliesslich QL-Anweisungen uebergeben werden
|
||||
(u.U. Bereinigen des Puffers).
|
||||
|
||||
\a
|
||||
\append Anfuegen der folgenden Eingaben an den Anfragenpuf-
|
||||
fer. Nach Eingabe eines \a wird die automatische
|
||||
Loeschunterstuetzung des Anfragenpuffers (falls
|
||||
sie "ein" war) ausgeschaltet und damit der Anfra-
|
||||
genpuffer nicht zurueckgesetzt (kein reset).
|
||||
|
||||
\d
|
||||
\time
|
||||
\date Anzeigen der aktuellen Tageszeit und des Datums.
|
||||
|
||||
\s
|
||||
\sh
|
||||
\shell Flucht in eine MUTOS-Shell. Wurde der {shell}-Makro
|
||||
definiert, wird dieses Shell-Programm zur aktiven
|
||||
Shell. Wenn nicht, wird "/bin/sh" aktiv.
|
||||
|
||||
Der Aufruf des \shell-Monitor-Kommandos kann mit
|
||||
oder ohne Parameter erfolgen.
|
||||
|
||||
Ein Aufruf ohne Parameter startet die Shell inter-
|
||||
aktiv. Danach kann wie unter einer normalen, dem
|
||||
Terminal zugeordneten Shell gearbeitet werden, bis
|
||||
diese entsprechend den Konventionen (z.B.
|
||||
Control-z oder Control-d ) verlassen wird und eine
|
||||
Rueckkehr zum Monitor erfolgt.
|
||||
|
||||
Sind Parameter spezifiziert, werden diese als Auf-
|
||||
ruf eines einzigen MUTOS-Programmes (1.Parameter
|
||||
ist der Shell-Kommandoname (Filename des auszu-
|
||||
fuehrendes Files), die weiteren Parameter sind die
|
||||
dem Kommando zu uebergebenden Parameter) verstan-
|
||||
den, das unter Steuerung der aktiven Shell abzu-
|
||||
arbeiten ist. Anschliessend erfolgt automatisch
|
||||
die Rueckkehr zum Monitor. Wenn z.B. "\shell ls
|
||||
-l" spezifiziert wird, erfolgt die Anzeige des In-
|
||||
haltes des Arbeits-Directory in der Langform und
|
||||
anschliessend sofort die Rueckkehr zum Terminal-
|
||||
Monitor.
|
||||
|
||||
\q
|
||||
\quit Ausgang aus DABA (Verlassen des IQL-Interfaces).
|
||||
|
||||
\cd
|
||||
\chdir Aendern des Arbeits-Directory fuer den Monitor in ein
|
||||
benanntes Directory (Parameter).
|
||||
|
||||
\i
|
||||
\include
|
||||
\read Umschalten der Eingabe auf ein benanntes File (Parame-
|
||||
ter). Backslash-Zeichen im File (Include-File)
|
||||
werden wie bei der Eingabe vom Terminal behandelt.
|
||||
|
||||
Ohne Parameter wird die entsprechende Programmebe-
|
||||
ne verlassen. In der Basis-Terminal-Ebene ent-
|
||||
spricht die Wirkung dem \quit-Kommando.
|
||||
|
||||
Die maximale Schachtelungstiefe ist 5 (generie-
|
||||
rungsabhaengig).
|
||||
|
||||
Ist in einem Include-File ein \read-Kommando mit
|
||||
dem Zeichen "-" spezifiziert erfolgt die Meldung
|
||||
"<Eingabe>" und zwischenzeitlich (bis <EOF>) ist
|
||||
das Terminal die Eingabe. Anschliessend wird die
|
||||
Eingabe aus dem Include-File fortgesetzt.
|
||||
|
||||
|
||||
\w
|
||||
\write Schreiben des Inhaltes des Anfragenpuffers in ein be-
|
||||
nanntes File (Parameter). Der File-Modus eines
|
||||
neu erstellten Files ist oktal "0644".
|
||||
|
||||
\b
|
||||
\branch Springen (Verzweigen der Steuerung) bedingt (Frage-
|
||||
zeichen, Ausdruck und Marke als Parameter) oder
|
||||
unbedingt (Marke als Parameter) innerhalb eines
|
||||
Include-File (s.a. Abschnitt "Springen").
|
||||
|
||||
\k
|
||||
\mark Setzen einer Sprungmarke (Parameter). Diese ist die
|
||||
Zielangabe eines auszufuehrenden \branch-
|
||||
Kommandos.
|
||||
|
||||
\<irgendein anderes Zeichen>
|
||||
Ignoriert irgendeine spezielle Bedeutung des nach-
|
||||
folgenden Zeichens. Das erlaubt, das "\" als li-
|
||||
terales Zeichen einzugeben (ql(iql). Es ist wich-
|
||||
tig zu bemerken, dass Backslash-Folgen manchmal
|
||||
durch den Makro-Prozessors verloren gehen. Des-
|
||||
halb sind zwei Backslash zu schreiben, wenn einer
|
||||
zu senden ist.
|
||||
|
||||
Makros
|
||||
|
||||
Eine ganaue Beschreibung der Makros ist in (macros(iql)) zu
|
||||
finden.
|
||||
|
||||
Springen
|
||||
|
||||
Die \branch und \mark Kommandos erlauben ein beliebiges
|
||||
Springen innerhalb eines Include-File. Dem \mark Kommando
|
||||
muss eine Marke folgen. Dem \branch kann eine Marke folgen
|
||||
(entspricht einem unbedingten Sprung), oder es folgt ein
|
||||
Ausdruck, dem ein Fragezeichen ("?") vorangeht und eine Mar-
|
||||
ke folgt (bedingter Sprung). Der Sprung wird ausgefuehrt,
|
||||
wenn der Ausdruck groesser als Null ist.
|
||||
|
||||
Das Kommando :
|
||||
|
||||
\branch ?{tuplecount}<=0 notups
|
||||
|
||||
|
||||
|
||||
|
||||
verzweigt zur Marke "notups", wenn der Makro "{tuplecount}"
|
||||
kleiner oder gleich Null ist (keine relevanten Tupel).
|
||||
|
||||
Die Ausdruecke, die im \branch spezifizierbar sind, haben
|
||||
folgende Einschraenkungen.
|
||||
|
||||
Die Operatoren +, -, *, /, <=, >=, <, >, =, and != sind, wie
|
||||
ueblich definiert. Der linke, einstellige Operator "!" kann
|
||||
fuer eine logische Negation benutzt werden. Leerzeichen
|
||||
(Blanks) innerhalb des Ausdruckes sind nicht erlaubt, da ein
|
||||
Leerzeichen den Ausdruck beendet. Folgende Besonderheiten
|
||||
sind zu beachten:
|
||||
|
||||
- Ueberfluessige Endklammern werden ignoriert.
|
||||
|
||||
- Ueberfluessige Anfangsklammern ergeben Null aus
|
||||
Ausdruckswert.
|
||||
|
||||
- Ein leerer Ausdruck bekommt den Wert Null.
|
||||
|
||||
- Nur ein nicht akzeptiertes Zeichen als Ausdruck hat den
|
||||
Wert Null.
|
||||
|
||||
- Der Wert eines Zeichens, dass kein Operator ist wird Null.
|
||||
|
||||
- Die Division durch Null ergibt den Wert Null.
|
||||
|
||||
|
||||
Wenn das \branch-Kommando als Eingabetext vom Terminal ge-
|
||||
geben wurde, wird das abgelehnt ("Kein Sprung am Terminal").
|
||||
|
||||
Aus einem Include-File wird zuerst ein vorhandener Ausdruck
|
||||
ausgewertet und bei einem Wert groeser Null ein Sprung ver-
|
||||
sucht.
|
||||
|
||||
Wird eine Marke gefunden, wird mit der dieser Marke folgen-
|
||||
den Textposition die Eingabe des Textes fortgesetzt.
|
||||
|
||||
Ist keine Marke gefunden worden, wird, falls der Makro {de-
|
||||
fault} definiert wurde, zu dieser dort definierten Marke ge-
|
||||
sprungen.
|
||||
|
||||
Andernfalls wird eine Meldung ausgegeben ("? Label ...").
|
||||
|
||||
IQL-Start
|
||||
|
||||
Beim IQL-Start (iql(mutos)) wird zuerst eine bei allen
|
||||
DABA-MUTOS-Kommandos ausgefuehrte Startprozedur durchlaufen.
|
||||
Dabei wird auf das MUTOS-File /etc/passwd zugegriffen und
|
||||
der Eintrag des Nutzers "daba" gelesen. Aus diesem Eintrag
|
||||
wird der Pfadname des Home-Directory gemerkt. Mit diesem
|
||||
Pfadnamen (durch .../ gekennzeichnet) sind alle nachfolgen-
|
||||
den DABA-Files lokalisierbar. Mit dem Nutzercode des auf-
|
||||
rufenden Nutzers wird im File .../sys/etc/users ein Nutzer-
|
||||
eintrag gelesen. Ist ein solcher nicht vorhanden, ist der
|
||||
Nutzer nicht autorisiert DABA anzuwenden. Aus dem Nutzer-
|
||||
eintrag wird ermittelt, ob der Nutzer berechtigt ist, die
|
||||
spezifizierte Datenbank zu nutzen. Wenn ja, erfolgt eine
|
||||
Pruefung auf das Vorhandensein dieser Datenbank. Anschlies-
|
||||
send werden die spezifizierten Optionen (Flags) auf Gueltig-
|
||||
keit geprueft. Danach erfolgt entsprechend der Prozessta-
|
||||
belle im vorliegenden Falle das Laden des DBBS und des
|
||||
Terminal-Monitor-Programmes.
|
||||
|
||||
Initialisierung
|
||||
|
||||
Nach Ablauf der allgemeinen Startprozedur steht das DBBS zur
|
||||
Arbeit bereit, und es beginnt eine Startprozedur des
|
||||
Terminal-Monitors (Initialisierung), bevor dieser seinen Ar-
|
||||
beitszyklus beginnt.
|
||||
|
||||
Erstens werden vom Monitor-Programm die Makros {pathname},
|
||||
{usercode}, {database} und {tuplecount} (macros(iql)) defi-
|
||||
niert, sodass sie fuer die Nutzung bereitstehen.
|
||||
|
||||
Zweitens wird das allgemeine Initialisierungs- oder Start-
|
||||
File (startup(files)) gelesen und verarbeitet. Dieses File
|
||||
ist vorgesehen, um z.B. mittels Makrodefinitionen den fuer
|
||||
alle Nutzer anwendbaren Standard-Editor und die Standard-
|
||||
Shell zu definieren.
|
||||
|
||||
Ist im Nutzereintrag des Files "users" (users(files)) ein
|
||||
nutzerspezifisches Start-File (Standard-Filename: ".ql")
|
||||
spezifiziert, wird drittens dieses gelesen und verarbeitet.
|
||||
Diese File kann die speziellen Spezifikationen des Nutzers
|
||||
enthalten. So kann z.B. in diesem File ein nutzerspezifi-
|
||||
scher Editor bzw. eine Shell definiert werden. Es ist aber
|
||||
auch moeglich, mit den Spezifikationen vorbereitende nut-
|
||||
zerspezifische Arbeiten auszufuehren.
|
||||
|
||||
Am Ende der Initialisierung wird die Steuerung standardma-
|
||||
essig an das Nutzerterminal uebergeben.
|
||||
|
||||
Flags
|
||||
|
||||
Die Arbeitsweise des Terminal-Monitors wird durch folgende
|
||||
Optionen (Flags) beim Aufruf des interaktiven Interface IQL
|
||||
(iql(mutos)) gesteuert:
|
||||
|
||||
-d Anzeige (keine Anzeige) des Inhaltes des "dayfile" (day-
|
||||
file(files)) (Standard: Anzeige).
|
||||
-s Anzeige (keine Anzeige, "schweigendes Arbeiten") von
|
||||
Monitor-Nachrichten (Standard: Anzeige). Das -s
|
||||
Flag unterdrueckt alle Nachrichten (ausser Fehler-
|
||||
nachrichten) des Monitors, einschliesslich der
|
||||
Login- und Logout-Nachrichten sowie die Ausgabe
|
||||
des "dayfile"-Inhaltes (entspricht -d Flag "ein")
|
||||
und die Ausgabe der Eingabeaufforderungen
|
||||
(Prompts).
|
||||
-/+a Autoloeschfunktion (automatisches Loeschen des
|
||||
Terminal-Monitorpuffers) "aus" ("ein") (Standard:
|
||||
"ein"). Das -a Flag unterdrueckt die automatische
|
||||
Loeschfunktion (nach \go bzw. \eval), sodass der
|
||||
Anfragenpuffer nicht automatisch geloescht wird.
|
||||
Die Wirkung ist so, als wuerde stets ein \append
|
||||
nach jedem \go eingegeben werden.
|
||||
|
||||
Fuer den Nutzer bedeutet dies, dass vor jeder neu
|
||||
eingegebenen Anfrage der Anfragenpuffer explizit
|
||||
durch \reset geloescht werden muss.
|
||||
|
||||
Das -I Flag gestattet, zum IQL-Start ein Include-File einzuzie-
|
||||
hen. Wurde das -I Flag mit einem Filenamen spezifiziert, wird
|
||||
dieses File abgearbeitet, Standard-Input bleibt aber dem Terminal
|
||||
zugeordnet.
|
||||
|
||||
Standardmaessig arbeitet der Terminal-Monitor in der Basis-
|
||||
Terminal-Ebene (Eingaben von Standard-Input). Wenn ein Include-
|
||||
File eingezogen wurde, erfolgt die Arbeit des Terminal-Monitors
|
||||
durch das Include-File gesteuert, und das File ist die Quelle des
|
||||
Eingabetextes. Werden aus dem Include-File neue Include-Files
|
||||
eingezogen, kann das als neue Programmebene betrachtet werden.
|
||||
Der Ruecksprung in die uebergeordnete Programmebene erfolgt durch
|
||||
ein "include" ohne Operanden.
|
||||
|
||||
Erfolgte eine Fileumlenkung (Standard-Input einem File zugeord-
|
||||
net), werden alle Eingaben aus diesem File erwartet.
|
||||
|
||||
Die Ausgaben des Monitors erfolgen stets auf Standard-Output
|
||||
(i.allg. dem Terminal zugeordnet). Die Eingaben der Funktions-
|
||||
makros {read} und {readdefine} (macros(iql)) werden in allen Pro-
|
||||
grammebenen von Standard-Input erwartet.
|
||||
|
||||
Unterbrechungen
|
||||
|
||||
Wenn der Terminal-Monitor auf das Ende der Bearbeitung einer An-
|
||||
frage durch das DBBS wartet, besteht die Moeglichkeit, die Arbeit
|
||||
des DBBS durch ein Unterbrechungssignal (Control-c) zu unterbre-
|
||||
chen, um die Steuerung dem Monitor zuruueckzugeben. Achtung, bei
|
||||
der Bearbeitung von QL-Anweisungen, die die Datenbank veraendern,
|
||||
ist eine Unterbrechung nicht angebracht (obwohl das DBBS fuer
|
||||
"normale" Unterbrechungen nicht unterbrechbar ist)!
|
||||
|
||||
Eine Unterbrechung waehrend der Arbeit mit einem Include-File
|
||||
fuehrt zur Rueckkehr in die Basis-Terminal-Ebene.
|
||||
|
||||
Ein <EOF> in einer unter der Basis-Terminal-Ebene liegenden Pro-
|
||||
grammebene fuehrt zur Rueckkehr in die darueber liegenden Pro-
|
||||
grammebene. Ein <EOF> in der Basis-Terminal-Ebene entspricht dem
|
||||
\quit-Kommando.
|
||||
|
||||
Fehler
|
||||
|
||||
Die Kommandos \edit und \shell erfordern das Erzeugen eines neuen
|
||||
Prozesses (Betriebssystem-Kommandos "fork" und "exec") . Gelingt
|
||||
das nicht, erfolgen die Fehlermeldungen "edit: fork" bzw.
|
||||
"shell: fork". Gelingt es nicht, die in den Makros {editor} bzw.
|
||||
{shell} spezifizierten Programme zu laden, wird der Makro {error-
|
||||
cout} auf den Wert -1 gesetzt und der Makro {exectrap} ausge-
|
||||
fuehrt. Als Ergebnis werden die Fehlermeldungen "edit: exec"
|
||||
bzw. "shell: exec" ausgegeben.
|
||||
|
||||
|
||||
|
||||
|
||||
Liefern die Editor- bzw. Shell-Programme einen Rueckkehrwert ver-
|
||||
schieden von Null, wird der Makro {exectrap} ausgefuehrt.
|
||||
|
||||
Bei einem \go-Kommando kann die Fehlermeldung "go: open 1" aus-
|
||||
gegeben werden, wenn die Eroeffnung des Monitor-Puffers nicht ge-
|
||||
lingt.
|
||||
|
||||
Bei einer ueber der maximal zugelassenen Schachtelungstiefe er-
|
||||
folgenden \include-Kommando wird die Fehlermeldung "Mehr als 5
|
||||
INCLUDE'S" ausgegeben.
|
||||
|
||||
Wurde ein \write-Kommando spezifiziert koennen die Fehlermeldun-
|
||||
gen "unakzeptabler file name ..." und "create WRITE-file ..." er-
|
||||
scheinen.
|
||||
|
||||
SIEHE AUCH
|
||||
daba(mutos), macros(iql), ql(iql),
|
||||
|
||||
DIAGNOSE
|
||||
DABA> Eine neue Anfrage kann begonnen werden.
|
||||
|
||||
DABA: Die vorherige Anfrage ist beendet, jedo-
|
||||
ch enthaelt der Puffer einen Inhalt. Der
|
||||
Monitor besitzt wieder die Steuerung.
|
||||
|
||||
DABA . . . Die Anfrage wird von DABA bearbeitet.
|
||||
|
||||
>>ed Es wird im MUTOS-Text-Editor gearbeitet.
|
||||
|
||||
>>sh Es wird zwischenzeitlich in der MUTOS-
|
||||
Shell gearbeitet.
|
||||
|
||||
Zeichen 0xx konvertiert in Blank
|
||||
DABA hat ein nichtdruckbares ASCII-
|
||||
Zeichen (oktal 0xx) in Blank umgewan-
|
||||
delt. Diese Nachricht zeigt an, dass
|
||||
eine solche Konvertierung fuer das Zei-
|
||||
chen (0xx) erfolgte.
|
||||
FEHLERQUELLEN
|
||||
|
|
@ -0,0 +1,42 @@
|
|||
RC(MUTOS) DABA16 RC(MUTOS)
|
||||
|
||||
NAME
|
||||
rc - REPORT-Compiler
|
||||
|
||||
UEBERSICHT
|
||||
rc {[ flags ] file}
|
||||
|
||||
BESCHREIBUNG
|
||||
|
||||
Der Report-Compiler rc uebersetzt ein oder mehrere Report-
|
||||
Quell-Files in Report-Code-Files (uebersetzte Report-
|
||||
Anweisungen). Ein Report-Code-File wird zur Steuerung der
|
||||
Report-Generierung mit rg verwendet.
|
||||
|
||||
Das Quell-File enthaelt Report-Anweisungen und wahlweise
|
||||
Domaenen-Beschreibungen (z.B. durch rd (rd(mutos)) mit dem
|
||||
Flag -r erstellt). Ist letzteres der Fall, wird ein
|
||||
Domaenen-Beschreibungs-File erzeugt.
|
||||
|
||||
Flags:
|
||||
|
||||
-c Nur Uebersetzen, keine Codeerzeugung
|
||||
-i Eingabe von Standard-Input
|
||||
-l automatische Umwandlung der Klein- in Grossbuchstaben
|
||||
-o Ausgabe des Report-Code-Files r_code
|
||||
-s Unterdrueckung des Uebersetzungsprotokolls
|
||||
-v Ausgabe des Uebersetzungsprotokolls
|
||||
|
||||
BEISPIELE
|
||||
/* Uebersetze das Quell-File "pers_r" und
|
||||
erzeuge das Report-Code-File "r_code" */
|
||||
rc -o pers_r
|
||||
|
||||
SIEHE AUCH
|
||||
rp_desc(mutos), rg(mutos), rd(mutos), report(mutos),
|
||||
report(daba)
|
||||
|
||||
|
||||
DIAGNOSE
|
||||
Im Laufzeitprotokoll (auf Standard-Output) werden selbst-
|
||||
erklaerende Hinweise gegeben.
|
||||
|
|
@ -0,0 +1,43 @@
|
|||
RD(MUTOS) DABA16 RD(MUTOS)
|
||||
|
||||
NAME
|
||||
rd - Erstellen eines Domaenen-Beschreibungs-Files oder eines
|
||||
Reportskelettes
|
||||
|
||||
UEBERSICHT
|
||||
rd [ flags ] dbname relname [file]
|
||||
|
||||
BESCHREIBUNG
|
||||
|
||||
Rd erstellt ohne flags aus der Relation relname der Daten-
|
||||
bank dbname ein Domaenen-Beschreibungs(Description)-File.
|
||||
Fehlt der Parameter file (Ausgabe-File), wird der Name desc
|
||||
gewaehlt.
|
||||
|
||||
Bei Spezifikation eines -r Flags wird ein Skelett eines Re-
|
||||
portprogrammes erzeugt. Das ist ein Report-Quellcode-File,
|
||||
das sowohl die Domaenen-Beschreibung als auch das Skelett
|
||||
einiger Report-Quellcode-Anweisungen enthaelt.
|
||||
|
||||
Flags:
|
||||
|
||||
-o Ausgabe auf Standard-Output (anstelle eines Files)
|
||||
-r Ausgabe eines Skelett-Reportprogramms einschliesslich der
|
||||
Domaenen-Beschreibungen. Fehlt das Argument file wird
|
||||
der Name report gewaehlt.
|
||||
|
||||
SIEHE AUCH
|
||||
rc(mutos), rp_desc(mutos), rg(mutos), report(mutos),
|
||||
report(daba)
|
||||
|
||||
BEISPIELE
|
||||
rd dt personal
|
||||
|
||||
rd -o dt teile > teile_d
|
||||
|
||||
rd dt teile teile_d
|
||||
|
||||
/*Reportskelett*/
|
||||
rd -r dt personal
|
||||
|
||||
rd -r dt personal pers_r
|
||||
File diff suppressed because it is too large
Load Diff
|
|
@ -0,0 +1,80 @@
|
|||
RETRIEVE(QL) DABA16 RETRIEVE(QL)
|
||||
|
||||
NAME
|
||||
retrieve - Wiederfinden (Suchen) von Tupel aus einer Rela-
|
||||
tion
|
||||
|
||||
UEBERSICHT
|
||||
retrieve [into relname ] (target_list) [where qual ]
|
||||
|
||||
retrieve unique (target_list) [where qual ]
|
||||
|
||||
BESCHREIBUNG
|
||||
Retrieve stellt alle Tupel bereit, die die Qualifikation er-
|
||||
fuellen und zeigt sie entweder am Terminal (Standardausgabe)
|
||||
an oder speichert sie in eine neue Relation. Wurde into mit
|
||||
relname nicht spezifiziert, werden doppelte Tupel nicht aus-
|
||||
geblendet. Wenn relname spezifiziert wurde, wird das Ergeb-
|
||||
nis der Anfrage mit diesem Namen in eine neue Relation ge-
|
||||
speichert.
|
||||
|
||||
Eine Relation mit diesem Namen und dem Anwender als
|
||||
Relations-Eigentuemer darf nicht bereits existieren. Der
|
||||
retrieve Anwender wird zum Eigentuemer der neuen Relation.
|
||||
Die Relation wird die Domaenen-Namen besitzen, die in der
|
||||
target_list als result_attnames spezifiziert wurden. Die
|
||||
neue Relation wird vom System fuer sieben Tage geschuetzt,
|
||||
falls der Nutzer nicht explizit durch eine save Anweisung
|
||||
das Schutzdatum der Relation verlaengert.
|
||||
|
||||
Wenn das Schluesselwort unique spezifiziert wird, werden die
|
||||
Tupel nach der Reihenfolge der angegebenenen Domaenen sor-
|
||||
tiert und doppelte Tupel vor der Anzeige entfernt.
|
||||
|
||||
|
||||
Das Schluesselwort all kann benutzt werden, um alle Domaenen
|
||||
wiederzufinden.
|
||||
|
||||
Wenn kein Ergebnis-Relations-Name relname spezifiziert wur-
|
||||
de, wird das Ergebnis der Anfrage am Terminal angezeigt und
|
||||
nicht gespeichert. Doppelte Tupel werden bei einer Anzeige
|
||||
am Terminal nicht entfernt.
|
||||
|
||||
Das Format, in dem die Domaenen angezeigt werden, kann zum
|
||||
Zeitpunkt des iql-Aufrufes definiert werden (iql(mutos)).
|
||||
|
||||
Wenn eine Ergebnis-Relation spezifiziert wurde, erfolgt
|
||||
standardmaessig eine Modifikation der Ergebnis-Relation in
|
||||
die Speicherungsstruktur "cheapsort", wobei doppelte Tupel
|
||||
entfernt werden.
|
||||
|
||||
Wenn die Standardstruktur "cheapsort" nicht gewuenscht wird,
|
||||
kann der Nutzer zum Zeitpunkt des iql-Aufrufes diese Stan-
|
||||
dardannahme mit dem -r Flag ueberschreiben (iql(mutos)).
|
||||
|
||||
Nur der Relations-Eigentuemer und Anwender mit retrieve Be-
|
||||
fugnis koennen die Anweisung nutzen.
|
||||
|
||||
|
||||
BEISPIEL[E]
|
||||
/* Finde alle Beschaeftigten, die mehr als ihr
|
||||
Leiter verdienen */
|
||||
|
||||
range of p is personal
|
||||
range of l is personal
|
||||
retrieve (p.name) where p.leiter = l.name
|
||||
and p.gehalt > l.gehalt
|
||||
|
||||
/* Finde alle Domaenen fuer Personen,
|
||||
die mehr als das Durchschnittsgehalt verdienen */
|
||||
|
||||
retrieve into temp (p.all) where p.gehalt > avg(p.gehalt)
|
||||
|
||||
/* Wiederfinden der Beschaeftigtennamen, sortiert */
|
||||
|
||||
retrieve unique (p.name)
|
||||
|
||||
SIEHE AUCH
|
||||
iql(mutos), modify(ql), permit(ql), ql(iql), range(ql),
|
||||
save(ql)
|
||||
FEHLERQUELLEN
|
||||
|
|
@ -0,0 +1,41 @@
|
|||
RP_DESC(MUTOS) DABA16 RP_DESC(MUTOS)
|
||||
|
||||
NAME
|
||||
rp_desc - Drucken eines Domaenen-Beschreibungs-Files
|
||||
|
||||
UEBERSICHT
|
||||
rp_desc [desc-file]
|
||||
|
||||
BESCHREIBUNG
|
||||
Der Parameter desc-file muss angegeben werden, wenn der
|
||||
Standard-File-Name desc nicht zutrifft.
|
||||
|
||||
|
||||
Rp_desc druckt ein Domaenen-Beschreibungs-File, das durch rd
|
||||
(rd(mutos)) oder rc (rc(mutos)) aus einem Report-Quellcode-
|
||||
File einschliesslich Domaenen-Beschreibung erzeugt wurde, in
|
||||
lesbarer Form.
|
||||
|
||||
Dieses File enthaelt eine Tabelle, die die Beschreibung der
|
||||
Domaenen eines Tupels darstellt und vom Report-Generator zur
|
||||
Lokalisation der Domaenen eines Tupel benutzt wird.
|
||||
|
||||
In der Tabelle beschreibt jede Zeile eine Domaene. Die
|
||||
Spalten enthalten die Domaenenreihenfolge (mit 1 beginnend),
|
||||
den Domaenentyp, die Domaenenlaenge und die Verschiebung
|
||||
(Offset, mit 0 beginnend) der Domaene vom Tupelanfang.
|
||||
|
||||
BEISPIELE
|
||||
rp_desc pers_d
|
||||
rp_desc > beispiel
|
||||
cat beispiel
|
||||
|
||||
| field | type | len | off |
|
||||
|~~~~~~~|~~~~~~~|~~~~~~~|~~~~~~~|
|
||||
| | | | |
|
||||
| | | | |
|
||||
|~~~~~~~|~~~~~~~|~~~~~~~|~~~~~~~|
|
||||
| | | | |
|
||||
|
||||
SIEHE AUCH
|
||||
rc(mutos), rd(mutos), rg(mutos), report(mutos), report(daba)
|
||||
|
|
@ -0,0 +1,379 @@
|
|||
KOMPONENTENUEBERSICHT(DABA) DABA16 KOMPONENTENUEBERSICHT(DABA)
|
||||
|
||||
AMXI(DABA) - Einbettung der Datenmanipulationssprache AMX in
|
||||
"C"
|
||||
|
||||
|
||||
EQL(DABA) - Eingebettetes QL-Interface
|
||||
|
||||
|
||||
IQLI(DABA) - Interaktives QL-Interface von DABA
|
||||
|
||||
|
||||
REPORTI(DABA) - Reportunterstuetzung
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
KOMPONENTENUEBERSICHT(IQL) DABA16 KOMPONENTENUEBERSICHT(IQL)
|
||||
|
||||
MACROS(IQL) - Makro-Unterstuetzung des Terminal-Monitors
|
||||
|
||||
|
||||
MONITOR(IQL) - interaktiver Terminal-Monitor
|
||||
|
||||
|
||||
QL(IQL) - DABA-Anfragesprache (Query Language)
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
KOMPONENTENUEBERSICHT(QL) DABA16 KOMPONENTENUEBERSICHT(QL)
|
||||
|
||||
APPEND(QL) - Anfuegen (Einfuegen) neuer Tupel an die Rela-
|
||||
tion
|
||||
|
||||
append [to] relname (target_list) [where qual]
|
||||
|
||||
COPY(QL) - Kopieren von Daten zwischen Relation und MUTOS-
|
||||
File
|
||||
|
||||
copy relname (domname = format {, domname = format })
|
||||
|
||||
direction "filename"
|
||||
|
||||
CREATE(QL) - Erstellen einer neuen Relation
|
||||
|
||||
create relname (domname1 = format {, domname2 = format
|
||||
})
|
||||
|
||||
DEFINE(QL) - Definieren Sicht, Befugnisse oder Integritaets-
|
||||
bedingungen
|
||||
|
||||
define view name (target_list) [ where qual ]
|
||||
|
||||
define permit oplist on tuple_variable [ (attlist) ] to
|
||||
name [ at term ] [ from time to time ]
|
||||
[ on day to day ] [ where qual ]
|
||||
|
||||
define integrity on tuple_variable is qual
|
||||
|
||||
DELETE(QL) - Loeschen von Tupel aus einer Relation
|
||||
|
||||
delete tuple_variable [where qual]
|
||||
|
||||
DESTROY(QL) - Zerstoeren einer bestehenden Relation
|
||||
|
||||
destroy relname { , relname }
|
||||
|
||||
destroy [ permit | integrity ] relname
|
||||
[ integer { , integer } | all ]
|
||||
|
||||
HELP(QL) - Anzeigen von Nutzungs- oder Datenbank-
|
||||
Informationen
|
||||
|
||||
help [ relname ] [ "[komponentenname]" ]
|
||||
{, relname}{, "[komponentenname]"}
|
||||
|
||||
help view relname {, relname}
|
||||
|
||||
help permit relname {, relname}
|
||||
|
||||
help integrity relname {, relname}
|
||||
|
||||
INDEX(QL) - Erstellen eines Sekundaerindex ueber eine Rela-
|
||||
tion
|
||||
|
||||
index on relname is indexname (domain1 { ,domain2 })
|
||||
|
||||
MODIFY(QL) - Modifizieren der Speicherungsstruktur einer Re-
|
||||
lation
|
||||
|
||||
modify relname [ to storage_structure [ on key1
|
||||
[ : sortorder ] { , key_n [ : sortorder ] } ]
|
||||
[ where [ fillfactor = n ]
|
||||
[ , minpages = n ] [ , maxpages = n ] ] ]
|
||||
|
||||
PERMIT(QL) - Zufuegen von Befugnissen zu einer Relation
|
||||
|
||||
define permit oplist on tuple_variable [ (attlist) ]
|
||||
|
||||
to name [ at term ] [ from time to time ]
|
||||
|
||||
[ on day to day ] [ where qual ]
|
||||
|
||||
PRINT(QL) - Drucken von Relationen
|
||||
|
||||
print relname {, relname}
|
||||
|
||||
RANGE(QL) - Deklarieren einer Variablen (Tupelvariablen) ue-
|
||||
ber einer Relation
|
||||
|
||||
range [ [ of ] tuple_variable is relname ]
|
||||
|
||||
REPLACE(QL) - Ersetzen von Domaenen-Werten in einer Relation
|
||||
|
||||
replace tuple_variable (target_list) [where qual]
|
||||
|
||||
RETRIEVE(QL) - Wiederfinden (Suchen) von Tupel aus einer Re-
|
||||
lation
|
||||
|
||||
retrieve [[into] relname ] (target_list) [where qual ]
|
||||
|
||||
retrieve unique (target_list) [where qual ]
|
||||
|
||||
SAVE(QL) - Verlaengern des Schutzdatums einer Relation
|
||||
|
||||
save relname until month day year
|
||||
|
||||
VIEW(QL) - Definieren einer Sicht (virtuellen Relation)
|
||||
|
||||
define view name (target_list) [ where qual ]
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
KOMPONENTENUEBERSICHT(MUTOS) DABA16 KOMPONENTENUEBERSICHT(MUTOS)
|
||||
|
||||
AMX(MUTOS) - AMX-Compiler
|
||||
|
||||
amx [ flags ] file.x
|
||||
|
||||
amxf [ flags ] file.x
|
||||
|
||||
samx [ flags ] file.x
|
||||
|
||||
oamx [ flags ] file.x
|
||||
|
||||
oamxf [ flags ] file.x
|
||||
|
||||
COPYDB(MUTOS) - Kopieren einer Datenbank
|
||||
|
||||
copydb [ -uname ] dbname directory { relname }
|
||||
|
||||
COPYR(MUTOS) - Kopieren von Daten zwischen Relation und
|
||||
MUTOS-File
|
||||
|
||||
copyr [ flags ] dbname relname { domname format })
|
||||
into/from file
|
||||
|
||||
CREATDB(MUTOS) - Erstellen einer Datenbank
|
||||
|
||||
creatdb [ -uname ] [ -e ] [ -m ] [ -/+c ]
|
||||
[ -/+q ] [ -1 | -2 | -4 | -8 ] dbname
|
||||
|
||||
|
||||
CREATER(MUTOS) - Erstellen einer neuen Relation
|
||||
|
||||
creater [ flags ] dbname relname { domname format }
|
||||
|
||||
DESTROYDB(MUTOS) - Zerstoeren einer bestehenden Datenbank
|
||||
|
||||
destroydb [ -s ] [ -m ] dbname
|
||||
|
||||
DESTROYR(MUTOS) - Zerstoeren einer bestehenden Relation
|
||||
|
||||
destroyr [ flags ] dbname { [ permit | integrity ] rel-
|
||||
name [ integer { , integer } | all ] }
|
||||
|
||||
EQC(MUTOS) - Aufruf des EQL-Praecompilers
|
||||
|
||||
eqc [ -d ] [ -f ] [ -r ] file.q {file.q}
|
||||
|
||||
HELPR(MUTOS) - Anzeigen von Informationen ueber die Relatio-
|
||||
nen der Datenbank
|
||||
|
||||
helpr [ flags ] dbname [ [ integrity | permit | view ]
|
||||
{relname} | all ]
|
||||
|
||||
INDEXR(MUTOS) - Erstellen eines Sekundaerindex ueber eine
|
||||
Relation
|
||||
|
||||
indexr [ flags ] dbname prim_rel index_rel { domname }
|
||||
|
||||
IQL (MUTOS) - Aufruf des interaktiven Ql-Interface des DBBS
|
||||
DABA16
|
||||
|
||||
iql [ flags ] dbname [ process_table ]
|
||||
|
||||
MANR(MUTOS) - Anzeigen der Komponentenbeschreibungen
|
||||
|
||||
manr {komponentenname}
|
||||
|
||||
MODIFYR(MUTOS) - Modifizieren der
|
||||
|
||||
modifyr [ flags ] dbname relname [ storage_strukture
|
||||
{ domname [ :sortorder ] } ]
|
||||
|
||||
PRINTR(MUTOS) - Drucken von Relationen
|
||||
|
||||
printr [ flags ] dbname { relname }
|
||||
|
||||
PURGE(MUTOS) - Zerstoeren verfallener und temporaerer Rela-
|
||||
tionen
|
||||
|
||||
purge [ -f ] [ -p ] [ -a ] [ -s ] [ -w ] { dbname }
|
||||
|
||||
RC(MUTOS) - REPORT-Compiler
|
||||
|
||||
rc {[ flags ] file}
|
||||
|
||||
RD(MUTOS) - Erstellen eines Domaenen-Beschreibungs-Files
|
||||
oder eines Reportskelettes
|
||||
|
||||
rd [ flags ] dbname relname [file]
|
||||
|
||||
REFR(MUTOS) - Anzeige einer Komponenten-Kurzbeschreibung
|
||||
|
||||
refr { komponentenname }
|
||||
|
||||
REPORT MUTOS() - DABA-Reportunterstuetzung
|
||||
|
||||
|
||||
rc {[ flags ] file }
|
||||
|
||||
rd [ flags ] dbname [ file ]
|
||||
|
||||
rg [ flags ]
|
||||
|
||||
rp_desc [ desc_file ]
|
||||
|
||||
|
||||
RESTORE(MUTOS) - Wiederherstellen nach einem DBBS- oder
|
||||
MUTOS-Absturz
|
||||
|
||||
restore [ -s ] [ -a ] [ -f ] [ +/-p ] [ +/-w ]
|
||||
[ -S ] [ -P ] { dbname }
|
||||
|
||||
RG(MUTOS) - REPORT-Generator (Interpreter)
|
||||
|
||||
rg [ flags ]
|
||||
|
||||
RP_DESC(MUTOS) - Drucken eines Domaenen-Beschreibungs-Files
|
||||
|
||||
rp_desc [desc-file]
|
||||
|
||||
SAVER(MUTOS) - Verlaengern des Schutzdatums einer Relation
|
||||
|
||||
saver [ flags ] dbname relname month day year
|
||||
|
||||
SYSMOD(MUTOS) - Modifizieren (Optimieren) der Systemrelatio-
|
||||
nen
|
||||
|
||||
sysmod [ flags ] dbname { relname }
|
||||
|
||||
USERSETUP(MUTOS) - Erstelle Nutzer-File
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
KOMPONENTENUEBERSICHT(FILES) DABA16 KOMPONENTENUEBERSICHT(FILES)
|
||||
|
||||
DAYFILE(FILES) - DABA-Login-Nachrichten
|
||||
|
||||
|
||||
DBTMPLT(FILES) - Datenbank-Spezifikation(Template)
|
||||
|
||||
|
||||
ERROR(FILES) - Files mit DABA-Fehlernachrichten
|
||||
|
||||
|
||||
LIBAMX(FILES) - AMX-Laufzeit-Bibliothek
|
||||
|
||||
|
||||
LIBQ(FILES) - EQL Laufzeit-Bibliothek
|
||||
|
||||
|
||||
STARTUP(FILES) - DABA-Start-File
|
||||
|
||||
|
||||
USERS(FILES) - DABA-Nutzerverzeichnis
|
||||
|
||||
|
||||
|
||||
|
||||
KOMPONENTENUEBERSICHT(ERROR) DABA16 KOMPONENTENUEBERSICHT(ERROR)
|
||||
|
||||
EINFUEHRUNG(ERROR) - Einfuehrung in die Fehlernachrichten
|
||||
|
||||
|
||||
PARSER(ERROR) - Zusammenstellung der Parser-
|
||||
Fehlernachrichten
|
||||
|
||||
Fehlernummern 2000 - 2999.
|
||||
|
||||
QRYMOD(ERROR) - Zusammenstellung der Fehlernachrichten der
|
||||
Anfragenmodifikation
|
||||
|
||||
Fehlernummern 3000 - 3999.
|
||||
|
||||
OVQP(ERROR) - Zusammenstellung der Fehlernachrichten des
|
||||
Ein-Variablen-Anfragenprozessors
|
||||
|
||||
Fehlernummern 4000 - 4499.
|
||||
|
||||
DECOMP(ERROR) - Zusammenstellung der Fehlernachrichten der
|
||||
Dekomposition
|
||||
|
||||
Fehlernummern 4500 - 4999.
|
||||
|
||||
DBU(ERROR) - Zusammenstellung der Fehlernachrichten der Da-
|
||||
tenbankdienste
|
||||
|
||||
Fehlernummern 5000 - 5999
|
||||
|
|
@ -0,0 +1,27 @@
|
|||
RP_DESC(MUTOS) DABA16 RP_DESC(MUTOS)
|
||||
|
||||
NAME
|
||||
rp_desc - Drucken eines Domaenen-Beschreibungs-Files
|
||||
|
||||
UEBERSICHT
|
||||
rp_desc [desc-file]
|
||||
|
||||
BESCHREIBUNG
|
||||
Der Parameter desc-file muss angegeben werden, wenn der
|
||||
Standard-File-Name desc nicht zutrifft.
|
||||
|
||||
|
||||
BEISPIELE
|
||||
rp_desc pers_d
|
||||
rp_desc > beispiel
|
||||
cat beispiel
|
||||
|
||||
| field | type | len | off |
|
||||
|~~~~~~~|~~~~~~~|~~~~~~~|~~~~~~~|
|
||||
| | | | |
|
||||
| | | | |
|
||||
|~~~~~~~|~~~~~~~|~~~~~~~|~~~~~~~|
|
||||
| | | | |
|
||||
|
||||
SIEHE AUCH
|
||||
rc(mutos), rd(mutos), rg(mutos), report(mutos), report(daba)
|
||||
|
|
@ -0,0 +1,22 @@
|
|||
SAVE(QL) DABA16 SAVE(QL)
|
||||
|
||||
NAME
|
||||
save - Verlaengern des Schutzdatums einer Relation
|
||||
|
||||
UEBERSICHT
|
||||
save relname until month day year
|
||||
|
||||
BESCHREIBUNG
|
||||
Save wird benutzt, um das Schutzdatum ueber die standard-
|
||||
maessigen 7 Tage hinaus zu verlaengern.
|
||||
|
||||
month ist der Monat (1,2,...12), day der Tag (1,2,3...) und
|
||||
year das Jahr (...1988,1989...).
|
||||
|
||||
|
||||
BEISPIEL[E]
|
||||
/* Schuetzen der Relation "personal" bis Ende Februar 1987 */
|
||||
save personal until 2 28 1987
|
||||
|
||||
SIEHE AUCH
|
||||
create(ql), purge(mutos), retrieve(ql), saver(mutos)
|
||||
|
|
@ -0,0 +1,20 @@
|
|||
SAVER(MUTOS) DABA16 SAVER(MUTOS)
|
||||
|
||||
NAME
|
||||
saver - Verlaengern des Schutzdatums einer Relation
|
||||
|
||||
UEBERSICHT
|
||||
saver [ flags ] dbname relname month day year
|
||||
|
||||
BESCHREIBUNG
|
||||
Die Aussagen zu save(ql) gelten auch fuer saver(mutos).
|
||||
|
||||
Sie sind jedoch um Folgendes zu ergaenzen:
|
||||
|
||||
Flags:
|
||||
|
||||
-uname erlaubt es, sich als Nutzer mit dem Login-Namen
|
||||
name auszugeben (iql(mutos)).
|
||||
|
||||
+/-w Warten oder kein Warten auf die Nutzbarkeit
|
||||
der Datenbank dbname (iql(mutos)).
|
||||
|
|
@ -0,0 +1,19 @@
|
|||
STARTUP(FILES) DABA16 STARTUP(FILES)
|
||||
|
||||
NAME
|
||||
.../sys/etc/startup - DABA-Start-File
|
||||
|
||||
BESCHREIBUNG
|
||||
Dieses File wird durch den DABA-Terminal-Monitor zum Login-
|
||||
Zeitpunkt gelesen. Es wird vor dem Start-File gelesen, das
|
||||
im File "users" spezifiziert werden kann. Der Hauptzweck
|
||||
besteht darin, einen neuen Standard-Editor und/oder eine
|
||||
Standard-Shell fuer den Aufruf durch das \e oder das \s
|
||||
Monitor-Kommando zu definieren.
|
||||
|
||||
Diese Spezifikationen sind Standard-Spezifikationen und gel-
|
||||
ten fuer alle Nutzer. Durch Spezifikationen des File
|
||||
"users" koennen sie ueberschrieben werden.
|
||||
|
||||
SIEHE AUCH
|
||||
monitor(iql), users(files)
|
||||
|
|
@ -0,0 +1,33 @@
|
|||
SYSMOD(MUTOS) DABA16 SYSMOD(MUTOS)
|
||||
|
||||
NAME
|
||||
sysmod - Modifizieren (Optimieren) der Systemrelationen
|
||||
|
||||
UEBERSICHT
|
||||
sysmod [ flags ] dbname { relname }
|
||||
|
||||
BESCHREIBUNG
|
||||
Sysmod modifiziert die relation-, attribute-, integrities-,
|
||||
protect-, tree-, references- und indexes- Systemrelationen
|
||||
in optimale Speicherungsstrukturen, wenn nicht wenigstens
|
||||
einer der Parameter relation, attribute, integrities, pro-
|
||||
tect, tree, references, oder indexes fuer die Systemrelatio-
|
||||
nen relname spezifiziert wurde. Wurden diese Parameter an-
|
||||
gegeben, werden nur die entsprechenden Systemrelationen mo-
|
||||
difiziert.
|
||||
Die Systemrelationen werden so modifiziert, dass eine maxi-
|
||||
male Zugriffsleistung bei der Nutzung von DABA erreicht
|
||||
wird.
|
||||
Der Anwender muss der Datenbankadministrator (DBA) der spe-
|
||||
zifizierten Datenbank oder der DABA-Systemverantwortliche
|
||||
(Verwendung des -s Flags) sein.
|
||||
|
||||
Sysmod sollte abgearbeitet werden, wenn die Datenbank er-
|
||||
stellt wurde. Danach sollte es periodisch angewendet wer-
|
||||
den, um eine groesstmoegliche Zugriffsleistung zu erhalten.
|
||||
Wenn einige Relationen und Sekundaerindizes erstellt
|
||||
und/oder zerstoert wurden, ist sysmod des oefteren abzuar-
|
||||
beiten.
|
||||
|
||||
SIEHE AUCH
|
||||
modify(ql), modifyr(mutos), restore(mutos)
|
||||
|
|
@ -0,0 +1,13 @@
|
|||
|
||||
toc range eqc restore
|
||||
append replace helpr rg
|
||||
copy retrieve indexr rp_desc
|
||||
create save iql saver
|
||||
define view manr sysmod
|
||||
delete amx modifyr usersetup
|
||||
destroy copydb printr dayfile
|
||||
help copyr purge error
|
||||
index creatdb rc startup
|
||||
integrity creater rd users
|
||||
modify destroydb refr
|
||||
print destroyr report
|
||||
|
|
@ -0,0 +1,59 @@
|
|||
USERS(FILES) DABA16 USERS(FILES)
|
||||
|
||||
NAME
|
||||
.../sys/etc/users - DABA-Nutzerverzeichnis
|
||||
|
||||
BESCHREIBUNG
|
||||
Dieses File enthaelt die Nutzerinformationen in Feldern, die
|
||||
durch den Doppelpunkt separiert werden. Es gibt folgende
|
||||
Felder:
|
||||
|
||||
0. Nutzername, direkt entnommen aus dem /etc/passwd File.
|
||||
1. Nutzercode, zugeordnet durch den DABA-
|
||||
Systemverantwortlichen. Es muss ein eindeutiger Code
|
||||
aus zwei Zeichen(Character) sein.
|
||||
2. MUTOS-Nutzeridentifikator. Er muss mit dem Eintrag im
|
||||
File /etc/passwd -ubereinstimmen.
|
||||
3. MUTOS-Gruppenidentifikator (gleiche Bemerkung).
|
||||
4. Statuswort in oktaler Darstellung. Erlaubte Bit-Werte
|
||||
sind:
|
||||
|
||||
0000001 creatdb
|
||||
Befugnis zur Erzeugung von Datenbanken
|
||||
0000002 direct update
|
||||
Befugnis zum Ueberschreiben der Stapelaenderung
|
||||
(Aenderund des Hintergrundes).
|
||||
0000004 update os system catalogs
|
||||
Befugnis zum Aendern der Systemkataloge
|
||||
0000020 trace flag
|
||||
Befugnis zur Benutzung der Trace-Flags
|
||||
0000100 proctabs
|
||||
Befugnis zur Benutzung der Prozesstabellen
|
||||
0000200 =proctab form
|
||||
Berechtigung zur Benutzung von undefinierten
|
||||
Prozesstabellen der Form "=file"
|
||||
(file ist eine Prozesstabelle im Verzeichnis
|
||||
.../sys/etc).
|
||||
0100000 DABA superuser
|
||||
Kennzeichen des DABA-Systemverantwortlicher
|
||||
|
||||
5. Eine Liste von automatisch gesetzter Flags fuer diesen
|
||||
Nutzer.
|
||||
6. Die fuer diesen Nutzer anwendbare Prozesstabelle.
|
||||
7. Ein Initialisierungs-File, das durch den DABA-Terminal-
|
||||
Monitor zum Login-Zeitpunkt gelesen wird.
|
||||
8. Kommentarfeld.
|
||||
9. Komma separierte Liste von Datenbanken. Wenn die Liste
|
||||
nicht vorhanden ist, kann der Nutzer jede Datenbank be-
|
||||
nutzen. Wenn sie mit einem "-" beginnt, kann der Nutzer
|
||||
jede Datenbank, ausser den nachfolgend spezifizierten
|
||||
benutzen. Andernfalls kann der Nutzer nur die spezifi-
|
||||
zierten Datenbanken benutzen.
|
||||
|
||||
WARNUNG: Das Erteilen der Befugnis, spezielle Prozesstabel-
|
||||
len zu benutzen, ist gleichbedeutend mit dem Ausschalten des
|
||||
Schutzsystems fuer diesen Nutzer.
|
||||
|
||||
BEISPIEL[E]
|
||||
daba:aa:5:2:177777:-d:=special:/mnt/daba/.ql::
|
||||
gast:ah:35:1:000000:::::demo.gast
|
||||
|
|
@ -0,0 +1,53 @@
|
|||
USERSETUP(MUTOS) DABA16 USERSETUP(MUTOS)
|
||||
|
||||
NAME
|
||||
usersetup - Erstelle Nutzer-File
|
||||
|
||||
UEEBERSICHT
|
||||
usersetup [ - ]
|
||||
|
||||
BESCHREIBUNG
|
||||
Das /etc/passwd File wird gelesen und zur Erstellung des
|
||||
DABA-Nutzer-Verzeichnis verwendet, das in ...sys/etc/users
|
||||
abgelegt ist. Wenn das Flag - gesetzt wird, wird das Ergeb-
|
||||
nis nach Standardoutput geschrieben.
|
||||
|
||||
Die Struktur des DABA-Nutzer-Files ist in users(files) be-
|
||||
schrieben. Der Nutzername, sowie die Nutzer- und Gruppeni-
|
||||
dentifikatoren werden so initialisiert, dass sie mit den
|
||||
korrespondierenden Eintrittspunkten im /etc/passwd File
|
||||
identisch sind. Das Status-Feld wird auf 000000 initiali-
|
||||
siert, ausgenommen fuer den Nutzer daba, bei dem alle Bits
|
||||
gesetzt sind (alle Berechtigungen). Als Initialisierungs-
|
||||
File wird das File .ql im Home-Directory (User's Login-
|
||||
Directory) des Nutzers eingetragen. Das Feld fuer den
|
||||
"DABA"- Nutzercode wird mit einem aufsteigenden Code, begin-
|
||||
nend mit 'aa' gefuellt. Alle anderen Felder werden mit Null
|
||||
initialisiert.
|
||||
|
||||
Nach dem Ablauf von usersetup kann das Nutzerverzeichnis
|
||||
editiert werden. Bei Nutzern, die eine spezielle Berecht-
|
||||
igung erhalten sollen, ist das Statusfeld zu aendern
|
||||
|
||||
Falls DABA-Nutzer nach Erstellung des DABA-
|
||||
Nutzerverzeichnisses im File /etc/passwd zugefuegt oder ge-
|
||||
loescht werden, ist es notwendig, das Nutzerverzeichnis zu
|
||||
editieren, um diese Aenderung einzuarbeiten. Das Kommando
|
||||
usersetup kann nur einmal ausgefuehrt werden, um das Nutzer-
|
||||
verzeichnis zu initialisieren.
|
||||
|
||||
FILES
|
||||
.../sys/etc/users
|
||||
/etc/passwd
|
||||
|
||||
BEISPIEL[E]
|
||||
usersetup soll befaehigen, das users -File auf einen Aus-
|
||||
gangsstand zu bringen.
|
||||
Der Nutzer mit dem Login-Namen "neumann" kann zum Beispiel
|
||||
durch folgendes Kommando im DABA-Nutzerverzeichnis aufgenom-
|
||||
men werden:
|
||||
|
||||
usersetup -|fgrep neumann >> .../sys/etc/users
|
||||
|
||||
SIEHE AUCH
|
||||
iql(mutos), users(file)
|
||||
|
|
@ -0,0 +1,27 @@
|
|||
VIEW(QL) DABA16 VIEW(QL)
|
||||
|
||||
NAME
|
||||
view - Definieren einer Sicht (virtuellen Relation)
|
||||
|
||||
UEBERSICHT
|
||||
define view name (target_list) [ where qual ]
|
||||
|
||||
BESCHREIBUNG
|
||||
Die Syntax der view Anweisung ist die der retrieve into An-
|
||||
weisung fast identisch. Die Daten werden jedoch physisch
|
||||
abgelet. Stattdessen wird die Definition gespeichert.
|
||||
Wenn die Sicht mit dem Namen name spaeter benutzt wird,
|
||||
erfolgt die Konvertierung der Anfrage, um mit den in
|
||||
der target_list spezifizierten Domaenen zu operieren.
|
||||
|
||||
|
||||
BEISPIEL[E]
|
||||
range of p is personal
|
||||
range of a is abt
|
||||
define view persabt (pname = p.name, p.gehalt, aname =
|
||||
a.name)
|
||||
where p.leiter = a.leiter
|
||||
|
||||
|
||||
SIEHE AUCH
|
||||
retrieve(ql), destroy(ql)
|
||||
Loading…
Reference in New Issue