Valores de la fábrica de conexiones de cola del proveedor de IBM MQ para clientes de aplicaciones

Utilice este panel para ver o modificar las propiedades de configuración de la fábrica de conexiones de cola seleccionada para su uso con IBM MQ Java™ Message Service (JMS). Estas propiedades de configuración controlan cómo se crean las conexiones entre el proveedor de JMS y IBM MQ.

Para ver esta página de la herramienta ACRCT (Application Client Resource Configuration Tool), pulse Archivo > Abrir. Después de buscar un archivo EAR, pulse Abrir. Expanda el archivo JAR seleccionado y pulse Proveedores de mensajería > Proveedor IBM MQ. Pulse con el botón derecho del ratón en Fábricas de conexiones de cola y pulse Nueva. Los campos siguientes se muestran en el separador General.

Nota:
  • Los valores de propiedades que especifique deben coincidir con los valores que especifique cuando configure IBM MQ para los recursos JMS. Para obtener más información sobre cómo configurar IBM MQ para recursos JMS, consulte la sección Utilización de Java del Information Center de IBM MQ.
  • En IBM MQ, los nombres pueden tener un máximo de 48 caracteres, a excepción de los canales, que tienen un máximo de 20 caracteres.

Una fábrica de conexiones de cola del proveedor de JMS tiene las propiedades siguientes.

Nombre

Nombre por el que se conoce esta fábrica de conexiones de cola para fines administrativos dentro de WebSphere Application Server. El nombre debe ser exclusivo dentro de las fábricas de conexiones JMS en el dominio administrativo de WebSphere.

Información Valor
Tipo de datos Serie

Descripción

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

Información Valor
Tipo de datos Serie
Serie Nulo

Nombre JNDI

El programa de tiempo de ejecución del cliente de aplicaciones utiliza este campo para recuperar información de configuración.

ID de usuario

ID de usuario utilizado, junto con la propiedad contraseña, en la operación de autenticación si la aplicación que llama no proporciona explícitamente un ID de usuario ni una contraseña.

Si especifica un valor para la propiedad de ID de usuario, también debe especificar un valor para la propiedad de contraseña.

Las propiedades de ID de usuario y contraseña de la fábrica de conexiones se utilizan si la aplicación que llama no proporciona explícitamente un ID de usuario ni una contraseña; por ejemplo, si la aplicación que llama utiliza el método createQueueConnection(). El cliente de JMS dirige el ID de usuario y la contraseña al servidor JMS.

Información Valor
Tipo de datos Serie

Password

Contraseña utilizada, junto con la propiedad de ID de usuario, para la autenticación si la aplicación emisora no proporciona explícitamente un ID de usuario ni una contraseña.

Si especifica un valor para la propiedad de ID de usuario, también debe especificar un valor para la propiedad de contraseña.

Información Valor
Tipo de datos Serie
Serie Nulo

Vuelva a entrar la contraseña

Confirma la contraseña.

Gestor de colas

Nombre del gestor de colas de IBM MQ para esta fábrica de conexiones.

Las conexiones creadas por dicha fábrica se conectan a este gestor de colas.

Información Valor
Tipo de datos Serie

Especificar información de nombre de usuario y puerto

Este botón de selección estará seleccionado de forma predeterminada y, si está seleccionado, habilita las propiedades de host y puerto e inhabilita la propiedad de lista de nombres de conexión.

Información Valor
Tipo de datos Botón de selección
Serie Seleccionado

Host

Nombre del host en el que el gestor de colas de IBM MQ se ejecuta sólo para conexiones de cliente.

Información Valor
Tipo de datos Serie
Serie Nulo
Rango Un nombre de host TCP/IP válido

Puerto

Número de puerto TCP/IP utilizado para la conexión con el gestor de colas de IBM MQ, sólo para la conexión con el cliente.

Este puerto se debe configurar en el gestor de colas de IBM MQ.

Información Valor
Tipo de datos Integer
Serie Nulo
Rango Un número de puerto TCP/IP válido configurado en el gestor de colas de IBM MQ.

Especificar la información de lista de nombres de conexión

