Error responses returned to the client

These responses are returned if errors occur during processing in the CICS® JSON handler.

About this task

If errors occur during processing in the CICS JSON handler, CICS returns a response to the client containing information about the error. An HTTP status code of 500 (Internal Server Error) is returned, and the message body contains details of the error in JSON format, depending on the type of error that occurred.

Example

If an error occurs before or after CICS has called the Axis2 pipeline, the message will contain information similar to the following:

{
  "exception" : {
     "message" : "An exception has occurred while validating HTTP headers".
     "class" : "com.ibm.cicsts.axis2.Controller"
   }
}

If an error occurs at any other point during processing, the message will contain similar information to a SOAP fault, with a detail section which varies depending on the nature of the error. This might contain a CICS message, such as:

{
  "Fault": {
     "faultstring": "Conversion from SOAP failed",
     "detail": {
       "CICSFault": "DFHPI1007 02/14/2013 17:51:47 IYK2ZKE1 00185 XML to data
transformation failed because of incorrect input UNDEFINED_ELEMENT startItemRuff)
for WEBSERVICE json_inquireCatalogWrapper."
      }
  }
}