Contents

The MSMQReceiver component is used to receive messages from MSMQ. The component supports different formatters used by sending client applications to serialise object messages written to queue. The name of the queue from which a message needs to be retrieved can be specified using the Configuration Property Sheet (CPS).

Points to note

  • If a queue specified in the CPS does not exist in a local or remote MSMQ server, it is not automatically created.
  • This component runs only on Windows Platform.
  • This component requires Microsoft .NET Framework 3.5 or above installed on the machine where peer server is running.
  • To receive messages sent from MSMQSender component, configure the component for ActiveXMessageFormatter.
  • The component returns message content as it is for messages whose body is of String type and for other types uses XMLSerializer to serialize objects into XML format and return the content. Hence the component supports receiving messages of types that can be serialized/deserialized using XMLSerializer. For more information on XMLSerializer refer to http://msdn.microsoft.com/en-us/library/system.xml.serialization.xmlserializer.aspx
  • Transactional remote receive can be performed in the context of a local Distributed Transaction Coordinator (MS DTC) transaction.

Configuration

The MSMQ server, queue and formatters can be configured in the CPS.


Figure 1: MSMQReceiver5.0 Configuration CPS

Error Configuration

Error Handling Configuration

Please refer Error Handling section Common Configurations  page.for details.

Connection Configuration

Use Connection Details from input

If 'yes', adapter will use configuration details from input request, if any property is not provided, corresponding value provided in this panel will be used. This is an Expert Property.

Server Name

Provide MachineName in case of OS protocol, IPAddress in case of TCP protocol and NetworkNumber; HostNumber in case of SPX.

Queue Name

Name of the Queue to which a component needs to be connected to.

Queue Type

Name of the Queue to which a component needs to be connected to; choose form the following options available:

  • private
  • public
Protocol

Protocol to be used. Use 'OS' to access with MachineName and 'TCP' to access with IPAddress.

Options available are:

  • OS
  • TCP
  • SPX
Icon
  • SPX is valid in case of Windows NT or Windows 2000 only.
  • SPX works only with MSMQ version 3.0 or higher.
Transaction

Specifies whether the queue is transacted or not.

Using Transactional Remote Receive

 

To use transactional remote receive, you need to configure both the Queue Computer and the Client Computer to enable network DTC access. The steps to do this are as follows:

  1. Open the Control Panel, open Administrative Tools, and open Component Services
  2. In Component Services, in the left pane, click the Component Services node, then click the Computers node. In the right pane, right-click My Computer and select Properties from the context menu. This will open the My Computer Properties dialog box.
  3. In the My Computer Properties dialog box, select the MSDTC tab, and click the Security Configuration... button in the Transaction Configuration group at the lower left. This will open the Security Configuration dialog box.
  4. In the Security Configuration dialog box, check the Network DTC Access checkbox. This will enable the Client and Administration and Transaction Manager Communication groups.

To enable Network DTC and configure Windows firewall on Windows7 or Windows Server 2008 R2

  1. Click Start, click Run, type dcomcnfg and then click OK to open Component Services.
  2. In the console tree, click to expand Component Services, click to expand Computers, click to expand My Computer, click to expand Distributed Transaction Coordinator and then click Local DTC.
  3. Right click Local DTC and click Properties to display the Local DTC Properties dialog box.
  4. Click the Security tab.
  5. Set the following options on the Security tab of the Local DTC Properties dialog box and click OK.
  6. In the Transaction Manager Communication group, check the Allow Inbound and Allow Outbound check boxes, and select the Mutual Authentication Required radio button.
  7. Click OK to close the Security Configuration dialog box. This will pop up a DTC Console Message dialog box that asks if you want to stop and restart the MS DTC service. Click Yes.
  8. Click OK to close the My Computer Properties dialog box.

You also need to configure Windows Firewall to add MS DTC to the list of exceptions. The steps to do this are as follows:

  1. Open the Control Panel and open Windows Firewall.
  2. In the Windows Firewall dialog box, select the Exceptions tab.
  3. Click the Add Program button and add Msdtc.exe, which is typically found in your Windows\System32 directory.

