Administration of the CICS Feature › Defining Parameters › CICS SMF Scope Definitions › Including and Excluding Transactions

Including and Excluding Transactions

Select option 2 on the CICS SMF Scope Definitions panel to access the Transaction In/Exclusion List panel shown following.

 APCDPS20 --- PMA - Transaction In/Exclusion List (CIC           ENTRY INSERTED
 COMMAND ===>                                                   SCROLL ===> HALF
                                                                                
                                                                                
 Commands     :  I -Insert                                                      
 Line Commands:  I -Insert   D -Delete   C -Change                              
                                                                                
  If EXCLUDED the following Transactions are NOT in the CICS SMF scope          
  If INCLUDED ONLY the following Transactions are in the CICS SMF Scope         
                                                                                
 LC Tran   IN/EXCLUDED  Description                                             
 -------------------------------------------------------------------------------
    TRX1     EXCLUDED     EXCLUDE TRANSACTION TRX1                              
 ******************************* Bottom of data ********************************

You can use line commands to work with a specific inclusion/exclusion or to insert a new transaction. To use line commands, place the cursor in the LC column to the left of the transaction and enter one of the following values:

I

Insert a new transaction exclusion or inclusion.

D

Delete an existing transaction exclusion or inclusion.

C

Change the name or description of an included or excluded transaction.

You can also use primary command I (Insert) to enter a new transaction inclusion or exclusion.

If you choose to insert (I) or change (C) a transaction exclusion or inclusion, the panel shown following is displayed.

 APCDPS21 --- PMA - Insert Transactions In/Exclusion (CICS SMF Scope)           
 COMMAND ===>                                                                   
                                                                                
 Please enter:                                                                  
                                                                                
 Transaction : TRX1      def. CICS SMF processing spectrum using a              
                         Transaction name                                       
 In/exclusion : E        I = inclusion   E = exclusion                          
                         decide whether all System Definitions are              
                         inclusions OR exclusions.                              
 Description  : EXCLUDE TRANSACTION TRX1                                        
                                                                                
                          use '_' as the placeholder for one byte               
                          use '*' as a generic value at the end                 
                                                                                
                          for example: System                                   
                                       ABC123*                                  
                                       A__1_345                                 
                                         C1*                                    
                                                                                
            CANCEL: CAN OR PF3                                                  
            SAVE  : ENTER                                                       

Inclusions are recommended when defining transaction names.

Generic notation of transaction names is allowed using * as a wildcard.

For example: TRAN* INCLUDED

In this example, all transaction names that do not begin with TRAN* are implicitly excluded from the CICS SMF Scope.

All defined transaction names must be either inclusions or exclusions.

You are not allowed to mix these definitions.