SHOW-HARDWARE-AUDIT

Output hardware AUDIT table

Component:	BS2000
Functional area:	AUDIT mode control
Domain:	PROGRAM
Privileges:	STD-PROCESSING TSOS

Function

The SHOW-HARDWARE-AUDIT command outputs the entries in the hardware AUDIT table in which the audit mode addresses are recorded. Output is possible only as long as the audit mode has not been terminated by means of the STOP-HARDWARE-AUDIT command.
The output may be directed to SYSOUT or SYSLST.
In the TU and TPR states, the audit mode addresses are generally processed on the basis of the module name and the displacement. If an address cannot be assigned to a module, or if the processor status is TU, the string ABSOLUTE is inserted in place of the module name.

The TU hardware AUDIT tables of a foreign task are always issued in the form of absolute addresses because the link information is not available. A nonprivileged user can only request the entries concerning tasks running under his or her own user ID.

Privileged functions

Systems support (TSOS privilege) can request the entries for all tasks (including the TPR processor status).

The table entries of the hardware audit table and the backup table are output in reverse chronological order on the 'first in - last out' principle. If a task is active at the time the request is made, the tables may already have changed by the time they are output.

An extended hardware AUDIT table (4 KBytes in TPR) cannot be output. To request or edit an extended TPR AUDIT table, it is necessary to use CDUMP with SCOPE=*SYSTEM. 

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

Operands

STATE = *USER(...) / *SYSTEM(...)
Processor state for which the hardware AUDIT table is to be output.

STATE = *USER(...)
The hardware AUDIT table is to be output for the nonprivileged processor state TU.
A nonprivileged user can only request the entries concerning tasks running under his or her own user ID.

SCOPE = *OWN-JOB / *TID(...) / *TSN(...)
Scope of the hardware AUDIT function.

SCOPE = *OWN-JOB
The hardware AUDIT table of the user’s own task is to be output.

SCOPE = *TID(...)
Only the entries for a task that is identified by means of an internal task number are requested.

TID = <alphanum-name 1..8>
Task identifier that is assigned to the task whose entries are requested.

SCOPE = *TSN(...)
Only the entries for a task that is identified by means of its task sequence number (TSN) are requested.

TSN = <alphanum-name 1..4> / <c-string 1..4>
TSN that is assigned to the task whose entries are requested.

STATE = *SYSTEM(...)
Only privileged users are allowed to select this operand value.
The hardware AUDIT table is to be output for the nonprivileged processor state TPR.

SCOPE = *OWN-JOB / *TID(...) / *TSN(...)
Scope of application for the hardware AUDIT function.

SCOPE = *OWN-JOB
The hardware AUDIT table of the user’s own (TSOS) task is to be output.

SCOPE = *TID(...)
Only the table for a task identified by an internal task number is requested.

TID = <alphanum-name 1..8>
Task identifier assigned to the task for which the table is being requested.

SCOPE = *TSN(...)
Only the table for a task identified by its task sequence number (TSN) is requested.

TSN = <alphanum-name 1..4> / <c-string 1..4>
TSN assigned to the task for which the table is requested.

OUTPUT = *SYSOUT / *SYSLST
Specifies whether the hardware AUDIT table is to be output to SYSOUT or to SYSLST.
The default value is SYSOUT, i.e. output is directed to SYSOUT.
The entries of the hardware AUDIT table appear in reverse order of their occurrence. The hardware AUDIT table is a 256-byte table, i.e. it can contain 64 logged branches. If BUFFER-SIZE=1 was specified in the START-HARDWARE-AUDIT command, the table is a 4096-byte table, i.e. it can contain 1024 logged branches.

Return codes

(SC2)	SC1	Maincode	Meaning
	0	CMD0001	Command executed without error
1	0	CMD0001	Hardware AUDIT table empty, so no output
	1	CMD2201	Specified task does not exist
	32	IDA0018	Internal system error. Hardware AUDIT table cannot be displayed
	32	IDA0022	No more storage space available for hardware AUDIT output SYSLST
	64	CMD0216	User does not have authorization
	64	IDA0001	Hardware AUDIT is not active
	64	IDA0011	Privilege error
	64	IDA0023	Hardware AUDIT not available user is not authorized
	64	IDA0024	Hardware AUDIT not available due to current test option settings for the active task