Valores de la fábrica de conexiones de cola del proveedor de mensajería de WebSphere MQ

Utilice este panel para ver o modificar las propiedades de configuración de la fábrica de conexiones de cola seleccionada que se va a utilizar con el proveedor de mensajería de WebSphere MQ. Estas propiedades de configuración controlan cómo se crean las conexiones para los destinos de cola JMS asociados.

Una fábrica de conexiones de cola de WebSphere MQ sirve para crear conexiones de JMS con colas proporcionadas por WebSphere MQ para mensajería de punto a punto.

Para ver los valores de fábrica de conexiones de cola de WebSphere 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 cola para visualizar las fabricas de conexiones de cola 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 cola. Esto restringe el conjunto de fábricas de conexiones de cola visualizadas.
  3. Seleccione el nombre de la fábrica de conexiones de cola 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 seleccionar cualquiera de los enlaces siguientes:

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 cola.

Puede especificar las siguientes propiedades adicionales mediante el uso de los mandatos administrativos de WebSphere MQ: Para más información sobre estas propiedades, consulte Mandato createWMQConnectionFactory.
Nota: Al especificar las propiedades de WebSphere MQ, se aplican las siguientes restricciones:

Una fábrica de conexiones de cola de WebSphere MQ tiene las propiedades siguientes.

Administración
Ámbito

Nivel en el cual 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 (u otros recursos) en un ámbito distinto, modifique el ámbito en el panel de colección de fábricas de conexiones de cola de WebSphere MQ y pulse Aplicar antes de pulsar el enlace del tipo de recurso.

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 de cola creadas utilizando este panel, el proveedor es el proveedor de mensajería de WebSphere MQ.

El proveedor es meramente informativo.

Tipo de datos Serie
Nombre

Nombre por el que se conoce esta fábrica de conexiones de cola para fines administrativos dentro de WebSphere Application Server.

Tipo de datos Serie
Rango El nombre debe ser exclusivo dentro del conjunto de fábricas de conexiones de cola definas en la célula.
Nombre JNDI

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

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.

Tipo de datos Serie
Descripción

Descripción de esta fábrica de conexiones de cola, para fines administrativos dentro de WebSphere Application Server.

Tipo de datos Serie
Valor predeterminado 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 de cola 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 cola seleccionada no se ha creado utilizando una CCDT, se visualizan las propiedades siguientes:
  • Gestor de colas
  • Transporte
  • Nombre de host
  • Puerto
  • Canal de conexión del servidor
  • Si borra el recuadro de selección de la propiedad Utilizar SSL para proteger las comunicaciones con Websphere MQ, las propiedades siguientes no se puede utilizar:
    • Gestionado centralmente
    • Configuración específica
    • Configuración SSL

Para obtener más información sobre cómo establecer las propiedades de SSL para WebSphere MQ, consulte el apartado Propiedades de SSL de la publicación WebSphere MQ Utilización de Java.

URL de tabla de definición de canal de cliente

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

Tipo de datos Serie
Gestor de colas

Si la fábrica de conexiones de cola 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 WebSphere MQ especificado para enviar o recibir mensajes.

Tipo de datos Serie
Rango Si esta fábrica de conexiones de cola 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 cola se basa en una CCDT, el valor debe ser uno de los siguientes:
  • Un nombre de gestor de colas válido
  • 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 cola 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.

Las transacciones globales no se deben utilizar con una fábrica de conexiones de cola que se configura para seleccionar de entre varios gestores de colas utilizando una CCDT, porque puede que el gestor de transacciones no pueda recuperar las transacciones globales después de una anomalía.

Transporte

El tipo de transporte de WebSphere MQ para la conexión. El tipo de transporte se utiliza para determinar los mecanismos exactos que se utilizan para conectarse con WebSphere MQ.

Tipo de datos Lista desplegable
Valor predeterminado Enlaces, si no cliente
Rango
Cliente
Utiliza una conexión de red basada en TCP/IP para comunicarse con el gestor de colas de WebSphere 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
  • Canal de conexión del 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 WebSphere MQ con información de bibliotecas nativas y Ajuste del tamaño de las agrupaciones de hebras utilizadas por el proveedor de mensajería de WebSphere MQ.

