AUDITREPORT

The AUDITREPORT control statement lets you copy the raw data used to produce the Record Summary Report (created at the end of the dump or extract process). You can write the data to a file for report processing outside of CA SMF Director. Additionally, you can use the AUDITREPORT PRINT statement to generate a customized Record Summary Report.
smfd127
The AUDITREPORT control statement lets you copy the raw data used to produce the Record Summary Report (created at the end of the dump or extract process). You can write the data to a file for report processing outside of CA SMF Director. Additionally, you can use the AUDITREPORT PRINT statement to generate a customized Record Summary Report.
When
you create a customized Record Summary Report with AUDITREPORT PRINT, the classic Record Summary Report is not produced.
Statement Format
The statement has the following syntax:
►►─ AUDITREPORT ─┬───────────────┬──┬────────────────────────────────────────────────────────────────────────────────────────────────────────────┬──────►◄                  └──TODD(
ddname
)─┘  └──PRINT──┬─────────────────┬───┬─────────────┬──┬─────────────────┬─┬─────────────────────────────────────┬─┘                                                └─PRINTDD(ddname)─┘   └TYPES(
W
|R|A)─┘  └SUBTYPES(
C
|D|N)──┘ └──DETAIL(column detail list)─────────┘
Operands
The statement has the following operands:
  • TODD(ddname)
    Specifies the name of an output file where the raw report data is written. You can use this file to format your own data reports.The file has the following attributes:
    • RECFM=VB
    • LRECL=80
    The block size can be any allowable block size up to 32756. LBI is not supported. The file is written using the QSAM access method, so you can specify z/EDC compression and pervasive encryption via SMS policies and classes or in the JCL definition of the file.
    The records are mapped with the SMFMROUT assembly language macro, which is available in the CASFMAC library.
  • PRINT
    Indicates that SMF Director should produce a customized Record Summary Report with the data generated. The report will be formatted based on the selections in the TYPE, SUBTYPE, and DETAIL operands, and written to the file defined in the PRINTDD operand.
    When you create a customized Record Summary Report with AUDITREPORT PRINT, the classic Record Summary Report is not produced.
  • PRINTDD(ddname|
    CAIAUDIT
    )
    Specifies the output file for the generated print file. The output print file is produced as a file of 133 byte print lines. Page breaks are produced based on the value of MAXLINES defined in the SCDS global configuration. As with the standard Audit Report file, if the MAXLINES value is set to zero, no page breaks are produced. 
    If this operand is omitted, the report is written to the CAIAUDIT DD.
  • TYPES(
    W
    |R|A)
    Indicates which record types to report on reported on. The following values are allowed:
    • (default) W
      Produce a report line for all SMF record types that were written by the dump or extract process.  
    • R
      Produce a report line for all SMF record types that were read in by the dump or extract process. For the dump process, this produces an identical report as TYPES(W) because all records read in by the product during the dump process will be written to the history file archive. During an extract process, the report shows which record types were read in during the extract and the count of the records read. Detail data is not produced for record types that were not written out.
    • A
      Produce a report line for all SMF record types, whether they were read in or written out during the dump or extract process.
  • SUBTYPES(
    C
    |D|N)
    Indicates the level of detail to be produced in the report for SMF record subtypes. There are three values allowed:
    • (default) C
      Produce a count of each subtype at the end of the record type report lines.  Each subtype and the count of the number of records will be produced.  If more space is needed, the report will line break and more subtype entries will be placed on the next line until all of the subtypes for a given type are listed.
    • D
      Produce an individual report line with all of the detail values for each subtype.  These lines will be presented in order after the line covering the SMF record type.
    • N
      Produce no subtype information.
     Only subtypes that are written out in the dump or extract process are reported on. There is no reporting on subtypes that were written during the dump or extract process.
  • DETAIL(column detail list)
    Indicates which columns to produce in the report. If this operand is omitted, only the "count of records read" and "count of records written" columns are produced. The operand allows for a list of up to six operands, each of which indicates which data columns to generate for each type, and for each subtype if the SUBTYPES(D) operand is indicated. The allowed detail items are:
    • MIN
      – The minimum LRECL for a record of the type/subtype indicated.
    • MAX
      – The maximum LRECL for a record of the type/subtype indicated.
    • AVG
      – The average LRECL for all of the records of the type/subtype indicated.
    • TOT
      – The total number of bytes for all of the records of the type/subtype indicated.
    • OLD
      – The oldest time stamp found for all of the records of the type/subtype indicated.
    • NEW
      – The most recent time stamp found for all of the records of the type/subtype indicated.
     The operand indicates which columns to produce. The order that they are produced in the report is not necessarily the same as the order that the columns are coded in the operand. There are no operands for records read or records written, since these columns are always produced in the report.
