IBM Integration Bus, Version 10.0.0.9 Operating Systems: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS


SCAAsyncRequest node

Use the SCAAsyncRequest node with the SCAAsyncResponse node to construct a pair of message flows that invoke a WebSphere® Process Server service component asynchronously.

The SCAAsyncRequest node is available in the following operation modes:
  • Developer
  • Application Integration Suite
  • Standard
  • Advanced
  • Scale
  • Adapter
For more information, see Operation modes.
This topic contains the following sections:
Note: From Version 7.5 onwards, WebSphere Process Server has been renamed IBM® Business Process Manager Advanced. Information in this topic that refers to WebSphere Process Server Version 7.0 is also applicable to IBM Business Process Manager Advanced Version 7.5.

Purpose

The SCAAsyncRequest node sends a request to a business process that is running on WebSphere Process Server, but the node does not wait for the associated response to be received. However, the SCAAsyncRequest node does wait for an acknowledgment before continuing with the message flow. The response to the Process Server request is received by the SCAAsyncResponse node, which can be in the same message flow or in a separate message flow. The nodes are used as a pair, and correlate responses against the original requests.

Diagram showing the relationship between the SCAAsynchronousRequest node and the SCAAsynchronousResponse node.

The SCAAsyncRequest node is the first half of the asynchronous request and response node pair. The SCAAsyncRequest node sends a request to a business process that is running on WebSphere Process Server. The request is sent by the SCAAsyncRequest node, but the SCAAsyncRequest node does not receive the response. The response is received by a SCAAsyncResponse node that is running on a different thread. The SCAAsyncResponse node is typically at the beginning of a different message flow; however, it must be in the same integration server as the SCAAsyncRequest node.

An IBM Integration Bus SCA definition is required to configure both the SCAAsyncRequest node and the SCAAsyncResponse node. The IBM Integration Bus SCA definition contains specific data related to the Process Server binding.

If an MQ binding is specified in the SCA definition, WebSphere MQ is used to process the messages, which means that WebSphere MQ must be installed on the same computer as the integration node. You must also specify a queue manager on the integration node by using the -q parameter of the mqsicreatebroker or mqsichangebroker command. WebSphere MQ is not provided as part of the IBM Integration Bus installation package, but your license for IBM Integration Bus entitles you to install and use WebSphere MQ. For more information about using WebSphere MQ with IBM Integration Bus, see Installing WebSphere MQ.

The SCAAsyncRequest node is contained in the SCA drawer of the palette, and is represented in the IBM Integration Toolkit by the following icon:

SCAAsyncRequest node icon

Terminals and properties

The SCAAsyncRequest node terminals are described in the following table.

Terminal Description
In The input terminal that accepts a message.
Failure The output terminal to which the message is sent if a failure is detected in the node.
Out The output terminal to which the message is sent after the node has successfully sent the message to the SCA resource.

The following tables describe the node properties. The column headed M indicates whether the property is mandatory (marked with an asterisk if you must enter a value when no default is defined); the column headed C indicates whether the property is configurable (you can change the value when you add the message flow to the BAR file to deploy it).

The Description properties of the SCAAsyncRequest node are described in the following table.

Property M C Default Description
Node name No No The node type The name of the node.
Short description No No None A brief description of the node.
Long description No No None Text that describes the purpose of the node in the message flow.

The Basic properties of the SCAAsyncRequest node are described in the following table.

Property M C Default Description
Unique identifier Yes Yes Not set The property specifies a unique identifier that is common to your pair of SCAAsyncRequest and SCAAsyncResponse nodes.
IBM Integration Bus SCA definition Yes Yes Not set The property specifies the name of the IBM Integration Bus SCA definition that contains configuration properties for the SCAAsyncRequest node. You can click Browse to see a list of all relevant IBM Integration Bus SCA definitions in the current workspace.

The Binding property of the SCAAsyncRequest node is described in the following table.

Property M C Default Description
Binding type Yes No From SCA export This property is read-only. It is supplied by the IBM Integration Toolkit when the SCA export configuration file is parsed. The property describes the binding type that was found in the IBM Integration Bus SCA definition.

If the binding is web services, only the WSDL properties are shown. If the binding is MQ, only the MQ properties are shown. For more information about using WebSphere MQ with IBM Integration Bus, see Installing WebSphere MQ.

The WSDL properties are described in the following table. These properties are shown on the Binding tab when the binding type is set to WebService.

Note: The values for the properties must be supplied on the node. They are not marked as mandatory on the node because the IBM Integration Bus SCA definition might not contain all the property values, resulting in node errors being shown. You must supply values for those properties that have not been configured by the IBM Integration Bus SCA definition file.
Property M C Default Description
WSDL file name Yes No Not set The WSDL file name is taken from the WSDL file that is referenced by the IBM Integration Bus SCA definition.
Target namespace No No From IBM Integration Bus SCA definition This property type is String. It is supplied by the IBM Integration Toolkit when the WSDL configuration file that is referenced by the IBM Integration Bus SCA definition is parsed.
Port type Yes No By default, the Port type that is referenced in the IBM Integration Bus SCA definition. This property type is String. This property is read-only.
Error Conditions:
  • The selected Port type does not contain at least one operation.
