Example: Application naming

An example of a Performance Summary report produced from CMF performance class data with application naming enabled is shown in Figure 2. The report is sorted by transaction ID, application naming transaction ID, and application naming program name.

The following sample Report Forms are provided to help you format the report.
PGAPLSUM
Transactions by application naming program
TRAPLSUM
Transactions by application naming transaction ID

You can edit a sample form, change it and SAVEAS to create a new report form. For example, modify TRAPLSUM by moving unwanted fields below EOR, then SAVEAS TRAPLMOD.

Figure 1. SUMMARY Report Form (Application naming)
                   EDIT SUMMARY Report Form - TRAPLMOD
  
 Title  . . Transactions by Application Transaction ID and Program name (APP
            LNAME)___________________________________________________________
                                                                           
     Field    Sort                                               - User Field -
 /   Name +   K  O  Type    Fn    Length  Dictionary Definition  Offset  Length
 __  TRAN____ K  A  _______ ___        8  TRAN     DFHTASK C001   ___     ___
 __  APPLTRAN K  A  _______ ___        4  APPLNAME DFHAPPL C001   ___     ___
 __  APPLPROG K  A  _______ ___        8  APPLNAME DFHAPPL C001   ___     ___
 __  TASKCNT_       _______ ___        8  TASKCNT  CICSPA  X902   ___     ___
 __  RESPONSE       _______ AVE        8  RESP     CICSPA  D901   ___     ___
 __  DISPATCH       TIME___ AVE        8  USRDISPT DFHTASK S007   ___     ___
 __  CPU_____       TIME___ AVE        8  USRCPUT  DFHTASK S008   ___     ___
 __  SUSPEND_       TIME___ AVE        8  SUSPTIME DFHTASK S014   ___     ___
 __  DISPWAIT       TIME___ AVE        8  DISPWTT  DFHTASK S102   ___     ___
 __  EOR_____       _______ ___                                   ___     ___
 __  EOX_____       _______ ___                                   ___     ___
 __  RESPONSE       _______ MAX        8  RESP     CICSPA  D901   ___     ___
 __  DISPATCH       TIME___ MAX        8  USRDISPT DFHTASK S007   ___     ___
 __  DISPATCH       COUNT__ AVE        8  USRDISPT DFHTASK S007   ___     ___
 __  CPU_____       COUNT__ AVE        8  USRCPUT  DFHTASK S008   ___     ___
 __  SUSPEND_       TIME___ MAX        8  SUSPTIME DFHTASK S014   ___     ___
 __  SUSPEND_       COUNT__ AVE        8  SUSPTIME DFHTASK S014   ___     ___
This produces a report with the following format and provides a summary of activity from each of the main menu options.
Figure 2. Performance Summary report: Application naming
 V5R1M0                                                 CICS Performance Analyzer
                                                           Performance Summary
 
SUMM0001 Printed at 12:03:45 04/17/2013     Data from 07:30:47  5/29/2010 to 08:35:48  5/29/2010                          
Transactions by Application Transaction ID and Program name (APPLNAME)
 
                                           Avg       Avg       Avg      Avg       Avg
Tran     Tran     Program    #Tasks   Response  Dispatch  User CPU  Suspend  DispWait
                                          Time      Time      Time     Time      Time
MENU     TOP1     PROGOPT1        5     1.4249     .0934     .0196  684.379     .0064
MENU     TOP2     PROGOPT2       48     1.0589     .7688     .2039   1.1260     .1046
MENU     TOP3     PROGOPT3        1     2.8065     .0002     .0002    .0029     .0000
MENU     TOP4     PROGOPT4       49     5.7820     .7531     .1997   1.1030     .1025
MENU     TOP5     PROGOPT5        4     3.1749     .0695     .0088    .0191     .0191
Notes:
  1. The APPLTRAN and APPLPROG fields are only available when application programs invoke the application naming event monitoring points. For more information, see the APPLNAME parameter on the DFHMCT TYPE=INITIAL macro in the CICS Resource Definition Guide.
  2. CICS PA supports the OMEGAMON® for CICS® umbrella transaction facility. The CMF fields APPLTRAN and APPLPROG provide support for the CICS application naming facility (DFHAPPL). CICS PA reports the umbrella names in the APPLTRAN and APPLPROG fields when they are available in the CMF record. If both the DFHAPPL and OMEGBSC EMPs are active, then DFHAPPL takes precedence.

    APPLTRAN and APPLPROG also provide a unified representation of the transaction and program names. When the DFHAPPL or OMEGBSC EMP is active but the transaction or program names are blank (not set by the application program), CICS PA reports the actual CICS transaction and program names. This allows you to use a single form field, APPLTRAN, to represent the transaction name in reports.

    Restriction: CICS PA requires the CMF dictionary record to be available so it can detect the presence of the OMEGBSC EMP and reference the umbrella names. Dictionary records are only written to SMF when monitoring commences, so they are often not available in the SMF file. In this case CICS PA cannot detect the presence of the OMEGBSC EMP and the umbrella names will not be reported. To ensure that the umbrella names are always accessible to CICS PA, use the ISPF dialog to create a dictionary record, which is then automatically included in the CPADICTR DD statement in the JCL at Report Set run time.

Information Information

Feedback


Timestamp icon Last updated: Saturday, 8 February 2014


http://pic.dhe.ibm.com/infocenter/cicsts/v5r1/topic///report-reference/cparr70.htm