Configuración de la fábrica de conexiones del proveedor de mensajería IBM MQ

Utilice este panel para ver o cambiar las propiedades de configuración de una fábrica de conexiones seleccionada para su uso con el proveedor de mensajería IBM MQ. Estas propiedades de configuración controlan cómo se crean las conexiones con colas y temas JMS asociados.

El proveedor de mensajería IBM MQ soporta interfaces independientes del dominio JMS 1.1, como la fábrica de conexiones JMS unificada. Una aplicación independiente de dominio puede utilizar la misma interfaz para mensajería punto-a-punto o de publicación/suscripción y puede tener soporte para ambas, la mensajería de punto a punto y de publicación/suscripción en la misma transacción. Con JMS 1.1, se recomienda utilizar las fábricas de conexiones JMS unificadas independientes de dominio para aplicaciones nuevas. Una interfaz específica de dominio amplía el equivalente independiente del dominio, por lo que una aplicación que utiliza fabricas de conexiones de cola y de tema específicas de dominio puede elegir qué interfaz utilizar de los dos.

Para ver valores de la fábrica de conexiones IBM MQ, utilice la consola administrativa para completar los pasos siguientes:
  1. En el panel de navegación, pulse Recursos > JMS -> Fábricas de conexionespara visualizar las fabricas de conexiones existentes.
  2. Si es necesario, en el panel de contenido, cambie el valor Ámbito por el nivel en el que se definen las fábricas de conexiones. Esto restringe el conjunto de fábricas de conexiones visualizadas.
  3. Seleccione el nombre de la fábrica de conexiones con la que desea trabajar.
En Propiedades generales existen cuatro grupos de propiedades:
Realice los cambios necesarios en los grupos de propiedades de valores de Administración, Conexión, Avanzadas y Seguridad y, a continuación, pulse Aplicar para guardar, en el panel de contenido de Propiedades adicionales, la configuración antes de pulsar cualquiera de los enlaces siguientes:
  • Propiedades avanzadas para mostrar o cambiar las propiedades avanzadas de la fábrica de conexiones IBM MQ.
  • Propiedades de intermediario para mostrar o cambiar las propiedades de intermediario de la fábrica de conexiones IBM MQ.
  • Propiedades personalizadas para mostrar o cambiar las propiedades personalizadas de la fábrica de conexiones IBM MQ.
  • Propiedades de transporte de cliente para mostrar o cambiar las propiedades de transporte de cliente de la fábrica de conexiones IBM MQ. Si la fábrica de conexiones seleccionada no se ha creado utilizando una tabla de definición de canal de cliente (CCDT), siga este enlace para entrar toda la información necesaria para conectarse a IBM MQ. Si la fábrica de conexiones seleccionada se ha creado utilizando una CCDT, no necesita proporcionar las propiedades de transporte de cliente, de modo que el enlace no existe.
  • Agrupaciones de conexiones para mostrar o cambiar el detalle de agrupaciones de conexiones de la fábrica de conexiones IBM MQ.
  • Agrupaciones de sesiones para mostrar o cambiar el detalle de agrupaciones de sesiones de la fábrica de conexiones IBM MQ.

En Elementos relacionados, puede pulsar JAAS - Datos de autenticación J2C para configurar la información de autenticación que se va a utilizar con la fábrica de conexiones.

Puede especificar las propiedades adicionales siguientes utilizando mandatos administrativos de IBM MQ:
  • -localAddress
  • -clonedSubs
  • -componentAuthAlias
Para más información sobre estas propiedades, consulte Mandato createWMQConnectionFactory.
Nota: Al especificar propiedades de IBM MQ, se aplican las restricciones siguientes:
  • Los nombres pueden tener un máximo de 48 caracteres, con la excepción de los canales, que tienen un máximo de 20 caracteres.
  • Los valores de propiedad que especifique deben coincidir con los valores que especifique cuando configure IBM MQ para los recursos JMS. Si desea más información sobre cómo configurar recursos JMS de IBM MQ, consulte las secciones Utilización de Java y Administración del sistema IBM MQ del IBM MQ Knowledge center.

