STOP-HARDWARE-AUDIT

Terminate hardware AUDIT mode and release hardware AUDIT table

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

Function

The STOP-HARDWARE-AUDIT command terminates the recording of branch instructions (hardware AUDIT mode previously activated with START-HARDWARE-AUDIT or RESUME-HARDWARE-AUDIT) and releases the hardware AUDIT table along with any existing backup table.

Privileged functions

Systems support (TSOS privilege) can exempt all tasks from AUDIT control.

Format

STOP-HARDWARE-AUDIT                                                                                                                          

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

Operands

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

SCOPE = *OWN-JOB
The request applies to TU actions in the user’s own task (in which the command was issued).

SCOPE = *ALL-JOBS
This value is only allowed in conjunction with STATE=*SYSTEM.
Release of AUDIT control is to include all jobs in the system. This presupposes that AUDIT has been activated with SCOPE=*ALL-JOBS.

SCOPE = *TID(...)
Only the task identified here by its internal task identifier (TID) is released from AUDIT control. Nonprivileged users can only specify tasks running under their own user ID.

TID = <alphanum-name 1..8>
Task identifier of the task.

SCOPE = *TSN(...)
Only the task identified here by its task sequence number (TSN) is released from AUDIT control. Nonprivileged users can only specify tasks running under their own user ID.

TSN = <alphanum-name 1..4> / <c-string 1..4>
Task sequence number of the task.

STATE =
Processor state to which the scope specified in the SCOPE operand is to relate.

STATE = *USER
The hardware AUDIT is to be stopped for the nonprivileged processor state TU.

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

Return codes

(SC2)	SC1	Maincode	Meaning
	0	CMD0001	Command executed without error
	1	CMD2201	Specified task does not exist
	64	CMD0216	User does not have required authorization
	64	IDA0001	Hardware AUDIT not active
	64	IDA0003	Hardware AUDIT table not created
	64	IDA0011	User not privileged
	64	IDA0023	Hardware AUDIT not available because user entry does not contain authorization
	64	IDA0024	Hardware AUDIT not available due to the current test option settings for the active task