Sample library

The CICS PA Sample Library (SCPASAMP) contains sample members to demonstrate CICS PA features, such as JCL to generate most of the CICS PA reports and extracts.

Member Name Description
CPAAOR Runs the Performance List and Summary reports for an AOR (Application-Owning Region).
CPACTGRP Runs the CICS® Transaction Gateway Statistics Activity Summary and Usage and Capacity reports.
CPADBCTL Runs the Performance List and Summary reports for IMS™ (DBCTL).
CPADB2 Runs the DB2® reports (list, short summary, long summary).
CPADB2# Runs the Performance List and Summary reports for a region using DB2.
CPADB2AD Runs the DB2 utility to delete a row from the Statistics Alerts DB2 table.
CPADB2HK Runs the DB2 utility to delete DB2 table rows based on relative date and time.
CPADB2PD Runs the DB2 utility to delete a block of rows from the Performance Summary table using start and end date and time.
CPADB2SD Runs the DB2 utility to delete all rows in the Dispatcher TCB Modes DB2 table for a specific TCB Mode Name and APPLID.
CPAFOR Runs the Performance List and Summary reports for an FOR (File-Owning Region).
CPAHDB Runs the SMF Dump process, followed by Take-up, HDB Load, and selected reports. By combining take-up, HDB load and reporting into a single job step, all CICS PA functions can be performed by a single pass of the SMF data.

For more information on this process, see Take-up from SMF File.

CPALGDDL Runs the DDL to define a DB2 table for the system logger extract data.
CPALGLOD Runs the DB2 Load Utility statements to load the system logger extract data into a predefined DB2 table.
CPALOGR Runs the System Logger reports (list and summary).
CPALSTSU Runs the Performance List report specifying file CPU service unit conversion factor.
CPAMQ Runs the WebSphere® MQ List and Summary reports for MQ Accounting (SMF 116) Classes 1 and 3.
Start of changeCPAMWPRXEnd of change Start of changeREXX used to convert the CSV created by CPAMWPXT to a format that can be used with the Mobile Workload report.End of change
Start of changeCPAMWPXTEnd of change Start of changeRuns the CICS PA Performance Summary extract to create a CSV file, and then uses the supplied REXX (CPAMWPRX) to convert the CSV to a format that can be used with the Mobile Workload report.End of change
CPAOMEGA Runs the OMEGAMON® List and Summary reports for all supported DBMS types.
  1. OMEGAMON List report of Total and Database segments
  2. OMEGAMON List report of Total segment
  3. OMEGAMON List report of Database segment for transaction codes starting with FNL*
  4. OMEGAMON Transaction Summary report with Average and Maximum statistics for Total and Database segments
  5. OMEGAMON Database Summary report with Average and Maximum statistics for Total and Database segments
  6. OMEGAMON Transaction and Database Summary reports with Total, Maximum and 90% Peak Percentile for Database segments
CPAPALST Runs the Performance Alerts list report:
  1. Using a FORM to generate the FIELDS. SEVERITY(ALL) indicates that all transactions are reported regardless of whether they are eligible or whether they generate an alert.
  2. Using the Alert Template to specify the fields in the report instead of a FORM. Operand SEVERITY(CRITICAL) indicates that only transactions with severity of Critical are reported.
  3. Using the Alert Template to specify the fields in the report instead of a FORM. Operand SEVERITY(WARNING) indicates that only transactions with severity of Warning or Critical are reported.
  4. Using the Alert Template to specify the fields in the report instead of a FORM. SEVERITY(INFO) indicates that only transactions with severity of Informational, Warning and Critical are reported.
  5. Using the Alert Template to specify the fields in the report instead of a FORM. SEVERITY(ELIGIBLE) indicates that only transactions that are eligible for alert processing are reported. Eligible transactions are those that have field values that match the Resource values defined in the Alert definition. Eligible transactions with and without alerts are reported.
