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

Utilice este panel para ver o modificar las propiedades de configuración de la especificación de activación seleccionada para su uso con el proveedor de mensajería IBM 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 la activación de IBM MQ, utilice la consola de administración para completar los pasos siguientes:

En el panel de navegación, pulse Recursos > JMS->Especificaciones de activaciónpara visualizar especificaciones de activación existentes.
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 visualizadas.
Seleccione el nombre de la especificación de activación con la que desea trabajar.

En Propiedades generales, hay cinco grupos de propiedades:

Administración
Conexión
Destino
Avanzada
Valores de seguridad

Realice los cambios necesarios en los grupos de propiedades de Administración, Conexión, Destino, Opciones avanzadas y Valores de seguridad y, a continuación, pulse Aplicar para guardar la configuración antes de pulsar, en el panel de contenido de Propiedades adicionales, cualquiera de los enlaces siguientes:

Propiedades avanzadas para visualizar o cambiar las propiedades avanzadas de su especificación de activación de IBM MQ.
Propiedades de intermediario para visualizar o cambiar las propiedades de intermediario de la especificación de activación de IBM MQ.
Propiedades personalizadas para visualizar o modificar las propiedades personalizadas de la especificación de activación de IBM MQ. Por ejemplo, utilizaría esta opción para establecer la propiedad personalizada WAS_EndpointInitialState para una especificación de activación. WAS_EndpointInitialState determina si el consumo de mensajes se inicia desde el destino JMS tan pronto como se utiliza la especificación de activación para que un bean controlado por mensaje establezca conexión con la destinación.
Propiedades de transporte de cliente para visualizar o cambiar las propiedades de transporte de cliente de la especificación de activación de IBM MQ. Si la especificación de activación seleccionada no se ha creado utilizando una Tabla de definición de canal de cliente (CCDT), siga este enlace para entrar toda la información necesaria para conectarse a IBM MQ. Si la especificación de activación seleccionada se ha creado utilizando una CCDT, no necesita proporcionar las propiedades de transporte de cliente, de modo que el enlace no existe.

En Elementos relacionados, puede pulsar JAAS - Datos de autenticación J2C para configurar la información de autenticación y utilizarla con la especificación de activación.

También puede especificar la propiedad -localAddress utilizando el mandato administrativo createWMQActivationSpec IBM MQ.

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

Los nombres pueden tener un máximo de 48 caracteres, con la excepción de los canales, que tienen un máximo de 20 caracteres.
Los valores de propiedad que especifique deben coincidir con los valores que especificó al configurar IBM MQ para recursos JMS. Para obtener más información, consulte los apartados Utilización de Java y Administración del sistema del Information Center de IBM MQ.

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 especificación de activación de IBM MQ tiene las propiedades siguientes.

Administración

Ámbito

El nivel hasta el cual puede visualizarse esta definición de recurso 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 sólo a efectos informativos y no puede cambiarse en este panel. Si desea examinar o modificar este recurso (u otros recursos) en un ámbito distinto, modifique el ámbito en el panel de recopilación de especificaciones de activación de IBM MQ y, a continuación, pulse Aplicarantes de pulsar el enlace del tipo de recurso.

Información	Value
Tipo de datos	Serie

Provider

El proveedor de 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 IBM MQ.

El proveedor es meramente informativo.

Información	Value
Tipo de datos	Serie

Nombre

Nombre por el que se conoce a esta especificación de activación a efectos administrativos en WebSphere Application Server.

Información	Value
Tipo de datos	Serie
Rango	El nombre debe ser exclusivo dentro del conjunto de especificaciones de activación definidas en la celda.

Nombre JNDI

El nombre JNDI utilizado para enlazar la especificación de activación 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

Descripción

Una descripción de esta especificación de activación con fines administrativos en WebSphere Application Server.

