Einträge in das SQL-Datenbankverzeichnis einfügen
Zugehörigkeit
Zweite DBH-Startanweisung
Funktionsbeschreibung
Die DBH-Startanweisung ADD-SQL-DATABASE-CATALOG-LIST dient dazu, das SQL-Datenbankverzeichnis mit Einträgen zu versorgen. In das SQL-Datenbankverzeichnis tragen Sie die Datenbanken ein, auf die der DBH während einer DBH-Session potenziell zugreifen soll. Der DBH kann im Laufe der Session nur auf Datenbanken zugreifen, die im SQL-Datenbankverzeichnis eingetragen sind.
Jede Datenbank im SQL-Datenbankverzeichnis wird identifiziert durch den logischen Datenbanknamen. Der logische Datenbankname ist der Name, mit dem ein Anwenderprogramm eine SESAM/SQL-Datenbank anspricht. Existiert zu dem logischen Datenbanknamen keine SESAM/SQL-Datenbank desselben Namens, erfolgt die Zuordnung zu einer existierenden Datenbank über den physikalischen Datenbanknamen. Der physikalische Datenbankname ist der Name der real existierenden SESAM/SQL-Datenbank.
Über einen Eintrag (Entry) ordnen Sie jeder Datenbank eine BS2000-Benutzerkennung (DB-Kennung) zu, tragen das entsprechende BS2000-Kennwort ein, ordnen dem logischen Datenbanknamen den physikalischen Datenbanknamen zu und regeln den Zugriff auf die Datenbank. Zu jedem Eintrag fügt SESAM/SQL während der laufenden DBH-Session noch den jeweils gültigen Status der Datenbank ein (siehe auch Administrationsanweisung SHOW-SQL-DB-CATALOG-ENTRIES auf "SHOW-SQL-DB-CATALOG-ENTRIES").
Die maximal zulässige Anzahl von Datenbank-Einträgen wird durch die DBH-Option SQL-DATABASE-CATALOG bestimmt (siehe "SQL-DATABASE-CATALOG"). Ihr Standardwert beträgt 1, kann aber bis zu einem Wert von 254 zulässigen Einträgen erhöht werden. Tragen Sie mehr Datenbanken ein, als maximal zulässig, so erhalten Sie eine Fehlermeldung.
Innerhalb einer Startanweisung dürfen Sie maximal 100 Datenbanken eintragen. Wollen Sie mehr als 100 Datenbanken eintragen, so müssen Sie die DBH-Startanweisung ADD-SQL-DATABASE-CATALOG-LIST erneut eingeben und zwar so oft, bis Sie alle gewünschten Datenbanken eingetragen haben.
Es ist auch möglich, die benötigten Datenbanken über mehrere ADD-SQL-DATABASE-CATALOG-LIST-Anweisungen in Gruppen einzugeben.
In jedem Fall müssen Sie die Parametereingabe der ADD-SQL-DATABASE-CATALOG-LIST-Anweisung mit der Anweisung END abschließen. Anschließend können Sie die Anweisung END erneut eingeben. Die zweite END-Anweisung schließt die Eingabe der
DBH-Startanweisungen insgesamt ab. Sie dürfen die zweite END-Anweisung an dieser Stelle nicht eingeben, wenn Sie über die Startanweisung ADD-OLD-TABLE-CATALOG-LIST noch Einträge in das CALL-DML-Tabellenverzeichnis einfügen wollen.
Es ist erlaubt, weniger Datenbanken einzutragen, als in der DBH-Option SQL-DATABASE-CATALOG vereinbart. Freie Einträge hält SESAM/SQL für die Administration frei. Über Administrationsanweisungen können Sie während der laufenden Session Datenbank-Einträge zufügen oder auch löschen, was sich allerdings nur auf die betreffende Session auswirkt.
Beachten Sie, dass auch die Utility-Anweisung CREATE CATALOG einen freien Eintrag im SQL-Datenbankverzeichnis benötigt.
ADD-SQL-DATABASE-CATALOG-LIST | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Operandenbeschreibung
ENTRY-1 = *NONE
In das SQL-Datenbankverzeichnis wird an dieser Stelle keine Datenbank eingetragen.
ENTRY-1 = *CATALOG(...)
Erster Eintrag einer Datenbank in das SQL-Datenbank-Verzeichnis.
Sie müssen mindestens den Operanden CATALOG-NAME berücksichtigen, sonst ist der Eintrag in das SQL-Datenbankverzeichnis ungültig!
CATALOG-NAME = <filename 1..18_without_all>
Logischer Datenbankname der einzutragenden Datenbank. Der logische Datenbankname ist der Name, mit dem eine Datenbank im Anwenderprogramm angesprochen wird. Den logischen Datenbanknamen müssen Sie angeben, sonst ist der Eintrag in das SQL-Datenbankverzeichnis ungültig! Der logische Datenbankname muss eindeutig sein, d.h. Sie dürfen diesen Namen nicht mehrmals vergeben.
USER-ID = *DBH-USER-ID / <name 1..8>
DB-Kennung der Datenbank.
Der Standardwert von USER-ID entspricht der DBH-Kennung.
PASSWORD = *NONE / <c-string1..4> / <x-string 1..8> /
<integer -2147483648..+2147483647>
BS2000-Kennwort, das die Dateien der Datenbank vor unberechtigtem Zugriff schützt. Sind die Dateien der Datenbank mit einem BS2000-Kennwort geschützt, müssen Sie dieses hier eintragen. Der Standardwert *NONE bedeutet, dass die Dateien der Datenbank keinen Kennwortschutz besitzen.
PHYSICAL-NAME =
Physikalischer Name der Datenbank.
Der physikalische Datenbankname ordnet den logischen Datenbanknamen, den das Anwenderprogramm benutzt, dem Namen einer real existierenden Datenbank zu. Der physikalische Datenbankname muss eindeutig sein, d.h. Sie dürfen diesen Namen nicht mehrmals vergeben.
PHYSICAL-NAME = *STD
Der physikalische Datenbankname entspricht dem logischen Datenbanknamen, den Sie unter CATALOG-NAME vergeben haben.
PHYSICAL-NAME = <filename 1..18_without_all>
Physikalischer Datenbankname, den Sie eintragen müssen, wenn dieser vom logischen Datenbanknamen abweicht.
Der physikalische Datenbankname wird aus dem BS2000-Dateinamen des Catalog-Space einer Datenbank abgeleitet. Das Suffix .CATALOG entfällt dabei. Der BS2000-Dateiname des Catalog-Space einer Datenbank lautet:
:catid:user-id.name.CATALOG
COPY-NUMBER =
Versionsnummer des SESAM-Sicherungsbestand der angegebenen Datenbank. Der SESAM-Sicherungsbestand des Catalog-Space muss vollständig und mit der Utility-Anweisung COPY CATALOG erstellt sein.
COPY-NUMBER = *NONE
Mit dem Standardwert *NONE wird ausschließlich mit der Original-Datenbank gearbeitet..
COPY-NUMBER = <1..999999>
Versionsnummer eines SESAM-Sicherungsbestands des angegebenen CatalogSpace. Wenn Sie COPY-NUMBER angeben, wird automatisch lesender Zugriff auf die Datenbank eingetragen (siehe ACCESS = *PARAMETERS(...)).
ACCESS =
Legt fest, welche Zugriffsfunktionen auf die Datenbank erlaubt sind.
ACCESS = *ALL
Der Zugriff auf die Datenbank ist nicht eingeschränkt. Lesender und ändernder Zugriff auf Anwender- und Metadaten sind erlaubt. Der Operandenwert *ALL bezieht sich nur auf die Original-Datenbank.
ACCESS = *PARAMETERS(...)
Der Zugriff auf die Datenbank ist eingeschränkt.
Die Parameter sind hierarchisch gegliedert. Ist CAT-ADMINISTRATION zugelassen, so sind implizit auch WRITE und READ zugelassen. Ebenso lässt WRITE implizit READ zu.
Mindestens ein Parameter muss mit *YES angegeben werden.
Wenn Sie COPY-NUMBER angegeben haben, wird der Wert READ = *YES automatisch eingestellt. Eine implizite oder explizite Angabe von ACCESS = *ALL wird dann ignoriert.
Bei detaillierter Angabe der Zugriffsrechte über ACCESS = *PARAMETERS() muss explizit WRITE = *NO und CAT-ADMINISTRATION = *NO angegeben werden, darüber hinaus muss (implizit oder explizit) READ =*YES und REPLICATION = *NO gesetzt sein, ansonsten erfolgt eine Fehlermeldung.
Die Angabe der Parameter WRITE und CAT-ADMINISTRATION ist für SESAM-Sicherungsbestände nicht zulässig.
READ = *YES
Lesender Zugriff auf Anwenderdaten und Metadaten ist erlaubt. Die Daten können abgefragt, aber nicht geändert werden.
READ = *NO
Lesender und ändernder Zugriff auf Anwender- und Metadaten ist nicht erlaubt.READ = *NO können Sie nicht wählen, wenn Sie für einen der beiden Parameter CAT-ADMINISTRATION oder WRITE den Standardwert *YES vergeben.
WRITE = *YES
Lesender und ändernder Zugriff auf Anwenderdaten ist erlaubt. Metadaten dürfen gelesen, aber nicht geändert werden.
WRITE = *NO
Ändernder Zugriff auf Anwender- und Metadaten ist verboten.
WRITE = *NO können Sie nicht wählen, wenn Sie für den Parameter CAT-ADMINISTRATION den Standardwert *YES vergeben.
CAT-ADMINISTRATION = *YES
Lesender und ändernder Zugriff ist erlaubt sowohl auf Anwenderdaten als auch auf Metadaten.
CAT-ADMINISTRATION = *NO
Es ist nicht erlaubt, die Metadaten im Catalog-Space der Datenbank zu ändern. Somit sind folgende Anweisungen verboten:
SQL-Anweisungen zur Schemadefinition und -verwaltung sowie zur Verwaltung der Speicherstruktur
Utility-Anweisungen
REPLICATION = *YES
Zugriff auf ein Replikat der angegebenen Datenbank. Auf eine normale Datenbank kann mit diesem Datenbank-Eintrag nicht zugegriffen werden. Auf einem Replikat sind nur lesende Zugriffe sowie die Utility-Anweisung REFRESH REPLICATION erlaubt.
REPLICATION = *NO
Kein Zugriff auf ein Replikat
ENTRY-2 = *NONE / *CATALOG(...)
Leitet den Eintrag der zweiten Datenbank in das SQL-Datenbankverzeichnis ein. Die Operanden von ENTRY-2 sind identisch mit denen in der Operandenbeschreibung für ENTRY-1.
Innerhalb einer ADD-SQL-DATABASE-CATALOG-LIST-Anweisung können Sie bis zu 100 Datenbanken eintragen. Jeden Eintrag leiten Sie mit "ENTRY-x =..." ein, wobei der Platzhalter "x" Werte zwischen 1 und 99 annehmen kann. Der Platzhalter "x" muss für jeden Eintrag einen anderen Wert annehmen. Die zugehörigen Operanden sind stets identisch mit denen in der Operandenbeschreibung für ENTRY-1.
ENTRY-100 = *NONE / *CATALOG(...)
Leitet den Eintrag der 100. Datenbank in das SQL-Datenbankverzeichnis ein. Innerhalb einer ADD-SQL-DATABASE-CATALOG-LIST-Anweisung können Sie nicht mehr als 100 Datenbanken eintragen. Wollen Sie in der DBH-Session mehr Datenbanken berücksichtigen, müssen Sie diese Startanweisung erneut eingeben.