CPAPASUM Runs the Performance Alerts summary report:
  1. Using a FORM to generate the FIELDS.
  2. Specifying SEVERITY(ELIGIBLE) to include only transactions that are eligible for alert processing. Eligible transactions are those that have field values that match the resource values defined in the alert definition. Eligible transactions with and without alerts are reported.
CPAPAXTL Runs the Performance Alerts list extract using a FORM to generate the FIELDS operand. SEVERITY(ALL) indicates that all transactions will be included in the extract.
CPAPAXTS Runs the Performance Alerts summary extract using a Form to generate the FIELDS operand. SEVERITY(ELIGIBLE) indicates that only transactions that are eligible for alert processing are reported. Eligible transactions are those that have field values that match the resource values defined in the alert definition. All eligible transactions with and without alerts are reported.
CPAPCBTS Runs the BTS (CICS Business Transaction services) report.
CPAPEXP Runs the Performance data extract.
CPAPLIST Runs the Performance List report with default FIELDS settings.
CPAPLSFC Runs the Performance List and Summary reports, tailored to present file control information.
CPAPLSPC Runs the Performance List and Summary reports, tailored to present program control information.
CPAPLSTX Runs the Performance List extended report with default FIELDS settings.
CPAPROFH Runs the Transaction Profiling report comparing SMF report data against HDB baseline data.
CPAPROFS Runs the Transaction Profiling report comparing SMF report data against SMF baseline data.
CPAPSUM Runs the Performance Summary report with default FIELDS settings and sorted by Transaction ID and User ID.
CPAPTOT Runs the Performance Totals report with default FIELDS settings.
CPAPTRGP Runs the Transaction Group report.
CPAPWAIT Runs the Performance Wait Analysis report.
CPAPWLM Runs the Workload Activity reports (list, summary by service class, and summary by report class).
CPAPXSYS Runs the Cross-System report and extract. The second job step (STEP2) runs the Performance List report against the extract created in the first job step.
Start of changeCPARSSAMEnd of change Start of changeStores the sample report sets and all associated objects. You run the JCL in member CPARSSJC to install the report sets.End of change
Start of changeCPARSSJCEnd of change Start of changeExtracts and installs the sample report sets and all associated objects.End of change
CPASAHDB Runs the Statistics HDB Alert report in various sort orders.
CPASASMF Runs the Statistics Alert report (from SMF data) in various sort orders.
CPASPSM1 Uses sysout2pdf, to convert the Performance Summary report to PDF and save file in a z/OS® UNIX directory.
CPASPSM2 Uses sysout2pdf, to convert a Performance Summary report containing many fields to a PDF with a custom page size. The report is sent as PDF and text attachments by email.
CPASPWT1 Uses sysout2pdf, to convert a Wait Analysis report to PDF, using a wait analysis report-specific filter that creates a bookmark for each transaction code. The report is sent as PDF and text attachments by e-mail.
CPASTLST Runs the Statistics List report.
Start of changeCPASTSUMEnd of change Start of changeRuns the CICS PA Statistics Summary report.End of change
CPASUREX REXX used to calculate the service unit conversion factor for the current LPAR.
CPATOD Runs the Performance Summary report analyzing transaction activity by Time of Day.
CPATOR Runs the Performance List and Summary reports for a TOR (Terminal-Owning Region).
CPATRSUM Runs the tiered Performance Summary reports.
CPATRU Runs the Transaction Resource Usage reports (list and summary) for files and temporary storage.
CPATTLST Runs the Transaction Tracking List report.
CPATTSUM Runs the Transaction Tracking Summary report.
CPAWEB Runs the Performance List and Summary reports showing web activity.
CPAXCEPT Runs the Exception List and Summary reports.

CICS PA has a powerful command language to request reports. This language allows you to tailor your report requests to address the many aspects of measuring CICS performance. The JCL samples demonstrate reporting for some of the more common CICS facilities.

In addition, the CICS PA dialog provides a comprehensive set of sample report forms for formatting your reports and extracts. See Table 1 for the list of sample report forms provided by CICS PA.