Propiedades de configuración del adaptador de MQSeries
En la siguiente tabla se enumeran las propiedades de configuración que se pueden definir mediante una ubicación de recepción del adaptador de MQSeries:
| Nombre de propiedad | Tipo | Descripción | Restricciones | Comentarios |
|---|---|---|---|---|
| uri | VT_BSTR | Especificar la ruta completa a la ubicación supervisada por la ubicación de recepción. | La URI de un puerto de envío o ubicación de recepción no puede superar los 256 caracteres. | None |
| queueDetails | VT_BSTR | Especifica información acerca de la cola de MQSeries de origen que incluye servidor, administrador de cola y cola. | - None | Esta propiedad se antepone a MQS:// para crear la propiedad URI. |
| transactionSupported | VT_BSTR | Especifica si el adaptador de MQSeries inicia una transacción del Coordinador de transacciones distribuidas de Microsoft (DTC) entre BizTalk Server y el servidor MQSeries. | Los valores válidos son: -Sí -No |
Cuando se establece en no, no hay ninguna garantía de entrega de mensajes. El valor predeterminado es Yes. |
| suspendAsNonResumable | VT_BSTR | Especificar si los mensajes suspendidos se marcan o no como reanudables. | Los valores válidos son: -Sí -No |
El valor predeterminado es no. |
| dataOffsetForHeaders | VT_BSTR | El adaptador utiliza valores de los encabezados de MQSeries (las estructuras MQXQH, MQIIH y MQCIH) para rellenar los valores correspondientes en las propiedades de contexto de BizTalk Server. De forma predeterminada, el adaptador quita estas propiedades de MQSeries del cuerpo del mensaje. | Los valores válidos son: -Sí -No |
Establezca esta propiedad en no para conservar las propiedades en el cuerpo del mensaje. El valor predeterminado es Yes. |
| pollingInterval | VT_BSTR | Especifica el intervalo usado por el componente de recepción para sondear la cola de MQSeries. | Los valores válidos son de 1 a 10000. | pollingInterval actúa en combinación con el intervalo de espera codificado de tres segundos que está integrado en el adaptador. Si el valor pollingInterval es inferior a tres (3) segundos, el intervalo de espera se establece como el valor de pollingInterval. El valor predeterminado es 3. |
| pollingUnit | VT_BSTR | Especifica la unidad de tiempo para el intervalo de sondeo. | Los valores válidos son: -Horas -Minutos -Segundos |
El valor predeterminado es segundos. |
| maximumBatchSize | VT_BSTR | Especifica el tamaño máximo de un lote de mensajes en kilobytes (KB). | Los valores válidos son de 1 a 10485760 | El valor predeterminado es 100. |
| maximumNumberOfMessages | VT_BSTR | Especifica el número máximo de mensajes en un lote. | Los valores válidos son de 1 a 100000 | El valor predeterminado es 100. |
| threadCount | VT_BSTR | Especifica el número de subprocesos que se utilizan por ubicación de recepción. | Los valores válidos son de 1 a 64. | El valor predeterminado es 2. |
| fragmentationSize | VT_BSTR | Especifica el tamaño del fragmento de mensaje en kilobytes (KB) para los mensajes a medida que se envían entre MQSAgent y el adaptador. | Los valores válidos son de 1 a 1048576. | El valor predeterminado es 500. |
| characterSet | VT_BSTR | Especifica el juego de caracteres y si MQSeries convierte los caracteres antes de enviar el mensaje a la ubicación de recepción. | Los valores válidos son: -Ninguno. No convertir. - UCS-2 y UTF-16. Convertir a estos conjuntos de caracteres. MQSeries no distingue un juego de otro. - UTF-8. Convertir al juego de caracteres UTF-8. |
El valor predeterminado es Ninguno. |
| errorThreshold | VT_BSTR | Especifica el número máximo de errores que se deben registrar. El adaptador continúa funcionando y, si se recupera, registra el suceso en el registro de sucesos. | Los valores válidos son de 1 a 1000. | El valor predeterminado es 10. |
| segmentación | VT_BSTR | Especifica si MQSeries ensambla los mensajes segmentados u obtiene los mensajes tal como están. | Los valores válidos son: -Ninguno -íntegro |
Especificar Ninguno para leer mensajes de la cola MQSeries sin habilitar la segmentación. Especificar Completa para que MQSeries ensamble mensajes segmentados antes de pasarlos al adaptador. El valor predeterminado es Ninguno. |
| ordered | VT_BSTR | Especifica si MQSeries mantiene el orden de los mensajes a medida que se reciben de la cola MQSeries. | Los valores válidos son: -No - noStop - síStop - síSuspend |
Especificar No para no tener en cuenta el orden de los mensajes. Especificar noStop para no tener en cuenta el orden de los mensajes y deshabilitar la ubicación de recepción si hay un error. Especificar yesStop para habilitar el ordenamiento. Esta opción finaliza la transacción y deshabilita la ubicación de recepción si hay un error. Especificar yesSuspend para habilitar el ordenamiento. Esta opción mueve el mensaje a la cola de suspensión cuando hay un error. Este valor no mantiene el orden cuando hay un error, pero permite que la ubicación de recepción continúe recibiendo mensajes. El valor predeterminado es no. |
En el siguiente código se muestra el formato de la cadena que se utiliza para establecer las propiedades:
<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>
En la siguiente tabla se enumeran las propiedades de configuración que se pueden definir mediante un puerto de envío del adaptador de MQSeries:
| Nombre de propiedad | Tipo | Descripción | Restricciones | Comentarios |
|---|---|---|---|---|
| uri | VT_BSTR | Especificar la ruta completa de la ubicación a la que enviar datos. | La URI de un puerto de envío o ubicación de recepción no puede superar los 256 caracteres. | None |
| queueDetails | VT_BSTR | Especifica información acerca de la cola de MQSeries de destino que incluye servidor, administrador de cola y cola. | La URI de un puerto de envío o ubicación de recepción no puede superar los 256 caracteres. | Esta propiedad se antepone a MQS:// para crear la propiedad URI. |
| transactionSupported | VT_BSTR | Especifica si el adaptador de MQSeries inicia una transacción del Coordinador de transacciones distribuidas de Microsoft (DTC) entre BizTalk Server y el servidor MQSeries. | Los valores válidos son: -Sí -No |
Cuando se establece en no, no hay ninguna garantía de entrega de mensajes. El valor predeterminado es Yes. |
| dataConversion | VT_BSTR | Especifica si se convierte el mensaje a la página de códigos ANSI de MQSeries para Windows Server. | Los valores válidos son: -Sí -No |
El valor predeterminado es no. |
| segmentationAllowed | VT_BSTR | Especifica si se usará la segmentación del administrador de cola MQSeries cuando un mensaje concreto supera la longitud máxima de mensajes de la cola MQSeries. | El valor válido es: -Sí -No |
El valor predeterminado es no. |
| fragmentationSize | VT_BSTR | Especifica el tamaño del fragmento de mensaje en kilobytes (KB) para los mensajes a medida que se envían entre el adaptador y MQSAgent. | Los valores válidos son de 1 a 1048576. | El valor predeterminado es 500. |
| ordered | VT_BSTR | Especifica si MQSeries mantiene el orden de los mensajes a medida que se envían a la cola MQSeries. | Los valores válidos son: -Sí -No |
El valor predeterminado es no. |
En el siguiente código se muestra el formato de la cadena que se utiliza para establecer las propiedades:
<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>
Nota
Al especificar datos de configuración transportTypeData para un adaptador que se compila mediante el marco de adaptador, los pares nombre/valor que se usan deben almacenarse en el <elemento AdapterConfig> . Dado que el <elemento AdapterConfig> especifica el tipo de datos VT_BSTR (vt="8"), los <> caracteres de los datos deben ser de escape.