Exception analysis summary commands

You can display exception analysis summary information by using the XSUM or XTRP commands or by using the History of All Tripped Exceptions panel.

You can use this information to help you set appropriate threshold values. For example, if an exception frequently trips, the threshold value might be set too low. After you fine-tune the threshold value for each exception, you can use this information to accurately monitor your IMS system for performance problem areas.

The summary display shows whether the exceptions are on or off, the threshold settings, the Automatic Screen Facility (ASF) parameters, and trip times and values. To display the History of All Tripped Exceptions panel, type E.D on the INFO-line of any panel and press Enter. The following figure shows a partial display of the History of All Tripped Exceptions panel.
Figure 1. History of All Tripped Exceptions
 ________________ KOIHIST  VTM     OI-II    V530./C I91C 03/25/15  9:38:21    B 
> Help PF1       Back PF3        Up PF7        Down PF8        Zoom PF11        
>                                                                               
> To have the Exception History update, remove the > preceding the XIMS         
> command.  The XIMS command must be executed to drive exception analysis.      
> Exception analysis must be performed to create a history of tripped           
> exceptions.  For an explanation of an exception, place the cursor on the      
> exception name and press PF11.                                                
>                                                                               
================================================================================
>                      History of All Tripped Exceptions                        
                                                                                
>XIMS                                                                           
 XTRP                      LIST=A                                               
+----------+----------+-----------+--------------+-----------+----------------+ 
+ DISP      Threshold  Trip Value  Time Occurred  Total Trips Trips Since Reset 
+ State=On                                                                      
+ Last                            03/25   08:40:11          5                 5 
+ Worst                           03/25   08:40:11                              
+ Group=ST  Limit=0  Persist=0  Auto=Off Log=Off                                
+----------+----------+-----------+--------------+-----------+----------------+ 
+ DLTR      Threshold  Trip Value  Time Occurred  Total Trips Trips Since Reset 
+ State=On                                                                      
+ Last                            03/25   08:40:11          5                 5 
+ Worst                           03/25   08:40:11                              
+ Group=ST  Limit=0  Persist=0  Auto=Off Log=Off                                
+----------+----------+-----------+--------------+-----------+----------------+

The Total Trips column shows the number of times that the exception tripped since the OMEGAMON® for IMS session started. The exceptions are displayed in alphabetical order.

The displays for the XTRP and XSUM commands are similar; however, XSUM displays information for all exceptions, whereas XTRP displays information only for tripped exceptions. If you use the XSUM or XTRP commands to display the summary information, the following keywords are available:
GROUP=cc
You can limit the exceptions that are displayed to a specified exception group. Enter any two-character code for an IBM®-supplied exception group or a user-defined group.
LIST=I
List exceptions in order of invocation. If you omit the LIST keyword, or specify LIST=A, the exceptions are listed in alphabetical order.
RESET
Enter RESET to reset the last and worst trip values to 0. By resetting these values, you can change the default thresholds to ones that meet your installation performance standards. Resetting the values can also be helpful when you want statistics on a specific job, or if you want to track exception activity in addition to cumulative activity.
Note: The XTRP command generates the summary display. The XSUM command displays all exceptions that are set, whether they trigger or not. You can include the XSUM RESET or XTRP RESET command in a Timed Screen Facility (TSF) screen space for automatic resetting at periodic intervals. Resetting either XSUM or XTRP resets the counters for both commands.

For more information about XSUM, XTRP, and the TSF, see the IBM OMEGAMON for IMS on z/OS®: Realtime Commands Reference.