Einträge aus dem SQL-Datenbankverzeichnis anzeigen
Geltungsbereich
DBH-Administration
Siehe auch
DBH-Startanweisung ADD-SQL-DATABASE-CATALOG-LIST auf "ADD-SQL-DATABASE-CATALOG-LIST"
Funktionsbeschreibung
Mit der Anweisung SHOW-SQL-DB-CATALOG-ENTRIES können Sie sich Einträge im SQL-Datenbankverzeichnis anzeigen lassen. Pro Eintrag wird Folgendes ausgegeben:
der logische Datenbankname
der physikalische Datenbankname
zusätzlich die Versionsnummer des SESAM-Sicherungsbestands des Catalog-Space, falls es sich bei der Datenbank um einen SESAM-Sicherungsbestand einer Datenbank handelt
der Zugriffsmodus (Class), der für diese Datenbank erlaubt ist (READ, WRITE, ADMIN und REPLICATION)
die DB-Kennung der Datenbank (USERID)
der Status der Datenbank (Status) mit zusätzlicher Information (Info).
Folgende Stati sind möglich:
STATUS = ACTIVE, d.h. die Datenbank ist in der laufenden DBH-Session geöffnet
STATUS = CLOSED, d.h. die Datenbank ist nach PREPARE-FOREIGN-COPY mit physikalischem Schließen der Datenbankdateien geschlossen
STATUS = FREE, d.h. die Datenbank ist physikalisch geschlossen und freigegeben
STATUS = LOCKED, d.h. auf Grund einer Sperre ist die Datenbank in der laufenden Session nicht verfügbar.
Zu diesem Status erhalten Sie zusätzliche Informationen darüber, warum die Datenbank nicht verfügbar ist. Liegt ein DVS-Fehler vor, so erhalten Sie den DVS-Fehlerschlüssel.
Ist das Problem (z.B. DVS-Fehler) beseitigt, können Sie mit der Administrationsanweisung SET-SQL-DB-CATALOG-STATUS den Status der Datenbank auf ACTIVE setzen.STATUS = RECOVER, d.h. die Datenbank befindet sich gerade im Recover-Zustand..
Am Ende des Recover ändert sich der Zustand der Datenbank automatisch zu ACTIVE, falls der Recover erfolgreich war, oder zu LOCKED, falls er nicht erfolgreich abgeschlossen werden konnte.STATUS = REORG, d.h. die Datenbank befindet sich gerade im Zustand der Reorganisation.
Am Ende der Reorganisation ändert sich der Zustand der Datenbank automatisch zu ACTIVE, falls die Reorganisation erfolgreich war, oder zu LOCKED, falls sie nicht erfolgreich abgeschlossen werden konnte.STATUS = REFRESH, d.h. die Datenbank befindet sich gerade im Refresh-Zustand..
Am Ende des Refresh ändert sich der Zustand der Datenbank automatisch zu ACTIVE, falls der Refresh erfolgreich war, oder zu LOCKED, falls er nicht erfolgreich abgeschlossen werden konnte.
Ein Zeitstempel im Format
yyyy-mm-dd hh:mm:ss, der angibt, wann der Status der Datenbank festgestellt wurde.
SHOW-SQL-DB-CATALOG-ENTRIES | ||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||
Operandenbeschreibung
SELECT =
Gibt an, welche Einträge aus dem SQL-Datenbankverzeichnis ausgegeben werden.
SELECT = *ALL
Alle Einträge aus dem SQL-Datenbankverzeichnis werden ausgegeben.
SELECT = *LOGICAL(...)
Selektiv werden die Einträge ausgegeben, die den anzugebenden CATALOG-NAME enthalten.
CATALOG-NAME = <filename 1..18 without-cat-user-gen-vers>
Logischer Datenbankname der Datenbank, deren Eintrag ausgegeben wird. Wenn es sich bei der Datenbank um einen SESAM-Sicherungsbestand handelt, wird auf dem Ausgabemedium zusätzlich die Nummer des SESAM-Sicherungsbestands des Catalog-Space ausgegeben.
SELECT = *PHYSICAL(...)
Selektiv werden die Einträge ausgegeben, die den anzugebenden PHYS-CATA-LOG-NAME enthalten.
PHYS-CATALOG-NAME = <filename 1..18 without-cat-user-gen-vers>Physikalischer Datenbankname der Datenbank, deren Eintrag ausgegeben wird. Wenn es sich bei der Datenbank um einen SESAM-Sicherungsbestand handelt, wird auf dem Ausgabemedium zusätzlich die Nummer des SESAM-Sicherungsbestands des Catalog-Space ausgegeben.
STRUCTURE-OUTPUT = *NONE / *SYSINF / <structured-name 1..20>
(WRITE-MODE = *REPLACE / *EXTEND)
Gibt in S-Prozeduren an, ob die Informationsausgabe in S-Variablen erfolgen soll (siehe Abschnitt „Syntax für die Ausgabe in S-Variablen“).
Ausgabe in S-Variablen
Ausgabe-Information | Name der S-Variablen | T | Inhalt |
Logischer Datenbankname | var(*LIST).CATALOG | S | <filename 1..18> |
Physikalischer Datenbankname | var(*LIST).PHYSICAL-NAME | S | <filename 1..18> |
Versionsnummer des | var(*LIST).COPY-NUMBER | S | <integer 1..999999> |
Zugriffsmodus | var(*LIST).ACCESS-MODE | S | WRITE / READ / |
DB-Kennung der Datenbank | var(*LIST).USERID | S | <name 1..8> |
Status der Datenbank | var(*LIST).STATE | S | ACTIVE / FREE / |
Zusätzliche Informationen | var(*LIST).INFORMATION | S | SQL-STATE: xxxxx / |
Zeitstempel | var(*LIST).TIMESTAMP | S |
|
Beispiel
Bildschirmausgabe nach Eingabe der Administrationsanweisung SHOW-SQL-DB-CATA-LOG-ENTRIES:
%SHOW-SQL-DB-CATALOG-ENTRIES <catalog-name> | Copy-|Class| UserID | Status | Info <physical-name> | Nr | | | | -------------------------------------------------------------------------- DCCAT | |ADMIN| SQLDB112 | ACTIVE | DB112.G6 | | | | | <date> <time> DB6LOKG | |ADMIN| SQLDB112 | ACTIVE | CATG6 | | | | | <date> <time> % <date> <time> SES7215 END OF OUTPUT %//
Administrationskommando im ISP-Format und an der CALL-DML-Schnittstelle
Hier entspricht der Administrationsanweisung SHOW-SQL-DB-CATALOG-ENTRIES das Administrationskommando OPT,DBC-INFO.
OPT,DBC-INFO[,supplement]
supplement ::= {C[ATALOG]=catalog-name|P[HYSICAL-NAME]=physical-name}
Wenn Sie den Parameter supplement nicht angeben, so wird das gesamte SQL-Datenbankverzeichnis ausgegeben.