Example: Use AUDITREPORT to Dump SMF Data in the Dump Process
The following example shows how you can use the AUDITREPORT control statement to dump SMF data in the dump process:
//        JOB                                          //DUMP   EXEC PGM=SMFD,REGION=0M                                    //STEPLIB  DD DISP=SHR,DSN=HLQ.CASFLOAD                       //SYSPRINT DD  SYSOUT=*                                              //SYSUDUMP DD  SYSOUT=*                                              //SYSOUT   DD  SYSOUT=*                                              //SCDS     DD  DISP=SHR,DSN=HLQ.SMFDIR.SCDS                              //REPDATA  DD  UNIT=3390,DISP=(NEW,CATLG),SPACE=(TRK,(1,1)),          //             DSN=APPL1.SMFDIR.REPDATA,                                        //             DCB=(RECFM=VB,BLKSIZE=29000,DSORG=PS,LRECL=80)        //SYSIN    DD  *                                                      AUDITREPORT TODD(REPDATA).                                                                                      DUMP.                                                               /*                                                                   
Example: Customized Record Summary Report 
The following example shows a customized report that is produced AUDITREPORT PRINT:
 BROADCOM                                        AUDIT TRAIL REPORT                            SMFD       PAGE     1                  CA SMF Director  r12.7                                                              XAD1      28 FEB 2019  14:06:34                                                                                                                                                        CAF0530I  CONTROL DATA SET LIVMI02.SMFR127.SCDS IS ON VOLUME PMA001                                                                                                                                                                                                         AUDITREPORT PRINT PRINTDD(AUDPRINT) TYPES(W) SUBTYPES(C)                                                                                     DETAIL(MIN,MAX,AVG) .                                                                                                                                                                                                                                                                              SOURCE DUMP(SMFDATA).                                                                                                               CAF2800I  SOURCE OPTION SET                                                                                                                                                                                                                                                 DUMP.                                                                                                                                                                                                                                                                                                                                                                                                           CAF2207I  SMF DATA WILL BE READ FROM FILE: SMFDATA   DSN: LIVMI02.SMFD127.AUDREP.XAD1DATA ON VOLUME TSU049                            CAF2218I  SMF DATA USING CONFIGURATION XAD1 IS BEING PROCESSED                                                                       CAF2401I  DUMP IS TO PRIMARY POOL TAPE VOLUME 253476  FILE: 13  DSN: LIVMI02.SMF16.XAD1.MS022819.T1406P01                             CAF2406I  XAD1 SMF DATA WAS FROM 02/20/2019 AT  0:00:00 TO 02/20/2019 AT  0:02:26                                                    CAF2406I  ALL SMF DATA WAS FROM 02/20/2019 AT  0:00:00 TO 02/20/2019 AT  0:02:12                                                      BROADCOM                                            RECORD SUMMARY REPORT                                PAGE 00001                  CA SMF DIRECTOR 12.7                                                                XAD1      28 02  2019  14:06:38                    TYPE  WRITTEN      READ          MINL   MAXL   AVGL   SUBTYPE COUNTS                                                                                                                                                                                                         14         664          664     432    652    452                                                                                    15         301          301     432    460    438                                                                                    17         127          127     100    100    100                                                                                    21          14           14     104    104    104                                                                                    22          14           14      60     60     60                                                                                    26          37           37     511    524    523                                                                                    30         210          210     480   4550   1354     1-        55       2-        10       3-        63       4-        63                                                                5-        19                                                                   32           2            2     224    224    224     1-         2                                                                   41           7            7     146    146    146     1-         4       2-         3                                                60         483          483     358   3167   1171                                                                                     61          94           94     296   4220    450                                                                                    62          46           46     254    254    254                                                                                     64         329          329     474    474    474                                                                                    65         125          125     310    388    311                                                                                     66          70           70     304    336    304                                                                                    80      20,340       20,340     256    434    257                                                                                     84           1            1    1344   1344   1344 32771-         1                                                                   92         736          736     160    348    217    10-       196      11-       196      14-        12      16-       317                                                               17-        15                                                                  100          10           10     678   9994   3065     0-         2       1-         2       2-         2       3-         2                                                                4-         2                                                                  101           7            7    2894   3006   2990     0-         7                                                                  102          14           14     238    238    238                                                                                   110         780          780     186  32742  22617     1-        60       2-       720                                               119         576          576     180    499    303     1-       287       2-       284      70-         5                            231          13           13     298    302    301                                                                                                                                                                                                                      TOTAL       25,000       25,000                   994