SHOW-CATALOG-USERS

Anzahl aktiver Auftraggeber zu ausgewählten Datenbanken ausgeben

Geltungsbereich

DBH-Administration

Funktionsbeschreibung

Die Administrationsanweisung SHOW-CATALOG-USERS gibt die Anzahl aller Auftraggeber aus, die zum Zeitpunkt der Eingabe auf ausgewählte Datenbanken zugreifen. D.h. es werden nur die Auftraggeber ausgegeben, die einen Zugriff innerhalb der Transaktion auf die Datenbank haben. CALL-DML-Benutzer, die nur einen CALL-DML-Open auf eine Tabelle der Datenbank haben, aber noch keinen Zugriff innerhalb einer Transaktion, werden nicht berücksichtigt.

Sind im SQL-Datenbankverzeichnis keine Datenbanken eingetragen, so erhalten Sie eine entsprechende Meldung.

Folgendes wird ausgegeben:

• der logische Datenbankname der ausgewählten Datenbank(en)

• der jeweilige Status der ausgewählten Datenbank(en) (siehe Administrationsanweisung SHOW-SQL-DB-CATALOG-ENTRIES auf "SHOW-SQL-DB-CATALOG-ENTRIES")

• die Anzahl der aktiven SQL- und CALL-DML-Auftraggeber.

SHOW-CATALOG-USERS

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

Operandenbeschreibung

CATALOG-NAME = *ALL / <filename 1..18 without-cat-user-gen-vers>

Logischer Datenbankname der ausgewählten Datenbank.Standardwert ist *ALL, d.h. alle Datenbanken werden ausgewählt.

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>
Status der Datenbank	var(*LIST).STATE	S	ACTIVE / FREE / LOCKED / REORG / RECOVER / REFRESH
Anzahl aktiver Auftraggeber	var(*LIST).USER	S	<integer>

Beispiel

Bildschirmausgabe nach Eingabe der Administrationsanweisung
SHOW-CATALOG-USERS:

%SHOW-CATALOG-USERS
CATALOG  DCCAT                STATE ACTIVE         0 USERS                      
CATALOG  DB6LOKG              STATE ACTIVE         7 USERS                      
% <date> <time> SES7215 END OF OUTPUT 
%// 

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

Hier entspricht der Funktion der Administrationsanweisung SHOW-CATALOG-USERS das Administrationskommando USER,CATALOG.

USER,C[ATALOG][=catalog-name]