Sample Report Forms

A set of sample report forms is provided with CICS PA (see Table 1). They demonstrate how CICS PA reports can be tailored to reflect the many ways you use and configure your CICS® systems. The CICS PA reports and extracts produced using these sample report forms will provide a detailed picture of the many aspects affecting CICS system performance.

Start of changeTo add the samples to your report forms data set, select Samples > Populate Report Forms data set with sample forms in the action bar of the Report Forms panel. The Sample Form Search panel is displayed.End of change

Start of change
   File  Options  Help 
 ------------------------------------------------------------------------------
                               Sample Form Search 
 Command ===>                                                                  

 Specify searching criteria then press Enter.

 Search String:
                                                                   
                                                                   

 Performance:
     List                              
     List Extended                     
     Summary                           

 Categories:
     Transaction Overview                   CPU Usage and Analysis
     Transaction Tracking                   Platforms, Applications and Policy
     Channels and Containers Usage          Transaction Communications Activity
     Transaction Storage Usage              Transaction Data Access
     Top Lists and Distributions            Web and Web Services
     Transaction Resource Usage             Java
     Miscellaneous                      
End of change

Start of changeThe Sample Form Search panel provides an easy way for you to quickly reduce the list of samples so you can find the ones you want. To reduce the list of samples, specify some search criteria and press Enter. If you press Enter without specifying any search criteria, the full list of samples is displayed. The following search criteria fields are available for this panel:End of change

Start of change
Search String
A sequence of consecutive characters to search for. The search matches the sample report forms that contain the search string in any of the fields of the sample report form, except for its selection criteria. That is, the searchable fields include: Description, Title, Field Name, Field Type, Function, Length, Dictionary Definition, and Field Description. For example, if you search for AB, the search returns all samples that contain the word ABEND in any of those fields.
Performance
Select any of the performance options to limit the search to that type of performance sample forms only.
Categories
Each sample report form is classified into one or more categories to provide another way of finding samples. For example, you can use the category search to find the sample forms that relate to CPU usage and analysis. To search all categories, leave all the line action fields empty. To search specific categories, enter line action S against those categories.
End of change
After you press Enter, the Sample Report Forms pop-up window lists the sample report forms that match the search criteria.
Figure 1. Select Sample Report Forms
       View                                                                   
    ------------------------------------------------------------------------- 
                             Sample Report Forms          Row 1 to 12 of 36  
    Command ===>                                         Scroll ===> PAGE    
                                                                             
    Select one or more Sample Report Forms then press EXIT.                  
                                                                             
       Name      Type     Description                       Saved            
       BADTSAWT  LISTX    Top 20 Worst Auxiliary TS Waits                    
       BADTSRQ   LISTX    Top 20 Worst Tsqueue Requests                      
       BADTSRQ5  LISTX    Top 20 Worst Tsqueue Reqsts (V5)                   
       BADTSSWT  LISTX    Top 20 Worst Shared TS Waits                       
       CPU4LEXT  LIST     CPU Analysis and Extract (V4)     Yes              
       CPU5LEXT  LIST     CPU Analysis and Extract (V5)                      
       EXPLORE4  SUMMARY  Explorer CSV for CICS TS V4                        
       EXPLORE5  SUMMARY  Explorer CSV for CICS TS V5                        
       MPSHRSTG  SUMMARY  Platform - Shared Stg Summary                      
       MPTSRQ    SUMMARY  Platform - TS Request Summary                      

You can add the sample report forms to your report forms data set. Start of changeIf a form with the same name as a sample report form already exists in your report forms data set, Yes is displayed in the Saved column for the sample and CICS PA prevents you from adding the sample to your report forms data set.End of change

Start of changeTo hide the forms that already exist in your report forms data set, choose View > Exclude selected forms. Those forms are removed from the Sample Report Forms pop-up window. To show them again, choose View > Include selected forms.End of change