CA Dynam for VSE User Guide

Reporting Commands
EXTENDED
Default. Logs all file activity, including uncontrolled file
activity, to the Audit Trail file. This option supports Audit
logging of reportable records.
SHARE=
This includes the following:
VSELOCK
YES
NO
Enqueues the Audit file through the VSE External Lock file
rather than internal CA methods.
Provides multi-CPU users with Audit data set
enqueue/dequeue. Indicates the Audit data set is shared.
Default. Single-CPU users should specify SHARE=NO.
Examples
DATASET INITIALIZE LOGMODE=EXTENDED SHARE=YES
DATASET STATUS Notes:
• Data set status information is automatically printed after the INITIALIZE or
UNLOCK functions are executed.
• If the Audit Trail file is locked, any program attempting to log (update) the
Audit file from another partition is kept waiting until the Audit file is
unlocked. Within a single system, this is accomplished through the VSE
Lock Facility. Cross-system serialization is performed using an exclusive
CA technique (SHARE=YES), which does not employ SENSE RESERVE.
If SHARE=VSELOCK is specified, the IBM LOCK macro is used with the
EXTERNAL operand. If you select this option, all systems accessing the
Audit file must be sharing the VSE Lock file.
Reporting Commands
AUDTUTIL enables you to report on information logged to the Audit trail file.
This table lists each of the reporting commands and briefly describes their
functions.
Command
FIELDS
GENERATE
Function
Required and valid only for user-defined reports. Specifies the
fields to be included in a user-defined report and the order in
which they will appear.
Required for both predefined and user-defined reporting.
Generates the report based on commands issued since the
previous REPORT command.
Chapter 12: Maintaining and Reporting on the Audit Trail 12–11