- 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.
Syntax
AUD
{
INPUT=DDIN
| INPUT=ddname
| DSNAME=logfile
}
[ LABEL=description
]
[ {
FORMAT=YES
| FORMAT=NO
} ]
[ {
DELETELOG=NO
| DELETELOG=YES
} ]
[ {
TYPE=BASE
| TYPE=subsys
} ]
[ {
CHANGED=NO
| CHANGED=YES
} ]
[ NULLIND=displaychar
]
[ {
HEX=NO
| HEX=YES
} ]
[ {
HEXND=NO
| HEXND=YES
} ]
[ {
HICHG=NO
| HICHG=YES
} ]
[ {
SHOWKEY=NO
| SHOWKEY=YES
} ]
- INPUT=ddname
- Defines a reference to a DD or TSO ALLOC statement for the input data set or z/FS 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
/*
//