CMRTTHR view

By default, the task kill exit is inactive. For information about activating and how to use the task kill exit, see 'Implementing the task kill function' in the MainView for CICS Customization Guide.

The task kill options and thresholds (warning and kill) are defined in a hierarchy of target groups, which can contain transaction groups. Transaction groups contain transaction IDs, overriding options and thresholds. The target group options and thresholds apply to all of the transactions that are running in the target CICS. The transaction group options and thresholds override the target group to provide more granular control of transactions.

By default, threshold checking is disabled for all transactions in the CICS region (all options are set to NO and all thresholds are set to 0). Any option or threshold that is not explicitly specified in the target group inherits the default value (NO or 0). Any option or threshold that is not explicitly specified in a transaction group inherits the value in the target group definition.

Use the CMRTTHR view and related views to administer target group definitions and transaction group definitions. The definitions are stored in the BBIPARM data set member CMRTTHnn for a BBI-SS PAS. (CMRTTH00 is the default member unless the BBCFG facility is used, as described in the MainView Common Customization Guide.)

If the task kill exit is enabled and the current CICS target name is not defined in CMRTTHnn (either explicitly or by wildcard), the current CICS target will use the options and thresholds in effect for the first (top most) target group defined in CMRTTHnn.

To display the CMRTTHR view, set the context to the BBI-SS PAS ssid and then issue the following command:

CMRTTHR

ddmmmyyyy  hh:mm:ss ------ MAINVIEW WINDOW INTERFACE (Vv.r.mm) ----------------
COMMAND  ===>                                                 SCROLL ===> CSR  
CURR WIN ===> 1        ALT WIN ===>                                            
>W1 =CMRTTHR===========BSPC=====*========(00 EDIT   MOD    )====MVCICS===D====7=
- Abend Codes CPU.... BBCP  File BBFC  Above BBSA  Total BBST  TDQ.. BBTD                                
              Elapsed BBEL  DB.. BBDB  Below BBSB  TSQ.. BBTS                                            
                                                                                                         
CMD   Name   CPU  Elps File Stg  Stg  Stg  DB   DB2  DBCT TSQ  TDQ  MQS  W W D N K X W Targets           
---          Time Time Cnt  Abov Bel  Tot  Cnt  Cnt  Cnt  Cnt  Cnt  Cnt  A O U C M D T ------------------
    TKILL1      5    0    0    0    0    0    0    0    0   10   10   10 N B N Y N N N BCV+S+3+,BC+++42* 
    TKILL2     90    0  100    0    0    0  200    0    0    0    0    0 Y B Y N N N N *                 
    TEST01      5    0    0    0    0    0    0    0    0    0    0    0 N B N Y N I N BCVDS+3+,BCVDS42* 
    TTEST1     10   40   20  800  400 1200   50   60   80  100  120  140 N B N N N A Y BCVDS69E          
    TKILL8     60    0    0    0    0    0    0    0    0    0    0    0 N B N N N C N BCVDS6*           
    TKILL9      0    0    0    0    0    0    0    0    0    0    0    0 N B N N N N N BCVDS64*          
    TTEST2      0    0    0    0    0    0    0    0    0    0    0    0 N N N N N N N BCVDSTST

The CMRTTHR view lists the task kill abend codes assigned to each threshold, the target groups, and the options and kill thresholds for all of the transactions in each target group.

Usage notes

• Always begin task kill administration by displaying the CMRTTHR view first and then entering the / or S command in the CMD field next to a target group. You cannot enter other CMRTTHR* views at the command line (except for CMRTTHR). This ensures that the subsequent views (such as CMRTTHRT and CMRTTHRE) are displayed with the correct information.

• You can hyperlink on the WT field to see the target groups warning thresholds in the CMRWTHR view or use the browse line command to see the kill and warning thresholds for the target group. See CMRWTHR view.

• Changes to any of the task kill thresholds (warning and kill) and options do not take effect until the CMRTTHnn table is reloaded. You can manually reload the table by using either the KRL command on the CREGAGT view or the FST2 KRLD transaction command. The reloaded thresholds and options do not apply to active tasks.

• The CMRTTHR view displays a default transaction group named $$DFLT$$ if the CMRTTHnn member is empty or does not exist in the BBIPARM concatenation.

• If you delete a target group or transaction group, all child items in that group are also deleted. A delete confirmation panel indicates whether there are any child items and provides an opportunity to cancel the delete request.

• The -/+ field in the upper left corner of the CMRTTR* views can be used to condense and expand the view header lines. Position the cursor on the - or + fields and press Enter to condense or expand the header.