How to Configure an MSMQ Send Port

You can set MSMQ send port adapter variables in the BizTalk Server Administration console. If properties are not set for the send port, the default send handler values set in the BizTalk Server Administration console are used.

Important

If a host instance is associated with an MSMQ send port or receive location, verify the MSMQ service is running on that machine. If the service is not running, the MSMQ receive ports will shut down shortly after they are started, and messages sent to the MSMQ send ports will be suspended.

In a clustered scenario, not only does the clustered MSMQ instance need to be running, but the local MSMQ service on each cluster machine should be running, as well.

To configure variables for an MSMQ send port

Follow these steps to configure variables for an MSMQ send port:

1. In the BizTalk Server Administration console, create a new send port or double-click an existing send port to modify it. See How to Create a Send Port for more information. Configure all of the send port options. On the General tab, in the Transport section, specify MSMQ for the Type option.

2. On the General tab, in the Transport section, click the Configure button next to Type.

3. In the MSMQ Transport Properties dialog box, do the following:

   Use this property	To do this	Data type	Default value
   Password	Specify the password for a remote queue. Use with User Name.	String	Blank
   User Name	Specify the user name for a remote queue. Use with Password. You cannot use the local user of the remote computer for the user name.	String	Blank
   Acknowledgement Type	Specify the type of acknowledgement message for Message Queuing to return to the sending application. You can select more than one acknowledgment type. Any of the acknowledgement types in the System.Messaging.AcknowledgeTypes enumeration are available.	String	None
   Administration Queue	Specify the queue name that receives the acknowledgement message.	String	Blank
   Body Type	Specify the message body type in MSMQ. Valid values are members of the .NET VarEnum enumeration.	Int	8209
   Certificate Thumbprint	Specify the thumbprint of the certificate to use for message authentication. Use this property in combination with the Use Authentication property to verify the message. Use the User Name and Password properties to gain access to queues.	String	Blank
   Destination Queue	Specify the destination queue. For more information about queues, see Message Queuing Queues. Note: The URI for a send port or receive location cannot exceed 256 characters.	String	Blank
   Encryption Algorithm	Select RC2, RC4, or None for the encryption algorithm.	Enum	None
   Maximum Message Size (in kilobytes)	Specify the maximum message size for messages that you send to the specified queue.	UnsignedInt	1024
   Message Priority	Set the message priority.	Enum	Normal
   Recoverable	Specify whether to guarantee the recoverability of a message.	Boolean	False
   Support Segmentation	Set this Boolean property value to True to segment messages larger than 4 MB.	Boolean	False
   Timeout	Specify the maximum time to wait for the messages to reach the destination queue. Applies only when you use transactions.	Int	0
   Timeout Unit	Set the unit to use for the Timeout property. Select Days, Hours, Minutes, or Seconds.	Enum	Days
   Transactional	Set this value to True to send messages if you use transactions.	Boolean	False
   Use Authentication	Set this Boolean property value to True to control authentication. Use this property in combination with the Certificate Thumbprint property to verify the message. Use the User Name and Password properties to gain access to queues.	Boolean	False
   Use Dead Letter Queue	Set this value to True to send messages to the dead letter queue if a failure occurs.	Boolean	True
   Use Journal Queue	Set this value to True to save a copy of the message whenever the message is processed.	Boolean	False

4. Click OK and OK again to save settings.

See Also

How to Configure an MSMQ Receive Location
Configuring the MSMQ Adapter