Konfigurationseigenschaften des MQSeries-Adapters
Die folgende Tabelle enthält die Konfigurationseigenschaften, die Sie für den Empfangsspeicherort eines MQSeries-Adapters festlegen können:
| Eigenschaftenname | type | BESCHREIBUNG | Beschränkungen | Kommentare |
|---|---|---|---|---|
| uri | VT_BSTR | Gibt den vollständigen Pfad des Speicherorts an, der vom Empfangsspeicherort überwacht wird. | Der URI für einen Sendeport oder Empfangsspeicherort darf nicht länger als 256 Zeichen sein. | Keine |
| queueDetails | VT_BSTR | Geben Sie Informationen zur MQSeries-Quellwarteschlange an, einschließlich Server, Warteschlangen-Manager und Warteschlange. | – None | Dieser Eigenschaft wird MQS:// vorangestellt, um die Eigenschaft uri zu erstellen. |
| transactionSupported | VT_BSTR | Geben Sie an, ob der MQSeries-Adapter eine Microsoft DTC-Transaktion (Distributed Transaction Coordinator) zwischen BizTalk Server und MQSeries Server initiiert. | Gültige Werte sind: -Ja -Nein |
Bei der Einstellung no ist die Nachrichtenübermittlung nicht garantiert. Der Standardwert ist yes. |
| suspendAsNonResumable | VT_BSTR | Geben Sie an, ob angehaltene Nachrichten als fortsetzbar gekennzeichnet werden sollen. | Gültige Werte sind: -Ja -Nein |
Der Standardwert ist no. |
| dataOffsetForHeaders | VT_BSTR | Der Adapter übernimmt Werte aus den MQSeries-Headern (die MQXQH-, MQIIH- und MQCIH-Strukturen) für die entsprechenden Werte in den Kontexteigenschaften von BizTalk Server. Standardmäßig entfernt der Adapter die MQSeries-Eigenschaften aus dem Nachrichtentext. | Gültige Werte sind: -Ja -Nein |
Legen Sie diese Eigenschaft auf no fest, um die Eigenschaften im Nachrichtentextteil beizubehalten. Der Standardwert ist yes. |
| pollingInterval | VT_BSTR | Geben Sie das Intervall an, in dem die Empfangskomponente die MQSeries-Warteschlange abruft. | Gültige Werte liegen zwischen 1 und 10000. | pollingInterval funktioniert in Kombination mit dem fest programmierten Warteintervall des Adapters (drei Sekunden). Bei einem pollingInterval-Wert von unter drei Sekunden wird das Warteintervall auf den pollingInterval-Wert gesetzt. Der Standardwert ist 3. |
| pollingUnit | VT_BSTR | Geben Sie die Zeiteinheit für das Abrufintervall an. | Gültige Werte sind: -Stunden -Minuten -Sekunden |
Der Standardwert ist seconds. |
| maximumBatchSize | VT_BSTR | Geben Sie die maximale Größe eines Nachrichtenbatches in Kilobytes (KB) an. | Gültige Werte liegen zwischen 1 und 10485760 | Der Standardwert ist 100. |
| maximumNumberOfMessages | VT_BSTR | Geben Sie die maximale Anzahl von Nachrichten in einem Batch an. | Die gültigen Werte liegen zwischen 1 und 100000. | Der Standardwert ist 100. |
| threadCount | VT_BSTR | Geben Sie die Anzahl von Threads pro Empfangsspeicherort an. | Gültige Werte liegen zwischen 1 und 64. | Der Standardwert ist 2. |
| fragmentationSize | VT_BSTR | Geben Sie die Größe (in KB) der Abschnitte von Nachrichten an, die zwischen dem MQSAgent und dem Adapter gesendet werden. | Gültige Werte liegen zwischen 1 und 1048576. | Der Standardwert ist 500. |
| characterSet | VT_BSTR | Geben Sie den Zeichensatz an, und geben Sie an, ob MQSeries vor dem Senden von Nachrichten an den Empfangsspeicherort Zeichen konvertieren soll. | Gültige Werte sind: -nichts. Es erfolgt keine Konvertierung. – UCS-2 und UTF-16. Zeichen werden in diese Zeichensätze konvertiert. MQSeries unterscheidet nicht zwischen den Zeichensätzen. – UTF-8. Zeichen werden in den Zeichensatz UTF-8 konvertiert. |
Der Standardwert ist none. |
| errorThreshold | VT_BSTR | Geben Sie die maximale Anzahl zu protokollierender Fehler an. Der Adapter arbeitet weiter. Sofern die Funktionsfähigkeit des Adapters wieder hergestellt werden kann, wird das Ereignis im Ereignisprotokoll festgehalten. | Gültige Werte liegen zwischen 1 und 1000. | Der Standardwert ist 10. |
| Segmentierung | VT_BSTR | Geben Sie an, ob MQSeries segmentierte Nachrichten assemblieren oder unverändert abrufen soll. | Gültige Werte sind: -nichts -vollständig |
Geben Sie none an, um Nachrichten ohne Aktivierung der Segmentierung aus der MQSeries-Warteschlange zu lesen. Geben Sie complete an, damit MQSeries segmentierte Nachrichten vor der Weiterleitung an den Adapter assembliert. Der Standardwert ist none. |
| geordnete | VT_BSTR | Geben Sie an, ob MQSeries die Reihenfolge beibehält, in der die Nachrichten von der MQSeries-Warteschlange empfangen werden. | Gültige Werte sind: -Nein - noStop - jaStop - jaSuspend |
Geben Sie no an, um die Reihenfolge der Nachrichten zu ignorieren. Geben Sie noStop an, um die Reihenfolge der Nachrichten zu ignorieren und den Empfangsspeicherort bei einem Fehler zu deaktivieren. Geben Sie yesStop an, um die Sortierung zu aktivieren. Mit dieser Option wird bei einem Fehler die Transaktion beendet, und der Empfangsspeicherort wird deaktiviert. Geben Sie yesSuspend an, um die Sortierung zu aktivieren. Mit dieser Option werden die Nachrichten bei einem Fehler in die Warteschlange Angehalten verschoben. Die Reihenfolge wird dabei zwar nicht beibehalten, der Empfangsspeicherort kann jedoch weiter Nachrichten empfangen. Der Standardwert ist no. |
Im folgenden Code wird das Format der Zeichenfolge dargestellt, die zum Festlegen der Eigenschaften verwendet wird:
<CustomProps><AdapterConfig vt="8"><Config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema"><uri>MQS://TESTMQServer/DQM1/RQ0</uri><queueDetails>TESTMQServer/DQM1/RQ0</queueDetails><transactionSupported>yes</transactionSupported><suspendAsNonResumable>no</suspendAsNonResumable><dataOffsetForHeaders>yes</dataOffsetForHeaders><pollingInterval>1</pollingInterval><pollingUnit>seconds</pollingUnit><maximumBatchSize>100</maximumBatchSize><maximumNumberOfMessages>100</maximumNumberOfMessages><threadCount>2</threadCount><fragmentationSize>500</fragmentationSize><characterSet>none</characterSet><errorThreshold>10</errorThreshold><segmentation>none</segmentation><ordered>no</ordered></Config></AdapterConfig></CustomProps>
Die folgende Tabelle enthält die Konfigurationseigenschaften, die Sie für den Sendeport eines MQSeries-Adapters festlegen können:
| Eigenschaftenname | type | BESCHREIBUNG | Beschränkungen | Kommentare |
|---|---|---|---|---|
| uri | VT_BSTR | Gibt den vollständigen Pfad des Speicherorts an, an den Daten gesendet werden sollen. | Der URI für einen Sendeport oder Empfangsspeicherort darf nicht länger als 256 Zeichen sein. | Keine |
| queueDetails | VT_BSTR | Geben Sie Informationen zur MQSeries-Zielwarteschlange an, einschließlich Server, Warteschlangen-Manager und Warteschlange. | Der URI für einen Sendeport oder Empfangsspeicherort darf nicht länger als 256 Zeichen sein. | Dieser Eigenschaft wird MQS:// vorangestellt, um die Eigenschaft uri zu erstellen. |
| transactionSupported | VT_BSTR | Geben Sie an, ob der MQSeries-Adapter eine Microsoft DTC-Transaktion (Distributed Transaction Coordinator) zwischen BizTalk Server und MQSeries Server initiiert. | Gültige Werte sind: -Ja -Nein |
Bei der Einstellung no ist die Nachrichtenübermittlung nicht garantiert. Der Standardwert ist yes. |
| dataConversion | VT_BSTR | Geben Sie an, ob die Nachricht in die ANSI-Codepage von MQSeries für Windows Server konvertiert werden soll. | Gültige Werte sind: -Ja -Nein |
Der Standardwert ist no. |
| segmentationAllowed | VT_BSTR | Geben Sie an, ob die Segmentierung des MQSeries-Warteschlangen-Managers verwendet werden soll, wenn eine Einzelnachricht die maximale Nachrichtenlänge für die MQSeries-Warteschlange überschreitet. | Gültige Werte sind: -Ja -Nein |
Der Standardwert ist no. |
| fragmentationSize | VT_BSTR | Geben Sie die Größe (in KB) der Abschnitte von Nachrichten an, die zwischen dem Adapter und dem MQSAgent gesendet werden. | Gültige Werte liegen zwischen 1 und 1048576. | Der Standardwert ist 500. |
| geordnete | VT_BSTR | Geben Sie an, ob MQSeries die Reihenfolge beibehält, in der die Nachrichten an die MQSeries-Warteschlange gesendet werden. | Gültige Werte sind: -Ja -Nein |
Der Standardwert ist no. |
Im folgenden Code wird das Format der Zeichenfolge dargestellt, die zum Festlegen der Eigenschaften verwendet wird:
<CustomProps><AdapterConfig vt="8"><Config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema"><uri>MQS://TESTMQServer/DQM1(QM1)/SQ0</uri><queueDetails>TESTMQServer/DQM1(QM1)/SQ0</queueDetails><transactionSupported>yes</transactionSupported><dataConversion>no</dataConversion><segmentationAllowed>no</segmentationAllowed><fragmentationSize>500</fragmentationSize><ordered>no</ordered></Config></AdapterConfig></CustomProps>
Hinweis
Wenn Sie TransportTypeData-Konfigurationsdaten für einen Adapter angeben, der mit dem Adapter Framework erstellt wird, müssen die verwendeten Name-Wert-Paare alle im <AdapterConfig-Element> gespeichert werden. Da das <AdapterConfig-Element> den Datentyp VT_BSTR (vt="8") angibt, müssen die <> Zeichen in den Daten mit Escapezeichen versehen werden.