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 pop-up menu of the mapping editor. To see this message in the Select a Message window:

In the left pane of the Select a Message window, expand the IBMWS entry.
Select the IBMWS.sfmxsd entry. The WS_SOAPFAULT_AREA entry appears in the central pane.
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:

In the operations editor, in an operation for invoking an outbound web service, the operations editor allows a maximum of only one fault message.
Note: In some cases the operations editor allows you to add more than one fault message. Nevertheless, only the first fault message is supported.
In the mapping editor, for an Invoke outbound web service node, the flow editor allows a maximum of only one additional output terminal for the fault message (see Invoke nodes in the flow editor).
When you generate runtime code for a flow that contains an Invoke outbound web service node, the runtime code that invokes the outbound web service supports only one fault message.

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