SHOW-LINKAGE-AUDIT

Output linkage AUDIT table

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

Function

The SHOW-LINKAGE-AUDIT command allows the user to have output the entries in the linkage AUDIT table, which contain the branch destination addresses in the event of subroutine calls.
Output can be directed to SYSOUT or SYSLST.

The branch destination addresses are generally presented in a module-related form, with module name and displacement. If an address cannot be assigned to any module, the string AVSOLUTE is output in place of the module name.

The TU linkage 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.

A processor-local linkage AUDIT table can only be output via a dump generator (CDUMP, SLED) and not in interactive mode.

Privileged functions

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

The table entries are output in reverse chronological order on a first in, last out basis. If a task is active at the time the request is made, the tables may already have changed by the time they are output. 

Format

SHOW-LINKAGE-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(...)
	*SYSLST(...)
		|		SYSLST-NUMBER = 0 / <integer 0..99>

Operands

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

STATE = *USER(...)
The linkage 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 linkage AUDIT function.

SCOPE = *OWN-JOB
The linkage AUDIT table of the user’s own job 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 job 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 job whose entries are requested.

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

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

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

SCOPE = *TID(...)
The only entries requested are those for the task which is identified by this internal task number.

TID = <alphanum-name 1..8>
Task identifier which has been assigned to the task for which the entries are being requested.

SCOPE = *TSN(...)
The only entries requested are those for the task which is identified by this task sequence number (TSN).

TSN = <alphanum-name 1..4> / <c-string 1..4>
TSN which has been assigned to the task for which the entries are being requested.

OUTPUT = *SYSOUT / *SYSLST
Specifies where the AUDIT table is to be output to.

OUTPUT = *SYSOUT
The linkage AUDIT table is output to the system file SYSOUT. The entries are output in reverse chronological order, i.e. the most recent entry appears first.

OUTPUT = *SYSLST(...)
The linkage AUDIT table is to be output to SYSLST. The entries are output in reverse chronological order, i.e. the most recent entry appears first.

SYSLST-NUMBER = 0 / <integer 0..99>
When SYSLST-NUMBER = 0 is specified, output is to SYSLST or to a SYSLST file whose name consists of “SYSLST” and a number between 1 and 99 (SYSLST01 through SYSLST99). 

Return codes

(SC2)	SC1	Maincode	Meaning
	0	CMD0001	Command executed without error
1	0	CMD0001	Linkage AUDIT table empty, so no output
	64	CMD0216	User does not have authorization
	64	IDA0038	Specified task does not exist
	64	IDA0052	Linkage AUDIT not available because user is not authorized
	64	IDA0053	Linkage AUDIT not available due to current test option settings for the active task
	64	IDA0060	The AUDIT functions are unavailable throughout the entire system in this session