Performance List report

The Performance List report provides a detailed list of the CMF performance class records.

To request the report, enter line action S against the List Performance Report on the Report Set panel. If reports of this type have been previously specified, the list of Performance List Reports is displayed. Otherwise, the Performance List Report panel is displayed for you to define your first report of this type.
Figure 1. Performance List Reports
   File  Filter  Edit  Systems  Options  Help
 ------------------------------------------------------------------------------
                       SAMPLE - Performance List Reports           Row 1 from 4
 Command ===> ________________________________________________ Scroll ===> ____
 
         ---- System Selection ----                                  Selection
 /  Exc  APPLID +  Image +  Group +   Output     Form +    Alert +   Criteria 
 S       CICSP001  ________ ________  LIST0001   TRANLIST  ________    YES
 _       DEVT____  MVS1____ ________  LIST0002   RESPLIST  ________    NO
 _       CICST001  ________ ________  LIST0003   TRANLIST  ________    YES
 _   *   ________  ________ RSYSGRP1  LIST0004   ________  ________    NO
 ********************************* End of list *********************************
 

This panel displays the list of Performance List Reports in this Report Set. You can select (edit), delete, or include/exclude any report, insert new ones, or rearrange them (move/copy).

The options are:
Exc
An asterisk (*) in this field indicates that the report or extract is excluded from report processing.

Use line action X to reverse the Exclude indicator.

System Selection
Identifies the CICS® APPLIDs whose data you want to select for processing.

You can specify any combination of APPLID, Image, or Group, but these must be defined in your System Definitions. If you do not specify System Selection here or in the Global Options, then you are prompted at run time to specify the System Selection. This will apply globally to all reports and extracts without their own System Selection. This is recommended as it allows you to run your Report Sets against any of your defined Systems. Press the Prompt key (F4) to select from a list of defined Systems, Images, or Groups. To modify your System Definitions, select Systems in the action bar.

Specify one of the following:
  • A CICS APPLID. An APPLID that matches a defined System's name pattern is also allowed. For example, CICSP1 can be specified if CICSP* is a defined system.
  • An APPLID and an MVS™ Image. This identifies the MVS Image where your CICS system runs.
  • An MVS Image. All CICS systems executing on this MVS Image is selected.
  • An APPLID and Image combination plus a Group. This is useful for uniquely identifying a CICS system when there are multiple CICS systems with the same name defined.
  • A Group alone. CICS PA will select all CICS APPLIDs defined to the Group. For example, for transaction grouping, or for systems that connect via IRC/MRO, ISC/APPC, or IPIC.

CICS PA uses the System Selection in JCL generation to build the APPLID(applid1,applid2,applid3,...) and INput(SMFIN001,SMFIN002,SMFIN003,...) operands, and corresponding //SMFINnnn DD statements.

System Selection can also be specified either:
  • In Global Options. The report-level specification takes precedence over the global.
  • At run time. The run-time System Selection overrides the Global Options and optionally the report-level specification.
Output
The DDname for the report output which CICS PA uses when generating the JCL to run the Report Set.

This option generates the OUTPUT(ddname) operand.

Form
The name of a Report Form to be used to tailor the format and content of the report. The report must use a Report Form of a compatible type, that is LIST or LISTX. If not specified, CICS PA uses the default Form. See Figure 1 for the default LIST Report Form.

CICS PA JCL generation translates the Report Form specification into the FIELDS operand.

Alert
The name of a Performance Alert Definition to be used to report performance non-compliance.
Selection Criteria
This indicator is generated by CICS PA.

YES indicates that Selection Criteria are activated for this report or extract.

NO indicates that Selection Criteria are not activated for this report or extract. This can mean that no Selection Criteria have been specified, all Select Statements are Excluded, or the Selection Criteria have been deactivated.

