Enabling Task Related User Exit (TRUE) monitoring

You can monitor Task Related User Exit (TRUE) activity in the enhanced 3270 user interface. TRUE monitoring allows you to gauge the effect of applications using Task Related User Exits.

You can enable TRUE monitoring in either of two ways:

Temporarily (until the CICS region is recycled), using the CICS Task Program and TRUE Detail Control (KCPCPROG) workspace; see below.
Permanently, using the Global Data Area; see Determining the values for the monitoring options in OMEGAMON AI for CICS.

The CICS Task Program and TRUE Detail workspace allows you to control the way OMEGAMON CICS collects task program and TRUE details. The settings for TRUE monitoring are in the lower subpanel, Task TRUE Detail Status.

From the initial All Active CICSplexes workspace, select a CICSplex by entering S, then select CICS Control Functions by entering C next to a CICS region, then select T CICS Task Program/TRUE Detail Control from the CICS Control Functions menu:

KCPCPROG    CICS Task Program and TRUE Detail Control      Region   : CICD6102 
                                                                               
               Task Program Detail Status for CICS CICD6102                    
                                                                               
  Task Program Detail..............................................       On   
  Aggregate Program Detail.........................................       On   
  Write to Task History............................................       On   
  Write to SMF.....................................................      Off   
                                    Modify          EXIT                       
                                                                               
                Task TRUE Detail Status for CICS CICD6102                      
                                                                               
  Task TRUE Detail.................................................      Off   
  Write to Task History............................................       On   
  Write to SMF.....................................................      Off   
                                    Modify          EXIT

Task TRUE Detail: This option collects usage information about each Task Related User Exit (TRUE) program which the task has invoked via an application request or for syncpoint processing. This will collect the count and elapsed time each exit is in control.
Write to Task History: This option will record the collected program data for a task to Task History. This will provide the Programs tab when looking at the details for a task. This will provide information about all programs used during the time covered by the history record.
Write to SMF: This option will record the collected information to SMF. The data can then be processed offline by utilities such as IBM CICS Performance Analyzer.