Valores de fábrica de conexiones de tema del proveedor de mensajería IBM MQ
Utilice este panel para ver o modificar las propiedades de configuración de la fábrica de conexiones de tema seleccionada que se va a utilizar con el proveedor de mensajería de IBM MQ. Estas propiedades de configuración controlan cómo se crean las conexiones para el destino de tema JMS asociado.
Una fábrica de conexiones de tema de IBM MQ sirve para crear conexiones de JMS con destinos de temas proporcionados por IBM MQ para mensajería de publicación/suscripción.
- En el panel de navegación, pulse para visualizar las fabricas de conexiones de tema existentes.
- 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 de tema. Esto restringe el conjunto de fábricas de conexiones de tema visualizadas.
- Seleccione el nombre de la fábrica de conexiones de tema con la que desea trabajar.
- Propiedades avanzadas para mostrar las propiedades avanzadas de su fábrica de conexiones de tema de IBM MQ.
- Propiedades de intermediario para mostrar las propiedades de intermediario de su fábrica de conexiones de tema de IBM MQ.
- Propiedades personalizadas para mostrar las propiedades personalizadas de su fábrica de conexiones de tema de IBM MQ.
- Propiedades de transporte de cliente para visualizar o cambiar las propiedades de transporte de cliente de la fábrica de conexiones de tema de IBM MQ. Si la fábrica de conexiones de tema seleccionada no se ha creado utilizando una Tabla de definiciones de canal de cliente (Client Channel Definition Table - CCDT), siga este enlace para entrar toda la información necesaria para conectarse a IBM MQ. Si la fábrica de conexiones de tema 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 visualizar el detalle de las agrupaciones de conexiones de la fábrica de conexiones de tema de IBM MQ
- Agrupaciones de sesiones para visualizar el detalle de las agrupaciones de sesiones de la fábrica de conexiones de tema de 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 de tema.
- -localAddress
- -clonedSubs
- -componentAuthAlias
Para más información sobre estas propiedades, consulte Mandato createWMQConnectionFactory.
- Los nombres pueden tener un máximo de 48 caracteres, a excepción de los canales, que tienen un máximo de 20 caracteres.
- Los valores de las propiedades que especifique deben coincidir con los valores especificados al configurar los recursos JMS de IBM MQ. Para obtener más información sobre la configuración de recursos JMS en IBM MQ, consulte Utilización de Java en IBM MQ Information Center.
Una fábrica de conexiones de tema de IBM MQ tiene las propiedades siguientes.
Administración
Ámbito
Nivel en el que esta definición de recurso está visible para 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 manera que los recursos definidos en ámbitos más específicos alteren temporalmente los duplicados definidos en ámbitos más generales.
El ámbito mostrado es meramente informativo y no se puede modificar en este panel. Si desea examinar o modificar este recurso en un ámbito distinto, modifique el ámbito en el panel de colección de fábricas de conexiones de tema de IBM MQ y pulse Aplicar antes de pulsar el enlace del tipo de recurso.
Información | Valor |
---|---|
Tipo de datos | Serie |
Provider
El proveedor de JMS asignado cuando se creó la fábrica de conexiones de tema.
Para todas las fábricas de conexiones de tema creadas utilizando este panel, el proveedor es el proveedor de mensajería de IBM MQ.
El proveedor es meramente informativo.
Información | Valor |
---|---|
Tipo de datos | Serie |
Name
Nombre por el que se conoce esta fábrica de conexiones de tema para fines administrativos dentro de WebSphere Application Server.
Información | Valor |
---|---|
Tipo de datos | Serie |
Rango | El nombre debe ser exclusivo dentro del conjunto de fábricas de conexiones de tema JMS definas en la célula. |
Nombre JNDI
Nombre JNDI utilizado para enlazar la fábrica de conexiones de tema en el espacio de nombres JNDI.
Como convención, utilice el nombre JNDI plenamente cualificado; por ejemplo, con el formato jms/Nombre, donde Nombre es el nombre lógico del recurso.
Información | Valor |
---|---|
Tipo de datos | Serie |
Descripción
Descripción de esta fábrica de conexiones de tema, para fines administrativos dentro de WebSphere Application Server.
Información | Valor |
---|---|
Tipo de datos | Serie |
Serie | Nulo |
Conexión
La información necesaria para configurar una conexión depende de que la fábrica de conexiones de tema seleccionada se haya creado utilizando una Tabla de definiciones de canal de cliente (CCDT).
- URL de tabla de definición de canal de cliente
- Gestor de colas
- Configuración SSL
- Gestor de colas
- Transporte
- Si está seleccionado Especificar información de host y puerto en forma de
valores de host y puerto separados, la propiedad de lista de nombres de conexión
no se puede utilizar, y sí se pueden utilizar las propiedades siguientes:
- Nombre de host
- Puerto
- Si está seleccionado Especificar información de host y puerto en forma de
una lista de nombres de conexiones, la propiedad de lista de nombres de conexión se puede utilizar, y no se pueden utilizar las propiedades siguientes:
- Nombre de host
- Puerto
- Canal de conexión de servidor
- Si borra el recuadro de selección de la propiedad
Utilizar SSL para proteger las comunicaciones con
IBM MQ, las propiedades siguientes no se puede utilizar:
- Gestionado centralmente
- Configuración específica
- Configuración SSL
Para obtener más información sobre el establecimiento de las propiedades SSL para IBM MQ, consulte propiedades SSL en la sección Uso de Java del Centro de conocimiento IBM MQ.
URL de tabla de definición de canal de cliente
URL que especifica la ubicación de una CCDT de IBM MQ.
Información | Valor |
---|---|
Tipo de datos | Serie |
Gestor de colas
Si la fábrica de conexiones de tema especificada se basa en una CCDT, esta propiedad se utiliza para seleccionar una entrada en la CCDT. De lo contrario, es el nombre del gestor de colas o del grupo de compartición de colas con el que se va a establecer conexión. Se establece una conexión con este recurso IBM MQ para enviar o recibir mensajes.
Información | Valor |
---|---|
Tipo de datos | Serie |
Rango | Si esta fábrica de conexiones de tema no se basa en una CCDT, el valor
debe ser un nombre de gestor de colas válido. Si la fábrica de conexiones de tema se basa en una CCDT,
el valor debe ser uno de los siguientes:
Si la fábrica de conexiones especificada está basada en un CCDT y el CCDT puede realizar la selección entre más de un gestor de colas, es posible que no pueda recuperar las transacciones globales.
Por lo tanto, para fábricas de conexiones que especifiquen un CCDT, tiene dos alternativas:
|
Transporte
El tipo de transporte 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 | Valor |
---|---|
Tipo de datos | Lista desplegable |
Serie | Enlaces, si no cliente |
Rango |
|
Especifique información del host y puerto en el formato de valores de host y puerto separados
Si se marca este botón de selección, significa que la conexión con el gestor de colas IBM MQ se realiza utilizando la información proporcionada por las propiedades de nombre de host y puerto.
Al seleccionar esta opción se habilitan las propiedades de nombre de host y puerto, y se inhabilita la propiedad de lista nombres de conexión. Para especificar información de lista nombres de conexión, pulse Especificar información de 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 un servidor y dicho nodo o servidor está ejecutando la versión 8.0 o posterior de WebSphere Application Server.
Información | Valor |
---|---|
Tipo de datos | Botón de selección |
Nombre de host
Nombre de host, dirección IPv4 o IPv6 del gestor de colas de IBM MQ con el que se debe establecer la conexión.
Información | Valor |
---|---|
Tipo de datos | Serie |
Puerto
El número de puerto en el que está escuchando IBM MQ.
Información | Valor |
---|---|
Tipo de datos | Integer |
Serie | 1414 |
Rango | El valor debe estar comprendido en el rango de 1 a 65536 (inclusive). |
Especificar información de host y puerto en el formato de una lista de nombres de conexión
Si se marca este botón de selección, significa que la conexión con el gestor de colas IBM MQ se realiza utilizando la información proporcionada por la propiedad de lista de nombres de conexión.
Las listas nombres de conexión se pueden utilizar para conectar a un gestor de colas único o a un gestor de colas de varias instancias. Para obtener más información sobre el uso de un gestor de colas de varias instancias, consulte el Information Center de IBM MQ. Si selecciona esta opción habilita la propiedad de lista de nombres de conexión e inhabilita las propiedades de nombre de host y puerto. Para especificar información de host y puerto aparte, pulse Especificar información de host y puerto en el formato de valores de host y puerto separados.
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 un servidor y dicho nodo o servidor está ejecutando la versión 8.0 o posterior de WebSphere Application Server.
Información | Valor |
---|---|
Tipo de datos | Botón de selección |
Lista de nombres de conexión
Lista de nombres de conexión que especifica los detalles de nombre de host y puerto a utilizar cuando quiera que la fábrica de conexiones conecte a un gestor de colas de varias instancias.
Esta propiedad sólo se debe utilizar para permitir la conexión a un gestor de colas de varias instancias. No debe utilizarse para permitir las conexiones a gestores de colas que no sean de instancias múltiples, ya que puede producir problemas de integridad de la transacción.
Información | Valor |
---|---|
Tipo de datos | Serie |
Serie | No establecido |
Rango | Este campo debe establecerse en una serie con al forma siguiente: host[(puerto)][,host(puerto)] La información de puerto es opcional y, si no se especifica, el valor predeterminado es 1414. host debe ser un nombre de host TCP/IP válido o una dirección IPv4 o IPv6. puerto debe ser un valor entero en el intervalo de 1 a 65536 (inclusives). Por ejemplo: localhost(1234),remotehost1(1234),remotehost2 |
Cuando se especifica la propiedad de lista de nombres de conexión, las propiedades de nombre de host o puerto se establecen automáticamente en el nombre de host y número de puerto de la primera entrada de la lista de nombres de conexión. Por lo que si especifica localhost(1234),remotehost1(1234),remotehost2, el nombre de host se establecería en localhost y el puerto sería 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 WebSphere Application Server o posterior.
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, la información en los campos nombre de host y nombre de puerto, basada en el primer elemento de la lista nombre de conexión, se utiliza en su lugar.
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 | Valor |
---|---|
Tipo de datos | Serie |
Serie | 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 la comunicación con IBM MQ
Esta opción determina si el protocolo SSL (capa de sockets seguros) se utiliza para proteger las comunicaciones de red con el gestor de colas IBM MQ o el grupo de compartimiento de cola.
Cuando se utiliza una fábrica de conexiones de tema del proveedor de mensajería de IBM MQ en el entorno del servidor de aplicaciones, éste gestiona la configuración de SSL. Para modificar los parámetros de configuración de SSL, utilice la consola administrativa para desplazarse hasta el panel .
Cuando se utiliza una fábrica de conexiones de tema del proveedor de mensajería de IBM MQ en el entorno de cliente, éste obtiene la información de la 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.
Sólo puede utilizar una suite de cifrado en la configuración de SSL para una fábrica de conexiones de tema de proveedor de mensajería de IBM MQ. Si especifica más de una suite de cifrado, solamente se utilizará la primera.
Información | Valor |
---|---|
Tipo de datos | Recuadro de selección. Si se elimina la selección de este recuadro de selección,
se inhabilitan las propiedades SSL siguientes:
|
Gestionado centralmente
Cuando se utiliza el protocolo SSL para comunicarse con IBM MQ, seleccione este botón de selección para especificar que la configuración de SSL se toma de la configuración de SSL del WebSphere Application Server gestionado centralmente.
Cuando se selecciona este botón de selección, se utilizan los atributos de nombre de host y puerto de la fábrica de conexiones de proveedor de mensajería de IBM MQ para seleccionar una configuración de SSL adecuada. Si la información de host y puerto se ha proporcionado mediante una lista de nombres de conexión, quiere decir que se utilizan la información de nombre de host y puerto del primer elemento de la lista para seleccionar una configuración SSL adecuada. Para proporcionar la configuración de SSL con la que debe coincidir la fábrica de conexiones, consulte el tema de valores de configuración de SSL de punto final de salida dinámico que encontrará en las referencias relacionadas.
Información | Valor |
---|---|
Tipo de datos | Botón de selección |
Configuración específica
Seleccione este botón de selección cuando desee especificar que se utilice una configuración de SSL determinada cuando deba emplearse SSL para proteger las comunicaciones de red con el gestor de colas o el grupo de compartimiento de colas de IBM MQ.
Información | Valor |
---|---|
Tipo de datos | Botón de selección |
Configuración SSL
Configuración de SSL que se utilizará cuando deba emplearse SSL para proteger las comunicaciones de red con el gestor de colas MQ o grupo de compartición de colas de IBM MQ.
Esta propiedad está inhabilitada si el botón de selección Gestionado centralmente está seleccionado y el recurso del proveedor de mensajería IBM MQ se ha definido explícitamente.
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 IBM MQ se basa en un CCDT, este parámetro sólo se utiliza si las entradas relevantes en el CCDT se han configurado para utilizar SSL.
Además, si se selecciona una configuración SSL de none, se utilizará la configuración de SSL predeterminada gestionada centralmente de WebSphere Application Server para el proveedor de mensajería de IBM MQ.
Información | Valor |
---|---|
Tipo de datos | Lista desplegable |
Avanzada
ID de cliente
Identificador de cliente que debe especificarse en la conexión con el proveedor de mensajería de IBM MQ.
Información | Valor |
---|---|
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 | Valor |
---|---|
Tipo de datos | Recuadro de selección |
Serie | Deseleccionado |
Rango |
|
Versión del proveedor
Versión del proveedor de mensajería de IBM MQ. Se utiliza para determinar la conexión a una versión particular de un gestor de colas. También se utiliza para determinar el tipo de funciones que exige el cliente.
Información | Valor |
---|---|
Tipo de datos | Serie |
Rango | El valor especificado debe ser la serie vacía o tener uno de
los siguientes formatos:
Por ejemplo 6.0.0.0. |
Soportar protocolo de compromiso de dos fases distribuido
Opción que especifica si la fábrica de conexiones de tema 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 de tema, 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 producir 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 | Valor |
---|---|
Tipo de datos | Recuadro de selección |
Serie | Seleccionado |
Rango |
|
No habilite XA cuando el gestor de colas especificado por la fábrica de conexiones de tema sea el único recurso de la transacción. Habilite XA si las transacciones implican otros recursos, incluidas otras colas o temas.
Valores de seguridad
Alias de autenticación para recuperación XA
Nombre de usuario y contraseña que se deben utilizar para conectarse a IBM MQ durante la recuperación de XA.
Información | Valor |
---|---|
Tipo de datos | Lista desplegable |
Serie | (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 durante la recuperación de XA. |
Alias de correlación-configuración
Este campo sólo se utiliza ante la ausencia de una configuración de inicio de sesión en la referencia del 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 será un alias de entrada de datos de autenticación JAAS - J2C. Para configurar la información de autenticación para utilizarla con la fábrica de conexiones de tema, en Elementos relacionados, pulse JAAS - Datos de autenticación J2C.
Información | Valor |
---|---|
Tipo de datos | Lista desplegable |
Serie | (ninguno) |
Rango | Están disponibles las siguientes opciones:
|
Alias de autenticación gestionada por contenedor
Alias de autenticación que especifica el nombre de usuario y contraseña que se deben utilizar para conectarse al proveedor de mensajería de IBM MQ.
Información | Valor |
---|---|
Tipo de datos | Lista desplegable |
Serie | (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. |