IBM Support

PH60661: CICS PA SUPPORT CICS TS 6.2 CMF AND STATISTICS RECORD CHANGES

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as new function.

Error description

  • CICS Performance Analyzer for z/OS (CICS PA) Support CICS
    Transaction Server for z/OS (CICS TS) 6.2 CMF and Statistics
    record changes.
    CIC0602T/K
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All users of CICS PA 5.4                     *
    ****************************************************************
    * PROBLEM DESCRIPTION: Support for CICS Transaction Server 6.2 *
    *                      and other changes                       *
    ****************************************************************
    This APAR delivers the following enhancement for CICS PA:-
    
    1. This APAR introduces support for CICS Transaction Server
       6.2, including support for new CMF fields, statistics
       fields and records.
    
    2. Idea CICSPA-I-95 requests the increase Selection Criteria
       value input field length to greater than 8 characters.
    
    3. CICSPA-I-110 requests allowing APPLID and resource
       filtering against CICS PA HDBs
    
    4. Update Container sample Forms CCLST, CCSUM to include field
       PGCSTHWM.
    
    5. Enhance Queue Manager and External Sort to remove 255 bytes
       key length limit
    
    6. Support z/OS Connect SMF 123 Server Feature field
    
    7. Implement new CICS PA derived field MAXTSKPC to display
       CURTASKS as a percentage of MAXTASKS
    
    8. Add new Statistics derived field QR TCB Dispatch / Interval
       Ratio in the Dispatcher TCB Modes record and sample Alerts
    
    9. The latest CICS PA Dashboards now include z/OS Connect EE
       Requester records. Sample Report Set ANALYTIC definitions
       must be updated to extract the Requester records.
    

Problem conclusion

  • The following changes are included:-
    
    1. Support all new CICS TS 6.2 Performance and Statistics
       records and fields, including in Forms, Templates and all
       reports that reference Performance and Statistics records.
    
       New CICS PA plugin for CICS Explorer Template:
       APPLNM62 Summary Explorer HDB for App Cntx 6.2
       EXPLOR62 Summary Explorer HDB for CICS TS 6.2
       EXPLST62 List    Explorer HDB for CICS TS 6.2
    
    2. Idea CICSPA-I-95 is delivered in this APAR by enhancing
       batch command and selection criteria processing to accept
       Selection Criteria field values greater than 8 characters,
       with maximum length of 128 characters. This enhancement
       gives the user much more flexibility in specifying specific
       field values.
    
    3. CICSPA-I-110 is delivered in this APAR by giving the user
       the option of specifying APPLID(s) and MVSID(s) in
       Historical Database (HDB) Load. This enhancement gives the
       user the ability to limit the HDB to desired APPLIDs and
       MVSIDs.
    
    4. Update Container sample Forms CCLST, CCSUM to include field
       PGCSTHWM. Field PGCSTHWM was added to monitor the storage
       allocated to containers for a user task.
    
    5. The APAR increases the maximum summary key length from 255
       to 4096 bytes, giving the user the ability to include long
       fields in the summary key. This change applies to all
       summary style reports as well as summary Historical
       Databases (HDB).
    
    6. Support z/OS Connect SMF 123 Server Feature field by
       displaying its value in the z/OS Connect EE List report and
       allowing it to be specified as a key field in the Summary
       report.
    
    7. This APAR introduces CICS PA Performance derived field
       MAXTSKPC. This field reports the CURTASKS value as a
       percentage of MAXTASKS, giving the user an indication of the
       CICS region task load. This field is available in all
       Performance Forms and user defined Templates.
    
    8. This APAR introduces CICS PA Statistics derived field
       DSGQRDSPINR. This field provides QR TCB Dispatch / Interval
       ratio in the Dispatcher TCB Modes record.
       This fields gives the user a way to describe and measure how
       busy a CICS region's QR TCB is.  This is important because a
       common cause of CICS transaction response time problems is a
       QR TCB that is too busy.
       This field is supported in all CICS PA Statistics functions.
    
    9. This APAR delivers update to Sample Report Set ANALYTIC
       definitions to support the latest version of the CICS PA
       Dashboards that include z/OS Connect EE Requester records.
    

Temporary fix

Comments

APAR Information

  • APAR number

    PH60661

  • Reported component name

    CICS PERF ANALY

  • Reported component ID

    5655Y2300

  • Reported release

    540

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    YesSpecatt / New Function / Xsystem

  • Submitted date

    2024-04-02

  • Closed date

    2024-05-31

  • Last modified date

    2025-03-28

  • APAR is sysrouted FROM one or more of the following:

  • APAR is sysrouted TO one or more of the following:

    UI97121 UI97122 UI97123 UI97124

