IBM Support

PH68247: ClassNotFoundException reported for IMS API providers with TLS connections after updating to Java 11 or later.

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as unreproducible in next release.

Error description

  • After migrating z/OS Connect from Java 8 to Java 17 the
    following error is reported when an API, using the IMS service
    provider, attempts to connect over an SSL/TLS connection:
    
    The exception is: state STATE_ACTIVE_INUSE
    javax.resource.spi.ResourceAdapterInternalException:
    com.ibm.crypto.provider.RACFInputStream > Accessing RACF keyring
    keystore - ClassNotFoundException caught.
    
    IMS TMRA APAR PH68428 has been opened for this problem.
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All users of the z/OS Connect 3.0 IMS        *
    *                 service provider features imsmobile-2.0      *
    *                 (OpenAPI 2) or ims-1.0 (OpenAPI 3).          *
    ****************************************************************
    * PROBLEM DESCRIPTION: ClassNotFoundException reported for IMS *
    *                      API providers with TLS connections      *
    *                      after updating to Java 11 or later.     *
    ****************************************************************
    The version of TMRA that z/OS Connect embeds references Java
    class com.ibm.crypto.provider.RACFInputStream, which exists in
    Java 8, but not Java 11 and later.
    

Problem conclusion

Temporary fix

Comments

  • The level of TMRA embedded in z/OS Connect has been updated to
    a level which supports Java 11+ TLS/SSL connections.
    
    The fix for this APAR is expected to be delivered by the PTF for
    z/OS Connect V3.0.101.0 (PH69396).
    

APAR Information

  • APAR number

    PH68247

  • Reported component name

    Z/OS CONNECT EE

  • Reported component ID

    5655CE300

  • Reported release

    000

  • Status

    CLOSED UR1

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2025-09-23

  • Closed date

    2026-02-12

  • Last modified date

    2026-02-12

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

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

Fix information

  • Fixed component name

    Z/OS CONNECT EE

  • Fixed component ID

    5655CE300

Applicable component levels

[{"Business Unit":{"code":"BU029","label":"Software"},"Product":{"code":"SSVVFY","label":"z\/OS Connect Enterprise Edition"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"000"}]

Document Information

Modified date:
12 February 2026