Gültigen Verweis auf Tabelleneintrag in dem CALL-DML-Datenbankverzeichnis herstellen
Geltungsbereich
DBH-Administration
Siehe auch
Administrationsanweisung ADD-OLD-TABLE-CATALOG-ENTRY auf "ADD-OLD-TABLE-CATALOG-ENTRY"
Administrationsanweisung SHOW-OLD-TABLE-CATALOG-ENTRIES auf "SHOW-OLD-TABLE-CATALOG-ENTRIES"
Funktionsbeschreibung
Mit der Anweisung REUSE-OLD-TABLE-CATALOG-ENTRY wird versucht, für einen Eintrag in dem CALL-DML-Datenbankverzeichnis einen gültigen Verweis auf eine Tabelle herzustellen.
Bevor diese Anweisung aufgerufen wird, muss der angesprochene Eintrag mit dem CALL-DML-Tabellennamen im CALL-DML-Datenbankverzeichnis vorhanden sein, ansonsten wird die Anweisung abgelehnt.
Der Tabellentyp wird dabei nicht geprüft. Der Anwender muss selber darauf achten, dass nur Verweise auf Tabellen vom Typ Nur-CALL-DML oder CALL-DML-/SQL hergestellt werden.
Existiert die Tabelle in der Datenbank nicht, kann keine Zuordnung hergestellt werden. Der Eintrag verbleibt im Zustand "invalid". Wenn die Datenbank zum Zeitpunkt des Aufrufs nicht eröffnet ist, bleibt der Eintrag ebenfalls im Zustand "invalid".
Wenn Sie keinen CALL-DML-Tabellennamen angeben beim Aufruf, so wird die Aktion für alle Einträge des CALL-DML-Datenbankverzeichnisses durchgeführt, die den Status "invalid" haben. Wenn kein Eintrag den Status "invalid" hat, wird die Anweisung ohne Fehlermeldung ignoriert.
War der Aufruf erfolgreich, ist der Eintrag anschliessend im Zustand "valid". Es kann nun auf die angegebene Tabelle mit CALL-DML zugegriffen werden.
War der Aufruf nicht erfolgreich, ist die Tabelle nicht verfügbar und damit im Zustand "invalid". Nachfolgende CALL-DML-Anweisungen werden mit Status-Meldung abgewiesen.
Wird die entsprechende Tabelle nachträglich mit der SQL-Anweisung CREATE TABLE erzeugt, so ist sie zunächst noch nicht für CALL-DML zugreifbar. In diesem Fall müssen Sie nach dem CREATE TABLE die Administrationsanweisung ADD-OLD-TABLE-CATALOG-ENTRY oder REUSE-OLD-TABLE-CATALOG-ENTRY mit einem entsprechenden Tabelleneintrag eingeben.
REUSE-OLD-TABLE-CATALOG-ENTRY |
CALL-DML-TABLE-NAME = *ALL / <text 1..17> |
Operandenbeschreibung
CALL-DML-TABLE-NAME = *ALL / <text 1..17>
Name der CALL-DML-Tabelle (maximal 17-stellig). Beim Standardwert *ALL wird versucht, für alle Tabelleneinträge im CALL-DML-Datenbankverzeichnis einen gültigen Verweis herzustellen.
Administrationskommando im ISP-Format und an der CALL-DML-Schnittstelle
Hier entspricht der Administrationsanweisung REUSE-OLD-TABLE-CATALOG-ENTRY das Administrationskommando OPT,CDBC-REUSE.
OPT,CDBC-REUSE[,C[ALL-DML-]T[ABLE]=call-dml-table-name]
call-dml-table-name darf als Zeichen keine Kommata enthalten, da Kommata als Trennzeichen fungieren.