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® APPLID(s) 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. 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.
- 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 at the top right of the
panel 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.
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 *
HDB Register . :
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 APPLID(s) 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. Multiple
reports of the same type can use the same DDname without consequence,
however a mix of reports using the same DDname might interleave the
print lines.
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 pre-defined 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 sub-option 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 generate
an alert or not, and whether they are eligible or not. 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:
Valid line actions are:- ⁄
- Display the menu of line actions.
- S
- Select to 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.
- HDB Register
- The data set name of the HDB Register that contains the Performance
Alert Definitions.