allegro CrashCourse
für Einsteiger und Außenstehende 
Was tun, wenn man nicht weiß, was man tun soll?

Jede Software verlangt ein paar Kenntnisse über das, womit man da eigentlich umgeht. 

Eine allegro-Datenbank besteht aus mehreren zuammengehörigen Dateien. Ihre Namen deuten an, was sie enthalten und wozu sie da sind. Am Beispiel der DemoBank ist das leicht zu sehen: 
Nehmen wir an, die allegro-Installation liegt im Ordner c:\allegro, genannt Programm-Ordner (ProgDir). Im Unterordner  demo2  sind dann diese Dateien: 

cat_1.ald   Die Daten (alles, was eingegeben wurde. Nur diese muß man unbedingt sichern.)
cat.api     Indexparameter = Vorschrift zum Indexieren; dabei werden die nächsten 5 Dateien erstellt:
cat.adx     Index d (Hauptindex, enthält Register 1 bis 11) 
cat.aex     Index e (optional, evtl. gibt es weitere: cat.agx, cat.azx o.a.) 
cat.tbl     Tabelle der Satzadressen in den .ald-Dateien (womit das Prog. die Sätze findet)
cat.stl     Kurzzeilen für Ergebnislisten (auch diese wird zusammen mit der nächsten beim Indexieren erstellt)
cat.res     Restriktionsdaten, z.B. Jahr, DokumentTyp 
cat.ini     Einstellungen für den Start von a99/alcarta (Für die Programme a99  und  alcarta )

Die folgenden Dateien können auch im ProgDir liegen, dann können sie mehreren Datenbanken zugleich dienen:
$a.cfg      Konfiguration: Grundeigenschaften und Definitionsliste der Datenfelder 
d-wrtf.apr  Anzeigeparameter (Vorschrift zum Anzeigen der Datensätze in a99)

Fünf Dinge können oder müssen bei einer anderen Datenbank anders sein: 

1. Sie muß woanders liegen - egal wo im System. Auch ein UNC-Pfad ist möglich, wie z.B. 
    \\datenserver\katalog. 

2. Es kann mehr als eine Datei des Typs .ald geben. Die Nummer (_1 ... _255) hat nur die Funktion, die Dateien auseinanderzuhalten, denn es können ja nicht zwei denselben Namen tragen. 
Jede der Dateien kann aber Sätze aller Typen enthalten. 
Maximale Größe einer .ald-Datei: 16 MB oder ein Mehrfaches davon (Einstellung in der .api). 

3. Der Namensteil  cat  leitet sich ab von der wichtigen Datei  cat.api. Darin steht die Vorschrift, wie der Index aufzubauen ist, also die Datei  cat.adx. (Daneben kann cat.api weitere Indexdateien erzeugen, im Beispiel  cat.aex.  Was sich darin befindet und wie es aussieht, ist allein Sache der  cat.api) 
Die Indexparameter dürfen anders heißen als cat.api, dann ändern sich auch die anderen Namen, die mit cat anfangen. 

