PH23414: CICS NODE BUNDLE ENDED ABNORMALLY

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• When the response from a JSON web service called using the
  ibm-cics-api Node module contains invalid JSON, the CICS BUNDLE
  will end abnormally with message:
  
  Unexpected token x in JSON at position y
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICS users.                              *
  ****************************************************************
  * PROBLEM DESCRIPTION: A Node.js application running in CICS   *
  *                      terminates after calling a JSON web     *
  *                      service.                                *
  ****************************************************************
  A Node.js application running in CICS calls a JSON web service
  running in the same CICS region using the ibm-cics-api module.
  
  The response from the JSON web service includes a character
  which is not valid JSON and cannot be parsed by JSON.parse().
  This causes an exception which will appear in the application's
  trace file as:
  
  *Exc* : handleAsyncError() - Error from user callback
    = Unexpected token in JSON at position 15
  
  CICS considers this exception to be a severe error that cannot
  be recovered from causing the Node.js application to be
  disabled.
  

Problem conclusion

• The locally optimised path of the ibm-cics-api module has been
  updated so that if a JSON web service returns a response that
  cannot be parsed into a JSON object, it will instead be returned
  as a string.
  
  This matches the existing behaviour when using ibm-cics-api
  from a Node.js application running outside of CICS.
  

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:

  UI70803 UI70806

Modules/Macros

• DFJ@H560
  

Fix information

• Fixed component name

  CICS TS Z/OS V5

• Fixed component ID

  5655Y0400

Applicable component levels

• R200 PSY UI70803

     UP20/08/01 P F007 ¢

• R300 PSY UI70806

     UP20/07/30 P F007 ¢

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.