Linkage-AUDIT-Modus starten
Komponente: | BS2000 |
Funktionsbereich: | AUDIT-Modus steuern |
Anwendungsbereich: | PROGRAM |
Privilegierung: | STD-PROCESSING |
Funktionsbeschreibung
Das Kommando steuert die Unterprogrammverfolgung (Linkage-AUDIT-Modus) für den Funktionszustand TU (task unprivileged), TPR (task privileged; siehe „Privilegierte Funktion“) oder TPR und SIH. Die Sprungzieladressen werden nach Ausführung der Befehle BASR, BALR, BASSM und BAKR in der Linkage-AUDIT-Tabelle aufgezeichnet. Befindet sich der Linkage-AUDIT-Modus im Zustand „HOLD“ (nach dem entsprechenden Kommando), wird er mit START-LINKAGE-AUDIT wieder aktiviert. Eine evtl. vorhandene Sicherungstabelle wird weiter benutzt.
Verfügbarkeit der AUDIT-Funktion
Systemweit kann die Systembetreuung die AUDIT-Funktion über den Parameter-Service (AUDALLOW=YES) zur Verfügung stellen. Über den Benutzereintrag steuert die Systembetreuung, ob ein Benutzer berechtigt ist den Linkage-AUDIT-Modus zu starten.
Jeder Benutzer kann mit dem Kommando MODIFY-TEST-OPTIONS den Linkage-AUDIT-Modus innerhalb seiner Task verbieten bzw. wieder zulassen (wirkt nur bei entsprechender Berechtigung im Benutzereintrag).
Privilegierte Funktion
Die Systembetreuung (Privileg TSOS) kann zusätzlich die Unterprogrammverfolgung für den Funktionszustand TPR bzw. TPR und SIH steuern.
Soll der prozessor-lokale Linkage-AUDIT auch während der Startup-Phase genutzt
werden, muss er über den Parameterservice eingeschaltet werden (siehe Handbuch „Einführung in die Systembetreuung“ [14]). Diese Funktion steht auch für Multiprozessoren uneingeschränkt zur Verfügung, d.h. für alle CPUs.
Die prozessor-lokale Linkage-AUDIT-Tabelle kann nur über einen Dump mit dem Auswerter DAMP betrachtet werden. Die Ausgabe im Dialog mit SHOW-LINKAGE-AUDIT ist nicht möglich.
Format
START-LINKAGE-AUDIT | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Operandenbeschreibung
STATE =
Funktionszustand, für den der Linkage-AUDIT eingeschaltet werden soll.
STATE = *USER(...)
Der Linkage-AUDIT wird für den nicht-privilegierten Funktionszustand TU eingeschaltet.
SCOPE = *OWN-JOB / *PROGRAM-LEVEL / *TID(...) / *TSN(...)
Geltungsbereiche für die Linkage-AUDIT-Funktion.
SCOPE = *OWN-JOB
Die Anforderung gilt für die eigene Task.
SCOPE = *PROGRAM-LEVEL
Die Anforderung gilt für diejenige PCB-spezifische Funktion, die sich auf den höchsten unterbrochenen PCB bezieht. Ist ein taskweiter Linkage-AUDIT eingeschaltet (SCOPE=OWN-JOB), so wird eine PCB-spezifische Anforderung abgelehnt. Ist ein PCB-spezifischer Linkage-AUDIT auf einem niedrigeren PCB eingeschaltet, so wird die neue Anforderung zusätzlich angenommen.
SCOPE = *TID(...)
Es soll nur eine Task, die mit einer internen Task-Nummer (TID) identifiziert wird, von Linkage-AUDIT überwacht werden. Der nicht-privilegierte Anwender kann nur Tasks angeben, die unter seiner Benutzerkennung laufen.
TID = <alphanum-name 1..8>
Task-Identifier der Task, die überwacht werden soll.
SCOPE = *TSN(...)
Es soll nur eine Task, die mit ihrer Task Sequence Number (TSN) identifiziert wird, von Linkage-AUDIT überwacht werden. Der nicht-privilegierte Anwender kann nur Tasks angeben, die unter seiner Benutzerkennung laufen.
TSN = <alphanum-name 1..4> / <c-string 1..4>
TSN der Task, die überwacht werden soll.
BUFFER-SIZE = 0 / <integer 0..16 4Kbyte>
Anzahl Seiten in Einheiten zu 4KByte, die in TU für die Linkage-AUDIT zusätzlich benötigt werden, um sie vor dem zyklischem Überschreiben zu sichern.
STATE = *SYSTEM(...)
Die Angabe ist nur für den privilegierten Anwender möglich.
Der Linkage-AUDIT wird für den privilegierten Funktionszustand TPR eingeschaltet.
SCOPE = *OWN-JOB / *PROGRAM-LEVEL / *ALL-JOBS / *TID(...) / *TSN(...)
Geltungsbereiche für die Linkage-AUDIT-Funktion.
SCOPE = *OWN-JOB
Die Anforderung gilt für die eigene (TSOS-)Task.
SCOPE = *PROGRAM-LEVEL
Die Anforderung gilt für diejenige PCB-spezifische Funktion, die sich auf den höchsten unterbrochenen PCB bezieht. Ist ein taskweiter Linkage-AUDIT eingeschaltet (SCOPE=OWN-JOB), so wird eine PCB-spezifische Anforderung abgelehnt. Ist ein PCB-spezifischer Linkage-AUDIT auf einem niedrigeren PCB eingeschaltet, so wird die neue Anforderung zusätzlich angenommen.
SCOPE = *ALL-JOBS
Sämtliche sich jeweils im System befindende Aufträge sollen mit Linkage-AUDIT überwacht werden.
SCOPE = *TID(...)
Es soll nur eine Task, die mit einer internen Task-Nummer (TID) identifiziert wird, von Linkage-AUDIT überwacht werden.
TID = <alphanum-name 1..8>
Task-Identifier der Task, die überwacht werden soll.
SCOPE = *TSN(...)
Es soll nur eine Task, die mit ihrer Task Sequence Number (TSN) identifiziert wird, von Linkage-AUDIT überwacht werden.
TSN = <alphanum-name 1..4> / <c-string 1..4>
TSN der Task, die überwacht werden soll.
STATE = *PROCESSOR(...)
Die Angabe ist nur für den privilegierten Anwender möglich.
Der Linkage-AUDIT soll prozessorlokal für die privilegierten Funktionszustände SIH und TPR eingeschaltet werden.
SCOPE = *INTERRUPT-HANDLING / *SYSTEM-LEVEL
Geltungsbereiche für die Linkage-AUDIT-Funktion.
SCOPE = *INTERRUPT-HANDLING
Die Anforderung gilt nur für den Funktionszustand SIH.
SCOPE = *SYSTEM-LEVEL
Die Anforderung gilt für beide privilegierte Funktionszustände SIH und TPR.
Kommando-Returncode
(SC2) | SC1 | Maincode | Bedeutung |
|---|---|---|---|
0 | CMD0001 | Kommando fehlerfrei ausgeführt | |
1 | 0 | CMD0001 | Linkage-AUDIT ist bereits eingeschaltet, Prozessor-lokaler Linkage-AUDIT bereits eingeschaltet, Operand BUFFER-SIZE ignoriert oder Linkage-AUDIT-Tabelle leer; deshalb keine Ausgabe |
1 | CMD2201 | PCB nicht vorhanden. Kommando abgewiesen | |
64 | CMD0216 | Fehlende Berechtigung des Benutzers | |
64 | IDA0033 | Linkage-AUDIT läuft mit SCOPE=*OWN-JOB; SCOPE=*PROGRAM-LEVEL abgewiesen | |
64 | IDA0038 | Angegebene Task existiert nicht | |
64 | IDA0041 | Linkage-AUDIT auf diesem System (HSI) nicht verfügbar | |
64 | IDA0043 | Linkage-AUDIT läuft prozessor-lokal; STATE=*SYSTEM abgewiesen | |
64 | IDA0044 | Linkage-AUDIT mit STATE=*SYSTEM aktiv; STATE=*PROCESSOR abgewiesen | |
64 | IDA0052 | Linkage-AUDIT ist wegen fehlender Berechtigung im Benutzereintrag nicht verfügbar | |
64 | IDA0053 | Linkage-AUDIT ist wegen der aktuell eingestellten Testoptionen für die laufende Task nicht verfügbar | |
64 | IDA0060 | In dieser Session stehen AUDIT-Funktionen systemweit nicht zur Verfügung | |
130 | IDA0045 | Zentrale AUDIT-Verwaltung zurzeit gesperrt |