SHOW-AUDIT-STATUS

Show status information on linkage and hardware AUDIT

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

Function

The SHOW-AUDIT-STATUS command outputs status information on the linkage and hardware AUDIT modes to SYSOUT. Both the system-wide and the task-specific usage of the AUDIT functions in the system are displayed. In addition to the general overview, the display can also show which tasks started the linkage or hardware AUDIT mode.

Format

SHOW-AUDIT-STATUS                                                                                                                               

INFORMATION = *SUMMARY / *ALL(...)
	*ALL(...)
		|	SELECT = *ALL / *LINKAGE-AUDIT / *HARDWARE-AUDIT

Operands

INFORMATION = *SUMMARY / *ALL(...)
Specifies the scope of the information which is to be displayed.

INFORMATION = *SUMMARY
The statuses of the following AUDIT functions are displayed:

• processor-local linkage AUDIT

• ALL-JOBS-AUDIT for linkage AUDIT

• ALL-JOBS-AUDIT for hardware AUDIT

The number of tasks in which the linkage or hardware AUDIT is still active (enabled and not on hold) is also shown.

INFORMATION = *ALL(...)
The same information is displayed as with *SUMMARY. Further task-specific information is also displayed for each task which has linkage or hardware AUDIT enabled.

SELECT = *ALL / *LINKAGE-AUDIT / *HARDWARE-AUDIT
Specifies the AUDIT mode for which information is to be displayed.

SELECT = *ALL
Information is displayed for linkage AUDIT and for hardware AUDIT.

SELECT = *LINKAGE-AUDIT
Information is displayed for linkage AUDIT only.

SELECT = *HARDWARE-AUDIT
Information is displayed for hardware AUDIT only.

Return codes

(SC2)	SC1	Maincode	Meaning
	0	CMD0001	Command executed without errors
	32	CMD0221	System error
	64	CMD0216	Privileges error

Output format

INFORMATION =*SUMMARY causes the 5 following information lines to be displayed which contain global information:

Information line	Meaning
Processor-local LINKAGE-AUDIT:	Status of the processor-local linkage AUDIT: INTERRUPT-HANDLING (ON for SIH) SYSTEM-LEVEL (ON for SIH and TPR) OFF
All-task LINKAGE-AUDIT :	Status of the ALL-JOBS-AUDIT for linkage AUDIT: ON or OFF
All-task HARDWARE-AUDIT :	Status of the ALL-JOBS-AUDIT for hardware AUDIT
LINKAGE-AUDIT active in nnnn task(s)	Number of tasks with active linkage AUDIT (ON, but not in HOLD status)
HARDWARE-AUDIT active in nnnn task(s)	Number of tasks with active hardware AUDIT (ON, but not in HOLD status)

Table 96: AUDIT status information

INFORMATION =*ALL causes task-specific information to be displayed in addition for each task with the AUDIT function enabled. This detailed information is displayed in table form ahead of the information lines which show the total number of tasks. One value line containing the following information is displayed for each task:

Information column	Meaning
TID	TID of the task displayed
TSN	TSN of the task displayed
TYPE	Type of enabled AUDIT function: LKA (linkage AUDIT) HWA (hardware AUDIT)
STATE	Function status of the enabled AUDIT function: SYSTEM (ON for TPR) USER (ON for TU)
ACTIVE	Activity status of the enabled AUDIT function: YES (ON, but not in HOLD status) NO (ON, but not in HOLD status)

Table 97: AUDIT status information (task-specific information)

Examples

/show-audit-sta inf=*all

Processor-local LINKAGE-AUDIT: INTERRUPT-HANDLING
All-task LINKAGE-AUDIT       : OFF
All-task HARDWARE-AUDIT      : OFF
Task-specific AUDITs:
  TID    TSN   TYPE STATE   ACTIVE
00010001  TSC  LKA  SYSTEM  YES
00010002 HERS  HWA  SYSTEM  YES
00010068 0FQ3  LKA  SYSTEM  YES
00010068 0FQ3  LKA  USER    YES
00010068 0FQ3  HWA  SYSTEM  YES
00010068 0FQ3  HWA  USER    YES
0001006C 0FQ7  LKA  USER    NO
0001006D 0FQ8  HWA  SYSTEM  NO
LINKAGE-AUDIT  active in 0002 task(s)
HARDWARE-AUDIT active in 0002 task(s)

/show-audit-sta inf=*sum

Processor-local LINKAGE-AUDIT: INTERRUPT-HANDLING
All-task LINKAGE-AUDIT       : OFF
All-task HARDWARE-AUDIT      : OFF
LINKAGE-AUDIT  active in 0002 task(s)
HARDWARE-AUDIT active in 0002 task(s)