MSMQ output connector

This connector enables the StreamServer to integrate with Microsoft message queuing environments.

Comments

Public message queues are published in the Active Directory. Private message queues are not published in the Active Directory. They are accessible only by Message Queuing applications that know the full path name or format name of the message queue.

Queue Manager

The server of the MS Message Queue.

Queue Name

The MS Message Queue to which to transfer data. This MS Message Queue must belong to the Queue Manager specified above.

Private

Select to define the MS Message Queue as a private queue. Private message queues can be accessed even if the queue manager is off-line.

Max Message Size

The maximum size (bytes) for an MSMQ message. The maximum value allowed is 4194304. If the data sent from the StreamServer exceeds the maximum size, it will be split into several messages. These messages will be synchronized as follows:

•	The first message in the sequence will have the appspecific property set to the number of messages that will arrive in this sequence of segmented messages (the first message is excluded).

•	The following messages will have this number decreased by one and the last message in the sequence will have the appspecific property set to 0.

•	All messages, except the first one, will have their correlation ID property set to the message ID of the first message.

Runtime specific connector settings

Message Delivery

•	Express – The message is not stored on disk, and cannot be recovered in case of failure.

•	Persistent – The message is stored on disk, and can be recovered in case of failure.

Message Priority

The priority of the message.

Message Encryption

Select to enable message encryption. The encryption uses symmetric key and asymmetric (public/private) key encryption algorithms. Encryption slows down transfer of messages.

Message Journaling

Specifies the level of journaling. Journals provide audit trails.

•	MQMSG_JOURNAL_NONE – No journaling.

•	MQMSG_JOURNAL – Journaling enabled.

•	MQMSG_DEADLETTER – If the message is not delivered or read in time, it will be stored in a deadletter queue.

•	MQMSG_JOURNAL|MQMSG_DEADLETTER – Both journaling and deadletter functionality enabled.

Max Time to Reach Queue

The maximum time (seconds) for the message to reach the destination queue. If the message does not reach the destination queue within this time, and you have enabled one of the dead-letter options, the message will be moved to the dead-letter queue.

Max Time to Receive

The maximum time (seconds) to wait for the message to be read. If the message is not read within the specified time, and you have enabled one of the dead-letter options, the message will be moved to the dead-letter queue.

Message Tracing

Specifies the level of tracking. To enable message tracing, message route tracking must be enabled by defining a report queue for the sending party.

•	Tracing Off – No tracing of the progress of the message.

•	Tracing On – Progress of the message is traced.

Transaction Type

Specifies the transaction type. Transactional messages are either sent together and in the order they were sent (a committed transaction), or not sent at all (an aborted transaction). The receiving MSMQ queue must support transactions.

•	MQ_NO_TRANSACTION – The message will be sent without transactional support.

•	MQ_INTERNAL_TRANSACTION – The message will be sent within a transaction.

Message Label

A descriptive text to include in the message.