Installationshinweise zum allegro-System

`Hinweise zur WWW-Anbindung` 

`Checkliste der notwendigen Dateien` 
Plattform
Ab V34 läuft das System auf allen Windows-Systemen ab XP (nicht mehr empfohlen!), insbes. auch auf den 64bit-Versionen. 
Für Linux existiert kein mit a99 vergleichbares Programm mit graphischer Oberfläche. 
Die Web-Anwendung `a35` kann aber die meisten Funktionen übernehmen. 
Ferner gibt es für viele Funktionen die Möglichkeit, das Konsolprogramm acon zu nutzen, in Verbindung mit dem Skript `al.job`.

Hinweis 
Es wird empfohlen, auf jedem PC, der mit alcarta oder a99 arbeiten soll, die Schriften zu installieren. Für Browser-Anwendungen mit a35 ist das nicht nötig.
Das sind die Dateien a-times.ttf und a-lucida.ttf . Letztere ist als nicht-proportionale Schrift für Register und Kurzanzeige wichtig. Alternativen: a-arial.ttf bzw. a-letter.ttf. 
Zusätzlich gibt es noch  a-dos.fon  für das DOS-Fenster (nur für Schriftgrößen 8x13 und 10x19; einstellen in den Eigenschaften des DOS-Fensters). 
Die Software darf auf einem Server liegen und von dort gestartet werden, nur die Schriften müssen auf jedem PC liegen und ordnungsgemäß installiert sein. Wenn die Schriften fehlen, kommen die bibliothekarischen `Sonderzeichen` in a99 falsch heraus, alles andere funktioniert jedoch korrekt. 
Wenn Sie das Installations-Gesamtpaket `INST-ALL` zum Installieren oder Upgraden benutzen, ist vieles bereits so eingerichtet, wie es im Handbuch und nachfolgend beschrieben wird. 
Was für das Classico-Kernsystem zu beachten ist, steht im Handbuch, `Kap.0.10`. Es wird im DOS-Fenster auf c:\allegro mit cp.bat gestartet.

Wer es ganz einfach haben will
nutzt die Funktion "Eigene Datenbanken registrieren" auf dem Startschirm der DEMO-Datenbank. Dann wird die DemoBank zur Startplattform für die eigenen Datenbanken gemacht. Das System sucht und katalogisiert zuerst alle auf der eigenen Platte vorhandenen "allegro"-Datenbanken, danach kann man jede sofort starten. Es kommen dann Hinweise und es wird eine einfache INI-Datei angelegt, die man hinterher ausbauen kann. 
Hat man Datenbanken, die nicht mit dem Standardschema arbeiten, ist das Schwierigste die Anpassung der Anzeigeparameter, denn das kann nicht ganz automatisch erfolgen. Mehr dazu `weiter unten`. 

Eine `Übersicht` zeigt die Anordnung der Dateien auf den Verzeichnissen. 
Sie müssen sich dann immer noch um Ihre Parameter kümmern, wenn Sie mit einem anderen als dem Standardschema arbeiten. 

Die im folgenden erwähnten Dateien sind ASCII-Textdateien, die man mit jedem DOS-Texteditor bearbeiten kann. Nehmen Sie nicht WinWord dafür, sondern "WinVi" (empfohlen), NotePad, Notepad++ oder etwas in dieser Art. Wenn Sie unsicher sind, kopieren Sie eine Datei vorher auf ein anderes Verzeichnis, um sie bei Mißerfolg unverändert zurückholen zu können!

Eigene Datenbank für a99 tauglich machen : Icon auf Desktop usw.
Was man vor allem braucht, ist eine INI-Datei. Die Vorlage dafür ist die mitgelieferte `A99.INI` 
(Mehr dazu weiter unten!)
Diese Datei legt man in den Datenbankordner, nicht in den Programm- oder andere Ordner. 
Hat man eine eigene INI erstellt, und heißt sie z.B.  xyz.ini und liegt in dem Ordner c:\allegro\katalog, kann man a99 so starten: 
	c:\allegro\allegro.exe  c:\allegro\katalog\xyz.ini 
Dies sollte man also dann in eine Verknüpfung einbauen. Das Programm allegro.exe ist identisch mit a99.exe, das aus historischen Gründen noch zusätzlich geliefert wird. 
Diese indirekte Arbeitsweise hat einen großen Vorteil: jederzeit kann man, auch in voll laufendem Betrieb, ein Update einspeisen - ohne irgendwelche Sperrungen o. dgl. 
Dasselbe geht mit dem OPAC-Programm alcarta: Die Verknüpfung dafür sieht so aus: 
	c:\allegro\alcarta.exe c:\allegro\katalog\cat.ini 
