Edit

Share via

Setting Up a Send Port for Receiving ACKs

  • Article

Microsoft BizTalk Accelerator for HL7 (BTAHL7) can receive acknowledgments (ACK) on a one-way send port. When you set up a new one-way send port for receiving ACKs on the same connection, you must associate that send port with a one-way receive port.

BTAHL7 setup creates a one-way receive port (called TwoWayAckReceivePort) and receive location (called TwoWayAckReceiveLocation). The receive location uses the Minimal Lower Layer Protocol (MLLP) transport type, has a URI of "127.0.0.1:65535", and uses the BTAHL72XReceivePipeline. These are the settings required for receiving and processing an ACK received against a message sent out by the BTAHL7 send adapter, in two-way mode. This receive location should not be deleted or used for any other purposes. Never send data to this receive location. BTAHL7 enables this receive location by default.

TwoWayAckReceiveLocation, which the BTAHL7 Setup Wizard creates, uses the BizTalkServerApplication as the receive handler. However, if you choose to create a new host and use it as the receive handler for MLLP, then you must do the following to create a new TwoWayAckReceiveLocation:

  1. Create a one-way receive port.

  2. Create a one-way MLLP receive location.

  3. Specify the appropriate values for the MLLP transport properties.

  4. Specify the appropriate receive handler.

  5. Enable the receive location.

To create a send port enabled to receive an ACK on the same socket

  1. Open the BizTalk Administration Console, and then expand BizTalk Server Administration, BizTalk Group, Applications, and BizTalk Application 1. Right-click Send Ports, point to New, and then click Static One-way Send Port.

  2. In the Name box, type the name of the send port.

  3. In the Transport section, for Type, select MLLP.

  4. Click Configure.

  5. In the MLLP Transport Properties dialog box, type a connection name and host (for instance, localhost).

  6. For Solicit Response Enabled, select Yes. Leave Submit Receive Location (URI) for ACK blank, and then click OK.

    Note

    When you leave Submit Receive Location blank, BTAHL7 enters the URI for the default TwoWayAckReceiveLocation. You can verify that after clicking OK in step 6, by clicking Configuration again. The URI for TwoWayAckReceiveLocation (127.0.0.1:65535) will be entered in Submit Receive Location (URI) for ACK.

    Note

    You must create a send port to subscribe to the ACK received, or the ACK will be seen in a suspended state, because no subscriptions were found. To subscribe to the ACK received by the send port, use filters, for example, BTS.MessageType == <MessageType> and BTS.ReceivePortName == <ReceivePort>. For static ACKs, the message type is StaticAck.

  7. Click OK.

See Also

Creating and Processing Acknowledgments
ACK Message Schema Types
Message Acknowledgment Segment
Acknowledgment Error Conditions