allegro Systemverwaltung 
                             
Checkliste der Dateien

Dies ist die Liste der Dateien, die man wirklich braucht, wo sie liegen müssen, dürfen oder können, und ob man was dran tun soll, kann oder nicht darf. 
Siehe auch `Hilfetext zur Installation`. 
Eine ausführlichere Dokumentation der Dateitypen steht im Handbuch, `Kap.0.3`, eine andere ist auf der `allegro-Website` zu finden.

Die Windows-Programme a99 und alcarta brauchen mit geringen Unterschieden dieselben Dateien. 
Nach einer Installation mit dem Gesamtpaket  inst-all.exe  liegt alles genau da, wo es normalerweise liegen sollte, obwohl es ein paar andere Möglichkeiten gibt. 

Zwar wollen und sollen es die Anwender so einfach wie möglich haben, das Datenbankwesen IST aber leider keine einfache Welt. Ganz ohne ein paar Vorbereitungen geht es deshalb nicht. Es geht aus dieser Liste hervor, was in welchen Dateien zu tun ist, damit die Sache läuft. 

a99 funktioniert selbständig, wenn alle Dateien auf dem Startverzeichnis liegen. Fast alle können aber auch auf dem ProgDir liegen, dann wird dessen Name in der .INI erwartet. In vielen Fällen wird zuerst auf dem Datenverzeichnis (genannt "DbDir") nachgesehen, denn es könnte ja eine datenspezifische Datei geben. 

Tip: Wenn in der INI kein ProgDir und kein DbDir angegeben ist, aber a99 bzw. alcarta so gestartet wird: 
a99:    	K:\allegro\allegro.exe m:\db\katalog\opac.ini
alcarta:    	K:\allegro\opac.exe m:\db\katalog\opac.ini
also mit vollständigen Pfadnamen, dann wird 
K:\allegro als ProgDir genommen, und 
m:\db\katalog als DbDir. Was bedeuten diese Abkürzungen? 

Bezeichnungen für die Datei-Standorte:

PATH 	Die Verzeichnisse, die in der DOS-Variablen PATH stehen. 

DbDir	Der Name des Datenverzeichnisses. Dieser ist entweder 
           a) 	in der INI ausdrücklich anzugeben, ODER 
           b)	wenn die INI auf dem DbDir liegt, dann genügt es, wenn 
        		beim Aufruf von a99/alcarta (in der "Verknüpfung") 
             	der vollständige Pfadname der INI-DATEI angegeben ist, s.o. 
             	(Wenn z.B. DbDir auf einer CD ist und die INI auch, kann 
             	darin ja nicht das Laufwerk der CD stehen.) 

ProgDir  Programmverzeichnis. Default ist C:\ALLEGRO   (siehe aber oben) 
	Dort werden Dateien gesucht, die nicht auf dem Datenbank- und 
  	auch nicht auf dem Startverzeichnis gefunden wurden. 
 	Für Hilfetexte und FLEXe gibt es eigene Verzeichnisse HELP und FLEX, 
 	die normalerweise am ProgDir hängen. 

Lokal	Startverzeichnis. Auch "Arbeitsverzeichnis" oder WorkDir genannt.
          Hier liegende Dateien sind nutzerspezifisch 
   	(Lokal geht fast immer, ist aber nicht immer default.) 

MEHRPLATZBETRIEB
Jeder sollte von einem eigenen Verzeichnis aus starten. Dort brauchen jedoch keine systemspezifischen Dateien zu liegen. 
Das Verzeichnis für temporäre Dateien wird so bestimmt: 
In der INI-Datei kann man mit DbAux=pfad ein Arbeitsverzeichnis setzen. Als Default wird die Systemvariable TEMP genommen, das ist dann z.B.  
c:\windows\temp  (mit DOS-Befehl "set temp" sieht man, was es auf dem eigenen PC ist). Man sieht es auch in den "Informationen zur Datenbank":  X dbinfo  eingeben. 

Welche Dateien müssen bzw. dürfen verändert werden?

Mit [X]	sind die Dateien markiert, die datenbankspezifisch bearbeitet oder 
    	erstellt werden müssen. Andere sind nicht so lebenswichtig: 

   [v] 	bedeutet: die Datei kann bei Bedarf verändert werden. 
   [o] 	heißt "optional" - diese Dateien werden nicht unbedingt gebraucht, 
	d.h. die Programme kommen ohne sie aus. 
