PH48972: ENHANCE CICS PA ZOS CONNECT REPORTS TO INCLUDE SMF 123 SUBTYPE 2REQUESTER RECORDS AND PORT FIELDS SUMMARY KEYS

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• - Enhance CICS PA zOS Connect reports to include SMF 123
  subtype 2 Requester records
  - Add support for fields PORT, OPORT, CLIPPORT and OCLIPORT
    in Summary keys
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of CICS PA V5.4                    *
  ****************************************************************
  * PROBLEM DESCRIPTION: Support is required for z/OS Connect EE *
  *                      API Requester records and for some CMF  *
  *                      Port field summary keys.                *
  ****************************************************************
  CICS Performance Analyzer (CICS PA) Idea CPA-I-82 requests
  support for z/OS Connect EE API Requester (SMF 123.2) data.
  Additionally, it requests increasing the number of z/OS Connect
  Summary key fields from 3 to 8.
  The following CICS TS CMF fields are defined as type A (count)
  fields and therefore are ineligible as key fields in various
  CICS PA Summary reports:-
  PORT      (DFHSOCK A246)
  OPORT     (DFHCICS A367)
  CLIPPORT  (DFHSOCK A330)
  OCLIPORT  (DFHCICS A369)
  CICS PA incorrectly terminates with RC=00 when z/OS Connect
  streaming experiences a connect error to the remote host.
  

Problem conclusion

• The user will now be able to report/extract z/OS Connect EE API
  Provider and/or Requester data for CICS related requests,
  together with their associated CICS task performance data, as
  well as requests for other subsystem types.
  In addition, the number of z/OS Connect summary key fields has
  been increased from 3 to 8 keys fields.
  This APAR now converts and treats the following CICS TS CMF
  fields as character fields, thus allowing them to be specified
  as Summary key fields in various Summary reports and HDB
  Templates.
  It also sets the CICS Performance Analyzer termination return
  code to 8 or 16 when z/OS Connect streaming processing detects
  a connection problem to the remote host.
  

Temporary fix

Comments

APAR Information

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

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

  UI83793 UI83794 UI83795 UI83796

Modules/Macros

• CPAAGLG  CPAC0230 CPAC0390 CPAC0392 CPAC0402 CPACMDMF CPACSUDR
  CPAFDXTR CPAHDHDD CPAHDHDR CPAHDLOD CPAHDLTP CPAOLCOP CPAPADRV
  CPAPRSMF CPAQFZMN CPAQRSZ1 CPAQRSZ2 CPAQRSZC CPAQRSZD CPAQRSZO
  CPAQRSZS CPAQRZFL CPAQTUTW CPARFEV  CPARFNEW CPARFRUN CPARSCKP
  CPARSDEC CPARSDEF CPARSEV  CPARSJCL CPARSPUT CPARSSAV CPARSZC
  CPARSZFL CPARSZJ  CPARSZJO CPARSZX  CPARSZXO CPASCDRV CPATTLMF
  CPAZCLST CPAZCSUM
  

Fix information

• Fixed component name

  CICS PERF ANALY

• Fixed component ID

  5655Y2300

Applicable component levels

• R540 PSY UI83793

     UP22/12/22 P F212  

• R54C PSY UI83796

     UP22/12/22 P F212  

• R54E PSY UI83794

     UP22/12/22 P F212  

• R54K PSY UI83795

     UP22/12/22 P F212  

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.