Creating new Templates

The NEW command is used to define a new Template. New Templates are created by specifying their initial attributes and then tailoring the data fields using the Template editor.
Figure 1. New HDB Template
  File  Systems  Options  Help                             
--------------------------------------------------------------- 
                      New HDB Template                     
Command ===> __________________________________________________ 
                                                           
Specify the name of the new Template and its options.      
                                                           
Name . . . . . PRODSUM_                                    
                                                           
APPLID . . . . ________  +     Version (VRM) . . ____ +    
MVS Image  . . ________                                    
                               _  Field Categories         
Type 2  1. List                                            
        2. Summary                                         
                                                           
                                                           
 F1=Help  F3=Exit  F4=Prompt  F6=Resize  F10=Actions  F12=Cancel 

You need to specify the Template name and type. In this example, a Summary Template called PRODSUM is created. 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.

The options are:
Name
The name of the new Template. A 1-8 character name in ISPF member name format. The name must be unique within the HDB Register.
APPLID, MVS™ Image, Version (VRM)
Optionally specify the CICS® System (APPLID/Image) or CICS Version (VRM). This ensures that the Template is populated only with Performance Class fields that are applicable.
  • Specify CICS System (APPLID, or APPLID and MVS Image) to populate the Template with fields applicable to that CICS system. When available, CICS PA uses the CICS version and Dictionary record for that system to determine which fields to include in the Template. The CICS system must be defined in System Definitions. Press Prompt (F4) from APPLID to select one from a list (see Select a system (CICS APPLID)). To link directly to System Definitions, use Systems in the action bar.
  • Alternatively, specify VRM to populate the Template with fields for that CICS version only. Press Prompt (F4) to select from a list of supported versions (see Select a version (VRM)).
If a CICS System is specified and its VRM or Dictionary record is available, it overrides the VRM specification.

If you do not specify either a CICS System or a VRM, then CICS PA populates the Template with fields applicable to the latest supported release of CICS.

Field Categories
Enter line action S or / to select the field categories to use to initially populate your new Template. For example, you can initialize your Template with Task and Terminal Control fields by selecting DFHTASK and DFHTERM from the list. The default is all categories, except CROSSYS, DBCTL, and OMCICS. See Figure 1 for an example of the Field Categories selection list.

Within the selected categories, the fields added to your Template depend on the specified CICS APPLID or VRM. If APPLID is specified, CICS PA obtains the fields from the CMF Dictionary for that APPLID. Otherwise the VRM is used (the default is 670).

Type of Template
The type of HDB is determined by the type of Template:
  1. List

    A List HDB contains data records for individual transactions. Typically, List HDBs are used for the detailed analysis of recent transaction events and have a short life span (retention).

  2. Summary

    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.

When specification is complete, press Enter to proceed with defining the Template.