Indexdateien (Menuepunkt
Datei/Öffnen/Indexdatei)
Hyperlinks:
Kopieren Indexdateibeschreibung
Die
mit Ebus-J erzeugten Programme können sowohl auf sequentielle und Random-Dateien als auch auf Ebus-Indexdateien (ISAM-Dateien) und über
JDBC auf beliebige SQL-Datenbanken zugreifen.
Jede
Ebus-Indexdatei <name> besteht aus 3 physikalischen Dateien:
|
<name> |
enthält
die Daten bei Dateityp Ebus. |
|
|
|
|
<name>.i1 |
enthält
die Indizes. |
|
|
|
|
<name>.ebu |
enthält
die Indexstruktur. |
Diese
drei Dateien werden vom Ebus-J logisch zu einer Indexdatei zusammengefasst. Für den Anwender ist nur das logische
Dateiformat wichtig, die physikalischen Dateizugriffe generiert der Ebus-J.
Dazu müssen die Beschreibungen der Indexdateien in der Indexdatei-Verwaltung
erfasst werden.
Sequentielle und Random-Dateien werden nicht mit der Indexdatei-Verwaltung erfasst. Sie können mit der Programmiersprache des
Ebus-J durch die Anweisungen OPEN, INPUT, LINE INPUT, OUTPUT, PUT, GET und CLOSE angesprochen werden.
Die
Beschreibungen der Indexdateien werden in der Bibliothek ebusdlib gespeichert. Jedesmal wenn bei der
Programmerstellung ein neues Arbeitsverzeichnis (Directory) benutzt wird, wird
dort eine Dateibibliothek automatisch
angelegt.
Achtung: Die Indexdatei-Beschreibung wird vom Ebus-J zur Programmerstellung benötigt, sie enthält den Namen und das Format der Indexdatei. Zur Laufzeit des Ebus-Programms wird eine Indexdatei (die von der Dateibibliothek ebusdlib vollkommen unabhängig ist) mit dem entsprechenden Dateinamen
geöffnet. In dieser Indexdatei werden die Datensätze gespeichert.

Dateiname: Der Dateiname einer
Indexdatei muss mit einem Buchstaben beginnen und darf nur Buchstaben und
Ziffern enthalten.
Button
'Speichern': Die Daten werden gespeichert und es wird zum Feld Dateiname
zurückgesprungen.
Button
'Abbrechen': Geänderte Daten werden nicht gespeichert und es wird zum Feld Dateiname
zurückgesprungen.
Taste
<Esc>: Es wird zum Feld Dateiname zurückgesprungen.
Wurden Daten geändert, so erfolgt zuerst eine Abfrage, ob die Änderungen
gespeichert werden sollen.
Folgende
Funktionstasten (Icons) stehen zur Verfügung:
F2: Auswahl
Dateibeschreibung (Durch Eingabe von
Anfangsbuchstaben kann die gewünschte Datei markiert werden)
F3: Blättern vorwärts:
nächster Dateiname
F4: Blättern rückwärts:
vorheriger Dateiname
F5: Löschen: Die gesamte
Dateibeschreibung wird nach einer Sicherheitsabfrage gelöscht.
Achtung: Beim Löschen einer Datei-Beschreibung wird nur die Beschreibung der
Indexdatei gelöscht, nicht die Indexdatei.
F7: Auswahl Dateibeschreibung
(Historie)
F8: Kopieren Dateibeschreibung
F9: Drucken Dateibeschreibung

