Previous Topic: Using EARLRPTSNext Topic: Customizing Reports


Generating zVM Reports Manually

You can use standard CA ACF2 VM and CA Earl commands and utilities to produce CA Earl reports. Examples of the input panels, output panels, and so on are shown.

To produce a CA Earl report manually

  1. Invoke the ACFRPTPP utility to convert the SMF files into a sequential file.
  2. Invoke the CA Earl utility to produce your report.

Invoking the ACFRPTPP Utility

Use the ACFSERVE QUERY SMF command to display the SMF files and determine which files you will need for to run your report. See the "Using the ACFSERVE Commands" chapter in the CA ACF2 for VM Administrator Guide for information on this command.

Link to and access the minidisks that contain the SMF files you are using for the reports. Then issue FILEDEF commands to define the following input and output files for ACFRATPP:

RECxxxxx

Each RECxxxxx FILEDEF defines a single SMF input file to ACFRPTPP. You can define multiple SMF input files.

SYSPRINT

This output file contains any messages ACFRPTPP issued, and a summary report showing how many records were read and written.

SMFFLT

This output file contains the sequential format SMF records. CA Earl report procedures use this file as input. See the CA ACF2 for VM Reports and Utilities Guide for a detailed description of ACFRPTPP.

The following example shows the FILEDEF and ACFRPTPP commands. Two SMF input files (REC00001 and REC00002) are defined for input. Also, the sequential SMF output file name is ACFFLT OUTPUT A.