4. Das a hinter dem Punkt leitet sich ab vom Namen der Konfigurationsdatei, in diesem Fall  $a.cfg. 
Der $ kann auch fehlen, er hat nur historische Bedeutung. Wenn Sie also eine Konfiguration  b.cfg  haben, dann haben Ihre Dateien die Typkennungen  .bdx, .bld, und Ihre Indexparameter nicht .api, sondern .bpi  (Achtung: Der Dateityp .api hat nichts zu tun mit mit dem Programmiererbegriff API = Application Programmers' Interface; api bedeutet  allegro parameters for indexing) 
$a.cfg liegt im ProgDir und kann dort mehreren Datenbanken dienen. Eigene, datenbankspezifische Varianten gehören ins DbDir. 
Wenn es  $a.cfg und  a.cfg beide gibt, dann nehmen die Programme die $a.cfg. 

5. Die Einstellungsdatei kann .ina heißen statt .ini. Das hat den Vorteil, daß man den Dateityp .ina mit dem Programm a99.exe verknüpfen kann. Dann wird bei Doppelklick auf eine .ina-Datei das Programm a99 gestartet und man ist sofort "drin". Mehr zum Start im `Anhang`. 

Im Fall der .ini- und .ina-Dateien ist der Name cat nicht zwingend, sondern auf den Inhalt kommt es an. Sie können sich weitere solche Dateien anlegen mit anderen Namen und Einstellungen, z.B. eine schmidt.ini für den Bearbeiter Schmidt. Die Einstellungen sind dokumentiert in  `a99.ini`. (Die ist zugleich auch eine funktionierende .ini-Datei für die DemoBank : Geben Sie mal ein  a99 a99, um sie zu benutzen.) 

Die wichtigsten Programme 

Windows:  `a99.exe` (graphisch); andere Variante: a99a.exe; ohne Schreibrecht: alcarta.exe

Linux: `acon` (Konsolprogramm), für Windows ebenfalls vorhanden und sehr wichtig 

Für beide:  srch (Volltextsuche+Export), import (Datenumwandlung), index (Indexierung) 

Begriffe 

ProgDir : Programmordner, z.B. c:\allegro 
DbDir : Datenbankordner, z.B.  c:\allegro\demo2 oder  k:\daten\katalog. 
Jede Datenbank braucht ihr eigenes DbDir als Wohnsitz. 
WorkDir : Arbeitsordner : Wo man a99 oder acon gestartet hat. Dort landen Ausgabedateien. 
Konfiguration : eine Datei vom Typ .cfg enthält wichtige Eigenschaften und die Liste der Felddefinitionen 
Indexparameter: Die in der `Exportsprache` geschriebene Spezifikation der Indexdaten, beruhend auf der Konfiguration. 

`FLEX` : die allegro-spezifische Skriptsprache. 
           Wenn es heißt, "ein FLEX" oder "der FLEX", dann ist damit ein FLEX-Skript gemeint, 
           geschrieben also in der FLEX-Sprache, Dateityp ist .flx für a99 und .job für acon. 
	  Eine Sammlung wichtiger FLEXe liegt im Unterordner  flex  des ProgDir. 
	  Ein `Tutorial` in engl. Sprache kann als erster Einstieg in FLEX und acon dienen. 

Weitere wichtige `Dateitypen` im ProgDir oder DbDir: .apr, .apt, .vw, .rtf 
Wichtig: Wenn ein Programm eine solche Datei braucht, sucht es sie zuerst im DbDir, bei Mißerfolg im ProgDir. Sehr praktisch, wenn man mehrere Datenbanken hat und einige Dateien (z.B. die $a.cfg oder die o.apt), die für alle Datenbanken gelten. 

ANHANG : Eine Datenbank öffnen
Was oben gesagt wurde, hilft beim Verständnis. Aber man will die Daten auch sehen und damit arbeiten. 
Dazu ist die Software da, und es geht immer auf dieselbe Weise: 

A. Windows : Programm a99 
Beispiel:  Datenbank  xyz  mit Schema b.cfg liegt in k:\daten\katalog, 
die Programme liegen im ProgDir c:\allegro. Dann startet man so, falls man keine .ini- oder .ina-Datei hat: 

   a99 -dk:\daten\katalog -bxyz -kb 

Wenn es aber eine Einstellungsdatei gibt, z.B.  start.ini oder  start.ina, dann reicht 
   a99 k:\daten\katalog\start

Alle Eigenschaften und Einstellungen bekommt man in a99 zu sehen mit dem Menüpunkt 
   Global / Datenbank-Information 

Die wichtigsten Admin-Funktionen, z.B. die Indexerneuerung, liegen im Menü "Reorganisieren", abzurufen mit dem Befehl   h org . 
Weitere Admin-Funktionen, z.B. die Bearbeitung wichtiger Dateien, liegen im Menü "Administration", abzurufen mit dem Befehl   h admin. 

B. Linux : per Browser oder mit Konsolprogramm acon 
Hier gibt es als graphische Oberfläche nur das browserbasierte `a35`. Seine Nutzung erfordert einige Vorbereitungen. Wenn man die Zeit nicht hat, kann man das FLEX-Skript  `al.job`  nutzen (der Dialog ist komplett englisch). Ausgeführt wird es vom Programm acon. 

Beispiel:  Datenbank  xyz mit Schema b.cfg liegt in /var/daten/katalog, und die 
Programme liegen in var/allegro. Man geht im Konsolfenster dorthin und startet  al.job  so: 

   ./acon -jal -d/var/daten/katalog -bxyz -kb  (oder auch -d../daten/katalog) 

Es erscheint dann ein Menü. Jede Funktion hat ein Zeichen, das man eingibt und dann Enter. 
Alle Eigenschaften und Einstellungen bekommt man zu sehen mit dem Menüpunkt 
   p : Properties    (eingeben:  p Enter) 

Admin-Funktionen, z.B. Indexerneuerung und Bearbeitung wichtiger Dateien, liegen im Menü "Admin", abzurufen mit dem Menüpunkt 
   a : Admin .     D.h.  a  eingeben und Enter 

Hinweis: Der  al.job  funktioniert auch unter Windows, und zwar ganz entsprechend: 
Beispiel:  Datenbank  xyz mit Schema b liegt in K:\daten\katalog, 
die Programme liegen in  c:\allegro. Dann startet man in  c:\allegro  so: 

   acon -jal -dk:\daten\katalog -bxyz -kb 

Sofort mal ausprobieren? `Hier klicken`. 
Das Programm acon.exe (Linux: acon) ist ein Konsolprogramm, d.h. es hat keine graphische Oberfläche. Dafür ist seine Arbeitsweise plattformunabhängig. Es leistet auch die Hauptarbeit für die Web-Oberflächen (a35, PHPAC, populo etc.). Ein sehr wichtiger Job ist  update.job, mit dem man Daten in eine Datenbank einmischt, wobei es viele Optionen gibt. 

2015-09-23 

?Anhang=h =ANHANG : Eine Datenbank benutzen 
?a99.ini=h a99.ini 
?Dateitypen=x jan http://www.allegro-b.de/doku/ff/ 
?al.job=h al 
?acon=h acon 
?a99.exe=x jan http://www.allegro-b.de/doku/alca99g.htm 
?FLEX=h flex 
?Tutorial=x jan http://www.allegro-b.de/doku/aconflex.htm 
?a35=x jan http://www.allegro-b.de/doku/a35/
?Hier klicken=x var "al.bat " D " " B " " K`Dos  
?Exportsprache=X gj exparam.htm