Si se ha inhabilitado la funcionalidad de IBM MQ en un ámbito que afecte a este recurso de proveedor de mensajería IBM MQ, aparece un mensaje informativo en el que se indica que se ha inhabilitado IBM MQ. En un entorno de servidor único, este mensaje informativo sólo se visualiza cuando se reinicia el servidor después de que se haya inhabilitado la funcionalidad de IBM MQ. En un entorno de despliegue de red, el mensaje informativo se visualiza inmediatamente.

Una fábrica de conexiones unificada IBM MQ tiene las propiedades siguientes.

Administración

Ámbito

Nivel al que esta definición de fábrica de conexiones está visible a las aplicaciones.

Los recursos tales como los proveedores de mensajería, los enlaces de espacio de nombres o las bibliotecas compartidas se pueden definir en varios ámbitos, de tal modo que los recursos definidos en ámbitos más específicos alteren temporalmente los duplicados definidos en ámbitos más generales.

El ámbito mostrado es sólo a efectos informativos y no puede cambiarse en este panel. Si desea examinar o modificar otros recursos en un ámbito distinto, modifique el ámbito en el panel de colección de fábricas de conexiones y, a continuación, pulse Aplicar antes de pulsar el enlace del tipo de recurso.

Información Value
Tipo de datos Serie

Proveedor

El proveedor de JMS asignado cuando se creó la fábrica de conexiones de cola.

Para todas las fábricas de conexiones que utilizan este panel, el proveedor es el proveedor de mensajería IBM MQ.

El proveedor es meramente informativo.

Información Value
Tipo de datos Serie

Name

Nombre por el que se conoce a esta fábrica de conexiones a efectos administrativos en WebSphere Application Server.

Información Value
Tipo de datos Serie
Rango El nombre debe ser exclusivo dentro del conjunto de fábricas de conexiones definas en la célula.

Nombre JNDI

Nombre JNDI utilizado para enlazar la fábrica de conexiones en el espacio de nombres JNDI.

Como convenio, utilice el nombre JNDI completo; por ejemplo, con el formato jms/Nombre, donde Nombre es el nombre lógico del recurso.

Información Value
Tipo de datos Serie

Descripción

Una descripción de esta fábrica de conexiones con fines administrativos en WebSphere Application Server.

Información Value
Tipo de datos Serie
Valor por omisión Nulo

Conexión

La información necesaria para configurar una conexión depende de que la fábrica de conexiones de cola seleccionada se haya creado utilizando una Tabla de definiciones de canal de cliente (CCDT).

Si la fábrica de conexiones seleccionada se ha creado utilizando una CCDT, sólo se visualizan las propiedades siguientes:
  • URL de tabla de definición del canal de cliente
  • Gestor de colas
  • Configuración SSL
Si la fábrica de conexiones seleccionada no se ha creado utilizando una CCDT, se visualizan las propiedades siguientes:
  • Gestor de colas
  • Transporte
  • Si la opción Introducir información sobre el host y el puerto en forma de valores separados de host y de puerto está seleccionada, la propiedad de lista nombre de conexión no se puede utilizar y las propiedades siguientes se pueden utilizar:
    • Nombre de host
    • Puerto
  • Si Entre información del host y puerto en forma de una lista de nombres de conexión está seleccionada, la propiedad de lista de nombres de conexión se puede utilizar y las propiedades siguientes no se pueden utilizar:
    • Nombre de host
    • Puerto
  • Canal de conexión de servidor
  • Si desmarca el recuadro de selección para la propiedad Utilizar SSL para proteger la comunicación con IBM MQ, no se pueden utilizar las propiedades siguientes.
    • Gestionado centralmente
    • Configuración específica
    • Configuración SSL

Si desea más información sobre cómo definir las propiedades SSL para IBM MQ, consulte la sección Propiedades SSL en la sección Utilización de Java del IBM MQ Information Center.

URL de tabla de definición del canal de cliente

URL que especifica la ubicación de una CCDT de IBM MQ.

