Cómo configurar un puerto de recepción y una ubicación de recepción para el adaptador de MQSC

Configure un puerto de recepción y una ubicación de recepción para el adaptador de BizTalk para WebSphere MQ mediante la consola de administración de BizTalk Server. Es preciso haber iniciado sesión con una cuenta que sea miembro del grupo de administradores de BizTalk Server. Además, debe tener los permisos adecuados en la base de datos single Sign-On (SSO).

Para configurar un puerto de recepción y una ubicación de recepción

1. En Programas, seleccione Microsoft BizTalk Server y, a continuación, seleccione administración BizTalk Server.

2. En el árbol de consola, expanda Grupo de BizTalk, expanda Aplicaciones y, a continuación, seleccione la aplicación para la que desea crear un puerto de recepción.

3. Haga clic con el botón derecho en Puertos de recepción, seleccione Nuevoy, a continuación, haga clic en Puerto de recepción unidireccional.

4. En la ventana Propiedades del puerto de recepción , configure las propiedades del puerto y, a continuación, haga clic en Aceptar.

5. En el árbol de consola, haga clic con el botón derecho en Ubicaciones de recepción, seleccione Nuevoy, a continuación, haga clic en Ubicación de recepción unidireccional.

6. En la ventana Seleccionar un puerto de recepción, haga clic en el puerto de recepción que creó en el paso anterior y, a continuación, haga clic en Aceptar.

7. En la ventana Propiedades de ubicación de recepción, seleccione el adaptador MQSC como Tipo de transporte y, a continuación, haga clic en Configurar.

8. En la ventana Propiedades de transporte del adaptador, configure las propiedades de la ubicación de recepción (consulte las tablas al final de este procedimiento).

   Nota

   Se requieren las siguientes propiedades para configurar una ubicación de recepción:

   Nombre del canal (se trata de una propiedad que distingue mayúsculas de minúsculas).

   Nombre de la conexión

   Tipo de transporte

   Queue (se trata de una propiedad que distingue mayúsculas de minúsculas).

   Queue Manager (se trata de una propiedad que distingue mayúsculas de minúsculas).

   Si no especifica una propiedad Channel Name, debe proporcionar un archivo de definición de canal de cliente para habilitar el cliente WebSphere MQ instalado en el equipo de BizTalk Server para comunicarse con administradores de colas remotos. También debe proporcionar un archivo de definición de canal de cliente si configura Capa de sockets seguros (SSL) para trabajar con mensajería transaccional. Para obtener más información, vea Cómo configurar un archivo de definición de canal de cliente.

9. Cuando haya terminado de configurar las propiedades, haga clic en Aceptar.

10. En la ventana Propiedades de ubicación de recepción, en la lista Controlador de recepción, seleccione la instancia del host de BizTalk Server en el que se ejecutará la ubicación de recepción.

    El controlador de recepción debe estar en ejecución en este host.

11. En la lista Canalización de recepción, seleccione la canalización de recepción que se usará para recibir mensajes en esta ubicación de recepción.

12. Haga clic en OK.

