The SUMMARY Report Form defines the format and content of the following reports and extracts:
The Report Form defines the fields to be included, the order of the columns, sort sequence, statistical functions, and a title for the report.
The Report Form panel has three views as there are too many columns of information to display in a single screen view. Scroll Right (F11) to toggle between the views.
When you select to Edit or View a Report Form, the first view shown in Figure 1 is displayed by default. This first view displays field descriptions. The second view displays data dictionary information for each field. The third view is relevant only when you use the RNG (Range) function.
File Edit Confirm Upgrade Profiling Options Help
------------------------------------------------------------------------------
EDIT SUMMARY Report Form - SAMPSUMM More: >
Command ===> ________________________________________________ Scroll ===> PAGE
Description . . . . Summary Report Form_____________ Version (VRM): 680
Selection Criteria:
_ Performance Page width . . 132_
Field
/ Name + Sort Type Fn Description
__ TRAN____ K A _______ ___ Transaction identifier
__ TASKCNT_ _ _______ ___ Total Task count
__ ALERT___ _ _______ SEV Total Alert count or percentage
__ RESPONSE _ _______ AVE Transaction response time
__ RESPONSE _ _______ MAX Transaction response time
__ RESPONSE _ _______ SEV Transaction response time
__ DISPATCH _ TIME___ AVE Dispatch time
__ CPU_____ _ TIME___ AVE CPU time
__ CPU_____ _ TIME___ SEV CPU time
__ SUSPEND_ _ TIME___ AVE Suspend time
__ SUSPEND_ _ TIME___ MAX Suspend time
__ DISPWAIT _ TIME___ AVE Redispatch wait time
__ FCWAIT__ _ TIME___ AVE File I/O wait time
__ FCAMCT__ _ _______ AVE File access-method requests
F1=Help F3=Exit F4=Prompt F5=Rfind F7=Backward F8=Forward
F10=Actions F11=Right F12=Cancel
File Edit Confirm Upgrade Profiling Options Help
------------------------------------------------------------------------------
EDIT SUMMARY Report Form - SAMPSUMM More: >
Command ===> ________________________________________________ Scroll ===> PAGE
Description . . . . Summary Report Form_____________
Title . . First half title__________________________________________________
Second half title_________________________________________________
Field - User Field -
/ Name + Sort Type Fn Length Dictionary Definition Offset Length
__ TRAN____ K A _______ ___ 8 TRAN DFHTASK C001 ___ ___
__ TASKCNT_ _ _______ ___ 8 TASKCNT CICSPA X902 ___ ___
__ ALERT___ _ _______ SEV 8 ALERT CICSPA A915 ___ ___
__ RESPONSE _ _______ AVE 8 RESP CICSPA D901 ___ ___
__ RESPONSE _ _______ MAX 8 RESP CICSPA D901 ___ ___
__ RESPONSE _ _______ SEV 8 RESP CICSPA D901 ___ ___
__ DISPATCH _ TIME___ AVE 8 USRDISPT DFHTASK S007 ___ ___
__ CPU_____ _ TIME___ AVE 8 USRCPUT DFHTASK S008 ___ ___
__ CPU_____ _ TIME___ SEV 8 USRCPUT DFHTASK S008 ___ ___
__ SUSPEND_ _ TIME___ AVE 8 SUSPTIME DFHTASK S014 ___ ___
__ SUSPEND_ _ TIME___ MAX 8 SUSPTIME DFHTASK S014 ___ ___
__ DISPWAIT _ TIME___ AVE 8 DISPWTT DFHTASK S102 ___ ___
__ FCWAIT__ _ TIME___ AVE 8 FCIOWTT DFHFILE S063 ___ ___
__ FCAMCT__ _ _______ AVE 8 FCAMCT DFHFILE A070 ___ ___
F1=Help F3=Exit F4=Prompt F5=Rfind F7=Backward F8=Forward
F10=Actions F11=Right F12=Cancel
File Edit Confirm Upgrade Profiling Options Help
------------------------------------------------------------------------------
EDIT SUMMARY Report Form - SAMPSUMM More: >
Command ===> ________________________________________________ Scroll ===> PAGE
Description . . . . Summary Report Form_____________ Version (VRM): 680
Selection Criteria:
_ Performance Page width . . 132_
Field Sort --------- Range -------------
/ Name + K O Type Fn From To Report
__ TRAN____ K A _______ ___ ___________ _________ _______
__ TASKCNT_ _ _______ ___ ___________ _________ _______
__ ALERT___ _ _______ SEV ___________ _________ _______
__ RESPONSE _ _______ AVE ___________ _________ _______
__ RESPONSE _ _______ MAX ___________ _________ _______
__ RESPONSE _ _______ SEV ___________ _________ _______
__ DISPATCH _ TIME___ AVE ___________ _________ _______
__ CPU_____ _ TIME___ AVE ___________ _________ _______
__ CPU_____ _ TIME___ SEV ___________ _________ _______
__ SUSPEND_ _ TIME___ AVE ___________ _________ _______
__ SUSPEND_ _ TIME___ MAX ___________ _________ _______
__ DISPWAIT _ TIME___ AVE ___________ _________ _______
__ FCWAIT__ _ TIME___ AVE ___________ _________ _______
__ FCAMCT__ _ _______ AVE ___________ _________ _______
F1=Help F3=Exit F4=Prompt F5=Rfind F7=Backward F8=Forward
F10=Actions F11=Right F12=Cancel
File Edit Confirm Upgrade Profiling Options Help
------------------------------------------------------------------------------
EDIT SUMMARY Report Form - SAMPSUMM More: >
Command ===> ________________________________________________ Scroll ===> PAGE
Description . . . . Summary Report Form_____________ Version (VRM): 680
Selection Criteria:
_ Performance Page width . . 132_
Field Sort ---- Alert ----
/ Name + K O Type Fn Severity Report
__ TRAN____ K A _______ ___ ________ _______
__ TASKCNT_ _ _______ ___ ________ _______
__ ALERT___ _ _______ SEV WARNING_ PERCENT
__ RESPONSE _ _______ AVE ________ _______
__ RESPONSE _ _______ MAX ________ _______
__ RESPONSE _ _______ SEV CRITICAL COUNT__
__ DISPATCH _ TIME___ AVE ________ _______
__ CPU_____ _ TIME___ AVE ________ _______
__ CPU_____ _ TIME___ SEV WARNING_ COUNT__
__ SUSPEND_ _ TIME___ AVE ________ _______
__ SUSPEND_ _ TIME___ MAX ________ _______
__ DISPWAIT _ TIME___ AVE ________ _______
__ FCWAIT__ _ TIME___ AVE ________ _______
__ FCAMCT__ _ _______ AVE ________ _______
F1=Help F3=Exit F4=Prompt F5=Rfind F7=Backward F8=Forward
F10=Actions F11=Right F12=Cancel
When a report specifies a Report Form and both have Selection Criteria specified, records must match both criteria to be included in the report.
When you increase the page width, you can include more fields in the report. Move EOR down the list or move fields above EOR to include the fields of interest. CICS PA automatically adjusts the EOR marker when the fields overflow the page width.
When you view the report output (using SDSF), scroll right to see the additional fields. Note that when you print the report, data that exceeds the maximum printer page width is truncated.
If the report uses a Report Form, and a title is specified on both, the title on the report takes precedence.
This option generates the TITLE1('left-half') and TITLE2('right-half') operands.
The title is ignored for extracts.
Before entering an Application Group name, enter APG in the Type column. Otherwise, the panel attempts to interpret the Application Group name as a CMF data field.
EOR is managed by CICS PA. It signals the end of the report line. The fields listed above EOR fit on the report line and are included in the report in the same order as they appear in the list. Those below EOR will not be reported and are ignored.
CICS PA automatically sets EOR when the Report Form is created and resets it if necessary when the Form is changed to ensure that the maximum page width of 132 is not exceeded. In positioning EOR, CICS PA allows for one blank separator between each field.
To produce a report line shorter than 132, either move EOR towards the top of the Form, delete unwanted fields, or move them below EOR.
EOX signals the end of the extract record. There are no restrictions on record length so EOX can be positioned anywhere in the list. EOX is initially positioned just below EOR. Fields above EOX are included in the extract, those below EOX are ignored. If EOX is not specified, EOR is used.
Sort fields identify the grouping required for summarization, and can be START and STOP time, or any character field, including character user fields.
A Sort Order of * (asterisk) identifies a candidate sort field, and is ignored for reporting purposes.
To activate a candidate sort field, move it to the top of the Form and set Sort Sequence to A or D.
Key fields above EOR must appear first in the list of fields. The only fields that can appear ahead of a key field are TASKCNT or TASKTCNT. Key fields below EOR are ignored. Up to 8 key fields can be specified, and at least one must be specified. The order of the key fields in the list defines the sort and summarization precedence, with the first key field being the major sort field.
If you create a Report Form that consists entirely of key fields, with or without the special fields TASKCNT or TASKTCNT, then reports or extracts that you create using this Report Form will contain additional default fields. To suppress these default fields, specify at least one other field that is not a key field: for example, the numeric field RESPONSE. For more information, see Customizing or suppressing default fields.
or
You must also specify the parameters for this function: the alert severity level CRITICAL, WARNING, or INFO, and whether to report COUNT or PERCENT. Press the Right (F11) key until the Alert columns scroll into view:
──── Alert ─────
Severity Report
________ _______
You can only enter values in the Alert columns if you have entered the SEV function in the Fn column.
Specifying the SEV function with Alert Severity and Report parameters generates the fieldname(SEV(CRITICAL|WARNING|INFO,COUNT|PERCENT)) operand.
Note: The SEV function is only supported by the Performance Summary report and extract. If a Summary Form containing SEV fields is used in any other report, such as Profiling, the SEV function is ignored and the Field will adopt its default function.
To specify the parameters for this function, press the Right (F11) key until the Range columns scroll into view:
─────────── Range ───────────
From To Report
___________ ________ _______
You can only enter values in the Range columns if you have entered the RNG function in the Fn column.
Specifying the RNG function with a Report value of COUNT (the default value) generates the RNGCOUNT() operand; a Report value of PERCENT generates the RNGPERCENT() operand.
> >= < <=
followed immediately by the limit value (for example, >1.0). Leave the To column blank.
lower limit <= field value < upper limit
For time fields, values with a decimal point (such as 1.0) are interpreted as seconds; integers (such as 1000) are interpreted as milliseconds.
CICS PA JCL generation translates these values to FIELDS(CHARACTER(SUBSTR(offset,length),...
File Edit Confirm Upgrade Profiling Options Help
------------------------------------------------------------------------------
EDIT SUMMARY Report Form - SUMMUFLD
Command ===> ________________________________________________ Scroll ===> PAGE
Description . . . . Summary Report Form_____________ Version (VRM): 680
Selection Criteria:
_ Performance Page width . . 132_
Field
/ Name + Sort Type Fn Description
__ WBTOTAL_ _ _______ AVE Web Total requests
__ CLOCK1__ _ TIME___ AVE User field: CMF ID=USERNM1 S001
. . .
__ FIELD1__ K * _______ ___ User field: CMF ID=USERNM2 C001
********************************* End of list *********************************
File Edit Confirm Upgrade Profiling Options Help
------------------------------------------------------------------------------
EDIT SUMMARY Report Form - SUMMUFLD
Command ===> ________________________________________________ Scroll ===> PAGE
Description . . . . Summary Report Form_____________
Title . . First half title__________________________________________________
Second half title_________________________________________________
Field - User Field -
/ Name + Sort Type Fn Length Dictionary Definition Offset Length
__ WBTOTAL_ _ _______ AVE 8 WBTOTWCT DFHWEBB A235 ___ ___
__ CLOCK1__ _ TIME___ AVE 8 CLOCK1 USERNM1 S001 ___ ___
. . .
__ FIELD1__ K * _______ ___ 12 FIELD1 USERNM2 C001 1__ 8__
********************************* End of list *********************************
Line Actions: For the list of valid line actions for the SUMMARY Report Form panel, see LIST Report Form.
Primary Commands: The following primary command is available only on the SUMMARY Report Form panel:
Also available from Profiling in the action bar.
For a list of other valid primary commands for the SUMMARY Report Form panel, see page LIST Report Form.