Valores de especificación de activación de proveedor de mensajería de WebSphere MQ

Utilice este panel para ver o modificar las propiedades de configuración de la especificación de activación 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 con las colas y temas asociados.

Para ver los valores de especificación de activación de WebSphere MQ, utilice la consola administrativa para completar los pasos siguientes:
  1. En el panel de navegación, pulse Recursos > JMS > Especificaciones de activación para visualizar las especificaciones de activación existentes.
  2. Si es necesario, en el panel de contenido, cambie el valor Ámbito por el nivel en el que se definen las especificaciones de activación. Esto restringe el conjunto de especificaciones de activación visualizados.
  3. Seleccione el nombre de la especificación de activación con la que desea trabajar.
En Propiedades generales existen cinco grupos de propiedades:
Realice los cambios necesarios en los grupos de propiedades de valores de Administración, Conexión, Destino, 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:

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 especificación de activación.

También puede especificar la propiedad -localAddress utilizando los mandatos administrativos de WebSphere MQ. Para más información sobre esta propiedad, consulte Mandato createWMQActivationSpec.

Nota: Al especificar las propiedades de WebSphere MQ, se aplican las siguientes restricciones:

Una especificación de activación de WebSphere 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 (u otros recursos) en un ámbito distinto, modifique el ámbito en el panel de colección de especificaciones de activación de WebSphere MQ y pulse Aplicar, antes de pulsar el enlace del tipo de recurso.

Tipo de datos Serie
Proveedor

Proveedor JMS asignado cuando se crea la especificación de activación.

Para todas las especificaciones de activación 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 especificación de activación para fines administrativos dentro de WebSphere Application Server.

Tipo de datos Serie
Rango El nombre debe ser exclusivo dentro del conjunto de especificaciones de activación definas en la célula.
Nombre JNDI

Nombre JNDI utilizado para enlazar la especificación de activación con 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.

Tipo de datos Serie
Descripción

Descripción de esta especificación de activación con fines administrativos en 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 especificación de activación seleccionada se haya creado utilizando una Tabla de definiciones de canal de cliente (CCDT).

Si la especificación de activación 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 especificación de activación 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 de 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.

Nota: Existen otras cuatro propiedades de conexión de WebSphere MQ que afectan a la especificación de activación:
  • maxConnections
  • connectionConcurrency
  • reconnectionRetryCount
  • reconnectionRetryInterval
Aunque estas propiedades controlan el comportamiento de la especificación de activación de WebSphere MQ, se configuran como propiedades personalizadas del proveedor de mensajería de WebSphere MQ. Para obtener más información sobre estas cuatro propiedades de la conexión, y cómo configurarlas, consulte Configuración de las propiedades personalizadas para el proveedor de mensajería de WebSphere MQ
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 especificación de activación se basa en una CCDT, esta propiedad se utiliza para seleccionar una entrada en una 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 para recibir mensajes.

Tipo de datos Serie
Rango Si esta especificación de activación no se basa en una CCDT, el valor debe ser un nombre de gestor de colas válido.
Si la especificación de activación 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 especificación de activación 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 especificación de activación 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 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 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 de 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 especificación de activación de 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.

Sólo puede utilizar una suite de cifrado en la configuración de SSL para una especificación de activación 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 seleccione este botón de selección, se utilizan los atributos de nombre de host y puerto de la especificación de activación 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 especificación de activación, 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 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 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
Destino
Nombre JNDI de destino

Nombre JNDI del destino JMS desde el que se consumen mensajes para su entrega a un bean controlado por mensaje (MDB) configurado para utilizar esta especificación de activación.

Tipo de datos Serie
Selector de mensajes

Expresión de selector de mensajes que especifica los mensajes que se entregarán.

Tipo de datos Serie
Tipo de destino

Tipo de destino (cola o tema) desde el que se consumirán mensajes.

Tipo de datos Lista desplegable
Rango
Cola
El nombre JNDI de destino se refiere al destino de JMS que es una cola.
Tema
El nombre JNDI de destino se refiere al destino de JMS que es un tema.
Suscripción duradera

Opción para especificar si se utiliza una suscripción duradera o no duradera para entregar mensajes a un MDB que se suscribe al tema.

Tipo de datos Recuadro de selección
Valor predeterminado No seleccionado (no duradera)
Rango
Deseleccionado
No duradera.
Seleccionado
Duradera.
Nombre de suscripción

Nombre de una suscripción duradera. Sólo está disponible cuando se marca el recuadro de selección Suscripción duradera.

Tipo de datos Serie
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
Permitir suscripciones duraderas clonadas

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

Tipo de datos Recuadro de selección
Valor predeterminado 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 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 especificación de activación 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 especificación de activación 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.

Valores de seguridad
Alias de autenticación

Nombre de usuario y contraseña que se deben utilizar para conectarse a WebSphere MQ.

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
Colección de Especificación de activación
Biblioteca de WebSphere MQ (en línea)


Nombre de archivo: umj_pasm.html