Información Value
Tipo de datos Serie

Gestor de colas

Si la fábrica de conexiones especificada se basa en una CCDT, esta propiedad se utiliza para seleccionar una entrada en la CCDT. De lo contrario, esta propiedad especifica el nombre del gestor de colas o el grupo de compartimiento de colas al que conectarse. Se establece una conexión con el recurso IBM MQ especificado para enviar o recibir mensajes.

Información Value
Tipo de datos Serie
Rango Si esta fábrica de conexiones no se basa en una CCDT, el valor debe ser un nombre de gestor de colas válido.
Si la fábrica de conexiones se basa en una CCDT, el valor debe ser uno de los siguientes:
  • Un nombre de gestor de colas válido
  • Un asterisco (*) seguido del nombre de un grupo de gestores de colas1
  • Un asterisco (*)
  • En blanco1
1Cuando se especifica el valor de la propiedad del gestor de colas en este formulario en combinación con una CCDT, las conexiones individuales establecidas mediante la fábrica de conexiones pueden conectarse a distintos gestores de colas. La selección de varios gestores de colas se produce cuando la CCDT contiene varias definiciones de canal de conexión de cliente con un parámetro de nombre de gestor de colas (QMNAME) coincidente, y estas definiciones de canal de conexión definen los detalles de conexión de red de gestores de colas diferentes.
Si la fábrica de conexiones especificada se basa en CCDT y CCDT puede seleccionar entre más de un gestor de colas, es posible que no pueda recuperar las transacciones globales. Por lo tanto, para las fábricas de conexiones que especifican una CCDT, tiene dos alternativas:
  • Evitar la ambigüedad sobre el gestor de colas de destino al especificar la propiedad de Gestor de colas, que significa que el valor especificado de esta propiedad no debe incluir un asterisco (*).
  • Evitar utilizar los recursos con aplicaciones que se inscriban en transacciones globales.

Transporte

El tipo de transporte de IBM MQ para la conexión. El tipo de transporte se utiliza para determinar los mecanismos exactos utilizados para conectarse a IBM MQ.

Información Value
Tipo de datos Lista desplegable
Valor por omisión Enlaces, después cliente
Rango
Cliente
Utilice una conexión de red basada en TCP/IP para comunicarse con el gestor de colas IBM MQ.
Enlaces, después cliente
Intenta una conexión en modalidad de enlace con el gestor de colas. Si esto no es posible, vuelve el transporte del cliente.
Enlaces
Establece una conexión de memoria cruzada con un gestor de colas que se ejecuta en el mismo nodo. Las siguientes propiedades de modalidad de transporte de cliente están inhabilitadas:
  • Nombre de host
  • Puerto
  • Lista de nombres de conexión
  • Canal de conexión de servidor
Para más información sobre la configuración de un tipo de transporte de Enlaces, si no cliente o Enlaces, consulte Configuración del proveedor de mensajería de IBM MQ con información de bibliotecas nativas

Introducir información sobre el host y el puerto en forma de valores separados de host y de puerto.

Si se ha seleccionado este botón de selección, esto significa que la conexión con el gestor de colas de IBM MQ se realiza utilizando la información proporcionada por las propiedades de nombre de host y de puerto.

Al seleccionar esta opción, se habilitan las propiedades de nombre de host y de puerto y se inhabilita la propiedad de lista de nombre de conexión. Para especificar información de la lista de nombres de conexión, pulse Entre información del host y puerto en el formato de una lista de nombres de conexión.

Este botón de selección sólo está disponible si la propiedad de ámbito especifica una célula o un clúster, o si la propiedad de ámbito especifica un nodo o servidor y dicho nodo o servidor está ejecutando la versión 8.0 o posterior de WebSphere Application Server.

Información Value
Tipo de datos Botón de selección

Nombre de host

El nombre de host o la dirección IPv4 o IPv6 del gestor de colas de IBM MQ al que va a conectarse.

Información Value
Tipo de datos Serie

Puerto

El número de puerto en el que está escuchando IBM MQ.