Achtung: Die Dateinamen sind in Wirklichkeit alle komplett in Kleinbuchstaben 
geschrieben, anders als in diesem Text. 

Name       	Standort (Verzeichnis-Reihenfolge)
                   	Bedeutung 
_____________________________________________________________ 
                   	Die Verzeichnis-Reihenfolge ist unterschiedlich. 
                   	D.h., in welcher Reihenfolge die Verzeichnisse nach einer 
	Datei abgesucht werden. 
	Das ist mit Überlegung so gemacht worden. 

1. Allgemein 	(unabhängig von CFG und Datenbank, kein Eingriff nötig) 
         	Die Sprachkennung (GER oder ENG) steht in der INI:  Language=GER 

ALLEGRO.EXE	Identisch mit dem Hauptprogramm a99.exe

A99.EXE      	ProgDir  /  PATH
ALCARTA.EXE	Die eigentlichen Programme : Katalogisierung bzw. OPAC

FLEX.EXE      	Programm zum Übergeben von FLEXen von außen (EXFLEX.TXT) 

CGI.EXE      	Hilfsprogramm für RuckZuck. 
            	Soll auf das CGI-Verzeichnis des Webservers

A99.INI	Kommentierte Liste aller INI-Befehle 
          	Kann man als Vorlage für eigene INI verwenden 

UIFEGER    [v]  	DbDir / Lokal / ProgDir  [Default ist GER] 
UIFEENG    	User-Interface. enth. u.a. die Button-Beschriftungen. 
             	Für A99 und alcarta gleich. (Auch Hotkeys veränderbar) 
        	Zeilen 200-221 = QuickHelp für die Buttons 

RS.BAT     [v]  	PATH  (Batch und Parameter für den PRESTO-Aufruf) 
AS.BAT 	für "a99" bzw. "alcarta" (APAC-Aufruf). Obsolet: 
              	[werden nur gebraucht, wenn _rs.flx bzw. _as.flx nicht 
 	vorhanden sind] 

RS.cPR     [v]  	Lokal / ProgDir
          	(wird automatisch aus RS.APR erzeugt bei Aufruf RS.BAT) 
         	Bei Export aus PRESTO entsteht RS.SET = externe 
 	Ergebnismenge 

D-W0.APR  	DbDir / Lokal / ProgDir
                   	Default für SatzAnzeige, wenn D-W.cPR fehlt 

E-W0.APR    	Lokal / ProgDir
            	Default für Export und externes Edit, wenn E-W.cPR fehlt 

DOOR.BAT [v]  	PATH
             	Aufruf eines externen Programms über die Schaltfläche 
            	mit der Tür. Wenn dieses eine Datei EXTERN.DAT erzeugt, 
        	kann diese anschließend eingelesen werden über 
             	Menü "Datei / Externe Ergebnismenge" 
             	Siehe Kommentar in DOOR.BAT. 
           Aber:
_DOOR.FLX 	ProgDir\FLEX
 	Wenn allerdings _DOOR.FLX existiert, wird dieser 
 	ausgeführt statt DOOR.BAT. 

