Performance Summary report

The command to produce the default report is:
CICSPA SUMMARY
To tailor the report, you can specify report options as follows:
CICSPA SUMMARY(
          [OUTPUT(ddname),]
          [EXTERNAL(ddname),]
          [NOTOTALS|TOTALS(n),]
          [INTERVAL(hh:mm:ss),]
          [ALERTDEF(defname),]
          [SEVERITY(ELIGIBLE|ALL),]
          [FIELDS(fld1[(options[,SEV(CRITICAL|WARNING|INFO,COUNT|PERCENT)])],...),]
          [LINECount(nnn),]
          [TITLE1('...sub-heading left...'),]
          [TITLE2('...sub-heading right...'),]
          [SELECT(PERFORMANCE(INCLUDE|EXCLUDE(field1(values1),...),...)),]
          [SELECT2(PERFORMANCE(INCLUDE|EXCLUDE(field1(values1),...),...))])

The FIELDS operand controls the format of the report by specifying the required fields, their format, the order of the columns, and, for numeric fields, the statistical functions (AVE|DEV|MIN|MAX|TOT|nn|RNGCOUNT(range)|RNGPERCENT(range)) used to summarize the data. nn% represents a peak percentile, such as 95%. A range can be specified as a lower limit and an upper limit separated by a hyphen (for example, 0.1-0.2), or as a comparison operator (one of: = > >= < <=) followed by a value (for example, >0). If the function is omitted, AVE is the default.

For Performance Alert reporting, SEV indicates a performance alert field. ALERTDEF specifies the Performance Alert Definition. SEVERITY specifies whether to report all transactions or only those that match the resource criteria in the Performance Alert Definition. ALERT is the field name used to provide count or percentage totals of transactions for an alert severity level (CRITICAL, WARNING, or INFO) for the summary key.

You can specify up to 8 Sort Key fields to order in ascending or descending sequence. The default is TRAN(ASCEND). The BY operand is optional. If the FIELDS operand is specified with key fields, the BY operand is ignored.

Sort fields identify the grouping required for summarization, and can be START and STOP time, or any character field, including character user fields.

Key fields must be the first fields specified in the Form and must be contiguous. However, TASKCNT and TASKTCNT can be specified anywhere in the list of fields, including amongst the key fields.

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 Alternate Sequencing of D for RESPONSE time to see the transactions with the highest response time at the top of the report. Note that grouping by Sort Key remains unaffected.

If BY and FIELDS are omitted, the default is:
CICSPA SUMMARY(
           FIELDS(TRAN,                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

If you specify a FIELDS operand that contains only sort key fields with or without the special TASKCNT or TASKTCNT fields, then the report contains those explicitly specified fields instead of the default sort key field TRAN, followed by the remaining default fields. This enables you to customize the sort order of the default report without explicitly specifying all of the fields in the report. To suppress the default fields, so that the report contains only the fields explicitly specified by the FIELDS operand, you must specify at least one field that is not a sort key, and that is not TASKCNT or TASKTCNT: for example, the numeric field RESPONSE.

The CICS PA dialog uses the SUMMARY Report Form to generate the FIELDS operand.

If the report becomes too large . . .
The Performance Summary report sorts the input records before reporting. When the EXTERNAL operand is not specified, CICS PA performs an internal sort using virtual storage. The amount of virtual storage required depends on the number of key fields and the resulting combinations. If the report becomes too large for virtual storage, you can use an External Work Data Set to store the records before they are sorted. Use EXTERNAL(ddname) to specify the External Work Data Set and invoke the external SORT facility.

Information Information

Feedback


Timestamp icon Last updated: Friday, 8 February 2013


http://pic.dhe.ibm.com/infocenter/cicsts/v5r1/topic//cparr63.htm