Eintrag in das CALL-DML-Tabellenverzeichnis einfügen
Geltungsbereich
DBH-Administration
Siehe auch
DBH-Startanweisung ADD-OLD-TABLE-CATALOG-LIST auf "ADD-OLD-TABLE-CATALOG-LIST"
DBH-Startanweisung ADD-SQL-DATABASE-CATALOG-LIST auf "ADD-SQL-DATABASE-CATALOG-LIST"
DBH-Option OLD-TABLE-CATALOG auf "OLD-TABLE-CATALOG"
Funktionsbeschreibung
Die Anweisung ADD-OLD-TABLE-CATALOG-ENTRY fügt einen Eintrag in das CALL-DML-Tabellenverzeichnis ein.
Damit Sie über diese Administrationsanweisung einen neuen Eintrag einfügen können, muss im CALL-DML-Tabellenverzeichnis noch ein freier Eintrag vorhanden sein. Sind im CALL-DML-Tabellenverzeichnis bereits alle Einträge belegt, so wird die Administrationsanweisung abgelehnt und Sie erhalten eine Fehlermeldung.
Der logische Datenbankname, dem Sie die CALL-DML-Tabelle zuordnen wollen, muss im SQL-Datenbankverzeichnis eingetragen sein. Mit der Administrationsanweisung SHOW-SQL-DB-CATALOG-ENTRIES können Sie dies prüfen. Existiert der logische Datenbankname nicht, so ist die CALL-DML-Tabelle, die Sie eintragen wollen, nicht zugreifbar. Die CALL-DML-Tabelle bleibt auch dann nicht zugreifbar, wenn Sie den logischen Datenbanknamen nachträglich ergänzen, z.B. über die Administrationsanweisung ADD-SQL-DB-CATALOG-ENTRY oder über die CREATE CATALOG-SQL-Anweisung.
Der CALL-DML-Tabellenname (auch wenn es sich um ein Replikat handelt) muss eindeutig sein, d.h. dieser Name darf im CALL-DML-Tabellenverzeichnis nicht bereits existieren.
SESAM/SQL prüft nicht, ob die CALL-DML-Tabelle, die Sie eintragen wollen, auch wirklich existiert. Es wird auch nicht geprüft, ob die Tabelle für CALL-DML zugreifbar ist.
Ist die CALL-DML-Tabelle nach Annahme der Administrationsanweisung nicht verfügbar, so werden alle folgenden CALL-DML-Open-Anweisungen mit Status abgewiesen. Wird die entsprechende CALL-DML-Tabelle nachträglich mit der SQL-Anweisung CREATE TABLE erzeugt, so wird sie erst dann für CALL-DML zugreifbar, wenn Sie mit der Administrationsanweisung REUSE-OLD-TABLE-CATALOG-ENTRY einen gültigen Verweis auf den bereits bestehenden Eintrag herstellen.
ADD-OLD-TABLE-CATALOG-ENTRY |
CALL-DML-TABLE-NAME = <text 1..17> ,CATALOG-NAME = <filename 1..18 without-cat-user-gen-vers> ,SCHEMA-NAME = <c-string 1..31 with-lower-case> ,TABLE-NAME = <c-string 1..31 with-lower-case> |
Operandenbeschreibung
CALL-DML-TABLE-NAME = <text 1..17>
Name der CALL-DML-Tabelle, wie er in der CALL-DML-Open-Anweisung verwendet wird. Diesen Namen müssen Sie in voller Länge (17) angeben. Er muss eindeutig sein, auch wenn es sich um ein Replikat handelt.
CATALOG-NAME = <filename 1..18 without-cat-user-gen-vers>
Logischer Datenbankname der Datenbank, der die CALL-DML-Tabelle zugeordnet werden soll. Dieser Name muss im SQL-Datenbankverzeichnis eingetragen sein.
SCHEMA-NAME = <c-string 1..31 with-lower-case>
Name des Schemas, dem die CALL-DML-Tabelle zugeordnet werden soll.
TABLE-NAME = <c-string 1..31 with-lower-case>
Name der Basistabelle, dem der CALL-DML-TABLE-NAME entspricht.
Administrationskommando im ISP-Format und an der CALL-DML-Schnittstelle
Hier entspricht der Administrationsanweisung ADD-OLD-TABLE-CATALOG-ENTRY das Administrationskommando OPT,CDBC-INS.
OPT,CDBC-INS,C[ALL-DML-]T[ABLE]=call-dml-table-name
,C[ATALOG]=catalog-name
,S[CHEMA]=schema-name
,T[ABLE]=table-name
call-dml-table-name, catalog-name, schema-name und table-name dürfen als Zeichen keine Kommata enthalten, da Kommata als Trennzeichen fungieren.
Wenn Sie die Eingabe des Administrationskommandos OPT,CDBC-INS mit einem Komma abschließen, so erwartet der DBH für diesen Eintrag noch Folgeangaben.
Um eine korrekte Zuordnung zu gewährleisten, müssen Sie Folgeangaben zu einem Eintrag stets mit dem Parameter CALL-DML-TABLE=call-dml-table-name versehen!
Soll der DBH das Administrationskommando ausführen, so dürfen Sie das Kommando nicht mit einem Komma abschließen. Wenn Sie die Eingabe des Administrationskommandos mit einem Komma abschließen und gleich darauf ein anderes Administrationskommando eingeben, so führt der DBH das zuvor begonnene Administrationskommando nicht aus und Sie erhalten eine Fehlermeldung.
Bei Eingabe über INFORM-PROGRAM wird automatisch von Klein- auf Grossschreibung konvertiert. Wenn schema-name oder table-name im Catalog also Kleinbuchstaben enthalten, dann wird bei Eingabe über INFORM-PROGRAM kein verwendbarer CBDC-Eintrag erzeugt.