IBM Support

OA62240: ZAPM CONNECT DOES NOT HANDLE RETURN CODE PROPERLY FROM DB2 AND IMS FIX FOR LOWERCASE TO UPPERCASE CONVERSION OF ID.

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • 1 - zAPM Connect DB2 SQL call causes a User Error in IMS
    application
    
    2 - IMS Connect transaction is not reported on the User
    Interface (UI) when a lower case clientid is entered.
    

Local fix

  • n/a
    

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All Z APM Connect v6.1.0 users.              *
    ****************************************************************
    * PROBLEM DESCRIPTION: 1 - zAPM Connect DB2 SQL call routine   *
    *                      is passing back to caller an invalid    *
    *                      return code in some instances, which    *
    *                      can cause a User Error message to be    *
    *                      reported.                               *
    *                                                              *
    *                      2 - IMS Connect clientid in lower       *
    *                      case causes a mismatch between IMS      *
    *                      Connect and IMS in the Horizontal       *
    *                      links.                                  *
    ****************************************************************
    * RECOMMENDATION: Apply this PTF.                              *
    ****************************************************************
    1 - DB2 DB exit passes back invalid return code in some
    instances.
    
    2 - IMS Connect clientid in lower case causes a mismatch
    between IMS Connect and IMS zAPM Horizontal link events causing
    transactions not to be reported on the UI.
    

Problem conclusion

  • 1 - DB2 exit always passes back IMS database call return code
    from application.
    
    2 - Clientid is converted to upper case in zAPM Connect like
    is done in IMS Connect.
    

Temporary fix

Comments

APAR Information

  • APAR number

    OA62240

  • Reported component name

    Z APM CONNECT

  • Reported component ID

    5698ABF00

  • Reported release

    610

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2021-10-07

  • Closed date

    2022-03-31

  • Last modified date

    2022-10-03

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

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

    UJ07179

Modules/Macros

  • AGMDB20E AGMDB20F AGMDBF0E AGMDBF0F AGMDLA0E AGMDLA0F AGMTEC0E
    AGMTEC0F
    

Fix information

  • Fixed component name

    Z APM CONNECT

  • Fixed component ID

    5698ABF00

Applicable component levels

  • R610 PSY UJ09066

       UP22/09/14 P F209

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":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSCL4Q","label":"IBM Z Application Performance Management Connect"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"610","Line of Business":{"code":"LOB35","label":"Mainframe SW"}}]

Document Information

Modified date:
03 October 2022