Defining Statistics Alerts

Statistics Alert reports highlight non-compliant activity triggered by specified threshold values of CICS® Statistics fields. The threshold values are called Alerts.

To define Statistics Alerts, do the following:
  1. Select option 8 Resource Definitions from the CICS PA Primary Option Menu.
  2. On the Resource Definitions Menu, specify the name of a VSAM KSDS repository to store the Alert definition. For now, use a personal data set, but for production use, you are more likely to use a shared repository.
  3. Then select option 5 Statistics Alerts and press Enter.

    If the repository data set does not exist, you will be prompted to create it.

  4. A list of Statistics Alert Definitions is displayed. Initially, the list is empty. Enter the NEW command to create a new definition.
  5. Follow the prompts to specify a name and select Initialize with sample scenarios.
  6. From the list of sample definitions, select CTSKEY.
  7. The Alert Definition edit panel is displayed. To Start of changebecome familiarEnd of change with specifying Alert conditions, use the context-sensitive help. Tab to fields of interest and press Help (F1).
      File  Edit  Lists  Options  Help                                        
     —————————————————————————————————————————————————————————————————————————————  
                   EDIT Statistics Alert Definition - GSGALERT Row 1 of 87 More: >
    Command ===> _______________________________________________ Scroll ===> PAGE 
                                                                                  
    Description  . . . Key System Alerts___________________                       
                                                                                  
    Specify the Conditions for this Alert Definition.                             
                                                                                  
    _ Alert     Transaction dumpcode taken________________________                
      Formula   TDRTTKN_____________________________________________________      
                ____________________________________________________________ +    
      Critical  >5___________   Warning  >0___________   Info  _____________      
      _ Res     ____________________________________________  List  ________ +    
      _ APPLID  ________                                                          
    ----------------------------------------------------------------------------- 
    _ Alert     Transaction dumpcode requested____________________                
      Formula   TRANS_DUMP_TAKEN____________________________________________      
                ____________________________________________________________ +    
      Critical  >25__________   Warning  >0___________   Info  _____________      
      _ Res     ____________________________________________  List  ________ +    
      _ APPLID  ________                                                          
    ----------------------------------------------------------------------------- 
    _ Alert     System dumpcode taken_____________________________                
      Formula   SDRSTKN_____________________________________________________      
                ____________________________________________________________ +    
      Critical  >1___________   Warning  >0___________   Info  _____________      
      _ Res     ____________________________________________  List  ________ +    
      _ APPLID  ________                                                          
    ----------------------------------------------------------------------------- 
    _ Alert     System dumps requested____________________________                
      Formula   SYS_DUMPS_TAKEN_____________________________________________      
                ____________________________________________________________ +    
      Critical  >5___________   Warning  >0___________   Info  _____________      
      _ Res     ____________________________________________  List  ________ +    
      _ APPLID  ________                                                          
    ----------------------------------------------------------------------------- 
  8. Scroll right (F11) to see the compressed view.
      File  Edit  Lists  Options  Help                                        
     —————————————————————————————————————————————————————————————————————————————  
                   EDIT Statistics Alert Definition - GSGALERT Row 1 of 87 More: >
    Command ===> _______________________________________________ Scroll ===> PAGE 
                                                                                  
    Description  . . . Key System Alerts___________________                       
                                                                                  
    Select a Condition to show its details.              
                                                         
      Alert                                              
    _ Transaction dumpcode taken                         
    _ Transaction dumps requested                        
    _ System dumpcode taken                              
    _ System dumps requested                             
    _ Maximum tasks reached                              
    _ Peak tasks (% of maximum tasks)                    
    _ Maximum active transactions in class reached       
    _ Storage violations for transaction ID              
    _ Peak transactions in tran. class (% of limit)      
    _ Storage: short-on-storage times in DSA             
    _ Cushion releases in DSA                            
    _ Storage: times no storage in DSA                   
    _ Storage: times suspended for storage               
    _ Storage violations                                 
    _ Storage: above the bar cushion releases  
    Start of change_ Storage: Number of IARV64 FROMGUARD FailuresEnd of change          
    _ Transient data: NOSPACE on DFHINTRA                
    _ DFHINTRA in use (% of CIs)                         
    _ String waits on DFHINTRA                           
    _ Formatting writes on DFHINTRA                      
    _ Buffer waits on DFHINTRA                           
    _ I/O errors on DFHINTRA                             
    _ Temporary storage: times hit NOSPACE on DFHTEMP    
    _ Formatting writes on DFHTEMP                       
    _ Temporary storage: string waits on DFHTEMP         
    _ Writes greater than DFHTEMP CI size                
    _ Temporary storage: buffer waits on DFHTEMP         
    _ DFHTEMP in use (peak % CIs used of CIs in TS ds)   
    _ Temporary storage: I/O errors on DFHTEMP           
    _ Peak DFHTEMP strings in use                        
  9. Exit to save the definition.

With the Statistics Alert Definition specified, you can now use it to format your report.