Imported binding Yes No From IBM Integration Bus SCA definition This property type is String. It is supplied by the IBM Integration Toolkit when the WSDL that is referenced by the IBM Integration Bus SCA definition is parsed.
Error Conditions:
  • No SOAP bindings (with HTTP transport) in the WSDL file are associated with the Port type.
  • The selected binding does not have any operations.
Operation Yes No From IBM Integration Bus SCA definition This property type is String.

The Operation property lists the operations that are defined by the port type. The first two-way operation in the list is selected by default.

Only two-way operations are supported.
Service port Yes No From IBM Integration Bus SCA definition This property type is String. It is supplied by the IBM Integration Toolkit when the WSDL configuration file is parsed.
Error Conditions:
  • No ports point to the selected binding.
Web service URL Yes Yes From IBM Integration Bus SCA definition This property type is String. This property is automatically derived from the <soap:address> element of the selected Service port. Whenever the selected port is updated, the Web service URL is updated accordingly. However, if you override the value, your value persists and the URL is no longer updated from the service port.
If you choose to override this property you must specify it in the form http://<hostname>[:<port>]/[<path>] where:
  • http://<hostname> must be specified.
  • <port> has a default of 80. If you specify a value, you must include the : before the port number.
  • <path> has a default of /. If you specify a value, you must include the / before the path.
SSL client authentication key alias No Yes "" (empty string) The keyAlias property specifies an SSL authentication key alias for the client-side of an SCAAsyncRequest connection. Taking the default value means that the first appropriate key is chosen for you automatically.
Enable certificate revocation list checking No Yes Not selected This property specifies whether CRL checking should be enabled for SSL connections

The MQ properties are described in the following table. These properties are shown on the Binding tab when the binding type is set to MQ.

Note: The values for the properties must be supplied on the node. They are not marked as mandatory on the node because the IBM Integration Bus SCA definition might not contain all the property values, resulting in node errors being shown. You must provide values for those properties that have not been configured by the IBM Integration Bus SCA definition file.
Property M C Default Description
Operation Yes No From the IBM Integration Bus SCA definition The available operations that are found in the interface of the IBM Integration Bus SCA definition. Only two-way operations are supported.
Queue name Yes Yes From the IBM Integration Bus SCA definition The name of the queue that receives a request message from IBM Integration Bus. This is taken from the IBM Integration Bus SCA definition, but can be updated directly in the node.

This can be a remote queue; see "How does distributed queuing work?" in the Intercommunication section of the WebSphere MQ product documentation.

Queue manager name Yes Yes From the IBM Integration Bus SCA definition The name of the queue manager that receives a message from IBM Integration Bus. It is taken from the IBM Integration Bus SCA definition, but can be updated directly in the node.

If a remote queue is used, leave this property blank to allow WebSphere MQ to resolve the queue manager name.

Reply-to queue name Yes Yes From the IBM Integration Bus SCA definition The name of the queue that receives a response message from WebSphere Process Server. It is taken from the IBM Integration Bus SCA definition, but can be updated directly in the node.
Reply-to queue manager name No Yes From the IBM Integration Bus SCA definition The name of the queue manager that receives a response from WebSphere Process Server. It is taken from the IBM Integration Bus SCA definition, but can be updated directly in the node.

This queue manager must be local to the integration node.

Response message correlation Yes No From the IBM Integration Bus SCA definition This property indicates how WebSphere Process Server provides correlation ID information in the response message. This correlation information is used by the IBM Integration Bus to determine which message is a response to which request, and is supplied by the IBM Integration Toolkit when the SCA export file is parsed.

Select From Message ID if the WebSphere Process Server is expected to copy the MQMD MSGID field in the request to the MQMD CORRELID field in the response.

Select From Correl ID if the WebSphere Process Server is expected to copy the MQMD CORRELID field in the request to the MQMD CORRELID field in the response.

The Transactionality property of the SCAAsyncRequest node is described in the following table.

Property M C Default Description
Transaction mode No No For MQ, 'yes' This property can be 'automatic', 'no', or 'yes'. The property is enabled only when the Binding type is MQ.
The Monitoring properties of the node are described in the following table.
Property M C Default Description
Events No No None Events that you have defined for the node are displayed on this tab. By default, no monitoring events are defined on any node in a message flow. Use Add, Edit, and Delete to create, change or delete monitoring events for the node; see Configuring monitoring event sources by using monitoring properties for details.

You can enable and disable events that are shown here by selecting or clearing the Enabled check box.


ac68530_.htm | Last updated 2017-07-17 12:45:01