PH64000: OpenAPI 3 optional fields found because they are set to null causing the _existence flag to be set incorrectly.

APAR status

• Closed as unreproducible in next release.

Error description

• When an OpenAPI 3 API which has optional fields is invoked, any
  optional fields not included in the JSON are set to null and the
  _existence flag is set to 1.
  This causes unexpected optional fields to be found.
  
  Additional search words: existence
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of z/OS Connect V3.0 with          *
  *                 OpenAPI 3 API provider and API requester.    *
  ****************************************************************
  * PROBLEM DESCRIPTION: OpenAPI 3 optional fields found because *
  *                      they are set to null causing the        *
  *                      _existence flag to be set incorrectly.  *
  ****************************************************************
  The z/OS Connect server did not differentiate between no value
  being present for a field or that field containing JSON null.
  This resulted in fields being assigned a JSON null value in both
  scenarios. JSON null is a value, so the _existence flag for the
  field was set.
  

Problem conclusion

Temporary fix

Comments

• z/OS Connect has been changed to treat fields with no value as
  not existing and so the _existence flag is set to 0 when the
  field does not exist.
  
  z/OS Connect Designer projects should be reloaded into a
  V3.0.91.0 (or later) Designer image to pick up this change.
  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 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