The SUMMARY Report Form defines the format and content of the Performance Summary Report and Extract, and also helps define the format and content of the Transaction Profiling report.
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.