Defining the Audit VSAM Data Set

You can create a new AUDIT data set using the DEFAUDIT member located in the platform server JCL library.

Procedure

  1. Edit the DEFAUDIT member in the JCL library to meet your installation requirements.
    Two job steps are included in the DEFAUDIT JCL:
    1. Invoke IEBDG to generate a dummy record.
    2. Invoke IDCAMS to do the following:
      • Delete the VSAM file if it already exists.
      • Define the VSAM cluster.
      • Repro one record into the VSAM file.
      • Define alternate index 1.
      • Define path 1.
      • Define alternate index 2.
      • Define path 2.
      • Build the index for alternate index 1.
      • Build the index for alternate index 2.
  2. Submit the JCL and verify that the linear VSAM file is successfully created.

    The GLOBAL parameter MAX_AUDIT_RECORDS defines how many audit records are saved in the platform server audit file. The default value is 25,000 records. Each audit record is 4176 bytes. Ensure enough space is allocated to the audit file to contain all of the records defined by the GLOBAL MAX_AUDIT_RECORDS parameter.

    When defining the VSAM cluster in substep 2, you can set the primary and secondary allocations of the audit file by specifying the RECORDS or Cylinders or Tracks parameter in DEFAUDIT JCL.

    Note: In some cases, it might be necessary to re-create the audit file. The JCL is written to be able to be rerun. Therefore, after deleting the existing audit file, you will get an error code result when the job runs for the first time. If this is the only error code that you receive, you can ignore it.