Die
Programmiersprache des Ebus-J wurde aus BASIC abgeleitet und beinhaltet
Erweiterungen für die Indexdatei-Zugriffe und mächtige Befehle für die einfache
Erstellung von kommerziellen Programmen. Wie in BASIC müssen Variablen nicht
deklariert werden, durch die Schreibweise wird der Typ des Parameters
festgelegt.
Ein
Programmteil, der in dieser Sprache geschrieben ist, wird Makro genannt. Alle erzeugten Makros werden in einer Bibliothek
gespeichert. Zur Ausführung aufgerufen werden kann ein Makro entweder über die
Programmbeschreibung als Makro vorher, Makro nachher,
Makro vor Maskenausgabe, Makro nach Maskenausgabe, Makro
für Maskenverarbeitung, Makro vor Index-Open, Makro
nach Index-Open (siehe Programme), oder über den Aufruf des
Befehls MACRO in einem Makro.
Da
alle Makros in einer Bibliothek verwaltet werden, auf die alle Programme im
aktuellen Arbeitsverzeichnis Zugriff haben, ist die Mehrfachverwendbarkeit der
Makros sichergestellt. Bei der Generierung eines Programms, liest der Generator
alle benötigten Makros aus der Bibliothek und generiert daraus das Programm.
Alphanumerische
Konstanten sind Zeichenketten (Strings), die durch das Zeichen " begrenzt
werden. Die Länge der Zeichenkette ist die Anzahl der in ihr enthaltenen
Zeichen. Der Leerstring hat die Länge 0 und wird durch ""
dargestellt.
Beispiele
für alphanumerische Konstanten:
"Hallo"
"BETRAG:
22,50 €"
Numerische
Konstanten bestehen aus 1-15 Dezimalziffern. Als Dezimalpunkt ist der Punkt . zu verwenden.
Beispiele
für numerische Konstanten:
123
45.99997
0.784
Variable
sind Namen, die im Programm zur Speicherung von Werten verwendet werden. Alle
Variablennamen müssen mit einem Buchstaben beginnen.
Es
gibt 3 Arten von Variablen:
a)
Indexdateivariable werden folgendermaßen geschrieben: <Indexdateiname>.<Feldname>
(z.B. KUNDEN.NAME$). Indexdateivariable enthalten immer mindestens einen Punkt
und haben eine feste Länge. Wird einer numerischen Indexdateivariablen ein Wert
zugewiesen, der größer ist als der durch die Feldlänge festgelegte maximal
darstellbare Wert, so werden überzählige führende Ziffern abgeschnitten. Wird
einer alphanumerischen Indexdateivariablen ein String zugewiesen, der größer
ist als die Feldlänge, so werden die überzähligen Zeichen am Ende des Strings
abgeschnitten. Wird einer alphanumerischen Indexdateivariablen ein String
zugewiesen, der kleiner ist als die Feldlänge, so wird der String mit
Leerzeichen aufgefüllt. Alphanumerische Indexdateivariable enthalten also immer
genau so viele Zeichen, wie bei der Definition der Feldlänge festgelegt wurden.
Indexdateivariable sind global bezüglich Haupt- und Unterprogramm.
b)
Hilfsvariable sind Variable, die frei definiert werden können. Hilfsvariable dürfen
nur aus Buchstaben, Ziffern und dem Zeichen _ bestehen. Hilfsvariable sind nur
dann global bezüglich Haupt- und Unterprogramm, wenn sie im Hauptprogramm als SHARED deklariert werden, andernfalls gelten sie nur
im aktuellen Programm. In Makros können Hilfsvariable als LOCAL deklariert werden. Derartige Variablen gelten
dann nur in diesem Makro, nicht in anderen Makros und auch nicht in
Untermakros.
c)
Sondervariable sind reservierte Variablen der Programmiersprache (z.B. EBUS_MENU$).
Jede Variable ist entweder vom Typ integer, numerisch oder alphanumerisch:
|
Integer |
Variable
dieses Typs werden durch das Zeichen % am Ende des Namens
gekennzeichnet. Dieser Typ ist nur für Hilfsvariablen zulässig. Es können
ganze Zahlen im Wertebereich von -2 hoch 63 bis +2 hoch 63 gespeichert
werden. |
|
Numerisch |
Numerische
Variablen werden als double-Wert gespeichert. Es können Dezimalzahlen mit 15
Stellen Genauigkeit dargestellt werden. Numerische Variablen sind daran zu
erkennen, dass sie weden mit % noch mit $ enden. |
|
alphanumerisch
(String- oder |
Variable
dieses Typs werden durch das Zeichen $ am Ende des Namens
gekennzeichnet. Alphanumerische
Variable (Ausnahme Indexdateivariable) besitzen eine variable Länge und
können beliebig viele Zeichen enthalten. |
Numerische
und integer Hilfsvariable werden beim Programmstart mit 0, alphanumerische
Hilfsvariable mit dem Leerstring "" initialisiert.
Beispiele
für zulässige Variablen-Namen:
|
Name |
Typ Variablenart |
|
H$ |
alphanumerisch Hilfsvariable |
|
VOR_NAME$ |
alphanumerisch Hilfsvariable |
|
ADRESSEN.NAME$ |
alphanumerisch Indexdatei-Variable |
|
VOR_NAME__1$ |
alphanumerisch Hilfsvariable |
|
I1 |
numerisch Hilfsvariable |
|
VON_DATUM_1 |
numerisch Hilfsvariable |
|
ADRESSEN.TELEFON |
numerisch Indexdatei-Variable |
|
I% |
integer Hilfsvariable |
|
I_2% |
integer Hilfsvariable |
|
CURSUP$ |
alphanumerisch Sondervariable |
Alle
Namen mit Ausnahme der reservierten Worte dürfen für Variable verwendet werden.
Man beachte, dass I und I% zwei verschiedene Variablen sind.
Jedes
Maskenfeld muss bei der Maskenerstellung mit einer Variablen verknüpft werden.
Im generierten Programm sind dann Variable und Maskenfeld identisch, d.h. sie
besitzen den gleichen Wert.
Der
Wert der mit dem Maskenfeld verknüpften Variablen wird immer automatisch am
Bildschirm angezeigt, wenn die Maske angezeigt wird, das Maskenfeld
angesprungen wird oder ein Makro vorher oder ein Makro
nachher eines Maske ausgeführt wurde, in dem Datensätze einer
Indexdatei gelesen wurden. Mit der Anweisung DISPLAY
kann die Anzeige eines Maskenfeldes aktualisiert werden.
Wird
auf der Maske in einem Feld ein Wert eingegeben, so ist der eingegebene Wert
automatisch in der zugehörigen Variablen enthalten.
Wird
einer Variablen, die mit einem Maskenfeld verknüpft ist, in einem Makro ein
neuer Wert zugewiesen, wird der neue Wert nicht automatisch am Bildschirm
angezeigt und bei Hilfsvariablen auch nicht auf die Länge des Maskenfeldes
ausgerichtet. Die Anzeige erfolgt erst, wenn das Maskenfeld angesprungen wird
oder die Anweisung DISPLAY ausgeführt wird oder
ein Makro vorher oder ein Makro nachher beendet
wurde, in dem Datensätze einer Indexdatei gelesen wurden.
ACHTUNG: Alphanumerische Variable,
die mit einem alphanumerischen Maskenfeld mit Formatstring verknüpft sind,
haben immer die durch den Formatstring festgelegte Länge, wenn das Feld am
Bildschirm angezeigt wird. Zwar kann die Variable in den Makros temporär mehr
oder weniger Zeichen enthalten, sobald das zugehörige Maskenfeld aber angezeigt
wird, werden überzählige Zeichen rechts abgeschnitten und fehlende Zeichen
durch Leerzeichen ersetzt.
Hilfsvariable
können dimensioniert werden. Dimensionierte Hilfsvariable werden als Array
bezeichnet.
DIM-Anweisungen
können an jeder beliebigen Stelle in jedem Makro stehen. DIM-Anweisungen werden
zur Laufzeit des Programms nicht mehr ausgeführt, sie werden bereits bei der
Generierung des Programms verarbeitet. Jedes Array darf innerhalb eines
Programms nur einmal definiert werden.
Arrays
werden über Indizes angesprochen. Als Index sind die Werte 0 bis zum Wert der
Dimensionierung zulässig.
Beispiel: DIM
SUMMEN(10),TEXT$(2,20)
Zulässig
sind: SUMMEN(0), SUMMEN(1), ... SUMMEN(10), TEXT$(0,0),...TEXT$(2,20)
Unzulässig
sind: SUMMEN(11), TEXT$(3,0), TEXT$(2,21)
Wird
im Makro auf ein unzulässiges Arrayelement zugegriffen, so wird ein
Laufzeitfehler gemeldet und der aktuell ausgeführte Makro wird abgebrochen. Bei
der Programmgenerierung kann das Kennzeichen Überprüfung der Arraygrenzen
generieren gesetzt werden. Dann werden vor jedem Zugriff auf ein
Arrayelement alle Indizes auf ihre Gültigkeit überprüft. Liegt ein Index
außerhalb des gültigen Bereichs, so erfolgt eine Fehlermeldung mit Angabe des
fehlerhaften Index und der Aufrufstelle im Makro.
Numerische
Ausdrücke bestehen entweder aus einer numerischen Konstanten oder einer
numerischen Variablen oder aus einer Verknüpfung von numerischen Konstanten und
Variablen mittels numerischer Operatoren. Bei der Verknüpfung mit Operatoren
gelten die Prioritätsregeln aus der Arithmetik (* / vor + –).
Als
Operatoren stehen zur Verfügung:
– Negierung (z.B.: –1
oder –XX%)
* Multiplikation
/ Division
+ Addition
- Subtraktion
Numerische
Ausdrücke können beliebig geklammert werden. Klammern haben Vorrang vor allen
Operatoren.
Numerische
Zuweisungen weisen einer numerischen Variablen einen Wert zu.
Beispiele:
I% = 1
J = J + 1
A(I,J) = 2*I + J
KUNDEN.KAUF.DATUM = NUMDATE(DATEG8$)
Zur
Bildung von alphanumerischen Ausdrücken steht nur der Operator + zur Verfügung:
Alphanumerische
Zuweisungen weisen einer alphanumerischen Variablen eine Zeichenkette zu.
Beispiele:
A1$
= "Hello"
A2$
= "World"
H$
= A1$ + " " + A2$ /* H$
enthält "Hello World"
C$(1) = H$
Vergleichsoperatoren
werden dazu benutzt, zwei Werte miteinander zu vergleichen. Verglichen werden
können dabei nur Ausdrücke vom gleichen Typ, also entweder numerische Ausdrücke
oder alphanumerische Ausdrücke.
|
Operator |
Bedeutung |
|
= |
Gleich |
Alphanumerische
Variable werden zeichenweise von links nach rechts verglichen bis ein Zeichen
ungleich ist oder das Ende der Zeichenkette erreicht ist
.
Folgende
Vergleichsausdrücke sind wahr:
|
"AAA"
< "AAB" |
Beim
3. Zeichen wird "A" < "B" gefunden. |
|
"AAA"
< "AAAA" |
Beim
4. Zeichen wird "" < "A" gefunden. |
|
"AAA"
< "AAA " |
Beim
4. Zeichen wird "" < "
" gefunden. |
|
" " < "A" |
Beim
1. Zeichen wird " " < "A" gefunden. |
|
""
< " " |
Beim
1. Zeichen wird "" < " " gefunden. |
|
"Z"
< "a" |
Die
Großbuchstaben sind in der Sortierreihenfolge des ASCII-Codes vor den
Kleinbuchstaben. |
Ein
logischer Ausdruck ist entweder wahr oder falsch. Ein logischer Ausdruck kann
aus einem numerischen Ausdruck oder einem Vergleichsausdruck bestehen. Ein numerischer
Ausdruck ist genau dann falsch, wenn er den Wert 0 hat, andernfalls ist der
Ausdruck wahr. Ein Vergleichsausdruck ist wahr, wenn die angegebene Relation
erfüllt ist.
Logische
Ausdrücke können durch folgende logische Operatoren zu komplexen logischen
Ausdrücken verknüpft werden:
|
NOT |
Verneinung:
A=0 Þ NOT A ist wahr |
|
AND |
logisches
UND: A=1 B=1 Þ A AND B ist wahr |
|
OR |
logisches
ODER: A=1 B=0 Þ A OR B ist wahr |
Logische
Ausdrücke können beliebig geklammert werden.
Es
gibt zwei Arten von Sprungzielen:
a) Sprungmarken
innerhalb eines Makros
b) Maskenfelder
a) Sprungmarken innerhalb
eines Makros
Sprungziele
innerhalb eines Makros werden durch Marken definiert und sind nur lokal
innerhalb des Makros gültig.
Eine
Sprungmarke kann an jeder beliebigen Stelle eines Makros vorkommen, sie muss
aber am Anfang der Zeile stehen. Sprungmarken müssen mit einem Buchstaben
beginnen und mit einem Doppelpunkt enden. Sprünge dürfen nur zu einer
Sprungmarke innerhalb des aktuellen oder in einen übergeordneten Blocks
erfolgen. Sprünge in parallele oder tiefere Blöcke sind nicht zulässig. Blöcke
werden durch folgende Schlüsselworte definiert:
THEN
... ELSE
THEN
... ENDIF
ELSE
... ENDIF
FOR
... ENDLOOP
WHILE
DO ... ENDDO
ON
ERROR ... END
FUNCTION
... ENDFUNC
OF
... OF
OF
... OFREST
OF
... ENDCASE
OFREST
... ENDCASE
Beispiel:
N1:
I% = I% + 1
...
IF I% < 10 THEN GOTO N1
ENDIF /* zulässig, da Sprung in übergeordneten Block
IF I% = 12 THEN GOTO N2 ENDIF
/* Unzulässig, da Sprung in parallelen Block
IF I% > 10
THEN
N2: K% = K% + 1
ENDIF
b) Maskenfelder
Ein
Sprung zu einem Maskenfeld führt dazu, dass der aktuelle Makro und alle
übergeordneten Makros beendet werden und zum angegebenen Maskenfeld gesprungen wird.
Wenn das Maskenfeld einen Makro vorher besitzt, wird dieser
ausgeführt.
Beispiele:
|
GOTO
#.1 |
Sprung
zum 1. Maskenfeld der aktuellen Maske |
|
GOTO
#10 |
Sprung
zum 1. Feld der Maske 10 |
|
GOTO
#10.2 |
Sprung
zum 2. Maskenfeld der Maske 10 |
|
GOTO
#10.#A$ |
Sprung
zum Maskenfeld der Maske 10, das mit der Hilfsvariablen A$ verknüpft ist. |
|
GOTO
#10.#ADR.PLZ |
Sprung
zum Maskenfeld der Maske 10, das mit der Indexdatei-Variablen ADR.PLZ
verknüpft ist. |
|
GOTO
#.+2 |
Sprung
zum übernächsten Maskenfeld |
|
GOTO
#.- 3 |
Sprung
um 3 Maskenfelder zurück |
Der
Zugriff auf Dateien erfolgt über Schreib-, Lese- und Steuer-Anweisungen. Alle
diese Anweisungen enthalten einen Block ON ERROR ... END, der im Fehlerfall ausgeführt wird. Wird der Block ON
ERROR ... END ausgeführt, so enthalten die Variablen OK
und OK2 die Fehlernummern und EBUS_ERRORTEXT$ die Fehlermeldung.
Der
Block ON ERROR ... END kann leer sein. Folgende Anweisung ist also zulässig:
CLOSE
1 ON ERROR END
Jedoch
wird in diesem Fall ein auftretender Fehler nicht bemerkt.
Es
gibt drei Arten von Dateien:
a) Indexdateien
Die
Datensätze von Indexdateien sind aus einzelnen Feldern zusammengesetzt. Mit
Hilfe der Felder werden die Schlüssel gebildet werden. Der Zugriff auf die
Datensätze erfolgt stets über einen Schlüssel. Die Datensätze können in
beliebiger Reihenfolge über die Schlüssel gelesen und geschrieben werden.
Die
Indexdateien werden beim Start eines Programms automatisch geöffnet und am
Programmende automatisch geschlossen. Defekte Indexdateien werden erkannt und
automatisch reorganisiert.
Bei
den Schreib- und Leseanweisungen wird der entsprechende Schlüssel für den
Dateizugriff aus dem aktuellen Inhalt der entsprechenden Indexdateifelder
gebildet.
Bei
der Schreibanweisung WRITE wird der durch den
Hauptschlüssel (Primärkey) festgelegte Satz in die Indexdatei geschrieben. Ist
ein Datensatz mit diesem Schlüssel bereits vorhanden, wird er mit den aktuellen
Werten überschrieben. Im Multi-User-Betrieb muss ein bereits bestehender
Datensatz, der zurückgeschrieben werden soll, vorher gelesen worden sein, andernfalls
wird der Fehler 1062 gemeldet.
Mit
der Anweisung DELETE wird der durch den
Hauptschlüssel festgelegte Satz in der Indexdatei gelöscht. Im
Multi-User-Betrieb muss der Datensatz, vorher gelesen worden sein, andernfalls
wird der Fehler 1062 gemeldet.
Mit
den Anweisungen PATH, NEWNAME,
OPENMODE könen im Makro vor Index-Open
die Pfade, die physikalischen Namen und der Zugriffsmodus von Indexdateien
gesetzt werden.
b) Sequentielle
Dateien
Sequentielle
Dateien müssen vor der Bearbeitung mit der Anweisung OPEN
unter Angabe einer Dateinummer geöffnet werden. Die Dateinummer dient der Identifizierung
der Datei bei allen weiteren Dateizugriffen.
Wird
die sequentielle Datei mit INPUT geöffnet, können die Daten mit den Anweisungen
INPUT und LINE INPUT sequentiell gelesen werden. Die
Funktion EOF zeigt an, ob das Dateiende erreicht
wurde.
Wird
die Datei mit OUTPUT geöffnet, können die Daten mit der Anweisung OUTPUT sequentiell geschrieben werden. Ist die Datei
vor dem Öffnen bereits vorhanden gewesen, wird der alte Inhalt gelöscht.
Wird
die Datei mit EXTEND geöffnet, können die Daten mit der Anweisung OUTPUT sequentiell geschrieben werden. Eine
bestehende Datei wird nicht gelöscht, neue Daten werden am Ende der datei
angefügt.
Sequentielle
Datei sollten nach der Bearbeitung mit der Anweisung CLOSE
geschlossen werden. Am Programmende werden alle noch offene Dateien automatisch
geschlossen.
Beispiel: Kopieren Datei INPUT.DAT nach OUTPUT.DAT
OPEN INPUT,1, "INPUT.DAT" ON
ERROR ERRORMES = "Fehler beim
Öffnen der Eingabedatei" + STR$(OK) QUIT END
OPEN OUTPUT,2,"OUTPUT.DAT" ON
ERROR ERRORMES = "Fehler beim
Öffnen der Ausgabedatei" + STR$(OK) CLOSE 1 ON ERROR END
QUIT END
WHILE NOT EOF(1)
DO LINE INPUT 1,DATA_RECORD$ ON ERROR ERRORMES
= "Fehler beim Lesen der Eingabedatei" + STR$(OK) CLOSE 1 ON ERROR END QUIT END
OUTPUT 2,DATA_RECORD$ ON ERROR ERRORMES
= "Fehler beim Schreiben der Ausgabedatei:" + STR$(OK) GOTO CLOSE_FILES END
ENDDO
CLOSE_FILES:
CLOSE 2 ON ERROR
ERRORMES =“Fehler beim Schließen der
Ausgabedatei:“ + STR$(OK) END
CLOSE 1 ON ERROR ERRORMES
=“Fehler beim Schließen der Eingabedatei + STR$(OK) END
c) Random
Dateien
Random Dateien haben eine feste Satzlänge. Im Unterschied zu sequentiellen Dateien können die Datensätze über die Satznummer in beliebiger Reihenfolge (wahlfrei) gelesen und geschrieben werden. Im Gegensatz zu Indexdateien benötigen sie keine Dateiverwaltung, denn der Zugriff auf einen Datensatz erfolgt ausschließlich über die Satznummer.
Random
Dateien müssen vor der Bearbeitung mit OPEN RANDOM
unter Angabe der Satzlänge geöffnet werden. Anschließend müssen über FIELD-Anweisungen die Felder des Datensatzpuffers
definiert werden. Mehrere FIELD-Anweisungen sind möglich. Alle
FIELD-Anweisungen sind gleichzeitig gültig.
Mit
der Anweisung GET wird der durch die Satznummer
spezifizierte Satz in den Puffer gelesen. Dadurch werden den in der
FIELD-Anweisung festgelegten Variablen die entsprechenden Werte zugewiesen.
Die
in den FIELD-Anweisungen definierten Variablen können nur durch die Anweisungen
LSET und RSET mit Daten
versorgt werden. Mit der Anweisung PUT wird der Puffer in den durch die
Satznummer festgelegten Satz geschrieben.
Wie
sequentielle Dateien sollten auch Random Dateien nach der Bearbeitung mit der
Anweisung CLOSE geschlossen werden. Am
Programmende werden alle noch offene Dateien automatisch geschlossen.
Schalter
steuern gewisse Funktionen im Programm.
Schalter
können mit ENABLE ein- und mit DISABLE ausgeschaltet werden.
Beim
Programmstart sind immer alle Schalter eingeschaltet.
Beispiel: DISABLE REORG /* keine
automatische Reorganisation bei defekten Indexdateien