Jede
Indexdatei kann maximal 2 hoch 64 Datensätze enthalten.
Jeder
Datensatz besteht aus beliebig vielen Feldern. Es gibt 3 verschiedene
Feldarten:
1) alphanumerisch (Maximallänge 99999 Byte)
2) numerisch (Maximallänge 15 Byte)
3) Datum (Länge 6 oder 8 Byte)
Die
Summe der Feldlängen aller in einer Indexdatei definierten Felder ergibt die Länge des Datensatzes.
Die
Daten werden in den Feldern im ASCII-Format abgelegt und so auch auf der
Festplatte gespeichert.
Texte
werden in alphanumerischen Feldern linksbündig gespeichert und mit Leerzeichen
(Blanks) aufgefüllt.
Zahlen
werden in numerischen Feldern als Dezimalzahlen abgespeichert. Positive Zahlen
werden ohne, negative Zahlen werden mit Vorzeichen abgespeichert. Um das Feld vollständig zu füllen, wird die
Zahl gegebenenfalls mit führenden Nullen aufgefüllt.
|
Beispiel: Feldlänge
6 |
-00123 |
Bei
Feldern mit Nachkommastellen wird der Dezimalpunkt (bzw. das Komma) nicht mit abgespeichert.
Es werden lediglich die Ziffern gespeichert.
Beispiel:
|
Feldlänge
6, 2 Nachkommastellen |
|
|
Wert |
abgespeicherte
Zeichenkette |
|
-
1.23 |
-00123 |
Datumsfelder
sind numerische Felder und werden vom Ebus-J immer im Format JJJJMMTT (Länge 8)
bzw. JJMMTT (Länge 6) abgespeichert.
Beispiel:
|
Datum |
abgespeicherter
Wert |
|
28.07.1991 |
19910728 |
Jedes
Indexdateifeld ist folgendermaßen aufgebaut:
Feldname: Der Feldname wird für die
Adressierung des Indexdateifeldes verwendet. In den Makros wird auf ein
Indexdateifeld über <Dateiname>.<Feldname> zugegriffen. Der
Feldname darf nur Buchstaben, Ziffern und Punkte
enthalten. Alphanumerische Dateifelder müssen mit dem Zeichen '$' enden.
Typ: Legt den Feldtyp des
Dateifeldes fest. Es gibt 3 Feldtypen:
A =
alphanumerisch
N =
numerisch
D =
Datum
Länge: Legt die Gesamtlänge
(inklusive Nachkommastellen) des Dateifeldes fest. Bei numerischen Felder (N)
ist die Maximallänge 15. Bei Datumsfeldern (D) sind nur 2 Längen zulässig: 6
(TT.MM.JJ) und 8 (TT.MM.JJJJ).
NKS: NKS bedeutet
Nachkommastellen und ist nur bei numerischen Feldern (N) anzugeben. Länge
ist die Gesamtlänge des Feldes, NKS muss deshalb <= Länge sein.
Bemerkung: Die Bemerkung hat nur
informatorischen Charakter. Bei Memofeldern (Dbase) muss am Anfang in
Großbuchstaben MEMO stehen, dahinter kann beliebiger Text folgen. Bei Logischen
Feldern (Dbase) muss am Anfang in Großbuchstaben LOGIC stehen, dahinter kann
beliebiger Text folgen.
Karteikarte Dateityp

Der
Dateityp legt fest, in welchem Format die Indexdatei zur Laufzeit eines
generierten Programms angelegt wird.
Bei
Dateityp Dbase wird das Dbase-III-Format verwendet. Es wird jedoch nur die
Datendatei <DATEINAME>.dbf im Dbase-III-Format angelegt, der Index
(<DATEINAME>.i1) ist im Ebus-Format.
Der
Dateityp JDBC legt fest, dass die Indexdatei in einer SQL-Datenbank geöffnet
wird. Über folgende Befehle können die notwendigen Parameter gesetzt werden:
JDBC_DRIVER legt den JDBC-Treiber für den
Zugriff auf die SQL-Datenbank fest.
JDBC_DATABASE legt den Namen der Datenbank
fest, in der die Indexdatei geöffnet wird.
JDBC_TABLE legt den Tabellennamen in der
Datenbank fest.
JDBC_USERID legt die Benutzerkennung für den
Zugriff auf die Datenbank fest.
JDBC_PASSWORD legt das Password für den
Zugriff auf die Datenbank fest.
Bei
Dbase gelten folgende Konventionen und Einschränkungen:
Der
Feldname darf nur maximal 10 Zeichen enthalten.
6-stellige
Datumsfelder sind nicht zulässig.
Memo-Felder
besitzen den Typ <A> (alphanumerisch) und haben genau die Länge
10. Unter Bemerkung muss am Anfang in Großbuchstaben MEMO stehen,
dahinter kann beliebiger Text folgen. Memofelder können nur mit der Anweisung PUT_MEMO geschrieben und mit der Funktion GET_MEMO$ gelesen werden.
Logische
Felder besitzen den Typ <A> (alphanumerisch) und haben genau die Feldlänge
1. Unter Bemerkung muss am Anfang in Großbuchstaben LOGIC stehen,
dahinter kann beliebiger Text folgen.
Dbase-Beschreibung
lesen aus Datei: Legt die Dbase-Datei fest, aus der die Dateibeschreibung eingelesen
werden soll.
Button
'Datei-Beschreibung einlesen': Die Dateibeschreibung wird aus der angegebenen
Dbase-Datei eingelesen.
Karteikarte Schlüssel