filedef rec00001 disk smf 94224001 *
Ready; T=0.01/0.01 16:38:59
filedef rec00002 disk smf 94225001 *
Ready; T=0.01/0.01 16:39:20
filedef smfflt  disk acfflt output *
Ready; T=0.01/0.01 16:39:39
filedef sysprint disk acfrptpp listing * ( lrecl 133
Ready; T=0.01/0.01 16:40:18
acfrptpp
SYSIN not defined ‑ enter report parameters or ENTER to start
PP?
Ready; T=0.01/0.01 16:45:38

An example of the output from ACFRPTPP is shown as follows.

CA ACF2 UTILITY LIBRARY ‑ ACFRPTPP ‑ SMF RECORD PRE‑PROCESSOR  ‑  PAGE 1 
DATE 03/29/02 (02.88) TIME 07.57
                *‑‑ RECORD SELECTION SUMMARY ‑ BY DDNAME ‑‑*
  DDNAME   DESCRIPTION          COUNT  SELECTION
 SMFFLT    SMF FLAT FILE           23  221‑D,220‑P,227‑V,223‑R,222‑L,230‑*
                                       * ‑ INDICATES ACF2 COMBINED SMF NUMBER

                      ‑‑‑ TOTAL RECORDS PROCESSED ‑‑‑

READ=75                  SELECTED=23              WRITTEN=23 
CA-ACF2 UTILITY LIBRARY ‑ ACFRPTPP ‑ SMF RECORD PRE‑PROCESSOR  ‑  PAGE 2 
DATE 03/29/02 (02.88) TIME 07.57
                *‑‑ SMF RECORDS INPUT SUMMARY ‑ BY DDNAME ‑‑*

         <‑‑‑‑‑‑‑‑‑‑ STARTING ‑‑‑‑‑‑‑‑‑‑>  <‑‑‑‑‑‑‑‑‑‑‑ ENDING ‑‑‑‑‑‑‑‑‑‑‑> 
DDNAME   <‑‑‑PHYSICAL‑‑‑><‑‑‑LOGICAL‑‑‑‑>  <‑‑‑PHYSICAL‑‑‑><‑‑‑LOGICAL‑‑‑‑> 
 COUNT             DATE    TIME    DATE    TIME      DATE    TIME    DATE    TIME
REC1      03/29/02 00.00  03/29/02 00.00    03/29/02 07.52  03/29/02 07.52 
    75 CA-ACF2 UTILITY LIBRARY ‑ ACFRPTPP ‑ SMF RECORD PRE‑PROCESSOR  ‑  PAGE 3 
DATE 03/29/02 (02.88) TIME 07.57

                *‑‑ SMF RECORDS INPUT SUMMARY ‑ BY TYPE ‑‑*

       ‑‑0‑‑  ‑‑1‑‑  ‑‑2‑‑  ‑‑3‑‑  ‑‑4‑‑  ‑‑5‑‑  ‑‑6‑‑  ‑‑7‑‑  ‑‑8‑‑  ‑‑9—
  0‑     0      0      0      0      0       0      0      0      0      0   
 10‑     0      0      0      0      0       0      0      0      0      0  
 20‑     0      0      0      0      0       0      0      0      0      0  
 30‑     0      0      0      0      0       0      0      0      0      0  
 40‑     0      0      0      0      0       0      0      0      0      0  
 50‑     0      0      0      0      0       0      0      0      0      0  
 60‑     0      0      0      0      0       0      0      0      0      0  
 70‑     0      0      0      0      0       0      0      0      0      0  
 80‑     0      0      0      0      0       0      0      0      0      0  
 90‑     0      0      0      0      0       0      0      0      0      0  
100‑     0      0      0      0      0       0      0      0      0      0  
110‑     0      0      0      0      0       0      0      0      0      0  
120‑     0      0      0      0      0       0      0      0      0      0  
130‑     0      0      0      0      0       0      0      0      0      0  
140‑     0      0      0      0      0       0      0      0      0      0  
150‑     0      0      0      0      0       0      0      0      0      0  
160‑     0      0      0      0      0       0      0      0      0      0  
170‑     0      0      0      0      0       0      0      0      0      0  
180‑     0      0      0      0      0       0      0      0      0      0  
190‑     0      0      0      0      0       0      0      0      0      0  
200‑     0      0      0      0      0       0      0      0      0      0  
210‑     0      0      0      0      0       0      0      0      0      0  
220‑     0      0      0      0      0      0       0      0      0      0  
230‑    75      0      0      0      0      0       0      0      0      0  
240‑     0      0      0      0      0      0       0      0      0      0  
250‑     0      0      0      0      0      0
       ‑‑0‑‑  ‑‑1‑‑  ‑‑2‑‑  ‑‑3‑‑  ‑‑4‑‑  ‑‑5‑‑  ‑‑6‑‑  ‑‑7‑‑  ‑‑8‑‑  ‑‑9‑‑

Invoking CA Earl to Produce a Report

Now that you have the SMF records converted into a sequential file, invoke CA Earl to format a report. Issue another series of FILEDEF commands. You must define:

EARLLIB

The file name and type of the CA Earl MACLIB. This is defined so that CA Earl can locate the programs needed to run your reports.

ACFFLT

The file name and type of the sequential SMF file you created using the ACFRPTPP utility. This is the input for your report.

The following example shows the FILEDEF commands and how to invoke CA Earl. The ACFFLT OUTPUT file that ACFRPTPP created is defined as report input:

filedef earllib disk earllib maclib *
Ready; T=0.01/0.01 17:01:59
filedef smfflt disk acfflt output *
Ready; T=0.01/0.01 17:02:20
earl rptpw
Ready; T=0.01/0.01 17:03:18

Output from the RPTPW report is placed in a file named RPTPW LISTING.

03/29/02                    INVALID PASSWORD REPORT                   PAGE     1
                 RUN DATE:    03/29/02     RUN TIME:    18.00.33 
‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑ 
     DATE  TIME LOGONID  JOBNAME  SUBMITTOR SOURCE    PROGRAM   REASON  LOG  CPU
                                  LID/PROC                        CODE  VIO 
‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑ 
03‑29‑02  8.32 ECEJAS   ECEJAS   LOGON     LV861                   12  VIO  TLC1 
03‑29‑02  8.32 ECEJAS   ECEJAS   LOGON     LV861                   12  VIO  TLC1 
03‑29‑02  9.13 TLEFKH   TLEFKH   LOGON     LV822                   17  VIO  TLC1 
03‑29‑02  9.18 TLEGEST  TLEGEST  LOGON     LV853                   12  VIO  TLC1 
03‑29‑02  9.18 TLEGEST  TLEGEST  LOGON     LV853                   12  VIO  TLC1 
03‑29‑02  9.43 TLEFKH   TLEFKH   LOGON     LV822                   12  VIO  TLC1