(Identisch mit alcarta.exe ist das Programm opac.exe.) 

Alternative: Der Dateityp darf statt .ini auch .ina lauten. Dies ermöglicht es, im "Explorer" diesen Typ direkt mit a99 oder alcarta zu verknüpfen, was mit .ini nicht geht, weil es ein Dateityp ist, der auch bei anderer Software in Gebrauch ist. 

Vorsicht bei langen Pfadnamen!
Sie können zwar z.B. auf  c:\Program Files (x86)\allegro installieren statt auf c:\allegro. Aber: Das DOS-Programm startet dann nicht mehr, denn der Pfadname ist zu lang - DOS-Programme vertragen nur 8 Buchstaben. Nicht nur deshalb folgender 
Tip: Keine langen Dateinamen, 8 Zeichen müssen reichen. Pfadnamen: Ohne Leer- und Sonderzeichen. Damit gehen Sie ganz unaufgeregt vielen Problemen aus dem Weg, die nicht die allegro-Entwickler zu verantworten haben, sondern Microsoft.

Weitere Verbesserung Ihrer Installation 
Schritt für Schritt

Beispiel. Ihre Datenbank hat folgende Gegebenheiten:

Konfiguration      	K          Default: 	A 
Datenbank          	XYZ                	CAT 
Verzeichnis        	D:\DATA             	C:\ALLEGRO\DEMO 
Anzeigeparameter   	D-A99.KPR           	D-WRTF.APR 

Was ist dann zu tun?

0. INI-Datei     (Vorlage zum Kopieren: a99.ini) 

Eine xyz.ini anlegen, am besten als Kopie von `a99.ini`. 
Die Datei a99.ini enthält alle INI-Befehle, die es gibt, und jeder Befehl ist kommentiert.  Das  Minimum:
In Ihrer xyz.ini müssen mindestens diese Zeilen stehen: 

[General] 
Konfiguration=k     (default: a)
DbName=xyz          der eigentliche Datenbankname
DbDir=d:\data       das Verzeichnis, wo die Datenbank liegt, aber:
         wenn die INI-Datei selber auch auf d:\data liegt, kann diese Zeile entfallen! 
DisplayParameter=D-A99
    und für alcarta könnte eine andere Datei gesetzt werden: 
	(default für beide ist d-wrtf)
OpacDisplay=d-a99
access=5

1. IndexParameter
Sie haben in jedem Fall bereits eine Index-Parameterdatei  xyz.kpi ! Wahrscheinlich liegt sie auf dem Datenverzeichnis. In dieser Datei müssen folgende Dinge vorkommen (z.T. sind sie schon vorhanden) 

1.1 Symbolische Registernamen für find-Befehle
    Zeilen für die symbolischen Registernamen und Restriktionen (wenn es welche gibt) 
    nach diesem Schema: (Es kann mehr symbolische als wirkliche Register geben!) 
    z.B.  (Beispiele in CAT.API) 
    Ein Registername sieht so aus: 
I PER 1 "Personennamen"
    Eine Restriktion sieht so aus: 
R ERJ r1 "Erscheinungsjahr" 
Fehlen solche Zeilen, hat man im Find-Menü keine Auswahl für das Suchen. 

1.2 Überschriften der Register, der Titelanzeige und der Kurzanzeige

    Das sind die Zeilen mit | am Anfang, z.B.  (Beispiele in CAT.API) 
|1="1 : Namensregister (Literatur von und über ...)" 
Fehlen solche Zeilen, hat man im Indexfenster keine Registernamen im Auswahlfeld. 

1.3 Umcodierung ASCII<->ANSI
    optional: 
to     zum Laden der O.APT (wird sonst automatisch gemacht) 
    wird gebraucht für korrekte Anzeige der Register und Kurztitel etc. 

Man braucht eine eigene o.kpt, wenn man nicht OSTWEST.FON verwendet oder nicht den PC-Satz 437. (siehe Kommentar in o.apt) Sonst wird automatisch  o.apt  geladen. Um das zu verhindern (wenn die Datenbank selbst ANSI ist!) macht man o.apt einfach leer. 

2. Hilfsparameterdateien, die gebraucht werden

d.kpt       ASCII->ANSI für Titelanzeige (Kopie von d.apt)
o.kpt       ASCII<->ANSI für Index und Kurzanzeige u.a. (Kopie von o.apt)
d-rtf.kpt   RTF-Attribute für die Anzeige (fett, kursiv, Farben usw.)
e-w.kpr     für Export mit Kategorienummern (Kopie von e-w0.apr)
p-w.kpr     für Export in Listenform
            (Provisorisches Minimum:   copy p-w0.apr p-w.kpr ) 

