Status einer Datenbank ändern
Geltungsbereich
DBH-Administration
Siehe auch
Administrationsanweisung SHOW-SQL-DB-CATALOG-ENTRIES auf "SHOW-SQL-DB-CATALOG-ENTRIES"
Funktionsbeschreibung
Die Anweisung SET-SQL-DB-CATALOG-STATUS ändert den Status einer Datenbank.
Die möglichen Stati einer Datenbank und ihre jeweilige Bedeutung sind in der Funktions- beschreibung zur Administrationsanweisung SHOW-SQL-DB-CATALOG-ENTRIES erläutert..
Abhängig vom momentanen Status der Datenbank, also dem Status vor Eingabe der Administrationsanweisung, führt die Anweisung SET-SQL-DB-CATALOG-STATUS zu unterschiedlichen Reaktionen. Zu unterscheiden sind folgende Fälle:
Vor Eingabe der Administrationsanweisung ist der Status der Datenbank ACTIVE:
wenn Sie in der Administrationsanweisung STATUS = ACTIVE angeben, so erfolgt keine Reaktion. Der Status der Datenbank bleibt ACTIVE
wenn Sie in der Administrationsanweisung STATUS = FREE angeben, dann wird der Aufruf einsynchronisiert, falls interne oder externe Transaktionen auf dieser Datenbank offen sind. Nach Abschluss der Synchronisation wird die Datenbank physikalisch geschlossen, und der Status der Datenbank wird im SQL-Datenbankverzeichnis auf FREE gesetzt.
Vor Eingabe der Administrationsanweisung ist der Status der Datenbank FREE oder LOCKED.
wenn Sie in der Administrationsanweisung STATUS = ACTIVE angeben, so wird die Datenbank physikalisch geöffnet
wenn Sie in der Administrationsanweisung STATUS = FREE angeben, so erfolgt keine Reaktion. Der Status der Datenbank bleibt FREE.
Vor Eingabe der Administrationsanweisung ist der Status der Datenbank CLOSED.
wenn Sie in der Administrationsanweisung STATUS = ACTIVE angeben, so erfolgt keine Reaktion. Der Status der Datenbank bleibt CLOSED
wenn Sie in der Administrationsanweisung STATUS = FREE angeben, so wird die Datenbank physikalisch geschlossen und freigegeben.
Wenn der Status der Datenbank RECOVER, REFRESH oder REORG ist, dann können Sie mit dieser Anweisung keine Statusänderung erreichen.
SET-SQL-DB-CATALOG-STATUS | ||||||||||||||||||||||||
| ||||||||||||||||||||||||
Operandenbeschreibung
STATUS = *ACTIVE / *FREE
Status, auf den die Datenbank gesetzt werden soll.
SELECT =
Legt fest, über welchen Namen der Eintrag identifiziert wird.
SELECT = *LOGICAL(...)
Der Eintrag wird über den logischen Datenbanknamen identifiziert.
CATALOG-NAME =
<filename 1..18 without-cat-user-gen-vers>
Logischer Datenbankname der Datenbank, deren Status geändert werden soll.
SELECT = *PHYSICAL(...)
Der Eintrag wird über den physikalischen Datenbanknamen identifiziert.
PHYS-CATALOG-NAME =
<filename 1..18 without-cat-user-gen-vers>
Physikalischer Datenbankname der Datenbank, deren Status geändert werden soll.
Administrationskommando im ISP-Format und an der CALL-DML-Schnittstelle
Hier entspricht der Administrationsanweisung SET-SQL-DB-CATALOG-STATUS das Administrationskommando OPT,DBC-UPD.
OPT,DBC-UPD,supplement,S[TATUS]=state
supplement ::= {C[ATALOG]=catalog-name|P[HYSICAL-NAME]=physical-name}
state ::= {A[CTIVE] | F[REE]}