Example: Application naming
An example of a Performance List report produced from CMF performance class data with application naming enabled is shown in Figure 1.
The commands to request this report are like the following:
CICSPA IN(SMFIN002),
LIST(FIELDS(
APPLTRAN, Application naming transaction ID
USERID, User identifier
APPLPROG, Application naming program name
TASKNO, Transaction identification number
STOP(TIMET), Task stop time (hh:mm:ss.thm)
DISPATCH(TIME), Dispatch time
CPU(TIME), CPU time
SUSPEND(TIME), Suspend time
DISPWAIT(TIME), Redispatch wait time
APPLID, CICS Generic APPLID
JOBNAME, Job name
MVSID, MVS SMF ID
RELEASE)) CICS release
Figure 1. Performance
List report: Application naming
V5R3M0 CICS Performance Analyzer
Performance List
LIST0001 Printed at 12:34:56 02/15/2015 Data from 07:30:47 5/29/2010 Page 1
Tran Userid Program TaskNo Stop Dispatch User CPU Suspend DispWait APPLID Jobname MVS Rlse
Time Time Time Time Time
TOP1 CBAKER PROGOPT1 16 7:30:47.653 .0002 .0002 .0029 .0000 IYK2Z1V1 CI07CJB1 MV2C 0660
TOP2 CBAKER PROGOPT2 17 7:30:47.660 .0019 .0007 .0067 .0000 IYK2Z1V1 CI07CJB1 MV2C 0660
TOP3 CBAKER PROGOPT3 18 7:30:47.699 .0112 .0011 .0362 .0298 IYK2Z1V1 CI07CJB1 MV2C 0660
TOP4 CBAKER PROGOPT4 13 7:30:47.785 .0189 .0031 .1189 .1157 IYK2Z1V1 CI07CJB1 MV2C 0660
TOP5 CBAKER PROGOPT5 15 7:30:47.829 .0261 .0044 .1539 .1053 IYK2Z1V1 CI07CJB1 MV2C 0660
TOP6 CBAKER PROGOPT6 12 7:30:47.842 .0363 .0034 .1587 .0012 IYK2Z1V1 CI07CJB1 MV2C 0660
TOP7 CBAKER PROGOPT7 10 7:30:47.945 .1053 .0142 .1930 .1393 IYK2Z1V1 CI07CJB1 MV2C 0660
Notes:
- 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.