Printing Repository Server audit log records

To print the audit log records from the Repository Server (RS) audit log stream on the z/OS® system logger, use the IMS File Select and Formatting Print utility (DFSERA10) with exit routine CSLRERA3.

DD statements

The DD statements for printing RS audit log records are:

STEPLIB DSN=: Points to IMS.SDFSRESL, which contains the IMS File Select and Formatting Print utility, DFSERA10.
SYSPRINT: Describes the output data set to which the formatted print records and control messages are to be directed. SYSPRINT is usually defined as SYSOUT=A. DCB should not be specified on the SYSPRINT DD.
SYSUT1 DSN=: Points to the RS audit log stream name that is specified on the AUDIT_LOG= parameter in the FRPCFG member of the IMS PROCLIB data set.

Control statements

The control statements for printing the RS audit log records are:

H=: Specifies the number of log records to print. H=EOF specifies to print all of the log records.
EXITR=: Identifies the Resource Manager (RM) audit log record exit routine that is called to format each log record. EXITR=CSLRERA3 specifies to print the records in a memory dump format, including the record type and time-stamp information for each record.

Limiting log data to a specific time range

To limit the log data to a specific time range, use the FROM and TO parameters on the SUBSYS statement, as shown in the following example. This DD card prints log records from 11:00 to 12:00 on day 42 of the year 2010:

//SYSUT1    DD    DSN=SYSLOG.REPO.AUDIT.LOG
//                SUBSYS=(LOGR,IXGSEXIT,
//                'FROM=(2010/042,11:00:00),TO=(2010/042,12:00:00)'), 
//                DCB=(BLKSIZE=32760)

Dates and times are specified in Greenwich mean time (GMT). The seconds field in the time value is optional. To use local dates and times, add the LOCAL keyword, as shown in the following example:

//SYSUT1    DD    DSN=SYSLOG.REPO.AUDIT.LOG,
//                SUBSYS=(LOGR,IXGSEXIT,
//                'FROM=(2007/042,11:00:00),TO=(2007/042,12:00:00),LOCAL'),
//                DCB=(BLKSIZE=32760)

Sample

The following JCL shows what is required to print RS log records from the RS audit log stream:

//CSLERA1   JOB   MSGLEVEL=1,MSGCLASS=A,CLASS=K
//STEP1     EXEC  PGM=DFSERA10
//STEPLIB   DD    DISP=SHR,DSN=IMS.SDFSRESL
//SYSPRINT  DD    SYSOUT=A
//SYSUT1    DD    DSN=SYSLOG.REPO.AUDIT.LOG,
//                SUBSYS=(LOGR,IXGSEXIT),
//                DCB=(BLKSIZE=32760)
//SYSIN     DD
CONTROL    CNTL   H=EOF
OPTION     PRINT  EXITR=CSLRERA3
END
//