<<

Inhaltsverzeichnis

Suchen

>>

 

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>
  bzw.
<name>.dbf

enthält die Daten bei Dateityp Ebus.

enthält die Daten bei Dateityp Dbase.

 

 

<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

 

 

Karteikarte Dateifelder

 

 

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
-12345
000000
000123
123456

 

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
- 123.45
0.00
1.23
1234.56

-00123
-12345
000000
000123
123456

 

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
28.07.91

19910728
910728

 

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
Feldlänge 6

- 1
- 123
- 99999
0
1
123
99999

-00001   niedrigster Schlüssel-Wert
-00123                  .
-99999                  .
000000                  .
000001                  .
000123                  .
999999  höchster 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.