Use FileAuditSummarize to display a summarization of a file's audit trail (see File Auditing).
FileAuditSummarize may also be entered as FileAuditSum[marize], AuditSummarizeFile, AuditSumFile, AuditSum[marize], AudSum[marize], AuditSm, or AudSm.
FileAuditSummarize is supported for BIM and workstation files only. It is not supported for PDS or VSE files.
Optional Operands
FILE is the BIM or workstation file for which changes are to be summarized.
Default: last referenced file.
FileAuditSummarize is most useful for files updated from a 3270 terminal. The audit trail created by a 3270 update can be very lengthy, as records are written to the audit trail as the updates occur. FileAuditSummarize uses the audit trail as input and produces as output a summarization of those changes. FileAuditSummarize shows only net changes. For example, if 5 lines were inserted, and if those lines were subsequently modified, FileAuditSummarize shows that 5 lines were inserted but shows the modified text. Since the lines were new, the fact that they got the way they are through modification is irrelevant.
FileAuditSummarize is considerably less useful for files updated through the BIM-EDIT/XP workstation component. Updates performed in this manner are considerably shorter since the audit trail is written at save time, and represents a concise summary of the updates that occurred during the course of the edit session. There is nothing to be gained by summarizing the results of a single-session update. However, if a file is updated through multiple edit sessions, FileAuditSummarize can be used to produce a summary of the combined updates.
FileAuditSummarize can be used to perform version auditing if a new version always starts with a cleared audit trail. Procedures involving check in and check out can be used to enforce this.
FileAuditSummarize sets the last referenced file.
When Valid
For BIM files, the user must have LIST access level for the FILE directory.
Return Codes
OK Successful.
NF File not found.
SC Inadequate access level.
Procedure Notes
FileAuditSummarize sets the TXM variables to the attributes of FILE.
Examples
Summarize changes for BIM file POLICIES:
=> audsum policies