Line Actions: The valid line actions on the list of reports panel are:
Display the menu of line actions
S
Select this row for review or modification
I
Insert a row
R
Repeat this row
C
Copy this row
M
Move this row.
A
Move⁄Copy after this row
B
Move⁄Copy before this row
D
Delete this row
X
Reverse the Exclude indicator (Include/Exclude)
Primary Commands: The following primary commands are valid for this panel:
SHOW
This command shows all items in the list, both Included and Excluded. This is the default on entry to the panel.

Also available from Filter in the action bar.

HIDE
This command hides all Excluded items which have * in the Exc column. Only the Included items, where Exc is blank, are displayed. If all items are Excluded, a blank row is inserted to accept entry of a new data set specification. Row n from m after the panel title indicates the total number of items in the list. HIDE is only in effect until exit from this panel, or until the next SHOW command is issued.

Also available from Filter in the action bar.

EXCLUDE
This command Excludes all items by displaying * in their Exc column.

Also available from Edit in the action bar.

INCLUDE
This command Includes all Excluded items by removing the * from their Exc column.

Also available from Edit in the action bar.

RESET
This command (or RES) removes all outstanding line actions and deletes any blank rows.

Also available from Edit in the action bar.

SYSDEFS
This command opens the Personal System Definitions dialog.

Also available from Systems in the action bar.

To display the Performance List Report panel, enter line action S against the List Performance Report on the Report Set panel, then if the list of previously specified reports is displayed, enter line action S against a particular report in the list.
Figure 2. Performance List Report
   File  Systems  Options  Help
 ------------------------------------------------------------------------------
                       SAMPLE - Performance List Report
 Command ===> _________________________________________________________________
 
 System Selection:                       Report Output:
  APPLID . . CICSP001  +                  DDname . . . . . . . . . LIST0001
  Image  . . ________  +                  Print Lines per Page . . ___ (1-255)
  Group  . . ________  +
 
 Report Focus:
  Form . . . TRANLIST +
  Alert  . . ________  +
   Severity  ________  +
  
 Report Options:
  Title  . . ________________________________________________________________
             ________________________________________________________________
 
 Selection Criteria:
  _  Performance  *
 
 Repository  . . : 
  F1=Help      F3=Exit      F4=Prompt    F7=Backward  F8=Forward  F10=Actions
 F12=Cancel

Use this panel to specify report options, report format, and record selection criteria for the Performance List report. The only mandatory option is the DDname for the report output. You can let the other options default.

The precision of numerical fields in the report is specified in Global Options (see Figure 1).

The options are:
System Selection
Identifies the CICS APPLIDs whose data you want to select for processing.

You can specify any combination of APPLID, Image, or Group, but these must be defined in your System Definitions. If you do not specify System Selection here or in the Global Options, then you are prompted at run time to specify the System Selection. This will apply globally to all reports and extracts without their own System Selection. This is recommended as it allows you to run your Report Sets against any of your defined Systems. Press the Prompt key (F4) to select from a list of defined Systems, Images, or Groups. To modify your System Definitions, select Systems in the action bar.

Specify one of the following:
  • A CICS APPLID. An APPLID that matches a defined System's name pattern is also allowed. For example, CICSP1 can be specified if CICSP* is a defined system.
  • An APPLID and an MVS Image. This identifies the MVS Image where your CICS system runs.
  • An MVS Image. All CICS systems executing on this MVS Image is selected.
  • An APPLID and Image combination plus a Group. This is useful for uniquely identifying a CICS system when there are multiple CICS systems with the same name defined.
  • A Group alone. CICS PA will select all CICS APPLIDs defined to the Group. For example, for transaction grouping, or for systems that connect via IRC/MRO, ISC/APPC, or IPIC.

CICS PA uses the System Selection in JCL generation to build the APPLID(applid1,applid2,applid3,...) and INput(SMFIN001,SMFIN002,SMFIN003,...) operands, and corresponding //SMFINnnn DD statements.

System Selection can also be specified either:
  • In Global Options. The report-level specification takes precedence over the global.
  • At run time. The run-time System Selection overrides the Global Options and optionally the report-level specification.
