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 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.
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:
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.
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:
|
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:
|
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:
|
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:
|
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.
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 |
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. |
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. |