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

See information about the latest product version

TwineballInput node

Use the TwineballInput node to discover how the WebSphere® Adapters nodes work.

This topic contains the following sections:

Purpose

The TwineballInput node is provided for educational purposes and helps you to see how the WebSphere Adapters nodes work. The TwineballInput node is a sample node with its own sample EIS. You cannot use the TwineBall nodes to connect to the external SAP, Siebel, and PeopleSoft EIS systems. Do not use this node in production.

The TwineballInput node is contained in the WebSphere Adapters drawer of the message flow node palette, and is represented in the IBM® Integration Toolkit by the following icon:

TwineBallInputnode icon

You can use the mqsisetdbparms command in the following format to configure an account name with a user name and password for the Twineball adapter.
mqsisetdbparms broker name -n adapter name -u user name -p password
For example:
mqsisetdbparms BRK1 -n eis::TwineballInbound.inadapter -u mqbroker -p ********
Look at the following sample to see how to use this node:

You can view information about samples only when you use the product documentation that is integrated with the IBM Integration Toolkit or the online product documentation. You can run samples only when you use the product documentation that is integrated with the IBM Integration Toolkit.

Terminals and properties

When you have put an instance of the TwineballInput 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. If you double-click a TwineballInput node, you open the Adapter Connection wizard. All mandatory properties for which you must enter a value (those that do not have a default value defined) are marked with an asterisk.

The TwineballInput node terminals are described in the following table.

Terminal Description
Out Business object events from the adapter are sent to the Out terminal.
Failure If an error happens in the TwineballInput node, the message is propagated to the Failure terminal. Information about the error, and business object events can also be propagated to the Failure terminal.
Catch Business object events are sent to the Catch terminal if they cause an uncaught exception in the message flow. If the Catch terminal is not connected, the retry process is activated to handle the business object.

The following table describes 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 at deployment).

The TwineballInput node Description properties are described in the following table.
Property M C Default Description
Node name No No The node type, TwineballInput. 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.
The TwineballInput node Basic properties are described in the following table.
Property M C Default Description mqsiapplybaroverride command property
Adapter component Yes Yes   The name of the adapter component that contains configuration properties for the adapter. Either enter a name of an adapter file or click Browse to select an adapter file from the list of files that are available in referenced message set projects. adapterComponent
The TwineballInput node Routing properties are described in the following table.
Property M C Default Description
Set destination list No No Selected This property specifies whether to add the method binding name to the route to label destination list. If you select this check box, the method binding name is added so that you can use a RouteToLabel node in the message flow after the TwineballInput node.
Label prefix No No   The prefix to add to the method name when routing to label. Add a label prefix to avoid a clash of corresponding label nodes when you include multiple WebSphere Adapters input nodes in the same message flow. By default, there is no label prefix, so that the method name and label name are identical.
The TwineballInput node Input Message Parsing properties are described in the following table.
Property M C Default Description
Message domain No No DataObject The domain that is used to parse the incoming message. By default, the message that is propagated from the TwineballInput node is in the DataObject domain. You cannot specify a different domain.
Message set Yes No Set automatically The name of the message set in which the incoming message is defined. This field is set automatically from the Adapter component property.

If you set this property, then subsequently update the project dependencies to remove this message set reference, a warning is issued. Either update the Message set property, or restore the reference to this message set project.

Message type No No   The name of the incoming message. The node detects the message type automatically. You cannot set this property.
Message format No No   The name of the physical format of the incoming message. You cannot set this property.
The TwineballInput node Transactional properties are described in the following table.
Property M C Default Description
Transaction mode No No Yes The transaction mode on this input node determines whether the rest of the nodes in the flow operate under sync point.
The Instances properties of the TwineballInput node are described in the following table. For a full description of these properties, see Configurable message flow properties.
Property M C Default Description mqsiapplybaroverride command property
Additional instances pool No Yes Use Pool Associated with Message Flow The pool from which additional instances are obtained.
  • If you select Use Pool Associated with Message Flow, additional instances are obtained from the message flow value.
  • If you select Use Pool Associated with Node, additional instances are allocated from the node's additional instances based on the number specified in the Additional instances property.
componentLevel
Additional instances No Yes 0 The number of additional instances that the node can start if the Additional instances pool property is set to Use Pool Associated with Node. By default, no additional instances are given to the node. additionalInstances
The TwineballInput node Retry properties are described in the following table.
Property M C Default Description mqsiapplybaroverride command property
Retry mechanism No No Failure This property specifies how retry processing is handled when a failure is rolled back to the TwineballInput node.
  • If you select Failure, retry processing is not performed so that you cannot set the remaining properties.
  • If you select Short and long retry, retry processing is performed first at the interval that is specified by the Short retry interval property, and if that is unsuccessful, it is then performed at the interval that is specified by the Long retry interval property.
 
Retry threshold No Yes 0 The maximum number of times that retry processing is performed for short retry. retryThreshold
Short retry interval No Yes 0 The interval between short retry attempts. shortRetryThreshold
Long retry interval No Yes 0 The interval between long retry attempts. longRetryThreshold
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 using monitoring properties for details.

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


ac37350_.htm | Last updated Friday, 21 July 2017