FIX: Er is een hotfix beschikbaar waarmee extra leveringsmethode eigenschappen voor de minimale lager Layer Protocol verzenden en ontvangen van adapters in BizTalk Accelerator voor HL7 in een omgeving met BizTalk Server 2010

Samenvatting

Dit artikel bevat een hotfix waarmee u twee extra leveringsmethode eigenschappen voor minimale onderste laag Protocol (MLLP) verzenden en ontvangen van poorten wanneer u de BizTalk Accelerator voor HL7 in een omgeving met Microsoft BizTalk Server 2010:

Bevestiging van MLLP Transport gebruiken

Deze eigenschap is beschikbaar in zowel eenrichtingsverkeer ontvangen en verzenden van unilaterale poorten.
Request-bericht onderbreking op Transport MLLP NAK

Deze eigenschap is alleen beschikbaar in één richting verzenden poorten.

De MLLP ontvangen adapter ondersteunt beide modi eenrichtingssynchronisatie en tweerichtingssynchronisatie verzoek antwoord. Als de adapter ontvangen is geconfigureerd, HL7 verwerking gebruikt de parameter Besteld levering Dit zorgt ervoor dat de volgorde van de aflevering van berichten wordt gehandhaafd. Wanneer de MLLP ontvangen adapter werkt in twee richtingen modus, de adapter niet een nieuw bericht van de upstream-systeem ontvangt totdat de adapter genereert een bevestiging van de toepassing (MSA) voor het vorige bericht op de upstream-systeem. De gegenereerde ACK/NAK is verzonden naar de berichtendatabase vak (MessageBoxDB). De volgende polling-interval wacht MessageBoxDB voordat de ACK/NAK naar de upstream-systeem stuurt.

De upstream systeem stuurt slechts één bericht tegelijk en alleen nadat een ACK/NAK ontvangen. Bovendien is geconfigureerd met de BizTalk-polling-interval en de Levering van bestelde parameter is ingesteld op True. Dit betekent dat het aantal berichten dat wordt verwerkt per seconde beperkt wordt. Deze hotfix biedt voor aanvullende configuratie voor unilaterale verzenden en ontvangen van poorten. Dit heeft geen invloed op de ACK/NAK. Echter hoger wel veel het aantal documenten dat per seconde wordt verwerkt.

Prestatie-items moet u een basislijn nemen voordat en nadat u deze hotfix hebt toegepast. Wanneer u benchmark dient een redelijk aantal berichten over een redelijke termijn. U kunt bijvoorbeeld het volgende gebruiken:

Voor de BizTalk: Messaging categorie, gebruikt u de teller van Verwerkte documenten per seconde .
Voor de BizTalk: Messaging latentie categorie gebruikt alle beschikbare items.

Een optie voor het verhogen van het aantal documenten dat per seconde wordt verwerkt is het verlagen van de instelling van de MaxReceiveInterval voor de BizTalk-host. Afhankelijk van het algemene klimaat voor het afstemmen van de computer waarop Biz Talk Server 2010 en op het volume van de documenten die worden verwerkt door de instelling van de MaxReceiveInterval te verlagen kan hebben een nadelig effect op de prestaties van het exemplaar van SQL Server. Voor het afstemmen van SQL Server en BizTalk-tuning, verwijzen naar alle beschikbare technische artikelen.

Meer informatie

Opmerking Deze hotfix lost ook een probleem in Microsoft BizTalk 2010 Accelerator voor HL7. Voor meer informatie over dit probleem, klikt u op het volgende artikel in de Microsoft Knowledge Base:

2454887 gebeurtenissen mogelijk niet juist aangemeld voor een MLLP-bericht in BizTalk 2009 Accelerator voor HL7 een computer met Microsoft BizTalk Server 2009 of Microsoft BizTalk Server 2010

Informatie over de hotfix

Een ondersteunde hotfix is beschikbaar bij Microsoft. Deze hotfix is echter alleen bedoeld als oplossing voor het in dit artikel beschreven probleem. Voer deze hotfix alleen uit op systemen waarop de in dit artikel beschreven problemen zich voordoen. Deze hotfix moet wellicht extra worden getest. Als u geen ernstige hinder ondervindt van dit probleem, is het daarom raadzaam te wachten op de volgende update waarin deze hotfix is opgenomen.