Si se selecciona, este botón de selección habilita la propiedad de lista de nombres de conexión e inhabilita las propiedades de host y número de puerto. Seleccione este botón de selección si desea conectarse a un gestor de colas de varias instancias.

Información Valor
Tipo de datos Botón de selección
Serie Deseleccionado

Lista de nombres de conexión

Lista separada por comas de información de host y puerto que se puede utilizar para conectarse a un gestor de colas de varias instancias.

El formato de la lista es:
host[(puerto)],[host[(puerto)]]
Donde puerto es opcional y el valor predeterminado es 1414, si no se establece ninguno. Por ejemplo:
nombre_host1,nombre_host2(1415)

Para obtener más información acerca de los gestores de colas de varias instancias, consulte IBM MQ Information Center.

Esta propiedad sólo se debe utilizar para conectarse a un gestor de colas de varias instancias. No debe utilizarse para la conexión a una lista de gestores de colas específicos ya que esto podría generar problemas de integridad de las transacciones.

Canal

Nombre del canal utilizado para la conexión con el gestor de colas IBM MQ, sólo para la conexión del cliente.

Información Valor
Tipo de datos Serie
Serie Nulo
Rango 1 a 20 caracteres ASCII

Tipo de transporte

Especifica si la conexión de cliente de IBM MQ o los enlaces JNDI se utilizan para la conexión con el gestor de colas IBM MQ. El proveedor de JMS externo controla los protocolos de comunicaciones entre los clientes JMS y los servidores JMS. Ajuste el tipo de transporte cuando utiliza la mensajería no ASF, no transaccional, no durable no persistente o cuando desee satisfacer cuestiones de seguridad y el cliente es local respecto al nodo del gestor de colas.

Información Valor
Tipo de datos Enum
Unidades No aplicable
Serie ENLACES
Rango
ENLACES
Los enlaces JNDI se utilizan para conectar con el gestor de colas. ENLACES (bindings) es un protocolo de memoria compartida y sólo se puede utilizar cuando el gestor de colas se encuentra en el mismo nodo que el cliente de JMS y provoca algunos riesgos de seguridad que se deben tratar mediante el uso de roles de EJB.
CLIENTE
La conexión de cliente de IBM MQ se utiliza para conectarse al gestor de colas. CLIENTE es un protocolo basado en TCP típico.
DIRECTO
Para IBM MQ Event Broker utilizando la modalidad DIRECT. DIRECT es un protocolo Lightweight Sockets que se utiliza en servicios de mensajes de publicación/suscripción no transaccionales, no perdurables y no persistentes. DIRECTO sólo funciona en clientes y beans controlados por mensajes mediante el protocolo que no es ASF.
EN COLA
En COLA es un protocolo TCP sin estado.
Recomendado
Tipo de transporte de fábrica de conexiones de cola
ENLACES es un 30% o más rápido, pero requiere que se configuren correctamente los roles EJB para garantizar la seguridad. Si le preocupa la seguridad y tiene que utilizar CLIENT, debe realizar un uso adecuado de SSL para proteger la conexión con el gestor de colas.
Tipo de transporte de fábrica de conexiones de tema
DIRECT es el tipo más rápido y debe utilizarse cuando sea posible. Utilice ENLACES cuando desee satisfacer tareas de seguridad adicionales y el gestor de colas sea local para el cliente JMS. EN COLA es lo que se utiliza para todos los demás casos. IBM MQ 5.3 antes de CSD2 con el valor DIRECTO puede perder mensajes cuando se utiliza con beans controlados por mensajes y bajo carga. Esta pérdida también ocurre con las aplicaciones en el extremo del cliente, a menos que maxClientQueueSize del intermediario esté establecido en 0. Puede establecer este valor en 0 con el mandato:
#wempschangeproperties WAS_nodeName_server1
 -e default -o DynamicSubscriptionEngine -n
 maxClientQueueSize -v 0 -x executionGroupUUID
