Summary template

A Summary Template defines the fields to be included in one or more Summary HDBs. A Summary HDB contains data records that summarize transaction activity over a specified time interval. Typically, Summary HDBs are used for long term trend analysis and capacity planning.

Edit the Template to meet your reporting requirements. In this example, FCAMCT is deleted and TSWAIT is inserted.
Figure 1. Edit Summary Template
  File  Edit  Confirm  Upgrade  Options  Help                                 
------------------------------------------------------------------------------
                     EDIT Summary Template - PRODSUM      Row 1 of 244 More: >
Command ===> ________________________________________________ Scroll ===> CSR_
                                                                              
Description  . . . Summary HDB Template____________  Version (VRM): 700       
                                                                              
Selection Criteria:                                                           
 _  Performance                    Time Interval  . . 00:15:00  (hh:mm:ss)    
                                                                              
     Field                                                                    
/    Name +    K  Description                                                 
__   START___  A  Task start time                                             
__   MVSID___  A  MVS SMF ID                                                  
__   APPLID__  A  CICS Generic APPLID                                         
__   TRAN____  A  Transaction identifier                                      
__   TASKCNT_     Total Task count                                            
__   RESPONSE     Transaction response time                                   
__   DISPATCH     Dispatch time                                               
__   CPU_____     CPU time                                                    
__   SUSPEND_     Suspend time                                                
__   DISPWAIT     Redispatch wait time                                        
__   FCWAIT__     File I/O wait time                                          
D_   FCAMCT__     File access-method requests                                 
__   IRWAIT__     MRO link wait time                                          
__   SC24UHWM     UDSA HWM below 16MB                                         
I_   SC31UHWM     EUDSA HWM above 16MB                                        
__   TSWAIT__     VSAM TS I/O wait time 
__   EOD_____     ---------------- End of HDB -----------------               
__   TERM____  A  Terminal ID 
__   APPLTRAN  A  Application naming Tran ID
 
A Summary Template operates in a similar manner to a List Template. Like the List Template (see List template), the following features apply to the Summary Template:
  • Scroll Right (F11) for more information.
  • Specify the following details. Where these differ with the List Template, the differences are noted.
    • Description. The default description is Summary HDB Template.
    • Version (VRM).
    • Selection Criteria. For example, the HDB only includes data for transactions that use File Control services (FCTOTAL>0).
    • Time Interval. Summary Templates specify a recording time interval in the range 00:00:01 (1 second) to 24:00:00 (24 hours). The default is 00:01:00 (1 minute) which indicates that summary data is accumulated and recorded in 1 minute intervals. Select the interval carefully because it will impact on HDB processing as follows:
      1. Loading. Shorter recording intervals write more records, increasing the size of your HDB data sets.
      2. Reporting. Longer recording intervals restrict reporting. For example, if you specify a recording interval of 1 hour then you can only report on 1 hour (or higher) intervals, and 15 minute interval reporting is not possible.
      Therefore selecting the correct interval is a balance between not loading too much data and not restricting reporting. Specify an interval that is both small enough so that data set size is kept to a minimum yet large enough to meet your reporting requirements. In Figure 1, the interval has been changed to 15 minutes.

      A time interval of less than one hour must fit evenly into the hour. CICS PA will round it down to the nearest interval that aligns to the hour. For example, 1.35 is reduced to 00:01:30 minutes which will produce 40 interval report lines for each hour of data.

      A time interval of more than one hour must fit evenly into the day. CICS PA will round it down to the nearest interval that aligns to the day. For example, 10.30.23 is reduced to 08:00:00 hours which will produce 3 interval report lines for each day of data.

      Minutes take precedence for an abbreviated entry. For example:
      1
      becomes 00:01:00
      1.1
      becomes 00:01:00 (rounded down from 00:01:01)
      1.1.1
      becomes 01:00:00 (rounded down from 01:01:01)

      This option generates the INTERVAL(hh:mm:ss) operand.

    • Field rows. A Summary Template has the following additional features:
      1. Key fields must be together at the top of the Template.
      2. The allowed key fields are: START, STOP, MVSID, APPLID, TRAN, TERM, APPLTRAN, APPLPROG, JOBNAME, PRCSTYPE, RPTCLASS, SRVCLASS, TCLASSNM, TCPSRVCE, USERID. Up to six key fields can be specified, but at least one must be specified. Either START or STOP must be specified as the first field at the top of the Template.
      3. TASKCNT is a required field immediately after the key fields.
  • Field selection
  • Select a performance field
  • Performance field help
  • Template upgrade

When editing is complete, press Exit (F3) to save your Template.

Attention: After a Template has been initially saved, you are permitted to edit the Template to change its field list. However if the Template is already being used to load data into a HDB, then changing the Template can potentially cause reporting problems in the future. CICS PA supports the alteration of Template fields, but a few simple rules will ensure that HDB processing is not compromised:
  1. Do not change the key fields of a Summary Template.
  2. Do not change the focus of a Template. For example, if the Template includes Temporary Storage fields only, do not delete those fields and insert File Control fields in their place. You should create another Template with a focus on File Control.