Rational Developer for System z

The fault message for an Invoke outbound Web service node

An Invoke outbound Web service node supports only one fault message, which by default is the WS_SOAPFAULT_AREA fault message.

The default fault message

When you import an outbound Web service definition, and an operations file and a message file are generated (see Importing an outbound Web service definition), the importer by default creates in the new operations file a reference to the fault message WS_SOAPFAULT_AREA.

The layout for this fault message is defined in the file IBMWS.sfmxsd, which appears in the Select a Message window of the mapping editor. The Select a Message window is opened when you select the Add Message Mapping Input entry or the Add Message Mapping Output entry from the contextual menu of the mapping editor. To see this message in the Select a Message window:
  1. In the left pane of the Select a Message window, expand the IBMWS entry.
  2. Select the IBMWS.sfmxsd entry. The WS_SOAPFAULT_AREA entry appears in the central pane.
  3. Select the WS_SOAPFAULT_AREA entry. The layout is displayed in the right pane.
The following table describes the fields in this fault message:
Field name: Description of the field:
WS_SOAPFAULT_CODE The SOAP fault code.
WS_SOAPFAULT_SUBCODE The SOAP fault subcode:
  • In SOAP 1.2 this field contains a subcode value.
  • In SOAP 1.1 this field is set to spaces.
WS_SOAPFAULT_NODE The URI of the SOAP node that generated the fault.
WS_SOAPFAULT_REASON The human-readable reason string.
WS_SOAPFAULT_DETAIL The human-readable detail information.

Typically, in the mapping editor, you would connect the additional output terminal for the fault message of an Invoke outbound Web service node as an input to one of the following:
  • To a Switch node, so that you can make a decision based on the data contained in the WS_SOAPFAULT_AREA message; or
  • To an Invoke node of some type, to handle the occurrence of a fault; or
  • To a Throw node or a Reply node, to end the flow.

Only one fault message

For an invocation of an outbound Web service, the service flow project tools allow a maximum of only one fault message . (By default this fault message is the WS_SOAPFAULT_AREA fault message, which is described in the preceding section of this topic).

Therefore:

All other types of invokes support multiple fault messages -- see Invoke nodes in the flow editor.


Terms of use | Feedback

This information center is powered by Eclipse technology. (http://www.eclipse.org)