PK21030: API GET OBJECT TRANDEF FILTER CRITERIA

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• The CPSM API can run into performance problems when issuing a :
  __
  EYUAPI('GET OBJECT
  __
  for a TRANDEF and specifying a transaction ID as the CRITERIA
  parameter.
  When you do this from the EUI, the parameter list (MAL) passed
  to the processor includes the definition name.  The only
  processing that CPSM has to do is issue a single READ for that
  definition.
  For the API, the name is passed as part of the filter, and not
  as part of the MAL.  CPSM has to browse through every
  definition, and check the filter criteria.
  The performance degradation is more apparent when there are
  thousands of resource definitions (TRANDEFs).
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICSPlex/SM V3R1M0 Users                 *
  ****************************************************************
  * PROBLEM DESCRIPTION: Response time may be excessive when     *
  *                      using an API criteria string or WUI     *
  *                      filter to request a single BAS CICS     *
  *                      resource definition record (e.g,        *
  *                      TRANDEF).                               *
  ****************************************************************
  * RECOMMENDATION: After applying the PTF that resolves this    *
  *                 APAR, all CMASes must be restarted.  Note    *
  *                 that the restarts do not need to occur at    *
  *                 the same time.                               *
  ****************************************************************
  When a criteria string is specified on an API GET request for a
  BAS CICS resource definition record, either directly or
  indirectly through a WUI filter, each record for the definition
  type is read from the CPSM data repository and the criteria is
  applied to determine if the record should be selected, even when
  the specific record name is included in the criteria string.
  
  In contrast, when a similar request is made for most Operations
  (e.g, LOCTRAN) and Monitor (e.g., MLOCTRAN) records, the name is
  retrieved from the criteria string and passed in the parameter
  list to the method that performs the GET, which then only needs
  to process the record specified in the parameter list.  This can
  greatly reduce the response time when there are many records for
  the resource type.
  

Problem conclusion

• Methods EYU0XDOL and EYU0XDOP have been updated to retrieve the
  record name from the criteria string, if provided, when an API
  GET is performed for a BAS CICS resource definition record.
  This is passed to method EYU0MOMB, which will add the name to
  the parameter list built for the method that performs the GET.
  

Temporary fix

• FIX AVAILABLE BY PTF ONLY
  

Comments

• Response time may be excessive when
  using an API criteria string or WUI
  filter to request a single BAS CICS
  resource definition record (e.g,
  TRANDEF).
  
  
  When a criteria string is specified on an API GET request for a
  BAS CICS resource definition record, either directly or
  indirectly through a WUI filter, each record for the definition
  type is read from the CPSM data repository and the criteria is
  applied to determine if the record should be selected, even when
  the specific record name is included in the criteria string.
  
  In contrast, when a similar request is made for most Operations
  (e.g, LOCTRAN) and Monitor (e.g., MLOCTRAN) records, the name is
  retrieved from the criteria string and passed in the parameter
  list to the method that performs the GET, which then only needs
  to process the record specified in the parameter list.  This can
  greatly reduce the response time when there are many records for
  the resource type.
  
  
  Methods EYU0XDOL and EYU0XDOP have been updated to retrieve the
  record name from the criteria string, if provided, when an API
  GET is performed for a BAS CICS resource definition record.
  This is passed to method EYU0MOMB, which will add the name to
  the parameter list built for the method that performs the GET.
  

APAR Information

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

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

  UK13283

Modules/Macros

•    EYU0XDOL EYU0XDOP
  

Fix information

• Fixed component name

  CPSM CICS 3.1

• Fixed component ID

  5655M1501

Applicable component levels

• R100 PSY UK13283

     UP06/04/06 P F604

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.