Message Configuration

Receive mode, type of formatter to be used to receive messages and associated properties are to be configured here.

Receive Operation Mode

Select Asynchronous mode to receive messages as soon as it is available on queue. In synchronous mode, one message will be read from queue after receiving input or after every configured interval in case of scheduling mode.


Figure 2: Message Configuration section with Asynchronous mode selected

Icon
  • In case of Asynchronous mode, the only property under Message Configuration that remains is the Message Formatter property.
  • Scheduling is not possible in Asynchronous mode and hence Scheduling Configuration section also does not appear.
Should wait ?

Select 'yes' to wait for specified period or no for infinite time while receiving message.

Icon

This property appears only if the Receive Operation Mode property is set to 'Synchronous'.


Figure 3: Message Configuration section with 'Should Wait?' property set as 'yes'

Wait time (milli sec)

Time period to wait before appropriate action to be taken

Icon

This property appears only if the Should Wait? property is 'yes'.

 

Action when message is not available

Action to be taken when message is not available on queue before the specified time out, in case of EMPTY_MESSAGE_ACTION empty message will be sent to output port, an error will be sent to error port in case of ERROR_ACTION

Icon

This property appears only if the Should Wait? property is 'yes'.

Message Formatter

Type of formatter to be used. MSMQReceiver supports three type of formatters.

  • ActiveXMessageFormatter
    This formatter has to be used to receive messages whose body are serialised using a format that is compatible with the MSMQ ActiveX Component. The ActiveXMessageFormatter is compatible with messages sent using Message Queuing COM components, allowing interoperability with applications that use the MSMQ COM control. MSMQReceiver component supports only primitive data types for ActiveXMessageFormatter
  • BinaryMessageFormatter
    This formatter has to be used to receive messages whose body are serialised using a binary format. The BinaryMessageFormatter is very efficient and can be used to serialize most objects. The objects which are marked as serializible can be used with this formatter. With MSMQReceiver component to receive messages of non primitive data types, Assembly(dll) containing the particular class type should be explicitly added as a resource to the component. The component after receiving the message, will output object content in XML Format
  • XMLMessageFormatter
    This formatter has to be used to receive messages whose body are serialised using a XML format. The XmlMessageFormatter is the default formatter that an instance of MessageQueue uses to serialize messages written to the queue. With MSMQReceiver component to receive messages of non primitive data types, Assembly(dll) containing the particular class type whose schema matches to the sender type should be explicitly added as a resource to the component. The name of the assembly and comma seperated fully namespace qualified class names (e.g com.fiorano.TestMessage) or primitive type names(string, int etc) should be provided in Assembly Name and Class Name properties respectively in the CPS of the component. The component after receiving the message, will output object content in XML Format


Figure 4: Message Configuration section with 'Message Formatter' property set as 'XMLMessageFormatter'

Assembly Name

Name of the assembly (along with extension, that is, Test.dll) containing class types that will be available on queue.

Icon
  • This property appears only when Message Formatter property is set to 'XMLMessageFormatter'.
  • This property is not required if messages of primitive data types are to be received.
Class Name

Comma-separated values of Namespace qualified class name of possible message types (e.g: fiorano.csharp.Test, string). In case of primitive data types, provide keywords of corresponding type (like string, int).

Icon

This property appears only when Message Formatter property is set to 'XMLMessageFormatter'.

Scheduling Configuration

Please refer the respective section in the MSMQSender5.0 page for the information about this property.

Input Schema

The input schema is auto generated on input port for SYNCHRONOUS receive operation and when the property "Use Connection Details from input" is set to "yes" as shown below


Figure 5: Input Schema.


Figure 6: Sample Input XML

Functional Demonstration

Scenario 1

Receive messages from a local MSMQ Server.
Configure the MSMQ Receiver in scheduling mode and provide required assemblies for XMLMessageFormatter and use Display component to check the response.


Figure 7: Sample Output


Figure 8: Demonstrating Scenario 1 with sample output.

Adaptavist ThemeBuilder EngineAtlassian Confluence