Als de hotfix gedownload kan worden, is er een sectie 'Hotfix downloaden' aan het begin van dit Knowledge Base-artikel. Als deze sectie niet wordt weergegeven, neem dan contact op met Microsoft Customer Service and Support om de hotfix te verkrijgen.

Opmerking Als er andere problemen optreden of als probleemoplossing is vereist, moet u wellicht een apart serviceverzoek indienen. De normale ondersteuningskosten gelden voor extra ondersteuningsvragen en problemen die niet in aanmerking komen voor deze specifieke hotfix. Voor een volledige lijst met telefoonnummers van Microsoft Customer Service and Support of om een afzonderlijk serviceverzoek aan te maken, gaat u naar de volgende Microsoft-website:

http://support.microsoft.com/contactus/?ws=supportOpmerking Het formulier 'Hotfix kan worden gedownload' geeft de talen weer waarvoor de hotfix beschikbaar is. Als uw taal niet wordt weergegeven, is dit omdat een hotfix niet voor die taal beschikbaar is.

Vereisten

U moet Microsoft BizTalk Accelerator voor HL7 hebben (BTAHL7) geïnstalleerd om deze hotfix te kunnen.

Opstartinformatie

U moet de computer opnieuw opstarten nadat u deze hotfix hebt toegepast. Als u niet wordt gevraagd opnieuw op te starten, moet u BizTalk-services opnieuw starten. Raadpleeg het Leesmij-bestand dat is opgenomen in dit hotfix-pakket voor meer informatie over deze procedure.

Informatie over vervanging

Deze hotfix vervangt geen eerder uitgebrachte hotfix.

Bestandsinformatie

De Engelse versie van deze hotfix heeft de bestandskenmerken (of recentere bestandskenmerken) die in de volgende tabel worden weergegeven. De datums en tijden voor deze bestanden worden weergegeven in Coordinated Universal Time (UTC). Wanneer u de bestandsinformatie weergeeft, wordt deze naar lokale tijd geconverteerd. Om het verschil tussen UTC en lokale tijd op te zoeken, gebruikt u het tabblad tijdzone in het onderdeel datum en tijd in het Configuratiescherm.

Bestandsnaam	Bestandsversie	Bestandsgrootte	Datum	Tijd	Platform
Microsoft.solutions.btahl7.mllp.dll	3.9.526.2	116,608	07-Jun-2011	15:27	x86
Microsoft.solutions.btahl7.shared.dll	3.9.526.2	92,040	07-Jun-2011	15:27	x86
Mllpreceive.exe	3.9.526.2	26,456	07-Jun-2011	15:27	x86
Mllpsend.exe	3.9.526.2	26,448	07-Jun-2011	15:27	x86

Over de hotfix

Berichtenstroom nadat de hotfix is geïnstalleerd en geconfigureerd

Nadat u toepast en het inschakelen van deze hotfix is opgenomen, dient de MLLP adapter elk bericht dat wordt ontvangen door de MLLP-adapter voor MessageBoxDB. Eindpunt Manager (EPM) wordt teruggebeld door de adapter samen met de status ingediend in de methode BatchComplete . Dit zorgt ervoor dat de adapter de commit ACK/NAK verzenden naar de upstream systeem. Op zijn beurt de upstream-systeem de ACK/NAK ontvangt en het volgende bericht. De methode BatchComplete is afhankelijk van de instelling van de MaxReceiveInterval en onmiddellijk nadat het bericht is verzonden naar BizTalk wordt genoemd.

Zodra het bericht wilt verzenden, verzendt de adapter verzenden het bericht op de downstream-systeem. De ACK/NAK wordt verwacht als de eigenschap Gebruik MLLP vervoer bevestiging is ingesteld op True. Als het verzenden een ACK is, BizTalk klaar is voor de verwerking met succes. Als het verzenden is een NAK, en de Stand-by Request-bericht op MLLP vervoer NAK -eigenschap is ingesteld op True, wordt het bericht rechtstreeks zonder opnieuw geschorst. Echter, als de Stand-by Request-bericht op MLLP vervoer NAK -eigenschap is ingesteld op False, BizTalk zal worden herhaald op basis van het verzenden opnieuw interval poortinstellingen. (Standaard de Stand-by Request-bericht op MLLP vervoer NAK -eigenschap is ingesteld op False.)

