Cómo configurar una ubicación de recepción MSMQ
Se pueden establecer variables de adaptador de ubicación de recepción de MSMQ en la consola de administración de BizTalk Server. Si no se definen las propiedades en la ubicación de recepción, se utilizarán los valores predeterminados del controlador de recepción definidos en la consola de administración de BizTalk Server.
Nota
Antes de completar este procedimiento, debe haber agregado un puerto de recepción. Para obtener más información, vea Cómo crear un puerto de recepción.
Importante
Si una instancia de host está asociada con una ubicación de recepción o un puerto de envío MSMQ, compruebe que el servicio MSMQ se está ejecutando en ese equipo. Si el servicio no está en ejecución, los puertos de recepción MSMQ se cerrarán poco después de que se inicien y se suspenderán los mensajes enviados a los puertos de envío MSMQ.
En un escenario agrupado, es necesario que tanto la instancia de MSMQ agrupada como el servicio MSMQ de cada uno de los equipos del clúster esté en ejecución.
Para configurar variables para una ubicación de recepción de MSMQ
Siga estos pasos para configurar variables para una ubicación de recepción MSMQ:
En la consola de administración de BizTalk Server, expanda administración BizTalk Server, expanda Grupo de BizTalk, expanda Aplicaciones y, a continuación, expanda la aplicación en la que desea crear una ubicación de recepción.
En la consola de administración de BizTalk Server, en el panel izquierdo, haga clic en el nodo Puerto de recepción. A continuación, en el panel de la derecha, haga clic con el botón secundario en el puerto de recepción asociado con una ubicación de recepción existente o que desee asociar con una nueva ubicación de recepción. A continuación, haga clic en Propiedades.
En el cuadro de diálogo Propiedades del puerto de recepción, en el panel izquierdo, seleccione Ubicaciones de recepción y, a continuación, en el panel derecho, haga doble clic en una ubicación de recepción existente o haga clic en Nuevopara crear una nueva ubicación de recepción.
En el cuadro de diálogo Propiedades de ubicación de recepción , en la sección Transporte junto a Tipo, seleccione MSMQ en la lista desplegable y, a continuación, haga clic en Configurar.
En el cuadro de diálogo Propiedades de transporte de MSMQ , haga lo siguiente:
Use Para hacer esto Tipo de fecha Valor predeterminado Contraseña Establecer una contraseña para usarla con una cola remota. String En blanco Nombre de usuario Determinar el nombre de usuario que se utilizará, junto con la contraseña, para tener acceso a una cola remota. No se puede utilizar el usuario local del equipo remoto como nombre de usuario. String En blanco Tamaño de lote Configurar el tamaño de lote. El adaptador de MSMQ envía mensajes por lotes a la base de datos de cuadros de mensaje. El tamaño predeterminado del lote es 20 y el tamaño mínimo del lote es 1. Nota: Si la propiedad Transactional de la ubicación de recepción se establece en True; cada lote de mensajes se envía a la base de datos messageBox en el contexto de una transacción del Coordinador de transacciones distribuidas de Microsoft (MSDTC). La transacción de MSDTC creada para un lote de mensajes permanece abierta hasta que todos los mensajes del lote se hayan guardado en el cuadro de mensajes y colocado en la cola de suscriptores apropiada. Por lo tanto, la duración de esta transacción de MSDTC aumenta en función del incremento del parámetro Tamaño del lote. Puesto que un gran número de transacciones de MSDTC abiertas de forma simultánea puede tener un efecto negativo en el rendimiento general, no debería asignarse un valor demasiado alto al parámetro Tamaño del lote cuando la compatibilidad con transacciones está habilitada. Int 20 En caso de error Especificar el modo en que el adaptador debe responder a un error. Defina esta propiedad con uno de los siguientes valores:
- Parada. Deje de recibir mensajes a través de esta ubicación de recepción si se produce una condición de error.
- Suspend(no reanudable). Suspenda los mensajes y marque como no reanudable.
- Suspend(reanudable). Suspenda los mensajes y marque como reanudable. Importante: Si la opción True para la propiedad Procesamiento ordenado , la opción Detener para la propiedad On Failure y la opción False para la propiedad Transactional se aplican al mismo tiempo, los mensajes que produzcan un error no se suspenderán ni dejarán en la cola de origen. En este escenario, puede que se pierda el mensaje. Para evitar la pérdida de datos, al usar la característica Procesamiento ordenado , la opción Detener para la propiedad On Failure solo se debe aplicar si se aplica la opción True para la propiedad Transactional . De este modo, si se produce un error de entrega, el mensaje original se colocará en la cola de origen de MSMQ. Si la propiedad Procesamiento ordenado se establece en un valor false, la propiedad On Failure no surtirá efecto y si se produce un error de entrega de mensajes, el mensaje se suspenderá con el estado Suspendido (reanudable).String Suspender (reanudable) Procesamiento ordenado Establezca esta propiedad en True o False. Indica si los mensajes se procesan en serie. Al establecer la propiedad en True , se admitirá la entrega de mensajes ordenada cuando se use junto con un puerto de envío de mensajería o orquestación de BizTalk que tenga la opción Entrega ordenada establecida en True. Para obtener más información, vea Entrega ordenada de mensajes.
Al establecer esta propiedad en True , también se optimiza el uso de recursos al controlar mensajes grandes mediante la creación del adaptador de un solo subproceso. Para obtener más información, consulte Envío y recepción de mensajes grandes mediante el adaptador de MSMQ.Boolean False Cola Escribir una ruta válida de acceso a la cola. Dependiendo de la ruta de la cola especificada, el sistema realiza las validaciones oportunas. Nota: El URI de un puerto de envío o una ubicación de recepción no puede superar los 256 caracteres. Nota: El adaptador de recepción de MSMQ usa un mecanismo de sondeo para supervisar la cola de MSMQ especificada para los nuevos mensajes cada 0,5 segundos. Este intervalo de 0,5 segundos es un intervalo fijo. String En blanco Transaccional Establezca esta propiedad en True o False. Nota: El adaptador admite solo lecturas transaccionales de colas remotas con Message Queuing 4.0 o posterior. En este escenario, tanto la BizTalk Server como el servidor remoto de Message Queuing deben ejecutar Message Queuing 4.0 o posterior.
Para obtener más información, vea Configuring the MSMQ Adapter and Considerations for Running Adapter Handlers within a Clustered Host.Boolean False Nota
El nombre de usuario y la contraseña solo se aplican a las cuentas de Windows que se usan para acceder a las colas remotas.
Haga clic en OK.
En el cuadro de diálogo Propiedades de ubicación de recepción, escriba los valores adecuados para completar la configuración de la ubicación de recepción y haga clic en Aceptar para guardar la configuración. Para información sobre el cuadro de diálogo Propiedades de ubicaciones de recepción , vea Cómo crear una ubicación de recepción.