Aktive Auftraggeber eines Space ausgeben
Geltungsbereich
DBH-Administration
Funktionsbeschreibung
Die Administrationsanweisung SHOW-SPACE-USERS gibt alle Auftraggeber aus, die zurzeit auf dem ausgewählten Space einer bestimmten Datenbank arbeiten. Ein Auftraggeber arbeitet auf einem Space, wenn er Tabellen oder Indizes benutzt, die auf diesem Space angelegt sind. Es werden auch systemgenerierte Identifikationen des internen Administrators (siehe "Syntax für die Identifikation von Auftraggebern") ausgegeben, falls für diesen Transaktionen auf dem Space ausgeführt werden.
Es werden nur die Auftraggeber ausgegeben, die einen Zugriff innerhalb einer Transaktion auf den Space haben. CALL-DML-Benutzer, die nur einen CALL-DML-Open auf eine Tabelle des Space haben, aber noch keinen Zugriff innerhalb der Transaktion, werden nicht berücksichtigt.
Außerdem werden einige Zusatzinformationen ausgegeben:
Identifikation des Auftraggebers
Vorgangsnummer des Auftraggebers, falls dieser eine asynchrone UTM-Anwendung ist
Programmlaufzeit in Sekunden (Duration-Time)
Zugriffsmodus (Access) des Space (READ, WRITE oder ADMIN)
Zustand des Space ("copy", "check pending" or "defect"), falls erforderlich.Informationen über die verschiedenen Space-Zustände finden Sie im " Basishandbuch".
SHOW-SPACE-USERS | ||||||||||||||||||||
| ||||||||||||||||||||
Operandenbeschreibung
SPACE-NAME = <filename 1..18 without-cat-user-gen-vers>
Name des Space, zu dem die Auftraggeber ausgegeben werden. Der Name des Space ist der Name der Space-Datei im BS2000.
CATALOG-NAME = <filename 1..18 without-cat-user-gen-vers>
Logischer Datenbankname der ausgewählten Datenbank.
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 |
Rechnername | var(*LIST).HOST | S | <name 1..8> |
Anwendung | var(*LIST).APPLICATION | S | <name 1..8> |
Auftraggeber | var(*LIST).CUSTOMER | S | <name 1..8> |
Vorgangsnummer | var(*LIST).CONVERSATION | S | <x-text 1..8> / '' (leer) |
Programmlaufzeit | var(*LIST).DURATION-TIME | S | <integer> |
Zugriffsmodus | var(*LIST).ACCESS-MODE | S | WRITE / READ / ADMIN |
Beispiel
Bildschirmausgabe nach Eingabe der Administrationsanweisung SHOW-SPACE-USERS SPACE-NAME=TABLESPACE,CATALOG-NAME=CAT-1:
SPACE TABLESPACE ------------------------------------------------------------------------ USER-IDENTIFICATION !DURATION-TIME! ACCESS ------------------------------------------------------------------------ D016ZE07TSN=12LDSESUTI ! 20 ! READ % <date> <time> SES7215 END OF OUTPUT %//
Administrationskommando im ISP-Format und an der CALL-DML-Schnittstelle
Hier entspricht der Funktion der Administrationsanweisung SHOW-SPACE-USERS das Administrationskommando USER,SPACE.
USER,SPACE=space-name,C[ATALOG]=catalog-name