The Performance Summary report can be tailored by specifying which fields and Application Groups are reported, the order in which they appear in the report, and the statistical functions used to summarize the data. This is done with the FIELDS operand followed by the field names, and for numeric fields, the function(s), and ordering sequence.
Up to 8 sort key fields can be specified, and at least one must be specified. The order of the key fields in the list defines the sort precedence, with the first key field being the major sort field. For each key field, the report can be ordered in ascending (ASCEND) or descending (DESCEND) sequence. The default is ascending. Sort key fields identify the grouping required for summarization, and can be any time stamp field, such as START and STOP time, any Application Group, or any character field, including character user fields.
The sort key fields must be specified first in the list ahead of the numeric fields. The only fields that can appear ahead of a key field are TASKCNT or TASKTCNT.
In addition to the sort key fields, one numeric field can be selected as ascending or descending to activate Alternate Sequencing. This will change the order of report lines from sort key to numeric field sequence. For example, specify RESPONSE(DESCEND) to see the transactions with the highest response time at the top of the report. Note that grouping by sort key remains unaffected by alternate sequencing.
CICSPA SUMMARY(
FIELDS(application-group-name(APG,ASCEND|DESCEND),...)
CICSPA SUMMARY(
FIELDS(field1,field2,...))
CICSPA SUMMARY(
FIELDS(field1(AVE|DEV|MAX|MIN|TOT|SEV|nn
|RNGCOUNT(range)|RNGPERCENT(range)
|SEV(CRITICAL|WARNING|INFO,COUNT|PERCENT)),
ASCEND|DESCEND,K|M|KB|MB,...),...))
CICSPA SUMMARY(
FIELDS(field1(TIME|COUNT(AVE|DEV|MAX|MIN|TOT|SEV|nn
|RNGCOUNT(range)|RNGPERCENT(range)
|SEV(CRITICAL|WARNING|INFO,COUNT|PERCENT)),
ASCEND|DESCEND,...),...)))
CICSPA SUMMARY(
FIELDS(CHARACTER(OWNER(owner)[,SUBSTR(offset,length)]),...))
CICSPA SUMMARY(
FIELDS(COUNT|CLOCKTIME|CLOCKCOUNT(
OWNER(owner),NUMBER(nnn),AVE|DEV|MAX|MIN|TOT|nn,
ASCEND|DESCEND),...))
If character type fields are specified in the FIELDS list, they must be specified first (except for TASKCNT or TASKTCNT which can be ahead or amongst them).
All numeric fields (except TASKCNT and TASKTCNT) are summarized using any number of the following statistical functions:
The range can be one of:
For example, RNGCOUNT(0.1-0.2)
To fall within the range, a field value must be greater than or equal to the lower limit, and less than the upper limit:
lower limit <= field value < upper limit
That is, one of the following comparison operators followed by a value:
= > >= < <=
For example, RNGPERCENT(<50)
For time fields, values with a decimal place (such as 1.0) are interpreted as seconds; integers (such as 1000) are interpreted as milliseconds.
You cannot use RNGCOUNT or RNGPERCENT to report from an HDB.
Here are some example uses of RNGCOUNT and RNGPERCENT:
For performance alert reporting, specify SEV(CRITICAL|WARNING|INFO,COUNT|PERCENT).
Optionally, count values can be converted for reporting by specifying one of the following:
If the FIELDS operand is omitted, the default is:
CICSPA SUMMARY(
FIELDS(TRAN(ASCEND), Transaction ID
TASKCNT, Number of CMF Records
RESPONSE(AVE,MAX), Avg/Max Response Time
DISPATCH, Avg Dispatch Time
CPU, Avg CPU Time
SUSPEND(AVE,MAX), Avg/Max Suspend Time
DISPWAIT, Avg Dispatch Wait Time
FCWAIT, Avg File Control I/O Wait Time
FCAMCT, Avg FC Access Method Calls
IRWAIT, Avg Inter-Region I/O Wait Time
SC24UHWM, Avg User Storage HWM below 16MB
SC31UHWM)) Avg User Storage HWM above 16MB