Properties Related to BizTalk Server

The MQSeries adapter assigns values to some context properties that are not directly related to MQSeries but are still useful in your applications.

All the properties receive values during sending and receiving except for BizTalk_CorrelationID. The BizTalk_CorrelationID property has a value only during receiving.

Name Type Description
BizTalk_CorrelationID string Use this property to have the MQSeries server generate a correlation identifier for use with the message.

For more information, see Correlating Messages Using Request-Reply.
DataConversion string Converts the message to the ANSI code page of MQSeries Server for Windows. On Send, if the message format is not MQFMT_STRING, there is no conversion.

Select Yes to perform this conversion from Unicode to ANSI.

Default: No
Ordered string Sets MQSeries to maintain the order of the messages as they are received from or sent to the MQSeries queue.

The property has different sets of values for sending and receiving. For information about the values, see. How to Configure MQSeries Adapter Receive Locations and Send Ports.

Default: No
SegmentationAllowed string Sets MQSeries to assemble segmented messages or to get the message as is. The property has different sets of values for sending and receiving.

When receiving, use No Action to read messages from the MQSeries queue without enabling segmentation; use Complete Message to have MQSeries assemble segmented messages before passing them on to the adapter.

Default: No Action

When sending, select Yes, to have MQSeries put segmented messages in the queue.

Default: No
SSOAffiliateApplication string Sets the Single Sign-On (SSO) affiliate application. You use the user ID and password from SSO for the MQMD_UserIdentifier, and the MQIIH_Authenticator (or MQCIH_Authenticator) property respectively.

Used only when sending messages.

Default: Blank
CompleteMessage string Designates whether to retrieve "complete message" when retrieving segmented messages from a queue.

Set this to Yes to retrieve the "complete message" for segmented messages in a queue.

Default: No
DynamicReceive string Designates whether to receive messages from a queue dynamically.

Set this to Yes when receiving messages from a queue dynamically. This feature is used in conjunction with a solicit-response send port.

If you specify match options (MessageID, CorrelationID, or GroupID), then only messages that correlate to the match criteria will be retrieved.
TransactionSupported string The adapter begins a Microsoft Distributed Transaction Coordinator (DTC) transaction between BizTalk Server and MQSeries Server. When set to No, there is no guarantee of message delivery.

Default: Yes
WaitInterval string Specifies the approximate time, expressed in seconds, that the MQ system waits for a suitable message to arrive. If no suitable message has arrived in this time, the call fails. Note: This can be set within an orchestration only.

Default: 3

See Also

MQSeries Adapter Properties
Data Type Conversion of Properties
MQSeries Context Properties