Información	Value
Tipo de datos	Serie
Valor por omisión	Null (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 definiciones 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
Si Entre información del host y puerto en el formato de separar los valores del host y puerto está seleccionada, la propiedad de lista de nombres de conexión no se puede utilizar y las propiedades siguientes se pueden utilizar:
- Nombre de host
- Puerto
Si Entre información del host y puerto en forma de una lista de nombres de conexión está seleccionada, la propiedad de lista de nombres de conexión se puede utilizar y las propiedades siguientes no se pueden utilizar:
- 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 cómo establecer las propiedades de SSL para IBM MQ, consulte Propiedades de SSL de la sección IBM MQ Utilización de Java del Information Center de IBM MQ.

Nota: Hay cuatro propiedades de conexión de IBM MQ que se utilizan para configurar el adaptador de recursos de IBM MQ utilizado por el proveedor de mensajería de IBM MQ. Estas propiedades afectan a la agrupación de conexiones que utilizan las especificaciones de activación:

maxConnections
connectionConcurrency(La definición de esta propiedad sólo afecta a los nodos WebSphere Application Server 7. La propiedad no tiene repercusión para los nodos de WebSphere Application Server versión 8 o posteriores. )
reconnectionRetryCount
reconnectionRetryInterval

Para obtener más información sobre estas cuatro propiedades y cómo configurarlas, consulte Propiedades del adaptador de recursos.

URL de tabla de definiciones de canal de cliente

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

Información	Value
Tipo de datos	Serie

Gestor de colas

Si la especificación de activación 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 el recurso de IBM MQ especificado para recibir mensajes.

Información

Value

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 esta 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
Un asterisco (*) seguido del nombre de un grupo de gestor de colas¹
Un asterisco (*)
En blanco¹

¹Cuando 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.

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:

Evitar ambigüedades sobre el gestor de colas de destino al especificar la propiedad Gestor de colas, lo que significa que el valor especificado de esta propiedad no debe incluir un asterisco (*).
Evitar el uso de recursos con aplicaciones inscritas en transacciones globales.

Transporte

El tipo de transporte de 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	Value
Tipo de datos	Lista desplegable
Valor por omisión	Enlaces, después cliente
Rango	Cliente Utiliza una conexión de red basada en TCP/IP para comunicarse con el gestor de colas de IBM MQ. Enlaces, después cliente Intenta una conexión en modalidad de enlace con el gestor de colas. Si esto no es posible, vuelve el transporte del cliente. Enlaces Establece una conexión de memoria cruzada con un gestor de colas que se ejecuta en el mismo nodo. Las siguientes propiedades de modalidad de transporte de cliente están inhabilitadas: Nombre de host Puerto Lista de nombres de conexión 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 de IBM MQ con información de bibliotecas nativas

Entre información sobre el host y el puerto en el formato de separar los valores de host y puerto

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

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	Value
Tipo de datos	Serie

Puerto

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

Entre información del host y puerto en el formato de una lista de nombres de conexión

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.

Información	Value
Tipo de datos	Botón de selección

Lista de nombres de conexión

Lista de nombres de conexión que especifica el nombre de host y los detalles del puerto que se debe utilizar cuando desea que la especificación de activación 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 mixta, la información de la propiedad de la lista de nombres de conexión, para las especificaciones de activación de ámbito de clúster o de célula, está disponible en los nodos de WebSphere Application Server Versión 7.0. El comportamiento exacto depende del nivel de fixpack del nodo:

Para los nodos que se ejecutan en un nivel de fixpack de WebSphere Application Server Versión 7.0 Fixpack 7 o posterior, la propiedad de lista de nombres de conexión se puede utilizar para conectarse a los gestores de colas de varias instancias.
Para los nodos que se ejecutan en un nivel de fixpack anterior a Versión 7.0, la propiedad de lista nombre de conexión no se reconoce, y un mensaje de aviso parecido al siguiente ejemplo es la salida:
```
[29/09/10 12:15:27:468 BST] 00000018 J2CUtilityCla W   
J2CA0008W: Class com.ibm.mq.connector.inbound.ActivationSpecImpl used by resource 
cells/L3A3316Node01Cell/resources.xml#J2CResourceAdapter_1284547647859 did not contain 
method setConnectionNameList. Processing continued.
```
En este caso, la información de las propiedades de nombre de host y puerto se utiliza para conectarse a un gestor de colas.

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	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 al que se está conectando.

Utilizar SSL para proteger la comunicación con IBM MQ

Esta opción determina si el protocolo SSL (Secure Sockets Layer) se utiliza para proteger las comunicaciones de red con el gestor de colas o el grupo de compartimiento de colas de IBM MQ.

Cuando se utiliza una especificación de activación del proveedor de mensajería de IBM MQ en el entorno del servidor de aplicaciones, el servidor de aplicaciones 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 Seguridad > Gestión de claves y certificados SSL.

Sólo puede utilizar una suite de cifrado en la configuración de SSL para una especificación de activación del 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: 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 SSL gestionada centralmente de WebSphere Application Server.

Cuando se selecciona este botón de selección, los atributos de nombre de host y puerto de la especificación de activación del proveedor de mensajería de IBM MQ se utilizan para seleccionar una configuración de SSL adecuada. Si se ha suministrado la información de host y de puerto para la especificación de la activación mediante una lista de nombre de conexión, significa que se utiliza la información de 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 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.

Información	Value
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	Value
Tipo de datos	Botón de selección

Configuración SSL

La configuración de SSL que se utilizará cuando vaya a 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 está inhabilitada si el botón de selección Gestionado centralmente está seleccionado y el recurso de proveedor de mensajería de IBM MQ se ha definido de forma explícita.

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

Si este recurso del proveedor de mensajería de IBM MQ se basa en una CCDT, este parámetro sólo se utiliza si se han configurado las entradas relevantes en la CCDT para utilizar SSL.

Además, si se selecciona la configuración de SSL none, se utiliza la configuración de SSL de WebSphere Application Server gestionada centralmente para el proveedor de mensajería de IBM MQ.

Información	Value
Tipo de datos	Lista desplegable

Destino

Nota: La propiedad WAS_EndpointInitialState es una propiedad personalizada. Esta propiedad determina si el consumo de mensajes empieza desde el destino JMS tan pronto como la especificación de activación se utiliza para que un bean controlado por mensajes conecte con el destino o no. Para establecer propiedades personalizadas, cuando haya completado los cambios en este panel de contenido y pulsado Aplicar para guardar la configuración, pulse el enlace Propiedades personalizadas en el panel de contenido bajo Propiedades adicionales.

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.

Información	Value
Tipo de datos	Serie

Selector de mensajes

Expresión de selector de mensajes que especifica qué mensajes se van a entregar.

Información	Value
Tipo de datos	Serie

Tipo de destino

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

Información	Value
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

Una opción para especificar si se utiliza una suscripción duradera o no duradera para entregar mensajes a un MDB suscrito al tema.

Información	Value
Tipo de datos	Recuadro de selección
Valor por omisión	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.

Información	Value
Tipo de datos	Serie

Avanzada

ID de cliente

El identificador de cliente que debe especificarse al conectar con el proveedor de mensajería de IBM MQ.

Información	Value
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	Value
Tipo de datos	Recuadro de selección
Valor por omisión	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 si se debe conectar a una versión determinada 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:

n.n.n.n
n.n.n
n.n
n

Donde n es un valor numérico superior 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 IBM MQ.

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.

Nombre de archivo: umj_pasm.html