MSMQ Adapter Property Schema and Properties

The MSMQ adapter assigns values to context properties that you use in your applications. For a list of the send and receive properties in the MSMQ adapter, see How to Configure an MSMQ Receive Location and How to Configure an MSMQ Send Port.

Context Properties

The following table shows the context properties to which the MSMQ adapter assigns values.

Property Name Type Description Promoted
Acknowledgement xs:int Specifies the classification of acknowledgment that this message represents using the values in the System.Messaging.Acknowledgment enumeration. No
AcknowledgeType xs:int Specifies the type of acknowledgment message that the sending application requests. No
AdministrationQueue xs:string Specifies the name of the queue name that receives the acknowledgment message. No
AppSpecific xs:int Specifies application-specific information that you can use to organize different types of messages. Yes
ArrivedTime xs:dateTime Specifies the time that the message arrived in the destination queue. No
Authenticated xs:boolean Specifies whether the message was authenticated. No
BodyType xs:int Specifies the type of data that the message body contains. No
CertificateThumbPrint xs:string Specifies the thumbprint of the client certificate that you want to use for message authentication purposes. Yes
CorrelationId xs:string Specifies the message identifier used by acknowledgment, report, and response messages to reference the original message. Yes
EncryptionAlgorithm xs:int Specifies the encryption algorithm used to encrypt the body of a message. No
Id xs:string Specifies the message's identifier. No
Label xs:string Specifies an application-defined Unicode string that describes the message. Yes
MaximumMessageSize xs:unsignedInt Specifies the maximum message size in kilobytes for messages that you send to the specified queue. No
MessageType xs:int Specifies the message type. A Message Queuing message can be one of the following types:

- Normal, which is either a typical message sent from an application to a queue, or a response message returned to the sending application.
- Acknowledgement, which Message Queuing generates whenever the sending application requests one. For example, Message Queuing can generate positive or negative messages to indicate that the original message arrived or was read. Message Queuing returns the appropriate acknowledgment message to the administration queue specified by the sending application.
- Report, which Message Queuing generates whenever a report queue is defined at the source Queue Manager. When tracing is enabled, Message Queuing sends a report message to the Message Queuing report queue each time the original message enters or leaves a Message Queuing server.
Priority xs:int Specifies the message priority using the values defined in the System.Messaging.MessagePriority enumeration. Yes
Recoverable xs:boolean Specifies whether the message is guaranteed to be delivered in the event of a computer failure or network problem. No
ResponseQueue xs:string Specifies the queue that receives application-generated response messages. No
SegmentationSupport xs:boolean Specifies whether the segmentation of messages larger than 4 MB is supported. No
SentTime xs:dateTime Specifies the date and time on the sending computer that the message was sent by the source queue manager. No
SourceMachine xs:string Specifies the computer from which the message originated. No
TimeOut xs:int Specifies the time for the message to reach the destination queue before a time-out occurs. No
TimeOutUnits string Specifies the units for the TimeOut property. You can set the property to Days, Hours, Minutes, or Seconds. No
Transactional xs:boolean Specifies the behavior for transactional and non-transactional send ports and receive locations. No
UseAuthentication xs:boolean Specifies whether the message was (or must be) authenticated before being sent. No
UseDeadLetterQueue xs:boolean Specifies whether a copy of the message that could not be delivered should be sent to a dead-letter queue. No
UseJournalQueue xs:boolean Specifies whether a copy of the message should be kept in a machine journal on the originating computer. No
Password xs:string No


The Acknowledgement, AcknowledgeType, EncryptionAlgorithm, and MessageType properties use the integer-equivalent values of the enumerations in the System.Messaging namespace. For more information about these values, see "System.Messaging Namespace" in .NET Framework Class Library Help.


If you need to develop a BizTalk project that will make use of the MSMQ adapter context properties, the BizTalk project must contain a reference to the file Microsoft.BizTalk.Adapter.MSMQ.MsmqAdapterProperties.dll located in the BizTalk Server installation directory.

Message Labels

You can use the Message Queuing Label property in filters by adding a reference to Microsoft.BizTalk.Adapter.MSMQ.MsmqAdapterProperties.dll and selecting the property in the Filter dialog box. You can also use the property in other contexts because the MSMQ adapter automatically adds it to the message context.

See Also

Configuring the MSMQ Adapter