PH11252: REST MODEL TO SWAGGER XFROM, RSAD 9.7 IS NOT ENFORCING A REQUIRED FIELD FOR DESCON THE RESPONSE STATUS CODE

APAR status

• Closed as program error.

Error description

• Using the REST Model to Swagger Transformation, but it doesn't
  generate a field that is required by the Swagger/OpenAPI.
  Specifically, response parameters on GET operations MUST include
  a description field. If the model doesn't have anything in the
  documentation field of the response, the transformation can't
  create something. However, since this is a required field, it
  should at least complain.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * -                                                            *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  * REST MODEL TO SWAGGER XFROM, RSAD 9.7 IS NOT ENFORCING A     *
  * REQUIRED FIELD FOR DESCON THE RESPONSE STATUS CODE           *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  

Problem conclusion

•  Swagger Transformation is generating empty description for
  response Objects.
  

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:

Fix information

• Fixed component name

  SW ARCHITECT WI

• Fixed component ID

  5724I7001

Applicable component levels