Print disguise audit trail

Use this screen to request File-AID/RDX to print the contents of the audit trail that File-AID/Data Solutions created for each object being disguised. The audit trail print provides the before and after images of the disguised record. An audit trail for disguised objects will only be created when your File-AID/Data Solutions installation enforces auditing or you disguise extract request called for an audit trail.

Audit trail dataset

Specify the file name of the disguise audit trail dataset you want printed. A separate audit trail dataset is created for each disguised object of the extract (identified by its extract data record number (Dnnn). The Data Privacy Summary Report created for the disguise extract lists the audit trail dataset for each disguised object (see also Audit File). The naming convention for each Audit Trail dataset is:

prefix.RDXA.DnnnBnnn.Dyymmdd.Thhmmss.Msss

The prefix is specified when the Extract File is disguised. Dnnn is the identifing number assigned to the object in the Extract File. Bnnn is only used when an Audit Trail is produced for an MVS object that uses an XREF; Bnnn is the layout number within the XREF.

Print format

Specify whether the disguise audit trail is to be printed in character or hex mode. Formatted printing is not supported.

H

Hex. The disguise audit trail prints in hex mode. The Hex format will print three lines for each data line; a character line, a zone line and a digit line.

C

Character. The disguise audit trail prints in character mode. The character format will print a single line for each data line.

Both reports format 100 positions of the record per print line. The after images for each 100 positions only prints when the data in those positions has changed. A change flag line identifies the changed data positions.

Records to print

You can limit the number of audit records printed. This limit count is a record count; the before and after images are considered two records.

nnn

Maximum number of records to print.

ALL

All records.

Audit trail disposition

Enter one of the following:

PK

Print and Keep the audit trail dataset.

PD

Print and Delete the audit trail dataset.

Sysout class

Enter the sysout class for the Audit Trail Report.

Primary Commands

The following File-AID/RDX-specific primary commands are valid on this screen:

JCL

View the JCL for the Audit Trail Print utility. File-AID/RDX shows the Generated JCL panel where you review and modify the print JCL. Enter the SUBMIT command to submit the print job.

GO (G)

Submits this Audit Trail Print request without displaying the JCL. Before issuing the GO command, make sure you have specified the desired print options as well as the audit trail file. File-AID/RDX will also issue a message upon completion of the job.

Printing multiple audit trail datasets

When you want to concatenate multiple audit trail datasets together and produce a separate Audit Trail Report for each data set with one batch job execution, edit the generated JCL before submitting the batch job.

Audit trail report

The Audit Trail Report is printed by the batch job submitted from the Print Audit Trail screen. The report displays the audit trail contents and is printed in a character or hexadecimal format. The report also contains summary information.

Samples of the character and hexadecimal formats of the Audit Trail Report are shown in Audit Trail Report — Hexadecimal and Audit Trail Report — Character.

Each page of the Audit Trail Report begins with page headings that consist of the edited data set name, the date and time the report was produced, the File-AID/Data Solutions release number, and the page number.

Following the page headings is the date and time when the data file was opened for disguise, and the TSO user ID that was used to perform the disguise. If the data file organization was VSAM-KSDS, File-AID/RDX includes the starting position and length of the defined key.

Preceding the image of each data file disguise on the report are audit trail record headings. The first line contains a sequential number assigned to each data file disguise, the disguise action (explained more fully below), and the date and time the disguise occurred.

For VSAM-RRDS data files, File-AID/RDX includes the relative record number of the disguised record.

HEX Print Report Contents

When printing the audit trail contents in HEX, File-AID/RDX displays each record in a three-line format similar to the hexadecimal mode of BMC AMI DevX File-AID/MVS Edit unformatted mode. The top line contains the character representation of the record, the middle line contains the upper half-byte of each character in HEX, and the third line contains the lower half-byte of each character in hexadecimal.

Up to l00 positions of the record are printed in each set of three lines. The POSITION column immediately to the left of the record contents indicates the starting position in the record represented by each set of three lines. For the updated records, the before image is printed, followed immediately by the after image, if a change has occurred on that line.

When the before and after images of a changed record are displayed, the Audit Trail Report also indicates the record positions that were changed with an asterisk (*) under each changed position. For each three-line set of print lines that contains changed record positions, CHANGE ===> is printed to the left and between the print lines, on the same line as the asterisks.

Audit Trail Report — Hexadecimal

Character Report Contents

The character audit trail report is similar to the HEX report except that the two hexadecimal lines are not printed. Unprintable characters are printed as blanks.

Audit Trail Report — Character

Summary Information

Summary information is printed on the last page of the Audit Trail Report. See Audit Trail Report — Summary. It contains the following information:

• Name of the audit trail dataset that was printed.
• Number of data file records that were changed.
• The number of members updated if the edit data set was a PDS.
• Name of the updated data file that created the audit trail.
• Names of the record layout dataset and member specified for the update and the record layout dataset type (SEQ for sequential, PDS for partitioned, PAN for CA Panvalet, LIB for CA Librarian).
• Names of the record layout XREF dataset and member specified for the update (if an X was specified in the Record layout usage field).
• Names of the selection criteria dataset and member, if existing selection criteria was used for the update. If temporary selection criteria was used during for the update, the literal ** TEMPORARY ** is printed.
• Date and time the data file was closed.
• The system ID on which the data file was updated.

Audit Trail Report — Summary

Executing print audit trail independently in batch

You can execute the Print Audit Trail function as a separate step in a batch job by coding the JCL shown in the following figure. This process can be useful when you want to print multiple audit trail datasets in one batch print job.

Print Audit Trail JCL

Audit Trail Print Execution Return Codes

The audit trail print execution return codes are summarized in the following table.

 Print Execution Return Codes