tMicrosoftMQInput Properties - 6.1

Talend Components Reference Guide

Talend Big Data
Talend Big Data Platform
Talend Data Fabric
Talend Data Integration
Talend Data Management Platform
Talend Data Services Platform
Talend ESB
Talend MDM Platform
Talend Open Studio for Big Data
Talend Open Studio for Data Integration
Talend Open Studio for Data Quality
Talend Open Studio for ESB
Talend Open Studio for MDM
Talend Real-Time Big Data Platform
Data Governance
Data Quality and Preparation
Design and Development
Talend Studio

Component family

Internet/MOM and JMS



This component retrieves the first message in a given Microsoft message queue (only support String).


This component allows you to fetch messages one by one in the ID sequence of these messages from the Microsoft message queue. Each execution retrieves only one message.

Basic settings

Property type

Always Built-in. Its schema has only one read-only column of string type: message.



Built-in: No property data stored centrally. Enter properties manually



Repository: Select the repository file where properties are stored. The fields that come after are pre-filled in using the fetched data.



Type in the Host name or IP address of the host server.



Enter the queue name you want to retrieve messages from.


Queue type

Select a Microsoft message queue type from the drop-down list.

  • Private: a private queue, which is registered on the local machine.

  • Public: a public queue, which is registered in the directory service.

For more information about Microsoft message queue types, see


Die on error

This check box is cleared by default, meaning to skip the row on error and to complete the process for error-free rows.

Advanced settings

tStatCatcher Statistics

Select this check box to gather the Job processing metadata at a Job level as well as at each 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.


This component is generally used as a start component of a Job or Subjob. It must be linked to an output component.


Outgoing links (from this component to another):

Row: Main, Iterate

Trigger: Run if; On Subjob Ok, On Subjob Error, On Component Ok; On Component Error.

Incoming links (from one component to this one):

Row: Iterate;

Trigger: Run if, On Subjob Ok, On Subjob Error, On Component Ok, On Component Error.

For further information regarding connections, see Talend Studio User Guide.


This component supports only String type. Also, it only works with the Windows systems.

This component requires installation of its related jar files. For more information about the installation of these missing jar files, see the section describing how to configure the Studio of the Talend Installation Guide.