IBM Support

PH64881: An empty object in an OpenAPI 3 payload is not processed by the z/OS Connect server.

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as unreproducible in next release.

Error description

  • When the openapi.yaml for an OpenAPI 3 API project contains an
    optional object that itself has only optional properties, when
    none of the child properties are present (leading to an empty
    object) the z/OS Connect server removes the empty object.
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All users of z/OS Connect OpenAPI 3 API      *
    *                 requester plug-in and API provider plug-in   *
    *                 (API-First).                                 *
    ****************************************************************
    * PROBLEM DESCRIPTION: An empty object in an OpenAPI 3 payload *
    *                      is not processed by the z/OS Connect    *
    *                      server.                                 *
    ****************************************************************
    At runtime the z/OS Connect server incorrectly removed empty
    objects from JSON payloads. This caused remote endpoints to
    reject requests because required (but empty) objects were not
    present.
    

Problem conclusion

Temporary fix

Comments

  • z/OS Connect has been changed to prevent the reported removal of
    empty objects during processing.
    
    API provider Gradle plug-in projects should be rebuilt with
    version 1.4.9 (or later).
    API requester Gradle plug-in projects should be rebuilt with
    version 1.2.3 (or later).
    
    The fix for this APAR is expected to be delivered by the PTF for
    z/OS Connect EE V3.0.91.0 (PH65316).
    

APAR Information

  • APAR number

    PH64881

  • 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-01-19

  • Closed date

    2025-03-13

  • Last modified date

    2025-03-13

  • 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:
13 March 2025