Información Value
Tipo de datos Integer
Valor por omisión 1414
Rango El valor debe ser un entero dentro del rango 1 - 65536 (ambos incluidos).

Introducir información sobre el host y el puerto en forma de lista de nombres de conexión

Si se ha seleccionado este botón de selección, esto significa que la conexión con el gestor de colas de IBM MQ se realiza utilizando la información proporcionada por la propiedad de lista de nombres de conexión.

La lista de nombres de conexión se puede utilizar para conectarse a un gestor de colas único o a un gestor de colas de varias instancias. Para obtener más información sobre la utilización de un gestor de colas de varias instancias, consulte el Information Center de IBM MQ. Al seleccionar esta opción se habilita la propiedad de lista nombre de conexión y se inhabilita el nombre de host y el puerto propiedades. Para introducir de forma separada la información de host y de puerto, pulse Introducir información sobre el host y el puerto en forma de valores separados de host y de puerto.

Este botón de selección sólo está disponible si la propiedad de ámbito especifica una célula o un clúster, o si la propiedad de ámbito especifica un nodo o servidor y dicho nodo o servidor está ejecutando la versión 8.0 o posterior de WebSphere Application Server.

Información Value
Tipo de datos Botón de selección

Lista de nombres de conexión

La lista de nombres de conexión que especifica los detalles de nombre de host y puerto que utilizará cuando desee que la fábrica de conexiones se conecte a un gestor de colas de varias instancias.

Esta propiedad sólo se debe utilizar para permitir una conexión a un gestor de colas de varias instancias. No debe utilizarse para permitir las conexiones a gestores de colas instancia que no sean de varias instancias, porque puede producir problemas de integridad de transacción.

Información Value
Tipo de datos Serie
Valor por omisión No establecido
Rango Este campo debe establecerse en una serie con el formato siguiente:

host[(puerto)][,host(puerto)]

La información de puerto es opcional y, si no se especifica, el valor predeterminado es 1414.

El host debe ser un nombre de host TCP/IP válido o una dirección IPv4 o IPv6.

El puerto debe ser un valor entero dentro del rango 1 - 65536 (ambos incluidos).

Por ejemplo: localhost(1234),remotehost1(1234),remotehost2

Cuando se especifica la propiedad de lista nombres de conexión, el nombre de host o las propiedades de puerto se establecen automáticamente en el nombre de host y el número de puerto de la primera entrada de la lista de nombres de conexión. Por tanto, si especificó localhost(1234),remotehost1(1234),remotehost2, el nombre de host se establecería en localhost y el puerto se establecería en 1234.

Esta propiedad sólo está disponible si la propiedad de ámbito especifica una célula o un clúster, o si la propiedad de ámbito especifica un nodo o servidor y dicho nodo o servidor está ejecutando la versión 8.0 o posterior de WebSphere Application Server.

Cuando se utiliza en un entorno de célula mixto, la información de la propiedad de lista de nombres de conexión no está disponible en las versiones de WebSphere Application Server anteriores a la versión 8.0. En este caso, se utiliza en su lugar la información de los campos de nombre de host y puerto, basada en el primer elemento de la lista de nombres de conexión.

Canal de conexión de servidor

El nombre del canal de conexión del servidor de IBM MQ se utiliza al conectar con IBM MQ.

Información Value
Tipo de datos Serie
Valor por omisión SYSTEM.DEF.SVRCONN
Rango El valor debe ser un canal de conexión de servidor definido en el gestor de colas de IBM MQ al que se está conectando.

Utilizar SSL para proteger las comunicaciones con IBM MQ

Esta opción determina si el protocolo SSL (Secure Sockets Layer) se utiliza para proteger las comunicaciones de red con el gestor de colas o el grupo de compartimiento de colas de IBM MQ.

Al utilizar una fábrica de conexiones de proveedor de mensajería IBM MQ en el entorno de servidor de aplicaciones, el servidor de aplicaciones gestiona la configuración de SSL. Para modificar los parámetros de configuración de SSL, utilice la consola de administración para desplazarse hasta el panel Seguridad > Gestión de claves y certificados SSL.

