RESUME-HARDWARE-AUDIT

Resume suspended AUDIT mode

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

Function

The RESUME-HARDWARE-AUDIT command resumes AUDIT mode after it has been suspended with HOLD-HARDWARE-AUDIT. The command acts like START-HARDWARE-AUDIT with SCOPE=*OWN-JOB, but differs from it in that any existing AUDIT backup table continues to be used to back up the AUDIT table.
The command is rejected if AUDIT mode has been activated but has not been suspended. If AUDIT mode has not been activated, the command activates it (like START-HARDWARE-AUDIT with SCOPE=*OWN-JOB).

The RESUME-HARDWARE-AUDIT command can only relate to the user’s own task.

Privileged functions

Systems support (TSOS privilege) can resume hardware AUDIT mode for the privileged processor state TPR (STATE=*SYSTEM).

Format

RESUME-HARDWARE-AUDIT                                                                                                                    

STATE = *USER / *SYSTEM

Operands

STATE =
Processor state for which the AUDIT mode is to be reactivated. If the hardware AUDIT mode is to be activated at the same time for both processor states, the command must be issued twice.

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

STATE = *SYSTEM
This operand value is reserved for privileged users.
The hardware AUDIT mode is to be reactivated for the privileged processor state TPR. 

Return codes

(SC2)	SC1	Maincode	Meaning
	0	CMD0001	Command executed without error
	64	CMD0216	User does not have authorization
	64	IDA0001	Hardware AUDIT not activated
	64	IDA0011	Privilege error
	64	IDA0023	Hardware AUDIT not available due to missing authorization in user entry
	64	IDA0024	Hardware AUDIT not available because of current test option settings for the active task