Minimum: 
Als Kopien von d.apt, o.apt, d-rtf.apt, p-w0.apr und e-w0.apr auf das eigene Datenvereichnis legen. 
(In diesen Dateien stehen Kommentare, falls man sie ausbauen will) 

3. Anzeigeparameter  D-A99.KPR  (default  D-WRTF.KPR)
Ist eine solche Datei nicht vorhanden, wird automatisch D-W0.APR genommen! Diese macht aber nur eine simple Anzeige mit Feldnummern. 
Normalfall: Sie nehmen Ihre vorhandenen Anzeigeparameter her, meistens heißt die Datei D-1.KPR, und machen folgende Ergänzungen oder Änderungen darin: 
Alternative: Nehmen Sie als `Vorlage` die Dateien d-srtf.apr und d-s.apt. Diese enthalten Kommentare! 
Kopieren Sie siese also auf  d-srtf.kpr  und  d-s.kpt und dann bearbeiten.

3.1 Grundparameter 
   Bauen Sie diese Werte ein:
    zm=0 
    zl=80  
    fl=0 
    dx=1 
      ke=""  vermeiden (unter DOS sowieso ohne Wirkung) 

3.2 Tabellen
    Am Ende der Datei diese 2 Zeilen: 
    td-rtf      RTF-Attribute 
    td          Tabelle ASCII -> ANSI 
    to		Tabelle o.apt für Auswahlfeld und Schreibfeld 

3.3 Abschnitt für Alternativanzeige: (mit F5 oder über Menü "Ansicht")
    Diesen Abschnitt baut man hinter irgendeiner Zeile #+# ein: 
    #-( 
    #t{ s0 &0 #4 }   oder 5 statt 4 wenn 3stelliges Schema! 
    ##                oder 
        #L         alternativ statt ##: Anzeige mit Labels aus der CFG
    #t{ C } 
    #+# 

3.4 Zwischenteile  (Textkonstanten für die Anzeige)

Das sind die Zeilen, die mit einer Zahl beginnen. Wenn darin oder in indirekten Prä-/Postfixen (p... oder P...) Umlaute vorkommen, erscheinen diese falsch. 
Abhilfe: die Umlaute in der .KPR durch ANSI-Codes ersetzen. 
Wenn Sie z.B. eine Zeile haben: 

19="Übersetzer: "

dann ist für das Ü (= ASCII 154) der ANSI-Code 220 einzusetzen.

3.5 Schriftart 

Wenn eine spaltenrichtige Anzeige wichtig ist, setze man ein 

  as="  \f1 "
dann wird "allegro Lucida Console" als Schriftart genommen. 
Wer sich auskennt: Die zu verwendenden Schriftarten lassen sich in DISPHEAD.RTF individuell vorgeben und im Text jeweils mit  "\fn "  einstellen. 

4. Konfiguration
In Ihrer Konfigurationsdatei $K.CFG (oder K.CFG) braucht sehr wahrscheinlich nichts geändert zu werden. Allenfalls bei sehr umfangreichen Kategoriesystemen (z.B. Pica) ist darauf zu achten, die Werte md, mb und mP evtl. etwas höher zu setzen als für das DOS-System. Wenn in Ihrer CFG also steht: 

md150 
mb200 
mP2000 

dann ändern Sie das ruhig so ab (die DOS-Programme sollten dann immer noch gehen): 

md300 
mb500 
mP5000 

Abfragelisten funktionieren zwar auch in a99, jedoch gibt es Probleme mit Schleifen, die darin evtl. für Mehrfachfelder eingerichtet sind. Es wird empfohlen, eine  `Formulardatei` anzulegen und die in der Formulartechnik steckenden Möglichkeiten für Mehrfachfelder auszunutzen. 

5. Hilfeseiten

Dazu gibt es eine eigene Anleitung:  `HELP.RTF` 
Für die eigene Datenbank sollte man sich folgende Dateien machen: (diese erscheinen dann bei Druck auf den Fragezeichen-Button)

DbNameGER.RTF    mit Wordpad anzulegen (Vorbild: CATGER.RTF, Demodatenbank) 
DbNameENG.RTF   englische Version 