Al utilizar una fábrica de conexiones de proveedor de mensajería IBM MQ en el entorno de cliente, el cliente adopta la información de configuración de SSL del archivo ssl.client.props. El uso de este archivo se detalla en la información de referencia relacionada de este tema.

Solo puede utilizar una suite de cifrado en la configuración de SSL para una fábrica de conexiones de proveedor de mensajería IBM MQ. Si especifica más de una suite de cifrado, solamente se utilizará la primera.

Información Value
Tipo de datos Recuadro de selección. Si este recuadro de selección no está seleccionado, las siguientes propiedades SSL están inhabilitadas:
  • Gestionado centralmente
  • Configuración específica
  • Configuración SSL

Gestionado centralmente

Cuando se utiliza el protocolo SSL para comunicarse con IBM MQ, seleccione este botón de opción para especificar que la configuración de SSL se ha obtenido de la configuración de SSL de WebSphere Application Server gestionada de forma central.

Cuando se selecciona este botón de selección, los atributos de nombre de host y puerto de la fábrica de conexiones del proveedor de mensajería de IBM MQ se utilizan para seleccionar una configuración de SSL adecuada. Si se ha proporcionado información sobre el host y el puerto mediante una lista de nombres de conexión, esto significa que se utiliza la información de nombre de host y puerto del primer elemento de la lista para seleccionar una configuración de SSL adecuada. Para proporcionar la configuración de SSL que debe coincidir con la de la fábrica de conexiones, consulte el tema Valores de configuración de SSL de punto final de salida dinámica que aparece en las referencias relacionadas.

Información Value
Tipo de datos Botón de selección

Configuración específica

Seleccione este botón de selección cuando desee especificar una configuración SSL concreta para utilizar cuando se debe utilizar SSL para proteger las comunicaciones de red con el gestor de colas o el grupo de compartición de cola de IBM MQ.

Información Value
Tipo de datos Botón de selección

Configuración SSL

La configuración de SSL para utilizar cuando se va a utilizar SSL para proteger comunicaciones de red con el gestor de colas IBM MQ o el grupo de compartición de colas.

Esta propiedad no está habilitada si el botón de selección Gestionado centralmente está seleccionado y el recurso del proveedor de mensajería de IBM MQ se ha definido de forma explícita.

Esta propiedad está siempre habilitada si el recurso del proveedor de mensajería de IBM MQ se basa en una CCDT.

Si este recurso de proveedor de mensajería de IBM MQ se basa en una CCDT, este parámetro sólo se utiliza si las entradas correspondientes en la CCDT se han configurado para utilizar SSL.

Además, si está seleccionada una configuración de SSL de none, se utiliza la configuración de SSL predeterminada de WebSphere Application Server gestionada centralmente para el proveedor de mensajería IBM MQ.

Información Value
Tipo de datos Lista desplegable

Avanzada

ID de cliente

El identificador de cliente que debe especificarse al conectar con el proveedor de mensajería de IBM MQ.

La identidad del cliente no es un ID de usuario en el sentido habitual y no está relacionada con la seguridad. Se utiliza por suscripciones duraderas en la mensajería de publicación/suscripción. Una suscripción duradera sigue recopilando mensajes mientras el suscriptor está "ausente" (por ejemplo, no en ejecución o anómalo) y proporciona los mensajes cuando el suscriptor se vuelve a conectar. La identidad del cliente es la señal que indica qué suscriptor es cuando se vuelve a conectar para que pueda obtener los mensajes que se han guardado en su ausencia.

Información Value
Tipo de datos Serie

Permitir suscripciones duraderas clonadas

Opción que determina si diferentes servidores pueden acceder simultáneamente a múltiples instancias de una suscripción duradera.

Información Value
Tipo de datos Recuadro de selección
Valor por omisión Deseleccionado
Rango
Seleccionado
Diferentes servidores pueden acceder simultáneamente a múltiples instancias de una suscripción duradera.
Deseleccionado
Diferentes servidores no pueden acceder simultáneamente a múltiples instancias de una suscripción duradera.

