AUD (Print audit trail report)

Purpose
Print a formatted or unformatted audit trail report.
Usage Notes
You must specify the name of the audit trail data set from which you want to produce a report. If the audit trail is from FM/IMS or FM/Db2, you must also indicate that.
Options
You can choose between printing an unformatted report or, if the audited function used a template, a report formatted according to the template you used. You can also specify whether or not you want the audit trail data set to be deleted after printing. You can provide a description to help to identify the audit trail report. For FM/Db2, you can specify any non-standard null display character used.
Related functions
None.
Figure 1. Syntax

1 AUD
1! INPUT=DDIN
1 INPUT=ddname
1 DSNAME=logfile
2? LABEL=description
1! FORMAT=YES
1 FORMAT=NO
1! DELETELOG=NO
1 DELETELOG=YES
1! TYPE=BASE
1 TYPE=subsys
1! CHANGED=NO
1 CHANGED=YES
6? NULLIND=displaychar
1! HEX=NO
1 HEX=YES
1! HEXND=NO
1 HEXND=YES
1! HICHG=NO
1 HICHG=YES
1! SHOWKEY=NO
1 SHOWKEY=YES
INPUT=ddname
Defines a reference to a DD or TSO ALLOC statement for the input data set or HFS file. The default is DDIN.
DSNAME=logfile
Specifies the name of the audit trail log data set.
LABEL=Description
Optional identification for the audit trail report. Must be within quotation marks if it contains blanks.
FORMAT
Determines the formatting of the audit trail report.
YES
Default. Report is formatted according to the template used in the audited Edit session.
NO
Report is not formatted.
DELETELOG
Determines whether or not the audit trail data set is deleted after printing. DELETELOG is not allowed for log data sets allocated using a DD statement.
NO
Default. The audit trail data set is not deleted.
YES
The audit trail data set is deleted after the report is printed.
TYPE
Specifies the subsystem used for the audited Edit session. Can be BASE, IMS, DB2, or CICS. BASE is the default.
CHANGED
NO
Default. All fields are reported.
YES
Only fields that are changed are reported.
NULLIND=displaychar
Specifies the null indicator character to be used in an audit trail report for Db2® data.
HEX=YES
Produces an UPDOWN hexadecimal display below the formatted field display when FORMAT=YES. Otherwise no effect.
HEXND=YES
Produces an UPDOWN hexadecimal display below the formatted field display when FORMAT=YES, only for fields that contain non-displayable characters. Otherwise (FORMAT=NO) no effect.
HICHG=YES
Highlights the changed fields. An asterisk is placed to the left of the "before" data to indicate the field has been changed.
SHOWKEY=YES
Displays key fields even when CHANGED=YES has been selected. A "K" is printed to the left of key field names. For a KSDS data set, a key field is any elementary field that intersects, or is contained in, the key area. Note: does not apply to Db2® audit reports.
//AUDIT job (acct),'name'
//* Print formatted audit trail report
//*
//FMNBATCH EXEC PGM=FILEMGR
//STEPLIB  DD DSN=FMN.SFMNMOD1,DISP=SHR
//SYSPRINT DD SYSOUT=*
//SYSABEND DD SYSOUT=*
//SYSUDUMP DD SYSOUT=*
//SYSIN    DD *
$$FILEM AUD ,
$$FILEM DSNAME=USER.FMNLOG.D020816.T070549,
$$FILEM LABEL='my description - BASE',
$$FILEM FORMAT=YES,
$$FILEM DELETELOG=NO
/*
//
//AUDIT job (acct),'name'
//* Print formatted audit trail report
//*
//FMNBATCH EXEC PGM=FILEMGR
//STEPLIB  DD DSN=FMN.SFMNMOD1,DISP=SHR
//SYSPRINT DD SYSOUT=*
//SYSABEND DD SYSOUT=*
//SYSUDUMP DD SYSOUT=*
//SYSIN    DD *
$$FILEM AUD ,
$$FILEM TYPE=IMS,
$$FILEM DSNAME=USER.IMSAUDIT.D021012.T085732,
$$FILEM LABEL='my description - IMS',
$$FILEM FORMAT=YES,
$$FILEM DELETELOG=NO
/*
//
//AUDIT job (acct),'name'
//* Print formatted audit trail report
//*
//FMNBATCH EXEC PGM=FILEMGR
//STEPLIB  DD DSN=FMN.SFMNMOD1,DISP=SHR
//SYSPRINT DD SYSOUT=*
//SYSABEND DD SYSOUT=*
//SYSUDUMP DD SYSOUT=*
//SYSIN    DD *
$$FILEM AUD ,
$$FILEM TYPE=DB2,
$$FILEM DSNAME=USER.FMN2AUD.DBT6.D021012.T141043,
$$FILEM LABEL='my description - DB2',
$$FILEM NULLIND=_,
$$FILEM DELETELOG=NO
/*
//