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.

Para ver valores de fábrica de conexión de temas de IBM MQ, utilice la consola administrativa para completar los pasos siguientes:
  1. En el panel de navegación, pulse Recursos > JMS -> Fábricas de conexiones de temaspara visualizar las fabricas de conexiones de tema 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 de tema. Esto restringe el conjunto de fábricas de conexiones de tema visualizadas.
  3. Seleccione el nombre de la fábrica de conexiones de tema 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 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.

Puede especificar las siguientes propiedades adicionales utilizando mandatos administrativos de IBM MQ:
  • -localAddress
  • -clonedSubs
  • -componentAuthAlias

Para más información sobre estas propiedades, consulte Mandato createWMQConnectionFactory.

Nota: Al especificar las propiedades de IBM MQ, se aplican las siguientes restricciones:
  • 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).

Si la fábrica de conexiones de tema seleccionada se ha creado utilizando una CCDT, sólo se visualizan las propiedades siguientes:
  • URL de tabla de definición de canal de cliente
  • Gestor de colas
  • Configuración SSL
Si la fábrica de conexiones de tema seleccionada no se ha creado utilizando una CCDT, se visualizan las propiedades siguientes:
  • 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:
  • Un nombre de gestor de colas válido
  • Un asterisco (*) seguido del nombre de un gestor de colas grupo1
  • 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 de temas pueden conectarse a distintos gestores de colas. La selección de varios gestores de colas tiene lugar 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 esas definiciones de canal de conexión definen los detalles de conexión de red de distintos gestores de colas.
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:
  • Evitar ambigüedades sobre el gestor de colas de destino al especificar la propiedad del gestor de colas (Queue manager), lo que significa que el valor especificado de esta propiedad no debe incluir un asterisco (*).
  • Evitar el uso de recursos con aplicaciones usadas en transacciones globales.

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
Cliente
Utiliza una conexión de red basada en TCP/IP para comunicarse con el gestor de colas de IBM MQ.
Enlaces, si no cliente
Intenta una conexión con modalidad de enlaces con el gestor de colas. Si no es posible, utiliza el transporte del cliente.
Enlaces
Establece una conexión de memoria cruzada con un gestor de colas que se ejecuta en el mismo nodo. Se inhabilitan las siguientes propiedades de Modalidad de transporte de cliente:
  • Nombre de host
  • Puerto
  • Lista de nombres de conexión
  • Canal de conexión de servidor
Para obtener más información sobre la configuración de un tipo de transporte Enlaces, si no cliente o Enlaces, consulte Configuración del proveedor de mensajería de IBM MQ con información de bibliotecas nativas.

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 Seguridad > Certificado SSL y gestión de claves.

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
  • 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 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
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. 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:
  • n.n.n.n
  • n.n.n
  • n.n
  • n
donde n es un valor numérico mayor que 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 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
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.

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:
  • ClientContainer
  • WSLogin
  • WSKRB5Login
  • DefaultPrincipalMapping
  • TrustedConnectionMapping
  • KerberosMapping

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.

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_ptcfm
File name: umj_ptcfm.html