HDB Templates
Templates specify the performance information that is to be contained in an HDB. Templates are used by List and Summary HDBs. They are not required for Statistics HDBs which instead use a menu-selection facility.
Customize the Templates to specify the data that you want to be contained in the HDB. Templates are similar to Report Forms which are used to customize reports.
File Options Help
------------------------------------------------------------------------------
HDB Templates
Command ===> NEW_____________________________________________ Scroll ===> CSR_
Select to edit Template. Enter NEW command to define a new Template.
/ Name Type Description Changed ID
********************************* End of list *********************************
F1=Help F3=Exit F7=Backward F8=Forward F10=Actions F12=Cancel
File Systems Options Help
---------------------------------------------------------------
New HDB Template
Command ===> __________________________________________________
Specify new Template options.
Name . . . . . PRODSUM_ Version (VRM) . . . ____ +
System Selection: Field Categories:
APPLID . . . . ________ + _ Select to specify Field Categories
MVS Image . . ________
Template Type:
2 1. List
2. Summary
You need to specify the Template name and type. Other options affect which CMF Fields the Template will initially be defined with. They can be used to reduce the amount of fields contained in the Template.
File Edit Confirm Upgrade Options Help
------------------------------------------------------------------------------
EDIT Summary Template - PRODSUM 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
__ EOD_____ ---------------- End of HDB -----------------
__ TERM____ A Terminal ID
__ APPLTRAN A Application naming Tran ID
F1=Help F3=Exit F4=Prompt F5=Rfind F7=Backward F8=Forward
F10=Actions F11=Right F12=Cancel
Templates are similar to Report Forms. Where Report Forms define the fields to be included in a report or extract, Templates define the fields to be included in an HDB.
When you define a new Template, the default fields list is initially displayed. Edit the Template to include the required fields.
The EOD marker in the Template signifies the end of fields that is included in the HDB. Fields after the EOD marker will not be included in the HDB. You can move required fields above the EOD marker to include them in the HDB.
The example in Figure 3 displays the default Summary Template. Key fields are positioned at the top and the most common performance indicators like response, dispatch and suspend times are included.
Edit the Template to meet your reporting requirements. In the example above, FCAMCT is deleted and TSWAIT is inserted.
Specify Performance Selection Criteria and the Report Interval to control the data you want in your HDBs:
- Selection Criteria
- Templates have optional Selection Criteria that allows you to
filter the CMF performance class records used to build the HDB. For
example, the HDB only includes data for transactions that use File
Control services (FCTOTAL>0).
Select Performance to specify Selection Criteria.
- Report Interval
- Summary Templates specify a recording time interval. The default
is 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.
Exit (F3) to save the Template. You are now ready to define an HDB that uses this Template.
- 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.