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): 680
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
__ APPLPROG A Application naming Program
__ STOP____ A Task stop time
F1=Help F3=Exit F4=Prompt F5=Rfind F7=Backward F8=Forward
F10=Actions F11=Right F12=Cancel
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:
- Loading. Shorter recording intervals write more records,
increasing the size of your HDB data sets.
- 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:
- Key fields must be together at the top of the Template.
- 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.
- 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:
- Do not change the key fields of a Summary Template.
- 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.