Modules/Macros

  • CPAAGLG  CPAALTMF CPABRIDG CPAC0151 CPAC0230 CPAC0390 CPAC0392
    CPAC0402 CPAC0634 CPAC0635 CPAC0688 CPAC0689 CPAC0695 CPACMDMF
    CPACSUDR CPAD750A CPAD750B CPAD750R CPAD750X CPADB2VW CPADICMF
    CPAELECT CPAERLST CPAFDXTR CPAFNLMF CPAGIQMD CPAGSORT CPAH07
    CPAHDEST CPAHDHDD CPAHDHDN CPAHDHDR CPAHDHDS CPAHDHM0 CPAHDHM1
    CPAHDHM3 CPAHDHM4 CPAHDHMD CPAHDHSK CPAHDHST CPAHDLOD CPAHDLST
    CPAHDLTP CPAHDMNU CPAHDNTP CPAHDOLI CPAHDRST CPAHDSTR CPAHDSUL
    CPAHDSUM CPAHDTE0 CPAHDTE1 CPAHDTS0 CPAHDTS1 CPAHDXPJ CPAHDXS1
    CPAHDXST CPAHSAPI CPAHSBLD CPAHSCT1 CPAHSCT2 CPAHSCT3 CPAHSCT4
    CPAHSCT5 CPAHSCT6 CPAHSCT7 CPAHSCT8 CPAHSCT9 CPAHSCTA CPAHSCTB
    CPAHSCTC CPAHSCTD CPAHSCTE CPAHSSDD CPAHSSDP CPAHSXDR CPAI00
    CPALSTMF CPALSXMF CPAMANMF CPAMROMF CPAOLCOP CPAPADRV CPAPRFMF
    CPAPRSMF CPAQFLOP CPAQMLFL CPAQRFA1 CPAQRFAP CPAQRFFC CPAQRSCX
    CPAQTUTW CPAQZ005 CPAQZ006 CPAQZ068 CPARFEV  CPARFLS0 CPARFLS1
    CPARFLX0 CPARFLX1 CPARFNEW CPARFNW0 CPARFNW2 CPARFRUN CPARFSAM
    CPARFSEV CPARFSL0 CPARFSL1 CPARFSS0 CPARFSS1 CPARFSU0 CPARFSU1
    CPARFSU2 CPARFSU3 CPARFSU4 CPARFT2F CPARSEV  CPARSJCL CPARSLE
    CPARSSAM CPAS012A CPAS029A CPAS046A CPAS060B CPAS062B CPAS07
    CPAS116A CPASASAM CPASCDRV CPASDDRV CPASIDTU CPASLSMF CPASMDS1
    CPASMDS2 CPASMDS3 CPASMDS4 CPASMDS5 CPASMDS7 CPASMDS8 CPASMDSC
    CPASMLST CPASMSJ2 CPASMSJ4 CPASMSJ5 CPASMSJ6 CPASMSJB CPASMSJD
    CPASMSJE CPASMSM2 CPASMSM4 CPASMSM6 CPASMSM7 CPASMSMC CPASMSMD
    CPASMSME CPASMSUM CPASMXM2 CPASMXM5 CPASMXM8 CPASMXM9 CPASMXMB
    CPASMXMD CPASMXME CPASMXSC CPASMXSE CPASSMMF CPASTADF CPASTALT
    CPASUMMF CPATPDRV CPAVRMP1 CPAX05   CPAZCLST CPAZCSUM
    

Fix information

  • Fixed component name

    CICS PERF ANALY

  • Fixed component ID

    5655Y2300

Applicable component levels

  • R540 PSY UI97121

       UP24/06/12 P F406  

  • R54C PSY UI97124

       UP24/06/13 P F406  

  • R54E PSY UI97122

       UP24/06/13 P F406  

  • R54K PSY UI97123

       UP24/06/13 P F406  

Fix is available

  • Select the PTF appropriate for your component level. You will be required to sign in. Distribution on physical media is not available in all countries.

[{"Business Unit":{"code":"BU048","label":"IBM Software"},"Product":{"code":"SSPPU4","label":"CICS Performance Analyzer for z\/OS"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"5.4","Line of Business":{"code":"LOB70","label":"Z TPS"}}]

Document Information

Modified date:
28 March 2025