HOLD-HARDWARE-AUDIT

Suspend AUDIT mode

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

Function

The HOLD-HARDWARE-AUDIT command suspends AUDIT mode, which was switched on using the START-HARDWARE-AUDIT command. The hold function always acts on the user’s own job, i.e. the AUDIT mode was switched on with SCOPE=*OWN-JOB.
The AUDIT tables are retained.
AUDIT mode may be resumed by entering the RESUME-HARDWARE-AUDIT command.

Privileged functions

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

Format

HOLD-HARDWARE-AUDIT                                                                                                                          

STATE = *USER / *SYSTEM

Operands

STATE =
Processor state for which the AUDIT mode is to be suspended.
If the hardware AUDIT mode is to be deactivated for both processor states, the command has to be issued twice.

STATE = *USER
The hardware AUDIT mode is to be suspended for the nonprivileged processor state TU. The hardware AUDIT table and the backup table, if there is one, are retained.

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

Return codes

(SC2)	SC1	Maincode	Meaning
	0	CMD0001	Command executed without error
	64	CMD0216	User does not have authorization
	64	IDA0001	Hardware is not active
	64	IDA0011	Privilege error
	64	IDA0023	Hardware AUDIT is not available because of missing authorization in the user entry
	64	IDA0024	Hardware AUDIT is not available because of the test options currently set for the active task