PH30465: DFHPI9740E MULTIPLE INSTANCES OF ALLOF, ANYOF, OR ONEOF JSON KEYWORDS INCORRECTLY PRODUCES REFERENCE LOOP

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• You are receiving the following error message when attempting
  to process your JSON schema with DFHJS2LS:
  
  com.ibm.cics.wsdl.CICSWSDLException: DFHPI9740E Unsupported JSON
  schema. A recursive JSON pointer
  "#/definitions/common.myDefinition" was found.
  
  Or when using the z/OS Connect Build Toolkit to process a
  Swagger document:
  
  BAQB0017W: Failed to process operation (operationId:
  myOperation, relativePath: /my-operation, method: POST).
  Reason: The definitions section contains a reference loop,
  caused by the reference ""#/definitions/common.myDefinition",
  that cannot be processed by the build toolkit.
  
  The combination of allOf, anyOf, oneOf JSON keywords and JSON
  pointers cause the DFHJS2LS utility to incorrectly generate and
  report a reference loop.
  
  The JSON schema is modified when processing these keywords. In
  schemas that contain an object that is referenced twice via
  pointers, the second time the object is referenced there is some
  residual data from the first time it was processed. This causes
  the schema to become recursive.
  

Local fix

• The object that contains the allOf, anyOf, oneOf JSON keywords
  can be updated to circumvent the issue by replacing the
  reference with the properties of the references object
  directly. Logically the schema will remain the same, but the
  false reference loop error will be avoided.
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICS users.                              *
  ****************************************************************
  * PROBLEM DESCRIPTION: DFHJS2LS may incorrectly fail with      *
  *                      error message DFHPI9740E when the JSON  *
  *                      schema uses a combination of allOf,     *
  *                      anyOf or oneOf JSON keywords and JSON   *
  *                      pointers.                               *
  ****************************************************************
  DFHJS2LS is used to process a JSON schema which uses the JSON
  keywords allOf, anyOf or oneOf, together with JSON schema
  pointer references.
  The combination of these keywords and pointer references can
  result in DFHJS2LS manipulating its internal copy of the JSON
  schema in a way which introduces a reference loop.  If this
  occurs DFHJS2LS fails with message:
  
  DFHPI9740E Unsupported JSON schema. A recursive JSON pointer
   "<pointer value>" was found.
  

Problem conclusion

• DFHJS2LS has been updated to resolve the problem described
  above.
  

Temporary fix

Comments

APAR Information

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

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

  UI72808

Modules/Macros

• DFJ@H176
  

Fix information

• Fixed component name

  CICS TS Z/OS V5

• Fixed component ID

  5655Y0400

Applicable component levels

• R300 PSY UI72808

     UP21/01/04 P F012

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.