Attribute von Ereignisströmen anzeigen
Komponente: | BS2000 |
Funktionsbereich: | Auftragsverarbeitung |
Anwendungsbereich: | CONSOLE-MANAGEMENT |
Privilegierung: | STD-PROCESSING |
Funktionsbeschreibung
Das Kommando SHOW-SYSEVENT-LOG-ATTRIBUTES zeigt die unter der eigenen Benutzerkennung darstellbaren Ereignisströme (Event-Streams) und deren aktuelle Attribute. Bereits geschlossene (inaktive) Ereignisströme können nur angezeigt werden, wenn sie bei der Beendigung nicht gelöscht wurden (siehe Kommando ASSIGN-SYSEVENT-STREAM, Operand CLOSE-MODE).
Das Kommando unterstützt die strukturierte Ausgabe in S-Variable (siehe „Ausgabe in S-Variable").
Privilegierte Funktionen
Die Systembetreuung (Privileg OPERATING) kann über alle existierenden System-Ereignisströme informieren lassen (Operand LOG-ID=*ALL-ACCESSIBLE und TYPE=*ANY/*SYSTEM-LOG).
Format
SHOW-SYSEVENT-LOG-ATTRIBUTES |
Operandenbeschreibung
LOG-ID = *BY-OWN-TASK / *ALL-ACCESSIBLE / <alphanum-name 1..4>
Gibt an, über welche Ereignisströme Informationen ausgegeben werden sollen.
LOG-ID = *BY-OWN-TASK
Die Attribute aller der Benutzertask zugewiesenen und noch darstellbaren Ereignisströme sollen angezeigt werden.
LOG-ID = *ALL-ACCESSIBLE
Die Attribute aller Ereignisströme, für die die eigene Benutzertask eine Zugriffsberechtigung besitzt, sollen angezeigt werden. Dies sind alle Ereignisströme, die der eigenen Task und Tasks mit derselben Benutzerkennung zugewiesenen sind.
Nur für Benutzer mit dem Privileg OPERATING:
Bei gleichzeitiger Angabe des Operanden TYPE=*SYSTEM-LOG bzw. *ANY (Default-Wert) wird, unabhängig von der Benutzerkennung, über alle existierenden System-Ereignisströme informiert.
LOG-ID = <alphanum-name 1..4>
Über den Ereignisstrom mit dem angegebenen Namen soll informiert werden. Der Name kann (im Falle von LOG-ID = *OWN-TSN bei der Zuweisung) auch mit numerischen Zeichen beginnen.
SELECT = *ALL / *BY-ATTRIBUTES(...)
Bestimmt, ob die über den Operanden LOG-ID ausgewählte Menge von Ereignisströmen durch weitere Selektionskriterien eingeschränkt werden soll.
SELECT = *ALL
Über alle über den Operanden LOG-ID ausgewählten Ereignisströme soll informiert werden.
SELECT = *BY-ATTRIBUTES(...)
Es soll nur über Ereignisströme informiert werden, die den nachfolgend angegebenen Selektionskriterien entsprechen.
STATUS = *ANY / *ACTIVE / *CLOSED
Informiert über Ereignisströme, die sich in dem angegebenen Status befinden.
STATUS = *ANY
Es soll über alle Ereignisströme, unabhängig von ihrem Status, informiert werden.
STATUS = *ACTIVE
Über alle aktiven Ereignisströme (aktuell zugewiesen und nicht geschlossen) soll informiert werden.
STATUS = *CLOSED
Über alle geschlossenen Ereignisströme soll informiert werden.
TYPE = *ANY / *USER-LOG / *SYSTEM-LOG
Benutzern mit dem Privileg OPERATING vorbehalten. Informiert über die angegebene Art von Ereignisströmen.
TYPE = *ANY
Es soll über alle Ereignisströme, unabhängig von der Art, informiert werden.
TYPE = *USER-LOG
Es soll nur über Benutzer-Ereignisströme informiert werden.
TYPE = *SYSTEM-LOG
Es soll nur über System-Ereignisströme informiert werden.
Kommando-Returncode
(SC2) | SC1 | Maincode | Bedeutung |
|---|---|---|---|
0 | CMD0001 | Kommando erfolgreich ausgeführt | |
1 | 0 | NBR3104 | Kein Ereignisstrom entspricht den Auswahlkriterien |
1 | 0 | NBR3105 | Kein Ereignisstrom in Verwaltung |
2 | 0 | OPS0002 | Unterbrechung (z.B. K2-Taste) während der Erzeugung der S-Variablen |
1 | CMD0202 | Syntaxfehler | |
32 | NBR3199 | Interner Fehler im Kommandoserver | |
32 | CMD2009 | Fehler bei Ausgabe in S-Variable (z.B. Subsystem nicht verfügbar) | |
64 | CMD0216 | Erforderliche Berechtigung nicht vorhanden |
Ausgabeformate
Die Ausgabe der Information über die Ereignisströme erfolgt in einem festen Format. Die Ausgabe enthält den Namen des Ereignisstroms (Log-Id), Kennung und TSN der Benutzertask, den aktuellen Status sowie Typ und Einstellung des zu protokollierenden Ereignisstroms. Entsprechen mehrere Ereignisströme den Auswahlkriterien, so werden die Attribute mehrerer Ereignisströme angezeigt. Das nachfolgend dargestellte Ausgabeformat wird für jeden der betroffenen Ereignisströme ausgegeben.
Die Ausgabe der Attribute für mehrere Ereignisströme kann mit der Taste [K2] abgebrochen werden.
Beispiel: Ausgabeformat für einen aktiven System-Ereignisstrom
SHOW-SYSEVENT-LOG-ATTRIBUTES 2014-06-29 16:04:34 ------------------------------------------------------------------------------ LOG-ID: 0LSI USER-ID: USERXY01 TYPE: USER OWNER-TSN: 0LSI STATUS: ACTIVE CLOSE-MODE: DELETE-EVENTS SYNCHRONOUS-EVENTS LOGGED: SYSOUT-MSG: NO CMD: NO STMT: NO ------------------------------------------------------------------------------ SHOW-SYSEVENT-LOG-ATTRIBUTES END OF DISPLAY ... ...
Ausgabe in S-Variable
Die Kommandoergebnisse unterscheiden sich bei Angaben verschiedener Operanden durch die Anzahl der Ereignisströme, zu welchen eine Information ausgegeben wird. Für jeden Event-Stream wird ein Satz S-Variablen versorgt.
Ausgabe-Information | Name der S-Variablen | T | Inhalt | Bedingung |
|---|---|---|---|---|
Löschen des Event-Streams nach Aufhebung der Zuweisung | var(*LIST).CLOSE-MODE | S | *DELETE-EVENTS | |
Protokollierung der über SDF zur Ausführung gebrachten Kommandoeingaben aus der Usertask | var(*LIST).CMD | S | *NO | |
Name des Ereignisstroms | var(*LIST).LOG-ID | S | <alphan.-name 1..4> | |
Zustand des Ereignisstroms | var(*LIST).STA | S | *ACTIVE | |
Protokollierung der über SDF zur Ausführung gebrachten Eingaben von Anweisungen innerhalb eines Benutzerprogramms in der Usertask | var(*LIST).STMT | S | *NO | |
Protokollierung der nach SYSOUT gesendeten Meldungen von Kommandoservern und Benutzerprogrammen | var(*LIST).SYSOUT-MSG | S | *NO | |
TSN der Dialogtask | var(*LIST).TSN | S | <alphan.-name 1..4> | |
Art des Event-Streams, der der Usertask zugewiesen ist | var(*LIST).TYPE | S | *SYS-LOG | |
Benutzerkennung der Dialogtask | var(*LIST).USER-ID | S | <name 1..8> |