Report Output DDname
The DDname for the report output. Specify 1-8 alphanumeric characters starting with an alphabetic character. The DDname is mandatory and should be unique to separate the output of multiple reports.

CICS PA assigns a default DDname LISTnnnn where nnnn is a sequential number 0001-9999 to ensure each report has a unique DDname.

This option generates the OUTPUT(ddname) operand.

Print Lines per Page
The maximum number of lines, including headings, to print on each page of the report. Valid values are from 1 to 255. The default is 60.

A global value can be specified to apply to all reports. If a value is also specified here on the report panel, it takes precedence over the global for this report only.

CICS PA JCL generation translates this field to the LINECount operand.

Report Form
The name of a LIST Report Form to be used to tailor the format and content of the report.

To select the name from a list of compatible Report Forms, position the cursor on the Form field and press Prompt (F4).

CICS PA JCL generation translates the Report Form specification into the FIELDS operand.

If a Report Form is not specified, CICS PA uses the default Form. See Figure 1 for the default Report Form for the LIST report.

Alert
The name of a Performance Alert Definition.

To select from a list of predefined names, position the cursor on the Alert field and press Prompt (F4).

CICS PA JCL generation translates the Alert specification into the ALERTDEF operand.

Severity
When an Alert name is specified, this suboption allows you to specify the minimum severity level to be reported and type of transactions reported.

The minimum severity level selected for reporting is used to report transactions that have at least that level of reporting in any of the severity fields. This could result in transactions being reported with severity lower than the specified severity when the transaction also has one or more severity fields that meets the specified severity criteria. For example, if you specify SEVERITY(CRITICAL) for the report, only transactions with Critical severity are reported, however, if a transaction also exceeds Warning or Info thresholds, the lower severity will be also reported.

Press Prompt (F4) to select from the list of available options which are:
CRITICAL
Only Critical transactions are reported.
WARNING
Only Critical and Warning transactions are reported.
INFO
All alerts are reported: Critical, Warning and Informational transactions.
ELIGIBLE
Only eligible transactions are processed and reported. Eligible transactions are those that have resource values that match resource values specified in the alert definition. The resulting report will include eligible only transactions with and without alerts.

This option provides the means to filter out transactions that would never generate an alert because their resource values do not match resource values specified in the alert definition.

ALL or blank
All transactions are reported regardless of whether they are eligible or whether they generate an alert. This is the default.

CICS PA JCL generation translates the Severity specification into the SEVERITY(CRITICAL|WARNING|INFO|ELIGIBLE|ALL) operand.

Title
Title of the report. Specify up to 128 characters of text to describe the report. CICS PA concatenates the two lines of 64 exactly as entered to make one line which prints at the top of each page of the report below the heading. The default is blank (no title).

If the report uses a Report Form, and a title is specified on both, the title on this report panel takes precedence.

This option generates the TITLE1('left-half') and TITLE2('right-half') operands.

Performance Selection Criteria
You can specify Selection Criteria to filter the CMF records on time period and field values to restrict reporting to the data that is of interest to you.

CICS PA JCL generation translates Selection Criteria to the SELECT(PERFORMANCE operand.

If you specify a Report Form that also has Selection Criteria specified, CICS PA JCL generation translates the Form's Selection Criteria to the SELECT2(PERFORMANCE operand. If both the report and the Form specify Selection Criteria, then a record must pass selection by both specifications to be included in the report.

Line Actions:
Display the menu of line actions.
S
Display the subpanel where Selection Criteria can be specified for this report. For details, see Specifying Selection Criteria.
A
Activate the Selection Criteria so they are generated for this report when the Report Set is submitted. Selection Criteria can only be activated if one or more Select Statements are specified and not all are excluded. An asterisk (*) indicates they are active.
D
Deactivate the Selection Criteria. Any you have specified here will not be used.
Repository
The data set name of the Repository that contains the Performance Alert Definitions.