Cómo configurar un puerto de envío para el adaptador de MQSC

  • Artículo

Configure un puerto de envío 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 envío

  1. En Inicio, seleccione Microsoft BizTalk Server y, a continuación, haga clic en Administración de BizTalk Server.

  2. En el árbol de consola, expanda Grupo de BizTalk, expanda Aplicacionesy, a continuación, seleccione la aplicación para la que desea crear un puerto de envío.

  3. Haga clic con el botón derecho en Puertos de envío, seleccione Nuevoy, a continuación, haga clic en Puerto de envío unidireccional estático.

  4. En la ventana Propiedades del puerto de envío, seleccione mqsc en la lista Tipo de transporte .

  5. Haga clic en Configurar.

  6. En la ventana Propiedades de transporte del adaptador, configure las propiedades del puerto de envío (consulte las tablas al final de este procedimiento).

    Nota

    Se requieren las siguientes propiedades para configurar un puerto de envío:

    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.

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

  8. En la ventana Propiedades del puerto de envío, en la lista Controlador de envío, seleccione la instancia de host en la que se ejecuta el adaptador de envío.

  9. En la lista Enviar canalización , seleccione la canalización que procesa los mensajes enviados a través de este puerto.

  10. Haga clic en OK.

  11. En la ventana Puertos de envío, haga clic con el botón derecho en el puerto de envío en la columna Nombre y seleccione Inscribir.

  12. Haga clic con el botón derecho en el puerto de envío en la columna Nombre y seleccione Iniciar.

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

    Use Para hacer esto
    Afiliada de SSO Establece la aplicación afiliada de inicio de sesión único (SSO). Se utiliza el Id. de usuario y la contraseña de SSO para la propiedad MQMD_UserIdentifier y la propiedad MQIIH_Authenticator (o MQCIH_Authenticator), respectivamente. Se supone que existe un vale de SSO válido.

    Valor predeterminado: en blanco
    Transacciones admitidas Cuando esta propiedad se establece en Sí, el adaptador MQSC funciona junto con webSphere MQ Extended Transactional Client (Extended-Client) en el equipo de 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

    En la sección Definición de canal de la 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 a los que el adaptador mqsC envía 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 de la ventana Propiedades de transporte , puede establecer las siguientes propiedades.

    Use Para hacer esto
    Segmentación permitida Establézcalo en Sí para indicar a MQSeries Queue Manager que cree mensajes segmentados al enviar mensajes grandes a colas mqSeries.

    Valor predeterminado: No

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

    Use Para hacer esto
    Cola Cola MQSeries a la que el adaptador enviará mensajes.

    Se admiten definiciones de colas remotas, colas locales, colas de alias y colas de transmisión.

    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 a las que el adaptador enviará 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.

  13. 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 recepción y una ubicación de recepción para el adaptador de MQSC