SHOW-HARDWARE-AUDIT

Hardware-AUDIT-Tabelle ausgeben

Komponente:	BS2000
Funktionsbereich:	AUDIT-Modus steuern
Anwendungsbereich:	PROGRAM
Privilegierung:	STD-PROCESSING TSOS

Funktionsbeschreibung

Mit dem Kommando SHOW-HARDWARE-AUDIT kann sich der Anwender die Einträge in der Hardware-AUDIT-Tabelle, in der die Sprungfolgeadressen verzeichnet sind, ausgeben lassen. Die Ausgabe ist nur möglich, solange der AUDIT-Modus nicht mit STOP-HARDWARE-AUDIT beendet wurde.
Die Ausgabe kann auf SYSOUT oder auf SYSLST erfolgen.
Die Aufbereitung der Sprungfolgeadressen erfolgt in TU und TPR in der Regel mit Modulname und Distanz. Kann eine Adresse keinem Modul zugeordnet werden oder liegt der Funktionszustand TU vor, dann wird an Stelle des Modulnamens der String ABSOLUTE eingefügt.

Die TU-Hardware-AUDIT-Tabellen einer fremden Task werden wegen der fehlenden Binderinformation immer als Absolutadressen ausgegeben. Der nicht-privilegierte Anwender kann dabei nur Einträge der Tasks, die unter seiner eigenen Benutzerkennung laufen, anfordern.

Privilegierte Funktionen

Die Systembetreuung (Privileg TSOS) kann die Einträge aller Tasks (auch für den Funktionszustand TPR) anfordern.

Die Tabelleneinträge der Hardware-AUDIT-Tabelle und der Sicherungstabelle erscheinen bei der Ausgabe in umgekehrter zeitlicher Reihenfolge nach dem Prinzip First in - Last out. Ist die Task zum Zeitpunkt der Anforderung der Tabellenausgabe aktiv, können diese Tabellen bereits fortgeschrieben worden sein, wenn die Ausgabe erfolgt.

Eine vergrößerte Hardware-AUDIT-Tabelle (4 KByte in TPR) kann nicht ausgegeben werden. Die Ausgabe einer vergrößerten TPR-AUDIT-Tabelle kann nur über CDUMP mit SCOPE=*SYSTEM angefordert bzw. aufbereitet werden. 

Format

SHOW-HARDWARE-AUDIT                                                                                                                        

STATE = *USER(...) / *SYSTEM(...)
	*USER(...)
		|	SCOPE = *OWN-JOB / *TID(...) / *TSN(...)
		|		*TID(...)
		|			|	TID = <alphanum-name 1..8>
		|		*TSN(...)
		|			|	TSN = <alphanum-name 1..4> / <c-string 1..4>
	*SYSTEM(...)
		|	SCOPE = *OWN-JOB / *TID(...) / *TSN(...)
		|		*TID(...)
		|			|	TID = <alphanum-name 1..8>
		|		*TSN(...)
		|			|	TSN = <alphanum-name 1..4> / <c-string 1..4>
,OUTPUT = *SYSOUT / *SYSLST

Operandenbeschreibung

STATE = *USER(...) / *SYSTEM(...)
Funktionszustand, für den die Hardware-AUDIT-Tabelle ausgegeben werden soll.

STATE = *USER(...)
Die Hardware-AUDIT-Tabelle soll für den nicht-privilegierten Funktionszustand TU ausgegeben werden. Der nicht-privilegierte Anwender kann nur Einträge der Tasks, die unter seiner Benutzerkennung laufen, anfordern.

SCOPE = *OWN-JOB / *TID(...) / *TSN(...)
Geltungsbereiche für die Hardware-AUDIT-Funktion.

SCOPE = *OWN-JOB
Die Hardware-AUDIT-Tabelle der eigenen Task soll ausgegeben werden.

SCOPE = *TID(...)
Es werden nur die Einträge für eine Task, die mit der angegebenen internen Task-Nummer identifiziert wird, angefordert.

TID = <alphanum-name 1..8>
Task-Identifier, der der Task zugeordnet ist, deren Einträge angefordert werden.

SCOPE = *TSN(...)
Es werden nur die Einträge für eine Task, die mit der angegebenen Task Sequence Number (TSN) identifiziert wird, angefordert.

TSN = <alphanum-name 1..4> / <c-string 1..4>
TSN, die der Task zugeordnet ist, deren Einträge angefordert werden.

STATE = SYSTEM(...)
Die Angabe ist nur für den privilegierten Anwender möglich.
Die Hardware-AUDIT-Tabelle soll für den privilegierten Funktionszustand TPR ausgegeben werden.

SCOPE = *OWN-JOB / *TID(...) / *TSN(...)
Geltungsbereiche für die Hardware-AUDIT-Funktion.

SCOPE = *OWN-JOB
Die Hardware-AUDIT-Tabelle der eigenen (TSOS-) Task soll ausgegeben werden.

SCOPE = *TID(...)
Es wird nur die Tabelle einer Task, die mit einer internen Task-Nummer identifiziert wird, angefordert.

TID = <alphanum-name 1..8>
Task-Identifier, der der Task zugeordnet ist, deren Tabelle angefordert wird.

SCOPE = *TSN(...)
Es wird nur die Tabelle einer Task, die mit ihrer Task Sequence Number (TSN) identifiziert wird, angefordert.

TSN = <alphanum-name 1..4> / <c-string 1..4>
TSN, die der Task zugeordnet ist, deren Tabelle angefordert wird.

OUTPUT = *SYSOUT / *SYSLST
Gibt an, ob die Hardware-AUDIT-Tabelle auf SYSOUT oder auf SYSLST ausgegeben werden soll.
Voreingestellt ist SYSOUT, d.h. die Ausgabe erfolgt auf SYSOUT.
Die Einträge der Hardware-AUDIT-Tabelle erscheinen in umgekehrter zeitlicher Reihenfolge. Die Hardware-AUDIT-Tabelle ist eine 256-Byte-Tabelle, d.h. sie enthält 64 protokollierte Sprünge. Wurde im Kommando START-HARDWARE-AUDIT der Operand BUFFER-SIZE=1 angegeben, ist die Tabelle 4096 Byte groß und enthält 1024 protokollierte Sprünge. 

Kommando-Returncode

(SC2)	SC1	Maincode	Bedeutung
	0	CMD0001	Kommando fehlerfrei ausgeführt
1	0	CMD0001	Hardware-AUDIT-Tabelle leer; deshalb keine Ausgabe
	1	CMD2201	Angegebene Task existiert nicht
	32	IDA0018	Interner Systemfehler. Hardware-AUDIT-Tabelle kann nicht angezeigt werden
	32	IDA0022	Kein weiterer Speicher für die Hardware-AUDIT-Ausgabe auf SYSLST verfügbar
	64	CMD0216	Fehlende Berechtigung des Benutzers
	64	IDA0001	Hardware-AUDIT ist nicht eingeschaltet
	64	IDA0011	Privilegierungsfehler
	64	IDA0023	Hardware-AUDIT ist wegen fehlender Berechtigung im Benutzereintrag nicht verfügbar
	64	IDA0024	Hardware-AUDIT ist wegen der aktuell eingestellten Testoptionen für die laufende Task nicht verfügbar