In het volgende diagram ziet u de berichtenstroom:

Message flow

Het bericht dat is verzonden door de upstream-systeem zendende toepassing wordt verwerkt door de MLLP adapter ontvangen.
De MLLP-adapter verzendt het bericht naar BizTalk/EPM.
De EPM teruggebeld door de adapter over de verzendstatus van het bericht. De EPM gebeurt dit in de Volledige Batch methode.
Een commit ACK/NAK wordt gegenereerd door de MLLP-adapter en is gebaseerd op de status van de indiening van de Batch. De ACK/NAK is verzonden naar de verzendende toepassing.

Opmerking Als de status van de Batch indienen geslaagd is, geeft de adapter de ACK. Echter geeft als er een storing of als de inzending een time-out optreedt (bijvoorbeeld de Volledige Batch methodeaanroep time-out), de adapter de NAK naar de verzendende toepassing.
De EPM handen boven het bericht aan de adapter voor het verzenden van MLLP voor verzending.
De MLLP adapter verzendt de verwerkte bericht verzenden naar de downstream-systeem.
Het niveau van het vervoer ACK/NAK door de adapter voor het verzenden van MLLP naar verwachting de communicatie te voltooien.
Als het bericht in stap 7 een ACK wordt, vraagt de adapter de EPM om het bericht te verwijderen. Anders wordt heeft de adapter de EPM vragen om een nieuwe poging die is gebaseerd op het interval voor opnieuw proberen. Een nieuwe optie is beschikbaar in de verzenden poort configuratie-instelling voor het uitstellen van het bericht rechtstreeks, zonder een nieuwe poging, als een NAK MLLP wordt ontvangen. Deze optie is standaard ingesteld op False. Als deze optie is ingesteld op True, wordt het bericht rechtstreeks, zonder een nieuwe poging, geschorst als een NAK MLLP wordt ontvangen.

Transport niveau ACK/NACK-indeling

De website bevat de volgende informatie:

Voorbeeld van een MLLP doorvoeren:

<SB><ACK><EB><CR>
Voorbeeld van een negatieve MLLP doorvoeren bevestiging:

<SB><NAK><EB><CR>

Opmerkingen

In deze voorbeelden, < SB > verwijst naar het teken blok Start (1 byte). Dit komt overeen met het teken < VT > ASCII- of < 0x0B >.

Dit moet niet worden verward met de Statusverklaring of STX ASCII-tekens.
In deze voorbeelden, < ACK > of < NAK > verwezen naar de tekenset bevestiging (1 byte. Komt overeen met het teken < ACK > ASCII- of < 0x06 >) of het teken voor negatieve bevestiging (1 byte. Komt overeen met het teken < NAK > ASCII- of < 0x15 >).
In deze voorbeelden, < EB > verwijst naar het teken einde Block (1 byte). Dit komt overeen met het teken < FS > ASCII- of < 0x1C >.
In deze voorbeelden, < CR > verwijst naar het teken voor regeleinde (1 byte). Dit komt overeen met het teken < CR > ASCII- of < 0x0D >.
Microsoft biedt contactinformatie van derden om u te helpen technische ondersteuning te vinden. Deze contactinformatie kan zonder kennisgeving worden gewijzigd. Microsoft garandeert niet de juistheid van deze contactinformatie van derden.

Het configureren van de ontvangen en verzenden poorten met de nieuwe eigenschappen

Configureer de ontvangen en poorten als volgt verzenden.

Opmerking De instellingen van de poort ontvangen en verzenden kunnen afzonderlijk of gezamenlijk worden gebruikt.

Poortconfiguratie ontvangen

De poort moet een eenrichtings-poort.
De parameter Besteld levering moet zijn ingeschakeld.
U moet de eigenschap Gebruik MLLP vervoer bevestiging instellen op True transport level bevestiging. Deze eigenschap is standaard ingesteld op False voor bestaande poorten of poorten van nieuwe.

Receive port

Poortconfiguratie verzenden

