Use the CallableInput node to split message flow processing. A message flow that contains a CallableInput node can be called by a message flow in another location.
You can split message flows so that you do processing in different locations. You can split your processing between different locations in IBM® Integration Bus, or between IBM Integration Bus and IBM Integration Bus on Cloud. You can split your flows between different applications in the same integration server, or between different integration servers, which can be in different integration nodes. A calling flow processes information in one location, then calls another flow in another location. The calling flow includes a CallableFlowInvoke node, which calls a CallableInput node in a second (callable) flow. When the message is processed by the callable flow, a CallableReply node returns message body and local environment folder data to the CallableFlowInvoke node in the original flow.
You specify an endpoint name on the CallableInput node of the callable flow. The CallableFlowInvoke node calls the correct callable flow by specifying the application that contains the callable flow, and the endpoint name that is specified on the CallableInput node. Therefore, you must deploy all callable flows in applications.
Application and endpoint name pairs must be unique on a single integration server. You can have multiple callable flows that share the same application and endpoint names, but they must be in different integration servers. In this case, the Switch server acts as a load balancer.
The CallableInput node is contained in the Callable Flow drawer of the palette, and is represented in the IBM Integration Toolkit by the following icon:
When you have put an instance of the CallableInput node into a message flow, you can configure it; see Configuring a message flow node. The properties of the node are displayed in the Properties view. All mandatory properties for which you must enter a value (those that do not have a default value defined) are marked with an asterisk.
Terminal | Description |
---|---|
Failure | The output terminal to which the message is routed if a failure is detected during processing. |
Out | The output terminal to which the compound message is routed when processing completes successfully. |
Catch | The output terminal to which the message is routed if an exception is thrown downstream and then caught by this node. |
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).
Property | M | C | Default | Description |
---|---|---|---|---|
Node name | No | No | The node type (CallableInput) | The name of the node. |
Short Description | No | No | A brief description of the node. | |
Long Description | No | No | Text that describes the purpose of the node in the message flow. |
Property | M | C | Default | Description |
---|---|---|---|---|
Endpoint name | Yes | No | A name that identifies the callable message flow. A CallableFlowInvoke node uses this name to call this message flow. This name is case sensitive and must match the Target Endpoint Name property of the CallableFlowInvoke node. |
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. |