Versión del proveedor

Versión del proveedor de mensajería de IBM MQ. Este valor se utiliza para determinar si se conecta a una versión concreta de un gestor de colas. También se utiliza para determinar el tipo de funciones que necesita el cliente.

Información Value
Tipo de datos Serie
Rango El valor especificado debe ser una serie vacía o tener uno de los siguientes formatos:
  • n.n.n.n
  • n.n.n
  • n.n
  • n
Donde n es un valor numérico superior o igual a cero.

Por ejemplo 6.0.0.0.

Soportar protocolo de compromiso de dos fases distribuido

Opción que especifica si la fábrica de conexiones soporta la coordinación XA de transacciones de mensajería. Habilite esta opción si va a utilizar múltiples recursos, incluyendo esta fábrica de conexiones, en la misma transacción.

Si no selecciona esta propiedad, inhabilitará el soporte para el protocolo de compromiso de dos fases distribuido. La sesión JMS puede estar todavía en una transacción, pero utiliza las llamadas de transacción local de gestor de recursos session.commit y session.rollback en lugar de las llamadas de XA. Esto puede llevar a una mejora en el rendimiento. Sin embargo, sólo un único recurso se puede inscribir en una transacción en WebSphere Application Server.

El soporte de último participante le permite incluir un recurso que no sea XA con otros recursos compatibles con XA.

Información Value
Tipo de datos Recuadro de selección
Valor por omisión Seleccionado
Rango
Seleccionado
La fábrica de conexiones soporta el uso de protocolos de compromiso de dos fases distribuidos para la coordinación del trabajo de transacción.
Deseleccionado
La fábrica de conexiones no soporta el uso de protocolos de compromiso de dos fases distribuidos para la coordinación del trabajo de transacción.

Mantenga seleccionada esta opción si en las transacciones se ven involucrados otros recursos, incluyendo otras colas o temas. Deseleccione esta opción sólo cuando tenga la certeza de que el gestor de colas que es el destino de esta conexión de cola es el único recurso de la transacción.

Valores de seguridad

Alias de autenticación para recuperación XA

El nombre de usuario y la contraseña para utilizar al conectarse a IBM MQ durante la recuperación de XA.

Información Value
Tipo de datos Lista desplegable
Valor por omisión (ninguno)
Rango Todos los alias de autenticación definidos en la célula y el valor "(none)", que especifica que no se pasa ninguna credencial a IBM MQ durante la recuperación de XA.

Alias de correlación-configuración

Este campo sólo se utiliza en ausencia de una configuración de inicio de sesión en la referencia de recursos de componente.

Cuando el valor de autorización del recurso es "contenedor", la mejor forma de definir la estrategia de autenticación es especificar una configuración de inicio de sesión y las propiedades asociadas en la referencia del recurso de componente.

Si se especifica la configuración de inicio de sesión DefaultPrincipalMapping, la propiedad asociada es un alias de entrada de JAAS - Datos de autenticación J2C. Para configurar la información de autenticación para utilizarla con la fábrica de conexiones, en Elementos relacionados, pulse JAAS - Datos de autenticación J2C.

Información Value
Tipo de datos Lista desplegable
Valor por omisión (ninguno)
Rango Están disponibles las opciones siguientes:
  • ClientContainer
  • WSLogin
  • WSKRB5Login
  • DefaultPrincipalMapping
  • TrustedConnectionMapping
  • KerberosMapping

Alias de autenticación gestionada por contenedor

El alias de autenticación que especifica el nombre de usuario y la contraseña para utilizar al conectarse al proveedor de mensajería IBM MQ.

Información Value
Tipo de datos Lista desplegable
Valor por omisión (ninguno)
Rango Todos los alias de autenticación definidos en la célula y el valor "(none)", que especifica que no se pasan credenciales a IBM MQ.

Icon that indicates the type of topic Reference topic



Timestamp icon Last updated: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=umj_pjcfm
File name: umj_pjcfm.html