STOP-LINKAGE-AUDIT

Terminate linkage AUDIT mode and release linkage AUDIT table

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

Function

This command terminates the subroutine trace (linkage AUDIT mode) that was activated with the START-LINKAGE-AUDIT command.

Privileged functions

Systems support (TSOS privilege) can also deactivate the linkage AUDIT mode for the processor states TPR and SIH.

Format

STOP-LINKAGE-AUDIT                                                                                                                                

STATE = *USER (...) / *SYSTEM(...) / *PROCESSOR(...)
	*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 / *ALL-JOBS / *TID(...) / *TSN(...)
		|		*TID(...)
		|			|	TID = <alphanum-name 1..8>
		|		*TSN(...)
		|			|	TSN = <alphanum-name 1..4> / <c-string 1..4>
	*PROCESSOR(...)
		|	SCOPE = *INTERRUPT-HANDLING / *SYSTEM-LEVEL

Operands

STATE = *USER(...) / *SYSTEM(...) / *PROCESSOR(...)
Processor state for which the linkage AUDIT is to be deactivated.

STATE = *USER(...)
The linkage AUDIT is to be deactivated for the nonprivileged processor state TU. Nonprivileged users can only specify tasks running under their own user ID.

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

SCOPE = *OWN-JOB
The request applies to the user’s own task.

SCOPE = *TID(...)
Only a task that is identified by means of the specified internal task number (TID) is to be released from monitoring by linkage AUDIT.

TID = <alphanum-name 1..8>
Task identifier that is assigned to the task for which monitoring is to cease.

SCOPE = *TSN(...)
Only a task that is identified by means of the specified task sequence number (TSN) is to be released from monitoring by linkage AUDIT.

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

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

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

SCOPE = *OWN-JOB
The request applies for the user’s own (TSOS) job.

SCOPE = *ALL-JOBS
All the jobs currently in the system are no longer to be monitored by linkage AUDIT.

SCOPE = *TID(...)
A single task, identified by its internal task number (TIN) is to be released from monitoring by linkage AUDIT.

TID = <alphanum-name 1..8>
The task identifier assigned to the job which is no longer to be monitored.

SCOPE = *TSN(...)
A single task, identified by its task sequence number (TSN) is to be released from monitoring by linkage AUDIT.

TSN = <alphanum-name 1..4> / <c-string 1..4>
The assigned TSN of the job which is no longer to be monitored.

STATE = *PROCESSOR(...)
Only privileged users are allowed to select this operand value.
The linkage AUDIT is to be deactivated for the local processor only, for the privileged processor states SIH and TPR.

SCOPE = *INTERRUPT-HANDLING / *SYSTEM-LEVEL
Scope of applicability of the linkage AUDIT function.

SCOPE = *INTERRUPT-HANDLING
The request applies for the processor state SIH.

SCOPE = *SYSTEM-LEVEL
The request applies for both privileged processor states, SIH and TPR.

Return codes

(SC2)	SC1	Maincode	Meaning
	0	CMD0001	Command executed without error
	64	CMD0216	User does not have required authorization
	64	IDA0030	Linkage AUDIT not active
	64	IDA0032	Linkage AUDIT table not assigned
	64	IDA0038	Specified task does not exist
	64	IDA0044	Linkage AUDIT running with STATE=*SYSTEM; STATE=*PROCESSOR rejected
	64	IDA0052	Linkage AUDIT not available because the user entry does not contain an authorization
	64	IDA0053	Linkage AUDIT not available because the current test option settings for the active task
	64	IDA0060	AUDIT functions globally not available in this session