PHRASE.A99 [v]	Lokal
	Enthält die Codes für Sonderzeichen. Einige können mit 
	Strg+x abgerufen werden, andere mit \ und nachfolgendem 
        	Groß- oder Kleinbuchstaben. Statt \ kann ein anderes 
  	Zeichen in der INI festgelegt werden (z.B. ESC=43 für +) 
   	Wenn \ (oder +) selbst einzugeben ist, dann \\ (bzw. ++) 
 	(Keine Kommentare oder Leerzeilen in PHRASE.A99 . ) 
 	Je Phrase exakt 2 Zeilen: 
 	Zeichen oder ASCII-Nummer
   	Ersatztext oder ASCII-Nummer
	Hinweis: im DOS-Fenster Schriftgröße 8x13 oder 10x19, 
	einstellen, damit man die korrekten Sonderzeichen sieht. 
	Enthält auch die Uservariablen #uXi (i=0...9), die für 
  	FLEXe verwendet werden (Alt+1 = #uX1 ...) 
              [v]	Eine Phrasendatei mit anderem Namen kann in der INI mit 
	dem Schlüssel  Phrase=...  vorgegeben werden. 

PHRASEN 	ProgDir
	Enthält eine erste Grundausstattung von Phrasen, 
	hauptsächlich Sonderzeichen. 
	Wird geladen, wenn beim ersten Start keine 
    	Datei PHRASE.A99 gefunden wird. 
    	Geben Sie "h phras" ein, dann kommt das Phrasen-Menü. 
	Darauf gibt es einen Flip "Standard-Phrasen laden" 
  	Wenn man diesen anklickt, wird die Daten PHRASEN neu 
	geladen. 

2. Datenbankspezifisch 
	dbn = Datenbankname (darf nur bis zu 4 Zeichen lang 
	sein.) Der eigene dbn wird in der INI mit DbName= gesetzt. 

xyz.INI    [X]	Name und Standort beliebig, Aufruf sollte erfolgen mit 
      	ProgDir\allegro.exe pfad\xyz.ini

 	also z.B. 
   	c:\allegro\allegro.exe c:\bolero\bol.ini  
	(wenn ProgDir nicht in bol.ini drinsteht)  oder 
   	allegro cat.ini   
	(wenn cat.ini auf Startverz. liegt und ProgDir drinsteht) 
   	allegro cat            (geht auch) 
    	Empfehlung: A99.INI als Vorlage nehmen. 

HE_??GER  [v]	Allgemeine Hilfedateien   (==> Datei HELP.RTF) 
...          	Lokal / DbDir / ProgDir\HELP / ProgDir\FLEX / ProgDir (.) 
xyzGER.rtf    	(datenbankspezif. Versionen, andere Sprachen möglich) 
dbnGER.RTF [o]	Datenbankspezifische, generelle Hilfe. Standort: DbDir 
  alcarta:    	dbn = Name der Datenbank. Vorbild: CATGER.RTF oder 
  HA statt HE 	eine der anderen Demo-Datenbanken. 
            	Default (wenn fehlend): genrlGER.rtf / genrleng.rtf

   Hilfedateien werden zuerst mit, dann ohne Sprachkennung gesucht. 

HE_InGER [o]  	DbDir / ProgDir\HELP
  bzw.        	n=1...9,0,;  Registerspezifische Hilfeseiten, erscheinen 
HA_InGER    	bei Button [?] des Indexfensters 
              	Default wenn nicht vorhanden: HE_IXGER 

*.RTF   [o]  	DbDir / ProgDir\HELP / ProgDir\FLEX / ProgDir / Lokal (.) 
           	(==> HELP.RTF, FLIP.RTF) 
     	Spezifische, selbstgestaltete Hilfedateien (Aufruf über 
 	Flips), Erstellung u. Bearb. mit WordPad oder direkt im 
	Anzeigefeld 

*.HTM   [o]  	ProgDir\HTML
       	Lokale HTML-Dateien für das Browser-Programm JanaS 

Datenbank 	DbDir
	Eine Datenbank besteht aus folgenden Dateien: 
	(dbn = normalerweise CAT, c = normalerweise A) 
   	dbn_*.cLD, dbn.cDX, dbn.TBL, dbn.STL, dbn.RES

dbn.cPI  [X]  	DbDir / PogDir  
	Indexparameter (welche Felder kommen in welche Register)
	Wichtig: Symbolische Registernamen einrichten. (s. CAT.API) 
   	Registerüberschriften, Titel der Datenbank 
  	Auch hier ist O.cPT einzubinden, siehe D-WRTF.cPR, 
  	d.h. diese Zeile ist darin notwendig:  
     	to   (falls man nicht intern Unicode hat) 

$c.CFG	DbDir / ProgDir, auch Lokal möglich 
  oder c.CFG 	Konfigurationsdatei [unveränderte DOS-Datei] 
	Standard: $A.CFG 
	Der Buchstabe  c  tritt in den Namen der 
	Datenbankdateien auf, siehe oben: z.B.  dbn.cDX 

dbn.FRM  [o]	DbDir / ProgDir\HELP / ProgDir / Lokal
     	Erfassungsformulare. (Mehr dazu: `FORM.RTF` und `INPUT.RTF`) 

*.FLX    [o]	DbDir / ProgDir\FLEX / ProgDir / Lokal
     	FLEX-Dateien (siehe FLEXGER.RTF) 
        	Start über Flip oder von außen (EXFLEX.TXT, FLEX.EXE) 

oninput.flx [X]	DbDir / ProgDir\FLEX
	Wird aktiv bei Button [Neusatz]  (= F9)
	Beseitigen, wenn bei Druck auf [Neusatz] die Standard- 
	Auswahl (Kopie / Neueingabe) erscheinen soll 

onforms.flx [X]	DbDir / ProgDir\FLEX
     	Wird aktiv bei Button [Form. #]  (= Alt+#)
	Beseitigen oder modifizieren, wenn nicht mit dem 
     	Standardsystem gearbeitet wird 

*.VW    [o]  	DbDir / ProgDir\VIEW / ProgDir\HELP / ProgDir / Lokal
	ViewListen (mehr dazu: "h viewlist" eingeben) 
	Anzeigen mit FLEX-Befehl  View name 
 	oder direkt durch  v name  im Schreibfeld. 

input.vw  [X]	DbDir / ProgDir\HELP
   	Auswahlliste für die Satztypen bei der Neueingabe 
	Anpassen für die eigene Datenbank, falls nicht Standard 
	oder oninput.flx löschen 

dbn.SGF 	DbDir
   	Signalfile. Wenn es mit '1' beginnt, dann kein Zugang 
 	zur Datenbank, Programm beendet sich. Hinter der '1' 
   	kann eine Begründung stehen für den Nutzer. 

D-WRTF.cPR [X]	DbDir / ProgDir   (meist aus D-1.cPR abgeleitet) 
D-W0.APR  	(wenn andere gewünscht: Befehl 
 	DisplayParameter/OpacDisplay in .INI) 
	Einbinden:  O.cPT, D.cPT, D-RTF.cPT, 
	d.h. folgende Zeilen einbauen: 
  	to          o.apt = ASCII <-> ANSI Tabelle für div. Zwecke 
  	td          d.apt = ASCII -> ANSI für Anzeigefeld 
  	td-rtf     d-rtf.apt = RTF-Schriftattribute für Anzeige 
     	egal an welcher Stelle. 
    	Außerdem 
	-->   Es muß darin einen Abschnitt #-( für die 
	Internanzeige geben 
   	Siehe D-WRTF.APR: den Abschnitt kann man kopieren. 
   	Wenn Flips gewünscht, müssen sie in dieser Datei 
  	programmiert werden (s. news 52) 
 	Wenn D-WRTF.cPR fehlt, wird als Ersatz D-W0.APR 
	genommen, dann hat man aber nur eine Anzeige mit 
	Kategorienummern. 
	(gilt für jedes Kategorienschema, d.h. Kopie nicht nötig) 
   Alternative: 	Es gibt kommentierte Grundmodelle für die 
	Anzeigeparameter: 
 	D-SRTF.APR und D-KRTF.APR  für Daten ohne bzw. mit 
	verknüpften Sätzen. Eingebunden sind darin 
	D-S.APT und D-K.APT, und nur 
	in diese muß man eingreifen. (Mehr dazu in `Vb.154`) 

E-W.cPR   [o]	DbDir / ProgDir   für Export und externes Edit. 
E-W0.APR 	(Änderung: Befehl  ExportParameter in .INI) 
         	wenn nicht da, wird E-W0.APR genommen 

P-W.cPR  [X]	DbDir / Lokal / ProgDir
P-W0.cPR  	Druckformat. 
	(wenn andere gewünscht: Befehl  PrintParameter in .INI) 
     	(z.B. Modifikation von D-WRTF.APR, ohne Flips etc.) 
     	P-W0.APR ist Default, wenn P-W.cPR fehlt. 
 	P-W0.cPr kann Kopie von P-W0.APR sein. 

D-RTF.cPT [v]	DbDir / Lokal / ProgDir
   	RTF-Steuerzeichen (Fett etc., Farben. Kopie von D-RTF.APT) 
  	(einbinden in Anzeigeparameter und RTF-Exporte.) 

               [v]	DbDir / ProgDir
DISPHEAD.RTF	für die Anzeige eines Datensatzes 
LISTHEAD.RTF	für Listen (Index- und Kurzanzeige: Button [List]) 
LONGHEAD.RTF	für Anzeige in Druckform (Menü "Ansicht") 
HELPHEAD.RTF	für Anzeige von TXT-Dateien als Help-Dateien 
	Headerdateien für RTF-Anzeige. Werden automatisch 
	benutzt. 
 	Datenbankspezifische Versionen möglich (Schriftarten.) 
	Nicht mit WinWord bearbeitbar, weil es keine vollständigen 
  	RTF-Dateien sind. Änderung nur nötig, wenn man spezielle 
 	Effekte oder Schriften in Anzeige oder Export wünscht. 

3. Defaults 
	DbDir / Lokal / ProgDir 

O.APT  [v]  	Eine  o.apt  muß es meistens geben. 
		(darin steht ein Kommentar) 
D.APT  [v]	Beide sind Tabellen für Zeichen-Umcodierung  ASCII-ANSI 
          	Kopie machen:  o.cpt und d.cpt für eigene Konf. c.CFG 
   	Werden automatisch geladen, wenn Befehle to und td 
 	fehlen. 
      	O.APT  für Index- UND Anzeigeparameter, 
    	enthält nur o-Befehle, arbeitet in beiden Richtungen 
      	d.h. muß in beiden Richtungen (ASCII<->ANSI) eindeutig sein. 
    	Macht eine 1:1-Zuordnung, wie sie für spaltengenaue 
     	Anzeigen gebraucht wird (Index, Kurzliste) 
 	Wichtig auch für die Anzeige der Daten in dem 
	Auswahlfeld links und für externes Editieren. 

	D.APT: ASCII->ANSI NUR für Anzeige- und 
	Exportparameter, enthält nur p- und q-Befehle fürs 
	Anzeigefeld (Umlaute, Akzentbuchstaben, Sonderzeichen) 
 	Diese Tabelle braucht nicht 1:1 zu sein. 

E.ADT  [o]	Lokal
  	Enthält Kategorien, die mit Alt+„ eingelesen werden 
 	(oder über Menü "Bearbeiten / Get") 
	Erfassungshilfe zum Einfügen immer gleicher Kategorien. 

EBOX.ICO  [o]	Standort egal. Braucht man nur für Desktop 

A-TIMES.TTF	Müssen ordnungsgemäß als Schriftarten installiert sein 
A-LUCIDA.TTF	(Standort meistens C:\WINDOWS\FONTS) 
     	A-LUCIDA für spaltenrichtige Anzeigen. 
     	Wenn nicht installiert, hat man keine bibl.spezifischen 
	Sonderzeichen 
A-ARIAL.TTF	Optional (Alternative zu A-TIMES) 
A-LETTER.TTF	Optional (Alternative zu A-LUCIDA) 
A-DOS.TTF 	für das DOS-Fenster. Schriftgröße 8x13 und 9x15 

Nur zur Information 

4. Dynamische Dateien (nur bei Bedarf zur Laufzeit, kein Eingriff sinnvoll) 

Standort: alle auf dem Verzeichnis TEMP des Systems 

OUTPUT.ADT	Entsteht als Default-Exportdatei (OutputFile=...) 
  	(ändern: Befehl OutputFile in .INI) 

EXX.XXX 	Zum externen Editieren des aktuellen Datensatzes 
 	(ändern: Befehl ExEdFile in .INI) 

RS.SET 	Aus PRESTO/APAC mit RS.APR exportierte Ergebnismenge, 
    	wird bei Rückkehr als Erg.Menge präsentiert 

Die folgenden Dateien existieren nur während einer Sitzung, oder wenn man die Sitzung später fortsetzen will: 
dbn._1  	Bookmarks 
dbn._2  	History list 
dbn._i  	Erg.Mengen (Nummernlisten) 
dbn.$$$  	Hilfsdatei mit Kopien von Sätzen 
dbn.TAB  	Hilfstabelle (Adressentabelle der OfflineDatei) 
dbn.RSS 	Hilfstabelle (Ergebnismengen-Namen) 
dbn.RXX 	Hilfstabelle (nur bei a99) 

Diese Dateien können alle gelöscht werden, wenn man die Sitzung nicht 
fortsetzen will. Manuelle Eingriffe sind nicht sinnvoll. 
                                                                          (2004-11-22/2021-11-07) 

?Vb.154=h vb154=Muster  
?Hilfetext zur Installation=h inst 
?FORM.RTF=h form 
?INPUT.RTF=h input 
?allegro-Website=x jan http://www.allegro-b.de/doku 
?Kap.0.3=h ac0-3