Utilice este panel para ver o modificar las propiedades de configuración de la fábrica de conexiones 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 con colas y temas JMS asociados.
El proveedor de mensajería de IBM MQ da soporte a 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 fabricas de conexiones JMS unificadas independientes del dominio para nuevas aplicaciones. 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.
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.
Si la funcionalidad de IBM MQ se ha inhabilitado en un ámbito que afecta a este recurso de proveedor de mensajería IBM MQ, aparecerá un mensaje informativo que indica que IBM MQ se ha inhabilitado. En un entorno de servidor único este mensaje informativo sólo se visualiza cuando se reinicia el servidor después de que la funcionalidad de IBM MQ se haya inhabilitado. En un entorno de despliegue de red, el mensaje informativo se visualiza inmediatamente. Para obtener más información, consulte Inhabilitar la funcionalidad de IBM MQ en WebSphere Application Server.
Una fábrica de conexiones unificada de IBM MQ tiene las propiedades siguientes.
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 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 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 |
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 de IBM MQ.
El proveedor es meramente informativo.
| Información | Value |
|---|---|
| Tipo de datos | Serie |
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 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 |
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 | Null (Nulo) |
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).
Para obtener más información sobre cómo configurar las propiedades de SSL para IBM MQ, consulte Propiedades de SSL en el apartado Utilización de Java del Information Center de IBM MQ.
URL que especifica la ubicación de una CCDT de IBM MQ.
| Información | Value |
|---|---|
| Tipo de datos | Serie |
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 este 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:
Si la fábrica de conexiones especificada se basa en una CCDT y la CCDT
puede seleccionarse de más de un gestor de colas, tal vez no pueda recuperar transacciones globales. Por lo tanto, para las fábricas de conexiones que especifican una CCDT, tiene dos alternativas:
|
El tipo de transporte de IBM MQ para la conexión. El tipo de transporte se utiliza para determinar los mecanismos exactos que se utilizan para conectarse con IBM MQ.
| Información | Value |
|---|---|
| Tipo de datos | Lista desplegable |
| Valor por omisión | Enlaces, después cliente |
| Rango |
|
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 puerto.
Al seleccionar esta opción se habilitan las propiedades de nombre de host y puerto y se inhabilita la propiedad de lista de nombres 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, dirección IPv4 o IPv6 del gestor de colas de IBM MQ al que se va a conectar.
| Información | Value |
|---|---|
| Tipo de datos | Serie |
Número de puerto en el que está escuchando IBM MQ.
| Información | Value |
|---|---|
| Tipo de datos | Entero |
| Valor por omisión | 1414 |
| Rango | El valor debe estar comprendido en el rango de 1 a 65536 (inclusive). |
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. La selección de 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 del host y el puerto por separado, pulse Entre información del host y puerto en el formato de valores separados de host y 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 |
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 debe utilizarse para permitir la 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 | Sin establecer |
| 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. 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 rango de 1 a 65536 (inclusive). Por ejemplo: localhost(1234),remotehost1(1234),remotehost2 |
Si 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 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.
Nombre del canal de conexión de servidor de WebSphere MQ que se utiliza para conectarse 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 con el que se establece la conexión. |
Esta opción determina si se utiliza el protocolo SSL (Capa de sockets segura) para proteger las comunicaciones de red con el gestor de colas o el grupo de compartimento de colas de IBM MQ.
Cuando se utiliza una fábrica de conexiones 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 de administración para desplazarse hasta el panel .
Cuando se utiliza una fábrica de conexiones 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 proveedor de mensajería de 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 se elimina la selección de este recuadro de selección,
se inhabilitan las propiedades SSL siguientes:
|
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, 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 la información del host y puerto de se ha proporcionado mediante una lista de nombres de conexión, esto significa que se utiliza la información del 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 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 | Value |
|---|---|
| Tipo de datos | Botón de selección |
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 | Value |
|---|---|
| Tipo de datos | Botón de selección |
Configuración de SSL que se debe utilizar 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.
Esta propiedad no está habilitada si el botón de selección Gestionado centralmente está seleccionado y el recurso de proveedor de mensajería IBM MQ se ha definido de forma explícita.
Esta propiedad está siempre habilitada si el recurso de proveedor de mensajería IBM MQ se basa en una CCDT.
Si este recurso de proveedor de mensajería IBM MQ se basa en una CCDT, este parámetro sólo se utiliza si las entradas relevantes en la 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 | Value |
|---|---|
| Tipo de datos | Lista desplegable |
El identificador de cliente que debe especificarse al conectar al 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 |
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 |
|
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 la serie vacía o tener uno de los formatos siguientes:
Por ejemplo 6.0.0.0. |
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 |
|
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.
Nombre de usuario y contraseña que se deben utilizar para 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 pasan credenciales a IBM MQ durante la recuperación de XA. |
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:
|
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 WebSphere.
| 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)", el cual significa que no se pasan credenciales a IBM MQ. |