Propriétés de configuration de l'adaptateur MQSeries
Le tableau suivant répertorie les propriétés de configuration que vous pouvez définir pour l'emplacement de réception de l'adaptateur MQSeries :
| Nom de la propriété | Type | Description | Restrictions | Commentaires |
|---|---|---|---|---|
| URI | VT_BSTR | Indiquer le chemin d'accès complet à l'emplacement contrôlé par l'emplacement de réception. | L'URI d'un port d'envoi ou d'un emplacement de réception ne peut pas comporter plus de 256 caractères. | None |
| queueDetails | VT_BSTR | Spécifier les informations relatives à la file d'attente MQSeries source, notamment le serveur, le gestionnaire de file d'attente et la file d'attente. | - Aucun. | Cette propriété est précédée de MQS:// pour créer la propriété de URI. |
| transactionSupported | VT_BSTR | Indiquer si l'adaptateur MQSeries commence une transaction Microsoft DTC (Distributed Transaction Coordinator) entre BizTalk Server et MQSeries Server. | Les valeurs autorisées sont : -Oui -non |
Lorsque la valeur est définie sur non, il n’existe aucune garantie de remise des messages. La valeur par défaut est yes. |
| suspendAsNonResumable | VT_BSTR | Indiquer si les messages suspendus peuvent être repris ou non. | Les valeurs autorisées sont : -Oui -non |
La valeur par défaut est no. |
| dataOffsetForHeaders | VT_BSTR | L'adaptateur utilise les valeurs des en-têtes MQSeries (structures MQXQH, MQIIH et MQCIH) pour renseigner les propriétés de contexte BizTalk Server. Par défaut, il supprime ces propriétés MQSeries du corps du message. | Les valeurs autorisées sont : -Oui -non |
Définissez cette propriété sur non pour conserver les propriétés dans le corps du message. La valeur par défaut est yes. |
| pollingInterval | VT_BSTR | Définir la fréquence utilisée par le composant de réception pour interroger la file d'attente MQSeries. | Les valeurs valides sont comprises entre 1 et 10000. | pollingInterval fonctionne en conjonction avec l'intervalle d'attente de trois secondes intégré à l'adaptateur. Si la valeur de pollingInterval est définie sur une valeur inférieure à trois (3) secondes, l'intervalle d'attente est ajusté en conséquence. La valeur par défaut est 3. |
| pollingUnit | VT_BSTR | Indiquer l'unité de temps à utiliser pour la fréquence d'interrogation. | Les valeurs autorisées sont : -Heures -Minutes -Secondes |
La valeur par défaut est secondes. |
| maximumBatchSize | VT_BSTR | Définir la taille maximale d'un lot de messages, en kilo-octets (Ko). | Les valeurs valides sont comprises entre 1 et 10485760. | La valeur par défaut est 100. |
| maximumNumberOfMessages | VT_BSTR | Définir le nombre maximal de messages dans un lot. | Les valeurs valides sont comprises entre 1 et 100000 | La valeur par défaut est 100. |
| threadCount | VT_BSTR | Spécifier le nombre de threads utilisés par emplacement de réception. | Les valeurs valides sont comprises entre 1 et 64. | La valeur par défaut est 2. |
| fragmentationSize | VT_BSTR | Définir la taille des fragments, en kilo-octets (Ko), des messages envoyés entre MQSAgent et l'adaptateur. | Les valeurs valides sont comprises entre 1 et 1048576. | La valeur par défaut est 500. |
| characterSet | VT_BSTR | Spécifier le jeu de caractères et si MQSeries doit les convertir avant d'envoyer le message à l'emplacement de réception : | Les valeurs autorisées sont : -Aucun. Pas de conversion. - UCS-2 et UTF-16. Conversion en ces jeux de caractères. MQSeries ne fait pas de distinction entre eux. - UTF-8. Conversion en jeu de caractères UTF-8. |
La valeur par défaut est none. |
| errorThreshold | VT_BSTR | Déterminer le nombre maximal d'erreurs à consigner. L'adaptateur continue de fonctionner et, s'il récupère, consigne l'événement dans le journal des événements. | Les valeurs valides sont comprises entre 1 et 1000. | La valeur par défaut est 10. |
| segmentation | VT_BSTR | Indiquer si MQSeries assemble les messages segmentés ou les récupère en l'état. | Les valeurs autorisées sont : -Aucun -Complet |
Spécifiez Aucune pour lire les messages de la file d'attente MQSeries sans activer la segmentation. Utilisez Complète pour que les messages segmentés soient assemblés avant d'être transmis à l'adaptateur. La valeur par défaut est none. |
| ordered | VT_BSTR | Définir si MQSeries doit conserver l'ordre des messages au fur et à mesure de leur réception depuis la file d'attente MQSeries. | Les valeurs autorisées sont : -non - noStop - yesStop - yesSuspend |
Sélectionnez non pour ne pas tenir compte de l'ordre des messages. Sélectionnez noStop pour ne pas tenir compte de l'ordre des messages et pour désactiver l'emplacement de réception en cas d'erreur. Sélectionnez yesStop pour activer le classement. Cette option permet de mettre fin à la transaction et de désactiver l'emplacement de réception en cas d'erreur. Sélectionnez yesSuspend pour activer le classement. Cette option place le message dans la file d'attente des messages interrompus en cas d'erreur. Cette valeur ne permet pas de conserver l'ordre en cas d'erreur, mais permet à l'emplacement de réception de continuer à recevoir des messages. La valeur par défaut est no. |
Le code suivant présente le format de la chaîne que vous devez utiliser pour définir les propriétés :
<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>
Le tableau suivant répertorie les propriétés de configuration que vous pouvez définir pour le port d'envoi d'un adaptateur MQSeries.
| Nom de la propriété | Type | Description | Restrictions | Commentaires |
|---|---|---|---|---|
| URI | VT_BSTR | Indiquer le chemin d'accès complet de l'emplacement de réception des données. | L'URI d'un port d'envoi ou d'un emplacement de réception ne peut pas comporter plus de 256 caractères. | None |
| queueDetails | VT_BSTR | Spécifier les informations relatives à la file d'attente MQSeries cible, notamment le serveur, le gestionnaire de file d'attente et la file d'attente. | L'URI d'un port d'envoi ou d'un emplacement de réception ne peut pas comporter plus de 256 caractères. | Cette propriété est précédée de MQS:// pour créer la propriété de URI. |
| transactionSupported | VT_BSTR | Indiquer si l'adaptateur MQSeries commence une transaction Microsoft DTC (Distributed Transaction Coordinator) entre BizTalk Server et MQSeries Server. | Les valeurs autorisées sont : -Oui -non |
Lorsque la valeur est définie sur non, il n’existe aucune garantie de remise des messages. La valeur par défaut est yes. |
| dataConversion | VT_BSTR | Spécifier si le message doit être converti en page de code ANSI du serveur MQSeries pour Windows. | Les valeurs autorisées sont : -Oui -non |
La valeur par défaut est no. |
| segmentationAllowed | VT_BSTR | Spécifier si la segmentation du gestionnaire de file d'attente MQSeries doit être utilisée si un message individuel dépasse la longueur maximale autorisée pour les messages de file d'attente MQSeries. | Les valeurs valides sont les suivantes : -Oui -non |
La valeur par défaut est no. |
| fragmentationSize | VT_BSTR | Définir la taille des fragments, en kilo-octets (Ko), des messages envoyés entre l'adaptateur et MQSAgent. | Les valeurs valides sont comprises entre 1 et 1048576. | La valeur par défaut est 500. |
| ordered | VT_BSTR | Définir si MQSeries doit conserver l'ordre des messages au fur et à mesure de leur envoi vers la file d'attente MQSeries. | Les valeurs autorisées sont : -Oui -non |
La valeur par défaut est no. |
Le code suivant présente le format de la chaîne que vous devez utiliser pour définir les propriétés :
<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>
Notes
Lorsque vous spécifiez des données de configuration TransportTypeData pour un adaptateur généré à l’aide de Adapter Framework, les paires nom/valeur utilisées doivent toutes être stockées dans l’élément <AdapterConfig> . Étant donné que l’élément <AdapterConfig> spécifie le type de données VT_BSTR (vt="8 »), les <> caractères dans les données doivent être placés dans une séquence d’échappement.