tMomConnection – Docs for ESB 5.x

Component family

Internet

Function

tMomConnection opens a connection
to the MQ Server.

Purpose

This component opens a connection to the MQ Server for
communication.

Basic settings

Failover

Select this check box to define multiple MQ servers for failover
in the displayed server address table.

This check box appears only when ActiveMQ is selected from the MQ server drop-down list.

MQ server

Select the type of the MQ server(s) to be connected from the
drop-down list, either ActiveMQ or
WebSphere MQ.

Host

IP address of the MQ server.

Port

Listening port of the MQ server.

Username and Password

User authentication credentials.

To enter the password, click the […] button next to the
password field, and then in the pop-up dialog box enter the password between double quotes
and click OK to save the settings.

Use Transacted

Select this check box to set the session created to be
transacted.

This check box appears only when ActiveMQ is selected from the MQ server drop-down list.

Channel

Specify the name of the channel through which the data connection
is established. The default value is
DC.SVRCONN.

This field appears only when WebSphere
MQ is selected from the MQ
server drop-down list.

QueueManager

Specify the name of the queue manager to which the data connection
is established.

This field appears only when WebSphere
MQ is selected from the MQ
server drop-down list.

Use or register a shared Connection

Select this check box to share your connection or use a connection
shared by a parent or child Job. This allows you to share one single
connection among several connection components from different Job
levels that can be either parent or child.

Shared Connection Name

Enter the shared connection name.

This field appears only when the Use or
register a shared Connection check box is
selected.

Advanced settings

Additional options

Define the failover transport options in the table. This table is
available only if you select the Failover check box in the Basic settings view.

For example, enter maxReconnectAttempts in the Option name field and then 0 in the Option
value field so that no attempt is made to retry the
connection when no server is available for the failover mode.

For more information about the transport options, see http://activemq.apache.org/failover-transport-reference.html.

tStatCatcher Statistics

Select this check box to collect log data at the component
level.

Global Variables

ERROR_MESSAGE: the error message generated by the
component when an error occurs. This is an After variable and it returns a string. This
variable functions only if the Die on error check box is
cleared, if the component has this check box.

A Flow variable functions during the execution of a component while an After variable
functions after the execution of the component.

To fill up a field or expression with a variable, press Ctrl +
Space to access the variable list and choose the variable to use from it.

For further information about variables, see Talend Studio
User Guide.

Usage

This component is more commonly used with other tMom* components,
especially with the tMomCommit and
tMomRollback components.

Log4j

The activity of this component can be logged using the log4j feature. For more information on this feature, see Talend Studio User
Guide.

For more information on the log4j logging levels, see the Apache documentation at http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html.

Limitation

This component supports ActiveMQ and WebSphere MQ servers.