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.
- 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.
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 ___ ___
V5R3M0 CICS Performance Analyzer
Performance Summary
SUMM0001 Printed at 12:34:56 02/15/2015 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
- 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.
- 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.