Jeder
Datensatz einer Indexdatei wird durch einen Hauptschlüssel (Primär-Key) eindeutig identifiziert. Daneben können bis zu 99 Nebenschlüssel (Sekundär-Keys) existieren.
Ein
Schlüssel setzt sich aus bis zu 10 Feldern des Datensatzes zusammen.
Die Länge des Schlüssels ist die Summe der Feldlängen. Sie darf höchstens 100 Byte
betragen.
Die
Inhalte der Felder des Schlüssels ergeben den Wert des Schlüssels, nach dem
sich die Sortier-Reihenfolge der Datensätze richtet. Die Werte des Hauptschlüssels müssen für jeden Datensatz eindeutig sein. Nebenschlüssel können mehrdeutig sein, d.h. mehrere Datensätze können
denselben Nebenschlüsselwert besitzen. Innerhalb von gleichen
Nebenschlüssel-Werten ist die Sortier-Reihenfolge zufällig.
Da
Schlüssel-Werte von numerischen Feldern aus ihrer ASCII-Darstellung berechnet
werden, entspricht bei positiven Zahlen der höheren Zahl auch der höhere
Schlüsselwert. Da das Minus-Zeichen einen niedrigeren ASCII-Wert als die Null
hat, haben alle negativen Zahlen einen niedrigeren Schlüsselwert als positive
Zahlen. Aber betragsmäßig höhere negative Zahlen haben auch einen höheren
Schlüsselwert als betragsmäßig niedrigere negative Zahlen, da die ASCII-Werte
der Dezimalzahlen mit ihrem Wert ansteigen.
Beispiel:
|
Zahl |
ASCII-Darstellung |
|
-
1 |
-00001 niedrigster Schlüssel-Wert |
Durch
die Art der Abspeicherung von Datumsfeldern (JJMMTT bzw. JJJJMMTT) wird erreicht,
dass ein höheres Datum auch einen höheren Schlüsselwert erzeugt.
Für
jede Indexdatei muss ein Primärkey festgelegt werden.
Der
Primärkey muss für jeden Datensatz eindeutig sein, er dient der
eindeutigen Identifizierung des Datensatzes.
Optional
können bis zu 99 Sekundärkeys angelegt werden. Sekundärkeys können mehrdeutig
sein, d.h. mehrere Datensätze können denselben Sekundärkey besitzen.
Jeder
Schlüssel (Key) kann aus bis zu 10 Feldern der Indexdatei zusammengesetzt sein.
Die maximale Größe eines Schlüssel beträgt 100 Bytes (Zeichen).
Mit
F2 wird in den Eingabefeldern Feldname ein Auswahlfenster
geöffnet.
Button
'neuen Sekundärkey erfassen': Ein neuer Sekundärkey wird angelegt.
Button
'Schlüssel löschen': Der aktuelle Sekundärkey wird gelöscht. Der Primärkey kann nicht
gelöscht werden.
Unterscheidung
zwischen Groß- und Kleinbuchstaben: Ist diese Checkbox gesetzt, so wird bei
alphanumerischen Feldern zwischen Groß- und Kleinschreibung unterschieden.
Beispiel: Im einem Datensatz ist der
Name "Huber" gespeichert. Wird versucht, den Datensatz über einen
entsprechenden Schlüssel zu lesen und wird das entsprechende Dateifeld mit
"HUBER" vorbelegt, so wird der Datensatz nicht gefunden, da "Huber"
und "HUBER" als unterschiedliche Zeichenketten interpretiert werden.
Karteikarte Beschreibung

Hier
kann eine Kurzbeschreibung und eine ausführliche Beschreibung der Indexdatei
angegeben werden.
Die
Kurzbeschreibung wird bei der Dateiauswahl angezeigt.
Die
ausführliche Beschreibung hat nur informatorischen Charakter, sie hat keinen
Einfluss auf den Programmablauf.