IBM Support

CICS PA is not using or finding the dictionary record

Question & Answer


Question

Why isn't CICS Performance Analyzer for z/OS (CICS PA) using my dictionary record? I am running CICS Transaction Server for z/OS (CICS TS) V5.1 and using CICS PA V5.1 to process CICS SMF 110 performance records. When I run the CICS PA job to list out the new user records in my DFHMCT, CICS PA does not seem to find them in the CPADICTR DD concatenation even though I know they are there.

The CICS PA Performance LIST command results in my USER fields printing as "Missing" in the report. This SYSPRINT DD shows the following messages:

   V5R1M0    18:41:01 12/02/2015                          CICS Performance Analyzer                                     Page     3
                                                              System Messages 
                                               __________________________________________________ 
   CPA0218I  Record processing for SMF File SMFIN001 has started
   CPA0220I  SMF records for System SYSA start at 11/23/2015 23:00:24:79
   CPA0230I  Dictionary Record default is being used, APPLID=CICSAOR1, Release= 6.8.0 
   CPA0359W  Connector ID X'0176' not mapped by Performance Dictionary record from module CPADICMF/CPAPRSMF
             Field ID=User field  , APPLID=CICSAOR1, Release= 6.8.0 from module CPADICMF/CPAPRSMF
   CPA0311E  Field ID XXXX  C001 is not defined to Dictionary -  field ignored from module CPALSTMF
   CPA0329E  Dictionary returned error on Field ID XXXX  C001 from module CPALSTMF/LIST0001
   CPA0222I  SMF records for System SYSA end at 11/23/2015 19:01:30:67
   CPA0219I  End of File processing for SMF File SMFIN001  has started 
   CPA0229I  CICS PA has completed processing, RC=8 
     
      V5R1M0    18:41:01 12/02/2015                          CICS Performance Analyzer                                     Page     4
                                                             End of File Record Counts 
                                                 __________________________________________________   
                   DD or Log Stream name        RecID          Record Type          Count     Pct of Total 
                   SMFIN001                     X'31'     Performance Class           1,100     100.00% 
                   SMFIN001                     Total                                 1,100     100.00% 
                                                Total     SMF Records                   100 

 

Answer

The following DFH$MOLS job can be used to print the dictionary record for the APPLID so you can review its contents.

 //DICTCOPY EXEC PGM=SORT,REGION=0M                                    //SORTIN DD DSN=&hlq..&applid..CICSV510.DICT,             //       DISP=SHR                                                     //SORTOUT DD DSN=&&TEMP,DISP=(NEW,PASS),UNIT=SYSDA,SPACE=(TRK,(5,2))  //DFSMSG DD SYSOUT=A                                                  //SYSOUT DD SYSOUT=A                                                  //SORTDIAG DD SYSOUT=A                                                //SYSIN DD *                                                           OPTION COPY,VLSHRT                                                    RECORD TYPE=V                                                         INCLUDE COND=(6,1,FI,EQ,110,AND,                                                    23,2,BI,EQ,X'0001',AND,67,2,BI,EQ,X'0001')              END                                                                  /*                                                                    //MOLSPRNT EXEC PGM=DFH$MOLS,REGION=0M,COND=(5,LT,DICTCOPY)           //STEPLIB DD DSN=&hlq..CICS680.SDFHLOAD,DISP=SHR                        //INPUT DD DSN=&&TEMP,DISP=(OLD,DELETE)                               //SYSOUT DD SYSOUT=A                                                  //SYSPRINT DD SYSOUT=A,DCB=BLKSIZE=133                                //SYSABEND DD SYSOUT=A,DCB=BLKSIZE=133                                //SYSUDUMP DD SYSOUT=A,DCB=BLKSIZE=133                                //SYSIN DD *                                                          * PRINT THE DICTIONARY RECORDS ONLY                                   PRINT DIC                                                             * DISABLE THE DATE/TIME SEQUENCE CHECKING                             TIMEOFF                                                               /*                                                                    

In this case, the dictionary showed the record version as "0650" which is CICS TS V3.2, but the region is CICS TS V5.1 which should be version "0680".

alt text

The SDFHLOAD data set used on the CICS PA system definition panelid CPASDCV0 was aliased to an old CICS TS data set.

After changing the SDFHLOAD data set to the CICS TS V5.1 SDFHLOAD and performing an option 1. to Populate Dictionary, the DFH$MOLS showed the correct record version as "0680" ...

alt text

...and the CICS PA Performance LIST job issued message...

CPA0228I Dictionary Record from Dialog is being used, DDname=CPADICTR +nnn, APPLID=xxxxxxxx, SID=xxxx, Release=v.r.m, Record Date=mm/dd/yyyy, Time=hh:mm:dd

The CICS PA order of precedence used to determine the CICS dictionary record to use is described in the CICS PA documentation under Order of precedence.

[{"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSPPU4","label":"CICS Performance Analyzer for z\/OS"},"Platform":[{"code":"PF035","label":"z\/OS"}],"Component":"","Version":"","Line of Business":{"code":"LOB35","label":"Mainframe SW"}}]

Product Synonym

CICSPA CICS PA

Document Information

Modified date:
02 December 2015

UID

dwa1241866