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:
  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.