|
Zwischen EXTEND und DBTT ist genau ein Leerzeichen anzugeben. Weitere Leerzeichen sind in diesem DAL-Kommando nicht erlaubt.
dbname
Name der Datenbank, zu der die Satzart gehört, für die die Online-DBTT-Erweiterung durchgeführt werden soll. Die Datenbank und der entsprechende Realm müssen zum Zeitpunkt des DAL-Kommandos bereits zugeschaltet sein und die Online-Realm-Erweiterung muss aktiviert sein.
recordref
Nummer der Usersatzart, für die die Online-DBTT-Erweiterung durchgeführt werden soll.
Die recordrefs der Satzarten können Sie mit dem DAL-Kommando DISPLAY DBTT-INCR anzeigen lassen oder Sie können sie dem BPSIA-Protokoll entnehmen.
recordref=1 wird UDS/SQL-intern genutzt und kann hier nicht angegeben werden.
extnmbr
Anzahl der Einträge, um die die DBTT mindestens erweitert werden soll.
Die Angabe muss größer oder gleich 1 und kleiner oder gleich 99999999 sein.
Falls der Parameter nicht angegeben ist, wird die Erweiterungsgröße intern berechnet.
Durch das DAL-Kommando EXTEND DBTT wird unabhängig von einer Aktivierung der Online-DBTT-Erweiterung beim nächsten Einspeichern eines Satzes in dieser Satzart genau eine Online-DBTT-Erweiterung durchgeführt. Dabei ist Voraussetzung, dass die Online-Erweiterbarkeit des betreffenden Realms aktiviert ist und der Realm zugeschaltet ist. Die erfolgreiche Erweiterung wird mit der Meldung UDS0741 mitgeteilt.
Da das DAL-Kommando erst beim nächsten Einspeichern eines Satzes in dieser Satzart ausgeführt wird, hängt der Zeitraum zwischen dem Absetzen des Kommandos und der Durchführung der Erweiterung nur von der Einspeicherung neuer Sätze durch die aktuell aktiven Anwendungen ab.
Ob ein EXTEND-DBTT-Auftrag noch vorgemerkt ist, können Sie mit DISPLAY DBTT ermitteln.
Wird der Realm, in dem die DBTT enthalten ist, abgeschaltet, dann wird ein noch nicht ausgeführter EXTEND-DBTT-Auftrag ohne zusätzliche Meldung annulliert. Diese Annullierung wird insbesondere auch beim Abschalten der entsprechenden Datenbank sowie beim Sessionende des DBH durchgeführt.
Der EXTEND-DBTT-Auftrag wird beim nächsten Speichern eines Satzes ausgeführt, auch wenn es dabei bei aktivierter Online-DBTT-Erweiterung zeitnah zu zwei Erweiterungen kommen kann, weil parallel in einer anderen Transaktion aufgrund der aktivierten Online-DBTT-Erweiterung ebenfalls eine DBTT-Erweiterung ausgeführt wird.
Werden mehrere EXTEND-DBTT-Aufträge hintereinander abgesetzt, bevor der nächste Satz der entsprechenden Satzart gespeichert wird, so wird die DBTT-Erweiterung nur einmal ausgeführt und zwar mit der zuletzt angegebenen Erweiterungsgröße.
In der Regel wird die tatsächliche Anzahl der DBTT-Einträge, um die erweitert wird, etwas größer als die gewünschte Anzahl sein. Die tatsächliche Anzahl hängt von folgenden Faktoren ab:
Seitengröße der Datenbank (2K, 4K oder 8K)
DBTT-Zeilenlänge der jeweiligen Satzart
Abhängig von diesen Faktoren gibt es eine Obergrenze für die mögliche Erweiterungsanzahl, auf die bei größeren Angaben automatisch reduziert wird.
Falls es innerhalb der DBTT-Erweiterung zu Engpässen kommt, kann die Anzahl der Einträge, um die erweitert wurde, auch geringer als die gewünschte Anzahl sein. In jedem Fall wird die Anzahl der DBTT Einträge, um die tatsächlich erweitert wurde, mit entsprechender Meldung ausgegeben.
Scheitert ein vorliegender EXTEND-DBTT-Auftrag, weil die Online-Realm-Erweiterung suspendiert oder weil die Maximalgröße der DBTT erreicht ist, wird die Online-Erweiterung der betreffenden DBTT im aktuellen Sessionabschnitt ausgesetzt und es wird eine entsprechende Fehlermeldung ausgegeben. Diese Meldung wird bei jedem neuen EXTEND-DBTT-Auftrag wieder ausgegeben, unabhängig davon, ob in dem aktuellen Suspendierungsabschnitt bereits eine diesbezügliche Meldung ausgegeben wurde oder nicht.
Liegt ein EXTEND-DBTT-Auftrag vor, wenn die Online-Realm-Erweiterung des betreffenden Realms deaktiviert wird, so wird der EXTEND-DBTT-Auftrag ohne zusätzliche Meldung annulliert.