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.

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=FMUSER.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=FMUSER.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=FMUSER.FMN2AUD.DBT6.D021012.T141043,
$$FILEM LABEL='my description - DB2',
$$FILEM NULLIND=_,
$$FILEM DELETELOG=NO
/*
//