HA_InGER       ASCII-Dateien für die einzelnen Register n=1..9 
Hnnn 		Hilfetexte für die Eingabe, #nnn = Kategorienummer. 
Tip: Wenn h123 nicht existiert, sucht das Programm nach h12, ist dieses auch nicht zu finden, dann nach h1. So kann man sich zunächst damit begnügen, Hilfetexte H0, ... H9 für die Feldgruppen #0XX bis #9XX anzulegen, wie es bei der Demo-Datenbank zu sehen ist. 

6. Menü-Erweiterung (für Experten)

Vielleicht will man eine Hauptfunktion zum Menü hinzufügen, damit sie immer leicht ausgelöst werden kann. 
In die INI-Datei setzt man dazu ein: 

MyMenu=Abc 
MyFLEX=xyz 

Abc ist der Text des Menüpunkts, z.B. "Erwerbung", xyz ist die FLEX-Befehlsfolge. 

Oder man macht folgende zwei Dinge: 

•	Zeile 243 in UIFEGER/UIFEENG  : Einsetzen der 	Bezeichnung des Menüpunkts (normalerweise leer, also unsichtbar) 

•	Eine FLEX-Variable #uXz muß über die Anzeigeparameter mit dem FLEX-Befehl gefüllt werden, der dann ausgelöst werden soll (dynamisch!). 

Es genügt dann ein Klick auf den Menüpunkt, um #uXz zu starten 

7. Formulare für die Erfassung und Bearbeitung 

Für das Eingeben und Bearbeiten von Daten kann man bis zu 200 `Formulare` anlegen. Diese können jeweils bis zu 14 Datenfelder umfassen und man kann leicht zwischen den einzelnen Formularen umschalten. Mit der FLEX-Sprache kann man einzelne Formulare gezielt erscheinen lassen und die Eingaben auswerten. Dadurch ergibt sich eine hohe Flexibilität für die Gestaltung von Eingabe- und Bearbeitungsvorgängen. 
Die Formulardatei soll  xyz.frm  heißen, wenn xyz.kpi Ihre Indexparameterdatei ist. Beispiel: cat.frm. 

8. Start von a99 oder alcarta 

Drei Möglichkeiten: 

allegro.exe        	oder  a99.exe : Man hat die Auswahl zwischen .INI, .INA und .cDX-Dateien 
allegro name     	name.ini wird geladen (wenn sie nicht existiert; name.ina) 
allegro opac name     	name.ini wird statt dessen an alcarta.exe übergeben

a99 kann auf jedem Verzeichnis gestartet werden, wo der Nutzer Schreibrecht hat. 
a99 kann auf einem Server liegen, es braucht nicht auf jedem Nutzer-PC installiert zu werden. Das Start- oder Arbeitsverzeichnis ist dasjenige, wo man das Programm startet. Geschieht dies mit einem Desktop-Icon, dann findet und ändert man es so: Rechte Maustaste auf dem Icon, Eigenschaften, Ausführen in... (dort steht der Startverzeichnisname)

Hat der User kein Schreibrecht auf dem im System vorgegebenen TEMP-Verzeichnis, kann man in der INI-Datei mit dem Befehl DbAux=... ein anderes Verzeichnis für die temporären Dateien vorgeben. Sonst wird automatisch das TEMP-Verzeichnis seines PC benutzt. 
Für alcarta gilt dasselbe. 

Und noch ein Tip:
Hat man eine .INA-Datei statt .INI, kann man den Typ .INA im Explorer mit a99 oder mit alcarta verknüpfen und dann die Datenbank auch durch Klick auf den Namen der INA-Datei oder durch den Befehl "start dateiname.INA" zum Laufen bringen (geht sogar ohne "start"). 

Hinweis zur Registry
Bei der Installation werden nur zwei Registry-Schlüssel angelegt, und zwar sind dies im Standardfall für die Version 28.6 die folgenden: 
HKLM / Software / allegro-C
   install=c:\allegro 
   version=V28.6 
Gebraucht werden diese nur beim Installieren einer neuen Version: das Installationsprogramm stellt damit fest, wo die bisherige Installation sich befindet. 

?HELP.RTF=h help 
?Sonderzeichen=h char 
?A99.INI=h a99.ini 
?Kap.0.10=h ac0-10 
?Formulardatei=h =7. Formulare 
?Übersicht=X files 
?Hinweise zur WWW-Anbindung=h phpac 
?Checkliste der notwendigen Dateien=h filelist 
?Vorlage=h vb154=Muster 
?INST-ALL=~start http://www.allegro-c.de/Auswahl 
?Formulare=h form 
?weiter unten=h =3. Anzeige 
?acon=h acon 
?a35=~start http://www.allegro-c.de/doku/a35 
?al.job=h acon#41