donde executionGroupUUID se puede encontrar iniciando el intermediario y buscando en el registro cronológico de sucesos o aplicaciones el suceso 2201. Este valor suele ser ffffffff-0000-0000-000000000000.
Nota: No se puede utilizar el JMS de IBM MQ 5.3 en WebSphere Application Server Versión 6.1 debido a que WebSphere Application Server Versión 6.1 tiene un tiempo de ejecución de Java 5. Por lo tanto, no se pueden establecer conexiones entre memoria con los gestores de colas de IBM MQ 5.3. Esto puede dar como resultado una disminución del rendimiento si anteriormente estaba utilizando IBM MQ 5.3 y ENLACES para las conexiones pero pasa a las conexiones de red de CLIENTE cuando realiza la migración a WebSphere Application Server Versión 6.1. [z/OS]Si utiliza IBM MQ 5.3 para z/OS, es posible que también necesite instalar un paquete de características adicional.

ID de cliente

Identificador de cliente de JMS utilizado para conexiones con el gestor de colas IBM MQ.

Información Valor
Tipo de datos Serie

CCSID

El identificador de conjunto de caracteres codificados para ser utilizado con el gestor de colas IBM MQ.

Este identificador de conjunto de caracteres codificados debe ser uno de los CCSID soportados por IBM MQ.

Información Valor
Tipo de datos Serie

Para obtener más información sobre los CCSID soportados y sobre cómo convertir entre datos de mensajes de un juego de caracteres codificado a otro, consulte las Administración del sistema y Application Programming Reference del Information Center de IBM MQ.

Retención de mensajes

Seleccione este recuadro de selección para especificar que desea conservar en la cola los mensajes no deseados. De lo contrario, dichos mensajes se manejan de acuerdo con sus opciones de configuración.

Información Valor
Tipo de datos Enum
Unidades No aplicable
Serie Deseleccionado
Rango
Seleccionado
Los mensajes no deseados permanecen en la cola.
Deseleccionado
Los mensajes no deseados se manejan de acuerdo con sus opciones de configuración.

Modelo temporal

Nombre de la definición de modelo que se utiliza para crear fábricas de conexiones temporales si no existe ninguna aún.

Información Valor
Tipo de datos Serie
Rango De 1 a 48 caracteres ASCII

Prefijo de cola temporal

Prefijo utilizado para la denominación de colas dinámicas.

Información Valor
Tipo de datos Serie

Anomalía si inmovilizado

Especifica si las aplicaciones realizan la devolución de una llamada a método si el gestor de colas ha entrado en una anomalía controlada.

Información Valor
Tipo de datos Recuadro de selección
Serie Seleccionado

Dirección local del servidor

Especifica la dirección local del servidor.

Información Valor
Tipo de datos Serie

Intervalo de sondeo

Especifica el intervalo, en milisegundos, entre exploraciones de todos los receptores durante la entrega de mensajes asíncronos.

Información Valor
Tipo de datos Integer
Unidades Milisegundos
Serie 5000

Intervalo de exploración

Especifica el intervalo de tiempo en milisegundos entre cada exploración de tema en busca de mensajes añadidos a un tema fuera de orden.

Este intervalo controla la exploración de mensajes que se han añadido a un tema fuera de servicio con respecto a un cursor de navegación de IBM MQ.

Información Valor
Tipo de datos Integer
Unidades Milisegundos
Serie 5000

Suite de cifrado SSL

Especifica el suite de cifrado que se utiliza para la conexión SSL con IBM MQ.

Establezca esta propiedad en un suite de cifrado válido proporcionado por el proveedor de JSSE. El valor debe coincidir con la CipherSpec especificada en el canal SVRCONN como la propiedad Canal..

Debe establecer esta propiedad, si establece la propiedad Nombre de igual SSL.

Almacén de certificados SSL

Especifica una lista de cero o más servidores CRL (Lista de revocación de certificados) utilizada para comprobar la revocación de certificados SSL. Si especifica un valor para la propiedad ID de usuario, debe utilizar la JVM de IBM MQ en Java 2 versión 1.4.

El valor es una lista de entradas delimitada por espacios con el siguiente aspecto:
ldap://nombresistprpal:[puerto]

