PK91757: API/WUI PROCESSING OF BAS CICS RESOURCE DEFINITIONS MAY BE ELONGATED

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• When retrieving or updating BAS CICS resource definition
  records, if the primary key is specified as a filter through
  the WUI or as part of a filter string through the API, it is
  not passed as the primary key in the parameter list used to
  process the request.  While the correct records will be returned
  or updated, the processing time for the request may be
  elongated.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICSPlex SM V4R1M0 Users                 *
  ****************************************************************
  * PROBLEM DESCRIPTION: When retrieving or updating BAS CICS    *
  *                      definition resource table records, if   *
  *                      the primary key is specified as a       *
  *                      filter through the CPSM WUI or CICS     *
  *                      Explorer, or as part of a filter string *
  *                      through the CPSM API, it is not passed  *
  *                      as the primary key in the parameter     *
  *                      list used to process the request.       *
  *                      While the correct records will be       *
  *                      returned or updated, the processing     *
  *                      time for the request may be elongated.  *
  ****************************************************************
  * RECOMMENDATION: After applying the PTF that resolves this    *
  *                 APAR, all CMASes and SMSS systems must be    *
  *                 restarted.  Note that the restarts do not    *
  *                 need to occur at the same time.              *
  ****************************************************************
  When a primary key is specified as a filter through the WUI or
  CICS Explorer, it is passed to the CPSM API as part of a filter
  string.  When method EYU0XDOP (XDOP) is called from method
  EYU0XDOL (XDOL) to parse the filter string, XDOL requests that
  XDOP return the primary key value.  Currently XDOL only requests
  the primary key from XDOP if the table being processed has one
  key, or if the table being processed has two keys and is a BAS
  CICS definition resource table.  With changes made for CPSM
  V4R1M0, all BAS CICS definition resource tables now have three
  keys, so XDOL will never request the primary key from XDOP for
  BAS CICS definition resource tables.
  
  If XDOL does not request the primary key, it cannot be added to
  the parameter list of the method that will retrieve or update
  the records.  As such, all records for the resource type will be
  examined, instead of only the ones that match the primary key.
  Since the filter will eventually be applied, only the correct
  records will be retrieved or updated.  However, additional
  processing time will most likely occur.
  

Problem conclusion

• XDOL has been updated to ask XDOP to return the primary key if
  the table being processed has one key, or if it has more than
  one key and is a BAS CICS definition resource table.   XDOP has
  also been updated to ensure it returns the correct primary key
  for BAS CICS definition resource tables.
  

Temporary fix

• FIX AVAILABLE BY PTF ONLY
  

Comments

APAR Information

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

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

  UK48621

Modules/Macros

• EYU0XDOL EYU0XDOP
  

Fix information

• Fixed component name

  CICS TS Z/OS V4

• Fixed component ID

  5655S9700

Applicable component levels

• R60M PSY UK48621

     UP09/07/25 P F907

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.