Configuración de la especificación de activación del proveedor de mensajería IBM MQ
Utilice este panel para ver o cambiar las propiedades de configuración de la especificación de activación seleccionada para ser utilizada con el proveedor de mensajería de IBM MQ. Estas propiedades de configuración controlan cómo se crean las conexiones con las colas y temas asociados.
- En el panel de navegación, pulse para visualizar especificaciones de activación existentes.
- Si es lo adecuado, en el panel de contenido, cambie el valor de Á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 desee trabajar.
- Propiedades avanzadas para visualizar o modificar las propiedades avanzadas de la 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, puede utilizar 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 empieza o no a partir del destino JMS tan pronto como se utiliza la especificación de activación para un bean controlado por mensajes para conectar con el destino.
- 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 creó utilizando una CCDT (tabla de definiciones de canal de cliente), siga este enlace para especificar toda la información necesaria para conectar con 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 los mandatos administrativos de IBM MQ createWMQActivationSpec.
- 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 especifique cuando configure IBM MQ para los recursos JMS. Para obtener más información, consulte las secciones Utilización de Java y Administración del sistema del centro de información de IBM MQ .
Si se ha inhabilitado la funcionalidad de IBM MQ en un ámbito que afecte a este recurso de proveedor de mensajería IBM MQ, aparece un mensaje informativo en el que se indica que se ha inhabilitado IBM MQ. En un entorno de servidor único, este mensaje informativo sólo se visualiza cuando se reinicia el servidor después de que se haya inhabilitado la funcionalidad de IBM MQ. En un entorno de despliegue de red, el mensaje informativo se visualiza inmediatamente.
Una especificación de activación 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 tal modo 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 |
Proveedor
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 |
Name
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
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 | Nulo |
Conexión
La información necesaria para configurar una conexión depende de si la especificación de activación seleccionada se ha creado utilizando una Tabla de definiciones de canal de cliente (CCDT).
- URL de tabla de definición del canal de cliente
- Gestor de colas
- Configuración SSL
- Gestor de colas
- Transporte
- Si la opción Introducir información sobre el host y el puerto en forma de valores separados de host y de puerto está seleccionada, la propiedad de lista nombre de conexión no se puede utilizar y las propiedades siguientes se pueden utilizar:
- Nombre de host
- Puerto
- Si la opción Introducir información sobre el host y el puerto en forma de lista de nombres de conexión está seleccionada, la propiedad de lista nombre de conexión no se puede utilizar y las propiedades siguientes no se pueden utilizar:
- Nombre de host
- Puerto
- Canal de conexión de servidor
- Si desmarca el recuadro de selección para la propiedad
Utilizar SSL para proteger la comunicación con IBM
MQ, no se pueden utilizar las propiedades siguientes.
- Gestionado centralmente
- Configuración específica
- Configuración SSL
Si desea más información sobre cómo definir las propiedades SSL para IBM MQ, consulte la sección Propiedades SSL en la sección IBM MQUtilización de Java del IBM MQ Information Center.
- maxConnections
- connectionConcurrency(El establecimiento de esta propiedad solamente afecta a nodos de la versión 7 de WebSphere Application Server. La propiedad no tiene repercusión para los nodos de WebSphere Application Server versión 8 o posteriores. )
- reconnectionRetryCount
- reconnectionRetryInterval
URL de tabla de definición del 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 un grupo de compartición de cola 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:
Si la fábrica de conexiones especificada se basa en CCDT y CCDT puede seleccionar entre más de un gestor de colas, es posible que no pueda recuperar las transacciones globales.
Por lo tanto, para las fábricas de conexiones que especifican una CCDT, tiene dos alternativas:
|
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 |
|
Introducir información sobre el host y el puerto en forma de valores separados de host y de 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 de puerto.
Al seleccionar esta opción, se habilitan las propiedades de nombre de host y de puerto y se inhabilita la propiedad de lista de nombre de conexión. Para introducir la información de lista de nombres de conexión, pulse Introducir información sobre el host y el puerto en forma de 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
El nombre de host o la dirección IPv4 o IPv6 del gestor de colas de IBM MQ al que va a conectarse.
Información | Value |
---|---|
Tipo de datos | Serie |
Puerto
El número de puerto en el que está escuchando IBM MQ.
Información | Value |
---|---|
Tipo de datos | Integer |
Valor por omisión | 1414 |
Rango | El valor debe ser un entero dentro del rango 1 - 65536 (ambos incluidos). |
Introducir información sobre el host y el puerto en forma de 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. Al seleccionar esta opción se habilita la propiedad de lista nombre de conexión y se inhabilita el nombre de host y el puerto propiedades. Para introducir de forma separada la información de host y de puerto, pulse Introducir información sobre el host y el puerto en forma de valores separados de host y de 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 |
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 se debe utilizar para permitir una 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 | No establecido |
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. El host debe ser un nombre de host TCP/IP válido o una dirección IPv4 o IPv6. El puerto debe ser un valor entero dentro del rango 1 - 65536 (ambos incluidos). Por ejemplo: localhost(1234),remotehost1(1234),remotehost2 |
Cuando se especifica la propiedad de lista nombres de conexión, el nombre de host o las propiedades de 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 se ha especificado localhost(1234),remotehost1(1234),remotehost2, el nombre de host se establecerá 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.
- 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 de nombres de conexión no se reconoce y se genera un mensaje de aviso parecido al siguiente ejemplo:
En este caso la información del nombre de host y las propiedades de puerto se utilizan para conectarse al gestor de colas.[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. El proceso continúa.
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 las comunicaciones 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 de proveedor de mensajería de IBM MQ en el entorno del servidor de aplicaciones, el servidor de aplicaciones gestiona la configuración SSL. Para modificar los parámetros de configuración de SSL, utilice la consola de administración para desplazarse hasta el panel .
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 este recuadro de selección no está seleccionado, las siguientes propiedades SSL están inhabilitadas:
|
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 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 IBM MQ para seleccionar una configuración SSL adecuada. Si se ha especificado la información de host y puerto a la especificación de activación mediante una lista de nombres de conexión, significa que se utilizará la información de nombre de host y de puerto del primer elemento de la lista para seleccionare una configuración SSL adecuada. Para proporcionar la configuración de SSL con la que debe coincidir la especificación de activación, consulte el tema Valores de configuración de SSL de punto final de salida dinámica 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 una configuración SSL concreta para utilizar cuando se debe utilizar SSL para proteger las comunicaciones de red con el gestor de colas o el grupo de compartición de cola 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 no está habilitada si el botón de selección Gestionado centralmente está seleccionado y el recurso del 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 de proveedor de mensajería de IBM MQ se basa en una CCDT, este parámetro sólo se utiliza si las entradas correspondientes en la CCDT se han configurado 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 |
Destination
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 |
|
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 |
|
Nombre de suscripción
Nombre de una suscripción duradera. Sólo está disponible cuando se selecciona 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 |
|
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 requeridas por el cliente.
Información | Value |
---|---|
Tipo de datos | Serie |
Rango | El valor especificado debe ser una serie vacía o tener uno de los siguientes formatos:
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. |