A continuación de este valor va una sola barra inclinada (/). Si se omite puerto, se asume que el puerto LDAP predeterminado es de 389. Durante la conexión, el certificado SSL presentado por el servidor se comprueba contra los servidores CRL especificados. Para obtener más información sobre la seguridad CRL, consulte la información sobre "Cómo trabajar con listas de revocaciones de certificado" en la sección Seguridad del Information Center de IBM MQ.

Nombre de igual SSL

Para SSL, un esqueleto de nombre distinguido debe coincidir con el nombre proporcionado por el gestor de colas de IBM MQ. El nombre distinguido se utiliza para comprobar el certificado identificador presentado por el servidor durante el tiempo de conexión.

Si no se ha establecido esta propiedad, se lleva a cabo esta comprobación de certificado.

La propiedad Nombre de igual SSL se ignorará si no se ha especificado la propiedad Suite de cifrado SSL.

Esta propiedad es una lista de pares de nombre y valor de atributo separados por comas o punto y coma. Por ejemplo:
CN=QMGR.*, OU=IBM, OU=WEBSPHERE

El ejemplo proporcionado comprueba el certificado de identificación presentado por el servidor en el momento de la conexión. Para que la conexión sea satisfactoria, el certificado debe tener un Nombre común que empiece por QMGR. y debe tener al menos dos nombres de Unidad organizativa; el primero es IBM® y el segundo WEBSPHERE. La comprobación no es sensible a las mayúsculas y minúsculas.

Para obtener más detalles sobre nombres distinguidos y su uso con IBM MQ, consulte la sección "Nombres distinguidos" en IBM MQ Information Center.

Agrupación de conexiones

Especifica un conjunto opcional de valores de agrupación de conexiones.

Las propiedades de agrupación de conexiones son comunes a todos los conectores J2C.

Las sesiones y las conexiones de las agrupaciones del servidor de aplicaciones con el proveedor de JMS para mejorar el rendimiento. Esta conexión es independiente de cualquier técnica de agrupación de conexiones de IBM MQ. Debe configurar las propiedades de conexión y de agrupación de sesiones de forma apropiada para las aplicaciones; de lo contrario, quizás no obtenga el comportamiento de la conexión y sesión que desee.

Cambie el tamaño de la agrupación de conexiones si el acceso del lado del servidor simultáneo al recurso JMS excede el valor predeterminado. El tamaño de la agrupación de conexiones se establece por cola o por tema.

Información Valor
Tipo de datos Recuadro de selección
Serie Seleccionado

Opciones de reconexión de cliente

Especifica si una conexión de modalidad de cliente se vuelve a conectar automáticamente o no, en el caso de una anomalía de comunicaciones o del gestor de colas. Esta propiedad se omite a menos que se utilice la fábrica de conexiones en un entorno de cliente ligero o gestionado.

Información Valor
Tipo de datos Lista desplegable
Serie DISABLED
Rango
DISABLED
La reconexión de cliente no se produce automáticamente.
ASDEF
Se utiliza el valor del atributo DefRecon de la stanza de canales del archivo de configuración de cliente. Si no hay ningún valor DefRecon especificado, este valor tiene el mismo efecto que un valor de DISABLED.
RECONNECT
La reconexión se produce con cualquier gestor de colas coherente con el valor del atributo del gestor de colas, que puede ser un gestor de colas diferente al que estaba conectada originalmente la conexión.
QMGR
La reconexión se produce solamente al gestor de colas al que estaba originalmente conectada la conexión.

Para obtener más información sobre la reconexión de cliente automática, consulte el Information Center de IBM MQ.

Tiempo de espera de reconexión de cliente

El número máximo de segundos que una conexión de modalidad de cliente intenta reconectar automáticamente a un gestor de colas después de una anomalía de comunicaciones o del gestor de colas. Este parámetro se ignora a menos que se utilice la fábrica de conexiones en un entorno de cliente ligero o gestionado. Si este parámetro se utiliza o no depende del valor del parámetro de opciones de reconexión de cliente.

Información Valor
Tipo de datos Integer
Unidades Segundos
Serie 1800
Rango Un valor mayor que cero y hasta 2147483647

Para obtener más información sobre la reconexión de cliente automática, consulte el Information Center de 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=ucli_pqcfm
File name: ucli_pqcfm.html