De poort moet een eenrichtings-poort.
De modus solicit antwoord moet worden ingesteld op Nee.
De parameter Besteld levering moet zijn ingeschakeld.
U moet de eigenschap Gebruik MLLP vervoer bevestiging instellen op True transport level bevestiging. Deze eigenschap is standaard ingesteld op False voor bestaande poorten of poorten van nieuwe.
Als de berichten worden geschorst rechtstreeks zonder opnieuw wordt uitgevoerd moeten wanneer een NAK Transport wordt ontvangen van een downstream-systeem, moet u de Stand-by Request-bericht op MLLP vervoer NAK -eigenschap instellen op True . Anders wordt het bericht wordt opnieuw geprobeerd het aantal keren dat is ingesteld in de geavanceerde opties van de poort verzenden transport. Deze eigenschap is standaard ingesteld op False voor bestaande poorten of poorten van nieuwe.

Send port

Over de eigenschap "Bevestiging met MLLP vervoer"

De volgende tabel beschrijft het verwachte gedrag van één of twee richtingen poorten die met de eigenschap MLLP vervoer bevestiging gebruiken . De vereiste combinatie van instellingen moet worden toegepast, zoals wordt beschreven in de sectie ' de hotfix activeren '.

Opmerkingen

"Upstream systeem" verwijst naar de verzendende toepassing. Verzendt berichten naar BizTalk. Deze berichten zijn inkomende BizTalk.
"Downstream systeem" verwijst naar de ontvangende toepassing. Berichten ontvangen van BizTalk. Deze berichten worden naar BizTalk uitgaand.

Type poort	MLLP V2-optie op	MLLP V2 optie uitschakelen
Unilaterale ontvangen	MLLP ACK/NAK verzenden naar het systeem upstream in de methode BatchComplete .	Geen wijziging in de. In dit geval is geen ACK/NAK upstream systeem verzonden.
Twee richtingen ontvangen	Geen wijziging in de. In dit geval is de HL7 ACK/NAK in de methode TransmitMessage naar de upstream systeem verzonden. Opmerking Deze optie wordt niet ondersteund. Negeren, zelfs als de waarde is ingesteld op True.	Geen wijziging in de. In dit geval is de HL7 ACK/NAK in de methode TransmitMessage naar de upstream systeem verzonden.
Unilaterale verzenden	De MLLP-ACK/NAK van de downstream-systeem wordt gewacht nadat het bericht is verzonden.	Geen wijziging in de. In dit geval wordt de ACK/NAK van de downstream-systeem niet gewacht nadat het bericht is verzonden.
Verzenden van bilaterale of unilaterale verzenden met vragen antwoord modus ingeschakeld	Geen wijziging in de. In dit geval wordt de HL7 ACK/NAK van de downstream-systeem gewacht nadat het bericht is verzonden. Opmerking Deze optie wordt niet ondersteund. Negeren, zelfs als de waarde is ingesteld op True.	Geen wijziging in de. In dit geval wordt de HL7 ACK/NAK van de downstream-systeem gewacht nadat het bericht is verzonden.

Twee richtingen ontvangen en verzenden van de poort is niet gewijzigd. Unilaterale ontvangen en verzenden van de werking van de poort is ook niet gewijzigd, tenzij de eigenschap Gebruik MLLP vervoer bevestiging is ingesteld op true.

Raadpleeg de documentatie bij de MLLP-adapter voor meer informatie. Als één richting ontvangen en verzenden poorten hebben de juiste configuratie, worden de prestaties verbeterd. Als de eigenschap Gebruik MLLP vervoer bevestiging van een tweerichtingsvertrouwensrelatie of een eenrichtingsvertrouwensrelatie poort is ingesteld op false, wordt het soort ACK die wordt gegenereerd blijft zonder wijzigingen. In dit geval afhankelijk de aard van de ACK die wordt gegenereerd van de BTAHL7 configuratie Explorer-instellingen voor de toepassing die het bericht verzendt. De waarde in de velden MSH 15 en 16 MSH van een specifiek bericht kan deze instelling genegeerd. Als de eigenschap Gebruik MLLP vervoer bevestiging van een tweerichtingsvertrouwensrelatie of een eenrichtingsvertrouwensrelatie poort is ingesteld op false, kunt u de configuratie van toepassingen die verwachten statische ACKs dat alleen met behulp van de configuratie van BTAHL7 Explorer instellen. Gedrag van de time-outwaarde voor de poort blijft ongewijzigd...

