Pragma UTILITY MODE

Das Pragma UTILITY MODE legt fest, ob für die SQL-Anweisung, in der dieses Pragma angegeben ist, die Transaktionssicherung wirksam sein soll. Die Transaktionssicherung ermöglicht, dass im Fehlerfall eine Transaktion auf einen konsistenten Zustand zurückgesetzt wird.

Das Pragma UTILITY MODE ist nur in der SQL-Anweisung ALTER TABLE wirksam.

Es wirkt nur, wenn die ALTER TABLE-Anweisung Spalten einer Basistabelle hinzufügt, ändert oder löscht. Bei einer ALTER TABLE-Anweisung, die Integritätsbedingungen zufügt oder löscht, bleibt das Pragma UTILITY MODE ohne Wirkung.

---

UTILITY MODE {ON | OFF}

---

ON

Bei der Ausführung der SQL-Anweisung wird die Transaktionssicherung ausgeschaltet. Die zugehörige ALTER TABLE-Anweisung eröffnet keine Transaktion. Sicherungsdaten für die ALTER TABLE-Anweisung werden nicht gespeichert. Führt ein Fehler zum Abbruch der Anweisung, ist das Rücksetzen auf einen konsistenten Zustand nicht möglich. Der Space, auf dem die zu ändernde Basistabelle liegt, ist im Fehlerfall defekt und muss mit Hilfe der Utility-Anweisung RECOVER repariert werden (siehe Handbuch „ SQL-Sprachbeschreibung Teil 2: Utilities“).

OFF

Das Pragma hat keine Auswirkungen. Die Transaktionssicherung bleibt eingeschaltet.

Eine ALTER TABLE-Anweisung, für die das Pragma UTILITY MODE ON eingeschaltet und wirksam ist, wird in folgenden Fällen mit Fehlermeldung abgebrochen:

• wenn eine Transaktion aktiv ist

• wenn es sich um eine ALTER TABLE-Anweisung zum kaskadierenden Löschen einer Spalte handelt, nämlich mit DROP COLUMN spalte CASCADE

• wenn es sich um eine ALTER TABLE-Anweisung zum Löschen einer Spalte handelt und noch ein Index für diese Spalte definiert ist

• wenn es sich um eine ALTER TABLE Anweisung zum Hinzufügen einer Spalte mit Indexdefinition für diese Spalte handelt

Wenn Sie für eine ALTER TABLE-Anweisung das Pragma UTILITY MODE nicht angeben, gilt als Standardeinstellung UTILITY MODE OFF.

ACHTUNG! Das Pragma UTILITY MODE ON hat zur Folge, dass nach einem Fehler oder Consistency Check der Space, auf dem die zu ändernde Basistabelle liegt, defekt ist. Um Datenverlust zu vermeiden, sollten Sie vor Eingabe der ALTER TABLE- Anweisung den Space sichern. Sie brauchen die Sicherung, wenn Sie einen defekten Space mit Hilfe der Utility-Anweisung RECOVER reparieren wollen.