SHOW-OLD-TABLE-CATALOG-ENTRIES

Einträge im CALL-DML-Tabellenverzeichnis anzeigen

Geltungsbereich

DBH-Administration

Siehe auch

• DBH-Startanweisung ADD-OLD-TABLE-CATALOG-LIST auf "ADD-OLD-TABLE-CATALOG-LIST"

• Administrationsanweisung REUSE-OLD-TABLE-CATALOG-ENTRY auf "REUSE-OLD-TABLE-CATALOG-ENTRY"

Funktionsbeschreibung

Die Anweisung SHOW-OLD-TABLE-CATALOG-ENTRIES gibt die Einträge im CALL-DML-Tabellenverzeichnis aus. Pro Eintrag wird Folgendes ausgegeben:

• der Name einer CALL-DML-Tabelle (CALL-DML-Table)

• der logische Datenbankname der Datenbank, der die CALL-DML-Tabelle zugeordnet ist (Catalog-Name)

• der Name des Schemas, dem die CALL-DML-Tabelle zugeordnet ist (Schema-Name)

• der Name der Basistabelle, dem die CALL-DML-Tabelle zugeordnet ist (Table-Name).

• der Status des Eintrags:

valid:

bei der Auswertung des Eintrags konnte eine Zuordnung zu einer CALL-DMLTabelle
festgestellt werden und diese existiert noch.

invalid:
bei der Auswertung des Eintrags konnte keine Zuordnung zu einer existierenden Tabelle festgestellt werden bzw. diese Zuordnung ist wieder verlorengegangen. Diese Situation tritt in folgenden Fällen ein:

• • • Die Datenbank wurde entweder zwischenzeitlich geschlossen (z.B. mit der Administrationsanweisung SET-CATALOG-STATUS) oder sie war zum
      Zeitpunkt der Auswertung nicht eröffnet.

    • Die Tabelle, zu der die Zuordnung hergestellt werden soll, ist in der Datenbank nicht (mehr) bekannt, weil z.B. ein DROP TABLE auf die Tabelle gegeben wurde.

SHOW-OLD-TABLE-CATALOG-ENTRIES

SELECT = *ALL / *SQL(...) / *CALL-DML(...)
	*SQL(...)
		|	CATALOG-NAME = <filename 1..18 without-cat-user-gen-vers>
	*CALL-DML(...)
		|	CALL-DML-TABLE-NAME = <text 1..17>
,STRUCTURE-OUTPUT = *NONE / *SYSINF / <structured-name 1..20>(...)
	<structured-name 1..20>(...)
		|	WRITE-MODE = *REPLACE / *EXTEND

Operandenbeschreibung

SELECT =

Gibt an, welche Einträge aus dem CALL-DML-Tabellenverzeichnis ausgegeben werden.

SELECT = *ALL
Alle Einträge aus dem CALL-DML-Tabellenverzeichnis werden ausgegeben.

SELECT = *SQL(...)
Selektiv werden solche Einträge ausgegeben, die einen bestimmten CATALOG-NAME enthalten.

CATALOG-NAME =
<filename 1..18 without-cat-user-gen-vers>
Logischer Datenbankname, der als Kriterium für das Anzeigen der zugehörigen Einträge gilt.

SELECT = *CALL-DML(...)
Es wird nur der Eintrag ausgegeben, der den anzugebenden CALL-DML-TABLE-NAME enthält.

CALL-DML-TABLE-NAME = <text 1..17>
Name der CALL-DML-Tabelle, deren Eintrag ausgegeben wird.

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
Name der CALL-DML-Tabelle	var(*LIST).CALL-DML-TABLE	S	<text 1..17>
Logischer Datenbankname	var(*LIST).CATALOG	S	<filename 1..18>
Schemaname	var(*LIST).SCHEMA	S	<text 1..31>
Name der Basistabelle	var(*LIST).TABLE	S	<text 1..31>
Status des Eintrags	var(*LIST).STATE	S	VALID / INVALID

Beispiel

Bildschirmausgabe nach Eingabe der Administrationsanweisung SHOW-OLD-TAB-LE-CATALOG-ENTRIES:

%SHOW-OLD-TABLE-CATALOG-ENTRIES
<call-dml-table> |<catalog-name> |<schema-name> / <table-name>   |<status>
--------------------------------------------------------------------------
DB6LOKG          |DB6LOKG        |SCHEMA112                      | valid 
                 |               |TAB112                         | 
% <date> <time> SES7215 END OF OUTPUT 
%// 

Administrationskommando im ISP-Format und an der CALL-DML-Schnittstelle

Hier entspricht der Administrationsanweisung SHOW-OLD-TABLE-CATALOG-ENTRIES das Administrationskommando OPT,CDBC-INFO.

OPT,CDBC-INFO[,supplement]

supplement :: = {C[ATALOG]=catalog-name|

C[ALL-DML-]T[ABLE]=call-dml-table-name}

Wenn Sie den Parameter supplement nicht angeben, so wird das gesamte CALL-DML-Tabellenverzeichnis ausgegeben.