La información sobre cómo gestionar el tamaño de las agrupaciones de hebras que utiliza el proveedor de mensajería de WebSphere MQ no es relevante para el fixpack 5 o posterior, puesto que ya no se utilza la agrupación de hebras WMQCommonServices.

Nombre de host

Nombre de host, dirección IPv4 o IPv6 del gestor de colas de WebSphere MQ al que se va a conectar.

Tipo de datos Serie
Puerto

Número de puerto en el que escucha WebSphere MQ.

Tipo de datos Entero
Valor predeterminado 1414
Rango El valor debe estar comprendido en el rango de 1 a 65536 (inclusives).
Canal de conexión del servidor

Nombre del canal de conexión de servidor de WebSphere MQ que se utiliza para conectarse con WebSphere MQ.

Tipo de datos Serie
Valor predeterminado SYSTEM.DEF.SVRCONN
Rango El valor debe ser un canal de conexión de servidor definido en el gestor de colas de WebSphere MQ con el que se establece la conexión.
Utilizar SSL para proteger la comunicación con WebSphere MQ

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 WebSphere MQ.

Cuando se utiliza una fábrica de conexiones de cola del proveedor de mensajería de WebSphere 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 cola del proveedor de mensajería de WebSphere 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 cola de proveedor de mensajería de WebSphere MQ. Si especifica más de una suite de cifrado, solamente se utilizará la primera.

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 WebSphere 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 cola de proveedor de mensajería de WebSphere MQ 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 de cola, consulte el tema de valores de configuración de SSL de punto final de salida dinámico que encontrará en las referencias relacionadas.

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 WebSphere MQ.

Tipo de datos Botón de selección
Configuración SSL

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 WebSphere.

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

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

Si este recurso de proveedor de mensajería WebSphere 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 WebSphere MQ.

Tipo de datos Lista desplegable
Avanzadas
ID de cliente

El identificador de cliente que debe especificarse al conectar al proveedor de mensajería de WebSphere MQ.

Tipo de datos Serie
Versión de proveedor

Versión del proveedor de mensajería de WebSphere 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 necesita el cliente.

Nota: Antes del fixpack 5, si se utiliza esta fábrica de conexiones para conectarse a un gestor de colas o un grupo de compartimiento de colas de un sistema WebSphere MQ for z/OS, entre el valor 6.0.0.0 en la propiedad Versión de proveedor. La fábrica de conexiones debe utilizar este valor de la versión de proveedor independientemente de la versión de WebSphere MQ for z/OS a la que se conecta.

Para el fixpack 5 o posterior, si se utiliza esta fábrica de conexiones para conectarse a un gestor de colas o un grupo de compartimiento de colas de un sistema WebSphere MQ for z/OS Versión 7, entre el valor 6.0.0.0 en la propiedad Versión de proveedor.

Para el fixpack 7 o posterior, la restricción de la versión del proveedor se anula.

Tipo de datos Serie
Rango El valor entrado debe ser la serie vacía o debe 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 cola soporta la coordinación XA de transacciones de mensajería. Habilite esta opción si en la misma transacción se deben utilizar múltiples recursos, incluyendo esta fábrica de conexiones de cola.

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 puede incluirse 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.

Tipo de datos Recuadro de selección
Valor predeterminado Seleccionado
Rango
Seleccionado
La fábrica de conexiones de cola 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 de cola 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 fábrica de conexiones de cola es el único recurso de la transacción.

Valores de seguridad
Alias de autenticación para recuperación XA

Nombre de usuario y contraseña que se deben utilizar para conectarse a WebSphere MQ durante la recuperación de XA.

Tipo de datos Lista desplegable
Valor predeterminado (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 WebSphere 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 cola, en Elementos relacionados, pulse JAAS - Datos de autenticación J2C.

Tipo de datos Lista desplegable
Valor predeterminado (ninguno)
Rango
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 WebSphere.

Tipo de datos Lista desplegable
Valor predeterminado (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 WebSphere MQ.



Los enlaces marcados (en línea) requieren acceso a Internet.

Conceptos relacionados
Tareas relacionadas
Referencia relacionada
La página web de la biblioteca de WebSphere MQ en http://www.ibm.com/software/ts/mqseries/library (en línea)
Colección de Fábrica de conexiones de cola
Biblioteca de WebSphere MQ (en línea)


Nombre de archivo: umj_pqcfm.html