Het verwachte gedrag in de hoek gevallen wanneer de eigenschappen worden gebruikt, is als volgt:

RECEIVE

WrongMLLPFormat: het bericht is niet verzonden naar BizTalk.
WrongHL7Format: het bericht wordt verzonden naar de BizTalk en een ACK MLLP/NAK die is gebaseerd op de voltooiingsstatus Batch wordt verzonden.
TransmittingSocketIssue: de MLLP-ACK/NAK is niet verzonden, maar het bericht wordt verzonden naar de BizTalk.
ReceivingSocketIssue: het bericht is ontvangen en daarom niet wordt ingediend, en geen MLLP ACK/NAK-uitzending wordt verzonden.
Als u een verzending naar BizTalk mislukt, wordt een NAK verzonden.
Als een negatieve status van de volledige partij wordt ontvangen, wordt een NAK verzonden.

Verzenden en poort verzenden eigenschap 'stop-berichten verzenden op het huidige bericht fout' = True

WrongMLLPFormat: het bericht is geschorst omdat de ACK MLLP/NACK kan niet worden gelezen. Verwerking wordt niet voortgezet totdat de geschorste berichten worden verwijderd.
WrongHL7Format: het bericht niet voordat de adapter heeft bereikt. Verwerking wordt niet voortgezet totdat de geschorste berichten worden verwijderd.
TransmittingSocketIssue: het bericht is opgeschort. Verwerking wordt niet voortgezet totdat de geschorste berichten worden verwijderd.
ReceivingSocketIssue: het bericht is opgeschort. Verwerking wordt niet voortgezet totdat de geschorste berichten worden verwijderd.

Het verwachte gedrag wanneer de Stand-by Request-bericht op MLLP vervoer NAK -eigenschap is ingesteld op True of False is als volgt:

Wanneer de Stand-by Request-bericht op MLLP vervoer NAK -eigenschap is ingesteld op True en een NAK is ontvangen, wordt het bericht geschorst zonder opnieuw te verzenden.
Als de Stand-by Request-bericht op MLLP vervoer NAK -eigenschap is ingesteld op de standaardinstelling is False, opnieuw verzenden van dat het bericht wordt gestart, op basis van het verzenden opnieuw interval poortinstellingen.

Wijzigingen in de MLLP SDK-hulpprogramma

Het hulpprogramma MLLP-SDK bevat de volgende nieuwe parameters. Alle andere parameters blijven ongewijzigd. Raadpleeg de productdocumentatie voor meer informatie.

Via de nieuwe parameter voor MLLPReceive.exe, de MLLP-ACK/NAK terug nadat het bericht is ontvangen. Bijvoorbeeld:

MLLPReceive /p 12000 /sb 11 28 /eb /cr 13 /MLLPTransACK
MLLPReceive /p 12000 /sb 11 28 /eb /cr 13 /MLLPTransNAK
Gebruik voor MLLPSend.exe, de nieuwe parameter voor MLLP ACK/NAK wachten. Bijvoorbeeld:

MLLPSend /sb 11 28 /eb /cr 13/f "C:\HL7\ls.txt" /I 127.0.0.1 11000 /p /UseMLLPTransACK

Referenties

Ga naar de volgende website van Microsoft Developer Network (MSDN) voor meer informatie over het beheren van de prestatie-instellingen op de BizTalk server:

BizTalk Server prestatie-instellingen beherenGa naar de volgende MSDN-website voor meer informatie over prestatiemeteritems messaging:

Prestatiemeteritems MessagingGa naar de volgende MSDN-website voor meer informatie over de bezorging van berichten besteld:

De bezorging van berichten besteldVoor meer informatie over BizTalk 2010 Accelerator voor HL7 (BTAHL7), gaat u naar de volgende Microsoft-website:

BizTalk 2010 Accelerator voor HL7 documentatie (BTAHL7)Ga naar de volgende MSDN-website voor meer informatie over de methode IBTBatchCallBack.BatchComplete :

IBTBatchCallBack.BatchComplete, methodeVoor meer informatie over hotfixes voor BizTalk Server klikt u op het volgende artikel in de Microsoft Knowledge Base:

Informatie over hotfixes voor BizTalk Server 2003907