If the linkage AUDIT function is activated, the destination addresses are logged to a 4-KB trace table (linkage AUDIT trace table) whenever the commands BASR, BALR, BASSM and BAKR are executed. This table is overwritten cyclically and can optionally be stored in the case of TU applications in a save table of up to 64 KB (see page "Hardware AUDIT") in the same way as for the hardware AUDIT. It is not possible to create an additional save table in TPR.Performance is reduced for the processor state for which the linkage AUDIT is activated.In contrast to the hardware AUDIT, the branches logged by the linkage AUDIT occur far more rarely than the conditional branches logged by the hardware AUDIT.
AUDIT control using the parameter service
The linkage AUDIT enables the linkage AUDIT to be activated on a CPU-specific basis for all CPUs or all logical machines of a server configuration. For each CPU, a trace table is created in privileged class 3 memory and retained throughout the entire session.The linkage AUDIT can be enabled in the startup phase via the parameter service.
The linkage AUDIT is controlled by means of the SYSOPT-IPL parameter record, which can be used to define different specifications for system initialization. The parameter that applies to AUDIT is LINKAGE-AUDIT-SCOPE, which is defined as follows within the SYSOPT-IPL record:
|
Meanings of the operands
LINKAGE-AUDIT-SCOPE = NO
The linkage AUDIT function is not activated (default value).
LINKAGE-AUDIT-SCOPE = INTERRUPT-HANDLING
The linkage AUDIT function is activated for the SIH processor state.
LINKAGE-AUDIT-SCOPE = SYSTEM-LEVEL
The linkage AUDIT function is activated for the TPR and SIH processor states.
In addition to this special AUDIT control, general control of the AUDIT can be achieved via the system parameter AUDALLOW and various BS2000 commands (see "Hardware AUDIT" for details).
AUDIT control in the current session
The START-LINKAGE-AUDIT, STOP-LINKAGE-AUDIT and RESUME-LINKAGE-AUDIT commands and the AUDIT macro are available to the system administrator to enable or disable the AUDIT in the current session.
Command | Meaning |
HOLD-HARDWARE-AUDIT | Interrupt linkage AUDIT mode |
RESUME-HARDWARE-AUDIT | Resume linkage AUDIT mode |
SHOW-AUDIT-STATUS | Shows the status of the linkage AUDIT and the hardware AUDIT |
SHOW-HARDWARE-AUDIT | Output linkage AUDIT table to SYSOUT or SYSLST |
START-HARDWARE-AUDIT | Start linkage AUDIT mode |
STOP-HARDWARE-AUDIT | Terminate linkage AUDIT mode and release linkage AUDIT table |
Macro | Meaning |
AUDIT | Apply hardware and linkage AUDIT functions |
Table 3: Interfaces for linkage AUDIT
If the linkage AUDIT function is activated, the destination addresses are logged to a 4-KB trace table (linkage AUDIT trace table) whenever the commands BASR, BALR, BASSM and BAKR are executed. This table is overwritten cyclically and can optionally be stored in the case of TU applications in a save table of up to 64 KB (see page "Hardware AUDIT") in the same way as for the hardware AUDIT. It is not possible to create an additional save table in TPR.Performance is reduced for the processor state for which the linkage AUDIT is activated.In contrast to the hardware AUDIT, the branches logged by the linkage AUDIT occur far more rarely than the conditional branches logged by the hardware AUDIT.
AUDIT control using the parameter service
The linkage AUDIT enables the linkage AUDIT to be activated on a CPU-specific basis for all CPUs or all logical machines of a server configuration. For each CPU, a trace table is created in privileged class 3 memory and retained throughout the entire session.The linkage AUDIT can be enabled in the startup phase via the parameter service.
The linkage AUDIT is controlled by means of the SYSOPT-IPL parameter record, which can be used to define different specifications for system initialization. The parameter that applies to AUDIT is LINKAGE-AUDIT-SCOPE, which is defined as follows within the SYSOPT-IPL record:
|
Meanings of the operands
LINKAGE-AUDIT-SCOPE = NO
The linkage AUDIT function is not activated (default value).
LINKAGE-AUDIT-SCOPE = INTERRUPT-HANDLING
The linkage AUDIT function is activated for the SIH processor state.
LINKAGE-AUDIT-SCOPE = SYSTEM-LEVEL
The linkage AUDIT function is activated for the TPR and SIH processor states.
In addition to this special AUDIT control, general control of the AUDIT can be achieved via the system parameter AUDALLOW and various BS2000 commands (see "Hardware AUDIT" for details).
AUDIT control in the current session
The START-LINKAGE-AUDIT, STOP-LINKAGE-AUDIT and RESUME-LINKAGE-AUDIT commands and the AUDIT macro are available to the system administrator to enable or disable the AUDIT in the current session.
Command | Meaning |
HOLD-HARDWARE-AUDIT | Interrupt linkage AUDIT mode |
RESUME-HARDWARE-AUDIT | Resume linkage AUDIT mode |
SHOW-AUDIT-STATUS | Shows the status of the linkage AUDIT and the hardware AUDIT |
SHOW-HARDWARE-AUDIT | Output linkage AUDIT table to SYSOUT or SYSLST |
START-HARDWARE-AUDIT | Start linkage AUDIT mode |
STOP-HARDWARE-AUDIT | Terminate linkage AUDIT mode and release linkage AUDIT table |
Macro | Meaning |
AUDIT | Apply hardware and linkage AUDIT functions |
Table 3: Interfaces for linkage AUDIT