Previous Topic: CA Earl ProcessingNext Topic: Using JCL


Using ISPF

This section shows how to use the CA ACF2 ISPF panels to generate a CA Earl report. Some of the example panels shown present numerous options. This guide explains only the options that pertain to CA Earl. For additional information about any screen, press the HELP key (usually PF1 key) or check your CA Earl Reference Guide.

To generate reports using ISPF, you must perform these steps:

  1. Enter ISPF from TSO READY mode to enter the ISPF facility.
  2. Use the ACFRPTPP utility to convert SMF files into a sequential format.
  3. Invoke the CA Earl report procedure.

The examples that follow can help you through these steps.

Converting SMF Files to Sequential Format

Determine which SMF data sets will provide the input to your CA Earl reports. CA Earl, as packaged with CA ACF2, processes sequential files only. The ACFRPTPP utility converts the standard SMF files into a sequential format suitable for CA Earl.

To access ISPF

  1. Type ISPF from the TSO READY prompt.

    The ISPF/PDF Primary Option Menu appears.

  2. Select option A - Perform CA ACF2 Processing

    The CA ACF2 ISPF Option Selection Menu appears.

  3. Select option 4 - CA ACF2 Report Program Processor

    The CA ACF2 Report Program Processor Menu appears.

  4. Type 0 on the Option line to activate the ACFRPTPP - ACF2 SMF Record Preprocessor.

    The CA ACF2 SMF Record Pre-Processor Menu appears.

    In this panel, the default data set name for the CA Earl sequential file is TLC001.SMFFLT. The TLC001 in this example represents your user ID. This file contains the sequential format SMF records and becomes the input to your CA Earl report.

  5. Press Enter.

    The CA ACF2 SMF Record Pre-Processor Menu appears.

    Select the SMF files that ACFRPTPP is to process by typing Type the names of the SMF data sets to provide the input for your CA Earl report. You must also fill in the data set name for the output listing. There are no defaults for these data set names, so be sure to specify them when running ACFRPTPP. For example, you can enter 'SYS1.MAN1' in the RECIN1 field and 'SYS1.MAN2' in the RECIN2 field to specify the data sets that provide the input. In the LIST ID field, specify MYOUTPUT to identify the data set name for the output listing. The LIST ID field has an eight‑character limit. This produces an output data set with the name userid.ACF2.ACFRPTPP.MYOUTPUT. These data sets contain statistics about ACFRPTPP processing.

    You need CA ACF2 authorization (a rule or special privilege) to access the SMF data sets.

  6. Press Enter to start the preprocessor.

    After ACFRPTPP completes processing, you are placed into ISPF/PDF Browse, or you can browse the data set that contains the ACFRPTPP processing statistics. See the Reports and Utilities Guide for a complete description of the report fields.

  7. Press the End key (usually your PF3 key) to return to the CA ACF2 Report Program Processor Menu:
  8. Type F on the OPTION line

    The EARL Report Processor panel appears.

CA Earl Report Processor Field Descriptions

This section describes the fields on the EARL Report Processor panel.

DATA SET

The program name of the data set that contains the CA Earl source statements. This field is blank the first time you use this panel. By default, the CA Earl sample programs are placed in a library named CAI.CAIMAC when you install CA ACF2. Check with your local CA ACF2 maintenance person if you are not sure about this data set name. See the "Sample Reports" chapter for a complete list of the CA Earl reports that we supply with CA ACF2. Also, remember that you can specify the name of one of your own custom reports.

MACLIB

The library name of the data set that contains the copy members that the CA Earl source program requires. This field is blank the first time you run an CA Earl report. By default, some standard copy members that you may need are placed in a library named CAI.CAIMAC when you install CA ACF2. Check with your local CA ACF2 maintenance person if you are not sure about this data set name.

LIST ID

The data where the report is written to, selected by the user.

//ACFFLT:

The name of the sequential data set that contains the CA Earl flat file SMF records ACFRPTPP creates. This file is the input for your CA Earl report. This field defaults to userid.SMFFLT. Press the ENTER or RETURN key to produce your report. By default, CA Earl writes your report to an output file named &syspref.ACF2.EARL.listid. &syspref is the same value as the user's DFT‑PFX value, and listid is the list ID specified on the EARL Report Processor panel.

Depending on how CA Earl is installed, you may need to modify the CLIST that runs this panel. Check with your systems programmer for assistance.