Example: Performance Alerts Summary

This is an example of performance alert reporting, useful for monitoring compliance to Service Level Agreements and CICS® transaction performance standards.

The commands to request this report are like the following:
CICSPA IN(SMFIN001),                            
       APPLID(*),                               
       PRECISION(4),                            
   SUMMARY(OUTPUT(SUMM0002),                    
       TOTALS(8),                               
       INTERVAL(00:01:00),                      
       ALERTDEF(ALERT08),                       
       SEVERITY(ELIGIBLE),                      
       FIELDS(TRAN(ASCEND),                     
              TASKCNT,                          
              ALERT(SEV(CRITICAL,PERCENT)),     
              ALERT(SEV(WARNING,PERCENT)),      
              ALERT(SEV(INFO,PERCENT)),         
              RESPONSE(AVE),                    
              RESPONSE(SEV(CRITICAL,PERCENT)),  
              RESPONSE(SEV(WARNING,PERCENT)),   
              RESPONSE(SEV(INFO,PERCENT)),      
              DISPATCH(TIME(AVE)),              
              CPU(TIME(AVE)),                   
              CPU(TIME(SEV(CRITICAL,COUNT))),   
              CPU(TIME(SEV(WARNING,COUNT))),    
              CPU(TIME(SEV(INFO,COUNT))))       

This example shows the use of the ALERT field. It shows the percentage of transactions for each severity level for the summary key. It also shows Response Time alerts as percentages (with two decimal places), while User CPU Time alerts are shown as counts (whole numbers with no decimal places).

Figure 1. Performance Summary report: Performance alerts
 V3R2M0                                                 CICS Performance Analyzer
                                                          Performance Summary
 
SUMM0002 Printed at 17:31:29  4/21/2010     Data from 07:50:50  3/26/2009 to 07:54:23  3/26/2009                              
                                                                                                                              
                  Critical  Warning     Info      Avg Critical  Warning     Info      Avg      Avg Critical  Warning     Info 
Tran       #Tasks    ALERT    ALERT    ALERT Response Response Response Response Dispatch User CPU User CPU User CPU User CPU 
                                                 Time     Time     Time     Time     Time     Time     Time     Time     Time 
CATA            1      .00      .00   100.00    .0097      .00      .00      .00    .0074    .0028        0        0        1 
CFQR            1   100.00      .00      .00 212.5694   100.00      .00      .00    .0001    .0001        0        0        0 
CFQS            1   100.00      .00   100.00 212.5693   100.00      .00      .00    .0149    .0011        0        0        1 
CFTL            1      .00      .00   100.00    .0810      .00      .00   100.00    .0170    .0041        0        0        1 
CGRP            1      .00   100.00   100.00    .1452      .00   100.00      .00    .0274    .0015        0        0        1 
CISC            2      .00      .00   100.00    .0699      .00      .00   100.00    .0096    .0008        0        0        1 
CISD            1      .00      .00      .00    .0006      .00      .00      .00    .0001    .0001        0        0        0 
CISE            1   100.00      .00   100.00 207.0152   100.00      .00      .00    .0102    .0011        0        0        1 
CISR            1   100.00      .00   100.00 207.0153   100.00      .00      .00    .0122    .0011        0        0        1 
CJSR            1      .00      .00   100.00    .0360      .00      .00   100.00    .0150    .0011        0        0        1 
CKAM            1   100.00      .00   100.00 197.1525   100.00      .00      .00    .0187    .0035        0        0        1 
CQRY            1      .00      .00   100.00    .0112      .00      .00   100.00    .0048    .0014        0        0        1 
CRLR            1      .00      .00   100.00    .0485      .00      .00   100.00    .0126    .0010        0        0        0 
CRSQ            1      .00      .00   100.00    .0351      .00      .00   100.00    .0155    .0010        0        0        1 
CRTP            1      .00      .00   100.00    .0080      .00      .00      .00    .0056    .0016        0        0        1 
CSAC            1      .00   100.00      .00    .5235      .00   100.00      .00    .0003    .0003        0        0        0 
CSFU            1      .00   100.00      .00    .8119      .00   100.00      .00    .7219    .0415        0        1        0 
CSHQ            1   100.00      .00   100.00 192.6462   100.00      .00      .00    .0922    .0091        0        0        1 
CSKL            1   100.00   100.00      .00 191.6213   100.00      .00      .00 190.8965    .0134        0        1        0 
CSNC            1   100.00      .00   100.00 205.4532   100.00      .00      .00    .0737    .0022        0        0        1 
CSNE            2    50.00      .00    50.00  99.8076    50.00      .00      .00    .0189    .0020        0        0        1 
CSSY           13    15.38    46.15    69.23   1.3247    15.38    46.15    23.08    .2042    .0457        1        0        8 
CSTE            1      .00      .00   100.00    .0490      .00      .00   100.00    .0371    .0032        0        0        1 
CSZI            1   100.00      .00   100.00 209.1438   100.00      .00      .00    .0682    .0077        0        0        1 
CWBG            1      .00      .00   100.00    .0086      .00      .00      .00    .0084    .0016        0        0        1 
CXRE            1      .00      .00   100.00    .0672      .00      .00   100.00    .0121    .0010        0        0        1 
Total          40    30.00    25.00    75.00  51.3500    30.00    22.50    30.00   4.8696    .0175        1        2       27 
In this example, transaction code (Tran) is the summary key. For transaction code CSSY, there are 13 transactions, and we observe:

To create an extract file, add the DD statement for the extract data set to the JCL and add the corresponding DDNAME operand to the SUMMARY command.

Figure 2. Performance Summary extract: Performance alerts
Tran;#Tasks;ALERT Critical;ALERT Warning;ALERT Info;Response Time Avg;Response Time Critical;Response Time Warning;Response Time Info...
CATA    ;       1;     .00;     .00;  100.00;   .0097;     .00;     .00;     .00;   .0074;   .0028;       0;       0;       1;  
CFQR    ;       1;  100.00;     .00;     .00;212.5694;  100.00;     .00;     .00;   .0001;   .0001;       0;       0;       0;  
CFQS    ;       1;  100.00;     .00;  100.00;212.5693;  100.00;     .00;     .00;   .0149;   .0011;       0;       0;       1;  
CFTL    ;       1;     .00;     .00;  100.00;   .0810;     .00;     .00;  100.00;   .0170;   .0041;       0;       0;       1;  
CGRP    ;       1;     .00;  100.00;  100.00;   .1452;     .00;  100.00;     .00;   .0274;   .0015;       0;       0;       1;  
CISC    ;       2;     .00;     .00;  100.00;   .0699;     .00;     .00;  100.00;   .0096;   .0008;       0;       0;       1;  
CISD    ;       1;     .00;     .00;     .00;   .0006;     .00;     .00;     .00;   .0001;   .0001;       0;       0;       0;  
CISE    ;       1;  100.00;     .00;  100.00;207.0152;  100.00;     .00;     .00;   .0102;   .0011;       0;       0;       1;  
CISR    ;       1;  100.00;     .00;  100.00;207.0153;  100.00;     .00;     .00;   .0122;   .0011;       0;       0;       1;  
CJSR    ;       1;     .00;     .00;  100.00;   .0360;     .00;     .00;  100.00;   .0150;   .0011;       0;       0;       1;  
CKAM    ;       1;  100.00;     .00;  100.00;197.1525;  100.00;     .00;     .00;   .0187;   .0035;       0;       0;       1;  
CQRY    ;       1;     .00;     .00;  100.00;   .0112;     .00;     .00;  100.00;   .0048;   .0014;       0;       0;       1;  
...