PH64070: Updating to V3.0.81.0 or later, causes existing API providers to fail with message BAQR1778E, "PLI" is not valid.

APAR status

• Closed as unreproducible in next release.

Error description

• After updating from z/OS Connect V3.0.78.0 to V3.0.86.0 all of
  the OpenAPI 3 PL/I CICS API providers built using the API-First
  method, with API project files generated by the API provider
  Gradle plug-in, reported the following message when deployed:
  
  BAQR1778E: Invalid z/OS Asset for type <asset_type> in
            <z/OS_asset_name)>. Reason: The language 'PLI' is not
            valid.
  
  Additional search words: msgBAQR1778E msgBAQR1778 BAQR1778
  top-down cicsChannel-1.1 cicsCommarea-1.1
  

Local fix

• Changing the language property in the zosAsset.yaml file under
  src\main\zosAssets\<operation> to PL/I allowed the API providers
  to run successfully.
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of z/OS Connect OpenAPI 3          *
  *                 API-First API providers specifying language  *
  *                 "PLI".                                       *
  ****************************************************************
  * PROBLEM DESCRIPTION: Updating to V3.0.81.0 or later, causes  *
  *                      existing API providers to fail with     *
  *                      message BAQR1778E, "PLI" is not valid.  *
  ****************************************************************
  At V3.0.81.0 z/OS Connect runtime validation was changed to
  ensure that either "PL/I" or "COBOL" was specified as the
  language type.
  This did not take into account that API providers could have
  been created using Gradle with the language "PLI". This change
  caused the reported error.
  

Problem conclusion

Temporary fix

Comments

• The z/OS Connect OpenAPI 3 runtime has been changed to allow
  the language parameter to be "COBOL", "PL/I" or "PLI". The API
  provider Gradle plug-in has also been changed to tolerate any
  of these 3 values.
  For APIs using the PL/I language, the generated zosAsset.yaml
  will always specify the value "PL/I" for the "language"
  property.
  
  The fix for this APAR is expected to be delivered by the PTFs
  for z/OS Connect V3.0.88.0 (PH64142).
  

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