13. En la ventana Ubicaciones de recepción , haga clic con el botón derecho en la ubicación de recepción en la columna Nombre y seleccione Habilitar.

    Propiedades de la ubicación de recepción

    En la sección Avanzadas de la ventana Propiedades de transporte , puede establecer las siguientes propiedades.

    Use	Para hacer esto
    Desplazamiento de datos para encabezados	El adaptador usa valores de los encabezados MQSeries (las estructuras MQMD, MQXQH, MQIIH y MQCIH) y rellena 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. Establezca en No para conservar las propiedades en el cuerpo del mensaje. Valor predeterminado: Sí
    Umbral de errores del registro de sucesos	Número máximo del mismo error que se va a registrar para determinadas condiciones de error. El adaptador continúa funcionando y, si el adaptador se recupera, registra el evento en el registro de aplicaciones. Valor predeterminado: 10
    Ordenó	Establézcalo en Sí para mantener el orden de los mensajes a medida que se reciben de la cola MQSeries y se envían al cuadro de mensajes de BizTalk Server. Para el lado de envío, el adaptador envía el mensaje a la cola en el mismo orden en que lo recibe del cuadro de mensaje. Establezca en No para no mantener el orden de los mensajes. Para el pedido de envío, si no usa Orchestration, debe habilitar La entrega ordenada en las opciones avanzadas de transporte de la configuración del puerto de envío. Para la ordenación del lado de recepción, si usa Orchestration, también debe establecer la propiedad Entrega ordenada en True en la orquestación de la ubicación de recepción. La entrega ordenada puede reducir el rendimiento; a menos que necesite la entrega ordenada, no se recomienda. Valor predeterminado: No
    Detenerse ante errores	Establezca en Sí para detener el procesamiento si se produce un error. Esta opción finaliza la transacción y deshabilita la ubicación de recepción si hay un error. Valor predeterminado: No
    Suspender como no reanudable	Establézcalo en Sí para mover un mensaje a la cola suspendida cuando haya un error e indique si es reanudable o no. La habilitación de este valor no conserva la entrega ordenada cuando se produce un error, pero permite que la ubicación de recepción continúe recibiendo mensajes. Valor predeterminado: No
    Transacciones admitidas	Cuando se establece en Sí, el adaptador MQSC funciona junto con webSphere MQ Extended Transactional Client (Extended-Client) en el equipo BizTalk Server para evitar la pérdida de mensajes y garantizar la entrega de mensajes una vez y solo una vez. Cuando se establece en No, puede producirse la duplicación de mensajes. En este caso, el adaptador usa el cliente WebSphere MQ (base-client) no transaccional para la integración con MQSeries. Valor predeterminado: No
    Intervalo de espera	Cuando se realiza MQGet para recuperar mensajes de la cola MQSeries, se puede establecer la opción MQGMO para el intervalo de espera. Si no hay ningún mensaje en la cola, el adaptador espera el tiempo especificado (en segundos) antes de cerrar la solicitud del cliente. En cuanto llegan los mensajes a la cola, el adaptador comienza a recuperar los mensajes. Valor predeterminado: 3

    En la sección Definición de canal del ventana Propiedades de transporte, puede establecer las siguientes propiedades.

    Use	Para hacer esto
    Nombre del canal	Nombre del canal definido en el equipo del servidor MQSeries con el que se comunica el cliente. Debe ser un tipo de canal "Conexión de servidor". Tenga en cuenta que se trata de una propiedad que distingue mayúsculas de minúsculas.
    Nombre de la conexión	Nombre del servidor MQSeries que contiene el Administrador de colas y las colas de las que el adaptador MQSC recibe mensajes. Para el tipo de transporte TCP, el formato que se va a especificar es SERVERNAME(PORT). El número de puerto es equivalente al número de puerto definido en el agente de escucha asociado al Administrador de colas. El nombre del servidor también se puede especificar como una dirección IP. Para LU6.2, especifique el nombre de LU o el nombre del grupo de LU configurado en Host Integration Server.
    Latido del corazón	Número de segundos entre comprobaciones para comprobar que la conexión de cliente o servidor funciona. Valor predeterminado: 300
    Contraseña	Contraseña que el MCA puede usar al intentar iniciar una sesión segura de LU 6.2 con un MCA remoto. El valor inicial de esta propiedad opcional es NULL.
    Especificación de cifrado SSL	Define un único CipherSpec para una conexión SSL que usará el punto de conexión configurado en el adaptador. Ambos extremos de una definición de canal SSL de WebSphere MQ deben incluir el atributo y el valor especificado aquí debe coincidir con el nombre especificado en el extremo del servidor del canal. El valor es una cadena con una longitud máxima de 32 caracteres. Solo es necesario cuando SSL está configurado para la comunicación entre el cliente MQSeries y los administradores de colas remotos.
    Nombre del mismo nivel SSL	Se usa para comprobar el nombre distintivo (también conocido como DN) del certificado del administrador de colas del mismo nivel o del cliente en el otro extremo de un canal de WebSphere MQ. Si el nombre distintivo que se recibe del mismo nivel no coincide con este valor, el canal no se inicia. Solo es necesario cuando SSL está configurado para la comunicación entre el cliente MQSeries y los administradores de colas.
    Tipo de transporte	Se admiten TCP y LU6.2. Valor predeterminado: TCP
    Id. de usuario	Identificador de usuario de MCA que usa MQSeries MCA para la autorización para acceder a los recursos de MQSeries. El valor inicial es NULL. Se trata de una propiedad opcional. Cuando este atributo está en blanco, MCA usa su identificador de usuario predeterminado.

    En la sección MQSeries del ventana Propiedades de transporte, puede establecer las siguientes propiedades.

    Use	Para hacer esto
    Juego de caracteres	Juego de caracteres en el que se debe convertir el mensaje cuando se reciben mensajes de la cola MQSeries. Si esta propiedad se establece en un valor distinto de None, el adaptador establece la opción MQGMO CONVERT al realizar un MQGet. Ninguno: no convertir. UCS-2 y UTF-16: convertir en estos juegos de caracteres. MQSeries no distingue un juego de otro. UTF-8: convertir en el juego de caracteres UTF-8. Valor predeterminado: None
    Segmentación permitida	Establecer MQSeries para que ensamble mensajes segmentados o para que obtenga el mensaje tal cual. Utilizar No se requiere acción para leer mensajes de la cola MQSeries sin habilitar la segmentación. Utilizar Completar mensaje para que MQSeries ensamble mensajes segmentados antes de pasarlos al adaptador. Valor predeterminado: Sin acción

    En la sección Rendimiento del ventana Propiedades de transporte, puede establecer las siguientes propiedades.

    Use	Para hacer esto
    Tamaño máximo de lote	Tamaño máximo de un lote de mensajes en KB. Esta propiedad y Maximum Messages in Batch funcionan conjuntamente para que el límite sea el valor que alcance el adaptador primero. Valor predeterminado: 100
    Número máximo de mensajes en lote	Número máximo de mensajes de 1 a 10 000 en un lote. Esta propiedad y el tamaño máximo de lote funcionan conjuntamente para que el límite sea el valor que alcance el adaptador primero. Valor predeterminado: 10
    Subprocesos	Número de subprocesos usados por ubicación de recepción. Valor predeterminado: 2

    En la sección Definición de cola del ventana Propiedades de transporte, puede establecer las propiedades enumeradas en la tabla siguiente.

    Use	Para hacer esto
    Cola	Cola MQSeries desde la que el adaptador recibirá mensajes (MQGet). Se admiten colas de transmisión, colas locales, colas de alias. Tenga en cuenta que se trata de una propiedad que distingue mayúsculas de minúsculas.
    Administrar cola	Nombre del Administrador de colas mqSeries que contiene las colas de las que el adaptador recuperará los mensajes. Se admiten los administradores de colas en clúster. Tenga en cuenta que se trata de una propiedad que distingue mayúsculas de minúsculas.

14. Haga clic en OK.

Consulte también

Adaptador de BizTalk para WebSphere MQ
Cómo configurar un archivo de definición de canal de cliente
Cómo configurar un puerto de envío para el adaptador de MQSC