How to use the dialog

The following steps briefly describe how to use the dialog to start reporting.

Initial setup (defaults apply)

This is applicable when using CICS PA for the first time.

Initial setup is optional. CICS PA uses default settings and prompts you to allocate data sets (with default allocation attributes) as they are required. However, if you want to step through the process, the initial setup procedure is:

  1. Check your ISPF environment settings. See Recommended ISPF setup.
  2. Specify the CICS PA Settings. This allows some customization of the CICS PA dialog and JCL used for generating reports and extracts. See CICS PA Settings.
  3. Specify default Reporting Allocation Settings (UNIT= and SPACE=) for the Extract data sets, External Work data sets, and Sort Work data sets. These are used by the CICS PA dialog to generate the corresponding DD statements in the JCL. See Reporting Allocation Settings.
  4. Specify the Control Data Sets that contain the Report Sets, Report Forms, Object Lists, and the Repository. See CICS PA Control Data Sets.
  5. If you plan to export HDB data to DB2®, specify your DB2 settings. Select option 0, CICS PA Profile, from the Primary Option Menu, and then select DB2 Settings.
  6. Start of changeSpecify which system definitions (personal or shared or both) to use at run time. If you plan to report on data stored in log streams, specify Log stream options. Select option 0, CICS PA Profile, from the Primary Option Menu, and then select File Selection.End of change

Everyday operation

The normal procedure to request and generate reports and extracts is as follows:
  1. Start of changeSpecify the System Definitions by identifying your personal and shared systems (CICS® APPLID, MVS™ Image, DB2 SSID, MQ SSID, System Logger), SMF Files, and Groups. You can automate much of this process by using the Take-up facility. See Personal System Definitions and Shared System Definitions.End of change
  2. Define a Report Set:
    • Create a new Report Set. See Creating new Report Sets.
    • Specify any Global Options and Selection Criteria. The Global Options apply to all reports and extracts within the Report Set. The global Performance Selection Criteria apply to all Performance reports and extracts within the Report Set. The global Exception Selection Criteria apply to all Exception reports within the Report Set.
    • Select and tailor the Reports and Extracts that you require. If report-specific options and selection criteria are specified, they take precedence over the corresponding Global Options and Selection Criteria at JCL build time. You can request more than one of each type of report or extract (for example, 3 Performance List Reports and 2 Cross-System Work Extracts), and specify different options for each. Exclude any of a particular type you do not want to generate, and Deactivate if you want to generate none of a particular type. See Maintaining Report Sets for details of all reports, extracts, and their options.
  3. Define any Report Forms used to tailor the format of the Performance List, Performance List Extended, Performance Summary and Cross-System Work reports, and Performance Data extract. See Maintaining Report Forms.
  4. Define any Object Lists used to enhance the Selection Criteria. See Maintaining Object Lists.
  5. Enter the RUN command to run the Report Set. The Active status controls which reports in the Report Set are run. Only active reports in active categories are selected, but you can use the RUN line action to temporarily override this. A panel is displayed for you to enter run-time options. Then CICS PA generates the JCL for batch report processing. Global Options and Selection Criteria, requested reports and extracts, and any Report Forms and Object Lists they use, are converted to a stream of commands for batch execution. You can choose to submit the JCL directly, or edit it first and optionally save the JCL in an external library. See Running Report Sets.
  6. View or print the job output using your usual method, such as SDSF or ISPF Outlist utility.
  7. Process the Extract data sets using a method appropriate to each. For example:
    • Analyze the Cross-System Work Extract data using CICS PA Performance Reports such as the List, Summary, and Totals reports.
    • Analyze the Performance Data Extract, Statistics Extract, or System Logger Extract data using external programs such as DB2 or PC tools such as Lotus® 1-2-3.
    • Specify the Record Selection Extract data sets as your SMF Files in System Definitions to reduce the volume of data processed by CICS PA.
  8. Define and maintain Historical Databases (HDBs) as repositories of performance data. Generate reports from your HDBs or export HDB data to DB2 tables for further analysis.

Information Information

Feedback


Timestamp icon Last updated: Friday, 8 February 2013


http://pic.dhe.ibm.com/infocenter/cicsts/v5r1/topic//howtodiag.htm