Sun Java System Message Queue Notas de la versi�n

Versi�n 3 2005Q4 (3.6 SP3)

N�mero de referencia 819-3559

Estas notas de la versi�n contienen informaci�n importante disponible en el momento de la publicaci�n de Sun Java™ System Message Queue 3 2005Q4 (3.6 SP3). Asimismo, este documento incluye el contenido de las notas de la versi�n de Sun Java™ System Message Queue 3 2005Q1 (3.6) para los clientes que actualicen desde versiones anteriores a Message Queue 3 2005Q1. Aqu� se tratan nuevas funciones y mejoras, limitaciones y problemas conocidos e informaci�n de otro tipo. Lea este documento antes de empezar a utilizar Message Queue.

La versi�n m�s actualizada de estas notas de la versi�n se encuentra en el sitio Web de documentaci�n de Sun Java System Message Queue: http://docs.sun.com/coll/1307.1. Consulte el sitio Web antes de instalar y configurar el software y, despu�s, vis�telo de forma peri�dica para ver los manuales y las notas de la versi�n m�s actualizados.

En estas notas de la versi�n se incluyen las siguientes secciones:

Historial de revisiones de las notas de la versi�n
Acerca de Message Queue 3 2005Q4 (3.6 SP3)
Errores solucionados en esta versi�n
Informaci�n importante
Limitaciones y problemas conocidos
Archivos que se pueden distribuir
Funciones de accesibilidad para usuarios con discapacidad
Informaci�n sobre problemas y respuestas de los clientes
Recursos adicionales de Sun

Se hace referencia a las direcciones URL de terceras partes para proporcionar informaci�n adicional relacionada.

Nota	Sun no se hace responsable de la disponibilidad de los sitios Web de terceras partes que se mencionan en este documento. Sun no garantiza ni se hace responsable de ning�n contenido, anuncio, producto ni de cualquier otro material disponible en dichos sitios o recursos. Sun no se responsabiliza de ning�n da�o, real o supuesto, ni de posibles p�rdidas que se pudieran derivar del uso de los contenidos, bienes o servicios que est�n disponibles en dichos sitios o recursos.

---

Historial de revisiones de las notas de la versi�n

Tabla 1  Historial de revisiones 

Fecha	Descripci�n de los cambios
26 de agosto, 2005	Actualizaci�n de Acerca de Message Queue 3 2005Q4 (3.6 SP3). Actualizaci�n de Actualizaciones de la documentaci�n de Message Queue 3 2005Q4 (3.6 SP3) Actualizaci�n de Requisitos de hardware y software para Message Queue 2005Q4 (3.6 SP3). Adici�n de errores solucionados en Message Queue 3 2005Q4 (3.6 SP3) a Errores solucionados en esta versi�n.
28 de junio, 2005	Adici�n de errores solucionados en Message Queue 3 2005Q1 (3.6 SP1) y Message Queue 32005Q4 (3.6 SP2) a Errores solucionados en esta versi�n.
1 de mayo, 2005	Actualizaci�n del apartado Problemas relacionados con la siguiente versi�n principal de Message Queue con nueva informaci�n. Se agrega una declaraci�n de Estabilidad de interfaz al apartado Compatibilidad.
24 de enero, 2005	Actualizaci�n en relaci�n con el lanzamiento de las versiones comerciales de Sun Java System Message Queue 3 2005Q1 y Java Enterprise System 2005Q1.
8 de noviembre, 2004	Versi�n inicial de Sun Java System Notas de la versi�n de Message Queue.

---

Acerca de Message Queue 3 2005Q4 (3.6 SP3)

Message Queue 3 2005Q4 (3.6 SP3) es una actualizaci�n que soluciona errores de Message Queue 3 2005Q1 (3.6). Contiene todas las soluciones ya incluidas en las versiones 3.6 SP2 y 3.6 SP1, adem�s de nuevas actualizaciones de la documentaci�n.

Message Queue 3 2005Q1 (3.6)

Sun Java System Message Queue es un completo servicio de mensajer�a con caracter�sticas fiables y as�ncronas que se ajustan a las especificaciones de la versi�n 1.1 de Java Messaging Specification (JMS). Adem�s, Message Queue ofrece una amplia variedad de funciones adicionales no incluidas en la especificaci�n JMS para satisfacer las necesidades de las implementaciones empresariales a gran escala.

Esta secci�n incluye:

Novedades de esta versi�n
Requisitos de hardware y software

Novedades de esta versi�n

Entre las nuevas funciones de Message Queue 3 2005Q1 (3.6), se incluyen:

Mensajes inactivos de Message Queue
No Acknowledge Mode (Modo sin acuse de recibo)
Compresi�n del cuerpo del mensaje del cliente
Detecci�n de errores de conexi�n (ping de tiempo de ejecuci�n de cliente)
Administraci�n de certificados: Herramientas NSS de C-API
Compatibilidad con la autenticaci�n b�sica de C-API
Compatibilidad con C-API de 64 bits

�stas se describen en los siguientes subapartados.

Mensajes inactivos de Message Queue

Message Queue crea autom�ticamente un destino especializado durante el inicio de agente que permite almacenar mensajes inactivos para tareas de diagn�stico. Un mensaje inactivo es el que se elimina del sistema por motivos distintos a una acci�n normal de procesamiento o expl�cita del administrador. Un mensaje se considera inactivo cuando ha caducado, cuando se elimina de un destino al desbordarse el l�mite de memoria o cuando se producen intentos de entrega fallidos.

Un administrador puede configurar destinos para descartar mensajes inactivos o enviarlos a la cola de mensajes inactivos. En este �ltimo caso, se agrega al mensaje informaci�n de propiedad adicional para indicar al administrador la causa de su inactividad. Asimismo, al crear un mensaje, un desarrollador de cliente puede tambi�n establecer un valor de propiedad que determine si �ste debe colocarse en la cola de mensajes al convertirse en inactivo.

Para obtener m�s informaci�n, consulte la Message Queue Administration Guide.

No Acknowledge Mode (Modo sin acuse de recibo)

El modo de acuse de recibo NO_ACKNOWLEDGE es una extensi�n de la API JMS. El agente suele esperar un acuse de recibo del cliente. Cuando el cliente ha especificado CLIENT_ACKNOWLEDGE, dicho acuse de recibo debe realizarse mediante programaci�n o, si ha especificado AUTO_ACKNOWLEDGE o DUPS_OK, autom�ticamente en la sesi�n. Si un cliente consumidor especifica el modo NO_ACKNOWLEDGE, el agente descarta el mensaje en cuanto se env�a al cliente consumidor. Aunque esta funci�n est� destinada especialmente a suscriptores no duraderos que consumen mensajes no persistentes, puede tambi�n utilizarla cualquier consumidor.

Esta funci�n permite mejorar el rendimiento, ya que reduce el tr�fico de protocolos y las tareas de agente implicadas en el acuse de recibo de un mensaje. Asimismo, mejora el rendimiento de los agentes que se ocupan de los clientes con un comportamiento inadecuado que no confirman la recepci�n de mensajes y acaparan innecesariamente recursos de memoria del agente. Este modo no afecta a los productores.

El modo NO_ACKNOWLEDGE no es compatible en los clientes C. Para obtener m�s informaci�n, consulte la Message Queue Developer’s Guide for Java Clients.

Compresi�n del cuerpo del mensaje del cliente

El desarrollador puede especificar que se comprima el cuerpo de un mensaje. De la compresi�n y descompresi�n del mensaje se ocupa el tiempo de ejecuci�n del cliente, por lo que no afecta al agente. Por tanto, las aplicaciones pueden utilizar esta funci�n con una versi�n anterior del agente, pero deben utilizar la versi�n 3 2005Q1 (3.6) de la biblioteca de tiempo de ejecuci�n de cliente de Message Queue.

Ventajas y limitaciones de la compresi�n     Aunque la compresi�n de mensajes se ha agregado para mejorar el rendimiento, esta ventaja no est� garantizada. Los beneficios dependen del tama�o y formato de los mensajes, el n�mero de consumidores, el ancho de banda de la red y el rendimiento de la CPU. Por ejemplo, el coste de la compresi�n y descompresi�n puede superar el tiempo que se ahorra en enviar y recibir un mensaje comprimido. �ste es el caso especialmente si se env�an mensajes peque�os en una red de alta velocidad. Sin embargo, las aplicaciones que publican mensajes grandes a muchos clientes o que lo hacen en un entorno de red lento, pueden mejorar el rendimiento del sistema mediante la compresi�n de mensajes.

Los consumidores de mensajes implementados con las bibliotecas de tiempo de ejecuci�n de cliente anteriores a la versi�n 3 2005Q1 (3.6) no pueden procesar mensajes comprimidos. Los clientes configurados para enviar mensajes comprimidos deben asegurarse de que los consumidores sean compatibles. Actualmente, los clientes C no pueden consumir mensajes comprimidos.

Para obtener m�s informaci�n, consulte la Message Queue Developer’s Guide for Java Clients.

Detecci�n de errores de conexi�n (ping de tiempo de ejecuci�n de cliente)

Message Queue 3 2005Q1 incorpora un nuevo atributo ConnectionFactory llamado imqPingInterval. El atributo imqPingInterval especifica la frecuencia de una operaci�n de ping desde el tiempo de ejecuci�n de cliente al agente. Mediante una comprobaci�n peri�dica de la conexi�n, el tiempo de ejecuci�n de cliente puede detectar de forma preventiva un error de conexi�n. Si la operaci�n de ping no se realiza correctamente, el tiempo de ejecuci�n de cliente muestra una excepci�n en el objeto de escucha de excepciones de la aplicaci�n cliente. Si la aplicaci�n no dispone de una escucha de excepciones, cuando la aplicaci�n intente de nuevo utilizar la conexi�n se producir� un error.

Para obtener m�s informaci�n, consulte la Message Queue Administration Guide.

Administraci�n de certificados: Herramientas NSS de C-API

C-API utiliza bibliotecas NSS (Servicios de seguridad de redes, Network Security Services) para la compatibilidad con SSL. Estas bibliotecas proporcionan API y utilidades para el desarrollo de aplicaciones seguras. Entre dichas utilidades se incluyen herramientas para la administraci�n de claves y bases de datos de certificados. En Message Queue 3.5, recomend�bamos a los desarrolladores que utilizaran Mozilla para administrar claves y certificados NSS. En Message Queue 3 2005Q1, los administradores pueden utilizar la herramienta NSS certutil para generar las claves y los certificados necesarios.

Para obtener m�s informaci�n, consulte la Message Queue Developer’s Guide for C Clients.

Compatibilidad con la autenticaci�n b�sica de C-API

Message Queue La C-API de 3 2005Q1 admite el tipo de autenticaci�n basic. Versiones anteriores de Message Queue no admit�an el tipo de autenticaci�n basic.

Compatibilidad con C-API de 64 bits

Ahora, Message Queue es compatible con C-API de 64 bits en plataformas Solaris/SPARC. Para obtener m�s informaci�n acerca de c�mo habilitar la compatibilidad con C-API de 64 bits, consulte la Message Queue Developer’s Guide for C Clients.

Requisitos de hardware y software

Este apartado especifica o describe el hardware y software necesario para esta versi�n de Message Queue. La Tabla 2 muestra los requisitos de hardware y software para sistemas operativos Solaris SPARC.

Tabla 2  Requisitos de software y hardware para Solaris SPARC 

Componente	Requisitos de la plataforma
Sistema operativo	Solaris 8, Update 7 Solaris 9, Update 7 Solaris 10, Update 1 (Incluye compatibilidad de 32 y 64 bits para Solaris 8, Solaris 9 y Solaris 10)
CPU	Sun UltraSPARC™ Nota: para garantizar un correcto funcionamiento de Message Queue, debe instalar todas las revisiones de Solaris para Java 2 Platform, Standard Edition 5.0. Para conocer la informaci�n m�s reciente acerca de las revisiones y descargar las versiones recomendadas o necesarias, consulte: http://java.sun.com/j2se/1.5.0/download.jsp
RAM	256 Mbytes
Espacio en disco	Platform Edition: El archivo de instalaci�n comprimido ocupa aproximadamente 33 Mbytes. El directorio de trabajo temporal utilizado para extraer los archivos de instalaci�n requiere un espacio adicional de 33 Mbytes. El producto instalado ocupa aproximadamente 33 Mbytes de espacio en el disco duro. Sin embargo, Message Queue puede necesitar m�s espacio si el agente almacena localmente mensajes persistentes. Enterprise Edition: El archivo de instalaci�n comprimido ocupa aproximadamente 152 Mbytes. El directorio de trabajo temporal utilizado para extraer los archivos de instalaci�n requiere un espacio adicional de 152 Mbytes. El producto instalado ocupa aproximadamente 33 Mbytes de espacio en el disco duro. Sin embargo, Message Queue puede necesitar m�s espacio si el agente almacena localmente mensajes persistentes.

La Tabla 3 muestra los requisitos de hardware y software para sistemas operativos Solaris x86.

Tabla 3  Requisitos de software y hardware para Solaris x86 

Componente	Requisitos de la plataforma
Sistema operativo	Solaris 9, Update 7 Solaris 10, Update 1 (Incluye compatibilidad de 32 y 64 bits para Solaris 9 y Solaris 10)
CPU	Intel Pentium 2 (o compatible) Nota: para garantizar un correcto funcionamiento de Message Queue, debe instalar todas las revisiones de Solaris para Java 2 Platform, Standard Edition 5.0. Para conocer la informaci�n m�s reciente acerca de las revisiones y descargar las versiones recomendadas o necesarias, consulte: http://java.sun.com/j2se/1.5.0/download.jsp
RAM	256 Mbytes
Espacio en disco	Platform Edition: El archivo de instalaci�n comprimido ocupa aproximadamente 22 Mbytes. El directorio de trabajo temporal utilizado para extraer los archivos de instalaci�n requiere un espacio adicional de 22 Mbytes. El producto instalado ocupa aproximadamente 22 Mbytes de espacio en el disco duro. Sin embargo, Message Queue puede necesitar m�s espacio si el agente almacena localmente mensajes persistentes. Enterprise Edition: El archivo de instalaci�n comprimido ocupa aproximadamente 115 Mbytes. El directorio de trabajo temporal utilizado para extraer los archivos de instalaci�n requiere un espacio adicional de 115 Mbytes. El producto instalado ocupa aproximadamente 22 Mbytes de espacio en el disco duro. Sin embargo, Message Queue puede necesitar m�s espacio si el agente almacena localmente mensajes persistentes.

La Tabla 4 muestra los requisitos de hardware y software para sistemas operativos Linux.

Tabla 4  Requisitos de software y hardware para Linux 

Componente	Requisitos de la plataforma
Sistema operativo	Red Hat Advanced Server 2.1, Update 6 RedHat Advanced Server 3.0, Update 4 Nota: en el momento de la publicaci�n de Message Queue, el software distribuido incluye la versi�n de JRE necesaria.
CPU	Intel Pentium 2 (o compatible)
RAM	256 Mbytes
Espacio en disco	Platform Edition: El archivo comprimido del producto tiene un tama�o aproximado de 17 Mbytes. El producto instalado ocupa aproximadamente 17 Mbytes de espacio en el disco duro. Sin embargo, Message Queue puede necesitar m�s espacio si el agente almacena localmente mensajes persistentes. Enterprise Edition: El archivo comprimido del producto tiene un tama�o aproximado de 104 Mbytes. El directorio de trabajo temporal utilizado para extraer los archivos de instalaci�n requiere un espacio adicional de 104 Mbytes. El producto instalado ocupa aproximadamente 17 Mbytes de espacio en el disco duro. Message Queue, sin embargo, puede necesitar m�s espacio si el agente almacena localmente mensajes persistentes.

Message Queue 3 2005Q1 utiliza tambi�n otras tecnolog�as, tal como se indica en la Tabla 5. Asimismo, pueden utilizarse versiones distintas o implementaciones de otros proveedores, pero Sun Microsystems no las ha probado y, por tanto, no garantiza su compatibilidad.

La Tabla 5 muestra y describe los componentes b�sicos que deben instalarse para poder desarrollar y ejecutar clientes de Message Queue.

Tabla 5  Message Queue 3 2005Q1: matriz b�sica de productos compatibles 

Plataforma/Producto	Se usa para	Versi�n de producto/plataforma compatible
Java Runtime Environment (JRE) (s�lo versiones de Sun Microsystems)	Agente (servidor de mensajes) de Message Queue y herramientas de administraci�n de Message Queue	Java Runtime Environment 1.4.2_05 Java 2 Platform, Standard Edition, 5.0 (1.5.0_02): Solaris 8 (SPARC), Solaris 9 (SPARC y X86) y Solaris 10 (SPARC y X86). Linux Red Hat Advanced Server 2.1, Update 6 y Linux Red Hat Advanced Server 3.0, Update 4. Windows XP Professional SP2, 2000 todas las ediciones SP4, Windows Server 2003 Enterprise Edition.
Java Software Development Kit (JDK), Standard Edition (s�lo versiones de producci�n de Sun Microsystems)	Desarrollo e implementaci�n de clientes Java (los clientes Java SOAP/JAXM s�lo se admiten en JDK 1.4.2 y 1.5)	JDK 1.4.2_05 Java 2 Platform, Standard Edition, 5.0 (1.5.0_02): Solaris (mismas plataformas que JRE) Linux (mismas plataformas que JRE) Windows (mismas plataformas que JRE)

La Tabla 6 muestra y describe los componentes que pueden instalarse para obtener compatibilidad adicional para un cliente de Message Queue. Puede que s�lo necesite algunos de los componentes de la lista. Por ejemplo, si no escribe un cliente C para Message Queue, no tendr� que instalar ninguno de los componentes necesarios para la compatibilidad con clientes C.

Tabla 6  Message Queue 3 2005Q1: matriz opcional de productos compatibles 

Producto	Se usa para	Versi�n de producto compatible
LDAP Directory Server	Compatibilidad con objetos administrados y repositorios de usuarios de Message Queue	Sun Java System Directory Server, versi�n 5.2 SP 3
Web Server	Compatibilidad con HTTP y HTTPS	Sun Java System Web Server, Enterprise Edition, versi�n 6.1 SP 4
Application Server	Compatibilidad con HTTP y HTTPS	Sun Java System Application Server, Enterprise Edition 8.1
Base de datos	Compatibilidad con persistencia conectada	PointBase, versi�n 4.8 Oracle 9i, versi�n 9.2
JNDI (Java Naming and Directory Interface)	Compatibilidad con objetos administrados	JNDI, versi�n 1.2.1 LDAP Service Provider, versi�n 1.2.2 File System Service Provider, versi�n 1.2 Beta 3 (compatible para tareas de desarrollo y prueba, aunque no para su implementaci�n en un entorno de producci�n).
Compilador C y biblioteca de tiempo de ejecuci�n C++ compatible	Compatibilidad con clientes C de Message Queue	Solaris: Sun WorkShop 6, Update 2 o compilador C++ posterior con -compat=5, compilador C de Sun WorkShop Linux: gcc/g++ 2.96 Windows: Microsoft Windows Visual C++ 6.0, SP3
NSPR (Netscape Portable Runtime)	Compatibilidad con clientes C de Message Queue	Versi�n incluida en Java Enterprise System 2005Q1. En la versi�n Platform Edition, se instala como paquete compartido.
NSS (Network Security Service)	Compatibilidad con clientes C de Message Queue	Versi�n incluida en Java Enterprise System 2005Q1. En la versi�n Platform Edition, se instala como paquete compartido.

---

Errores solucionados en esta versi�n

La Tabla 7 describe los errores solucionados en Message Queue 3 2005Q1 (3.6):

Tabla 7  Errores solucionados en Message Queue 3 2005Q1 (3.6) 

N�mero de error	Descripci�n
2091749	El agente recibe una excepci�n de puntero Null (nulo) en el conjunto compartido de subprocesos sometido a carga.
2092975	El almac�n persistente debe continuar cargando si se produce un error de deserializaci�n en un destino.
2092976	Error peri�dico al procesar un mensaje en un tema cuando se cierra un consumidor con selector en el momento en que el mensaje se enrutaba a trav�s del sistema.
4888259	Se reemplazan los comandos vmargs al pasar m�s de uno a imqbroker en Windows.
4934433	El c�digo de paquetes debe ofrecer protecci�n frente a paquetes grandes.
4941127	El destino no se cargar� completamente si el mensaje supera el l�mite de tama�o de mensaje individual.
4949398	El comando imqcmd query dst registra n�meros incorrectos cuando se carga un destino.
4953659	El cliente de Message Queue nunca llama a ExceptionListener.onException en una conexi�n parcialmente abierta.
4962906	El agente debe detectar una conexi�n de base de datos obsoleta y volver a conectarse.
4969880	El comando Receive(timeout) devuelve el valor null antes de que se agote el tiempo de espera en conexiones que se cierran con frecuencia.
4970719	En una transacci�n preparada, puede que se reenv�en mensajes de acuse de recibo a los consumidores.
4983525	Error al crear un productor en un destino creado autom�ticamente en un sistema Linux 3.0.
4987799	El adaptador de recursos y el agente de Message Queue deben admitir suscripciones compartidas para cl�steres de Application Server 8.1 Enterprise Edition.
4989708	El comando imqbrokerd siempre se comporta como si imq.transaction.autorollback fuera true.
4992645	Adaptador de recursos de Message Queue: El adaptador de recursos JMS debe admitir la agrupaci�n de conexiones.
4996776	El agente muestra ConcurrentModificationExceptions con un alto nivel de carga de cliente y m�tricas.
5004868	Las transacciones eliminadas no desaparecen de la base de datos JDBC.
5014570	El ejemplo de QBrowser no funciona con la versi�n Platform Edition.
5024685	Listas de control de acceso: los comandos queue.create.deny.user=* e imq.autocreate.queue=true no interact�an correctamente.
5025241	Los suscriptores duraderos con noLocal=true reciben mensajes autopublicados.
5037962	La discrepancia entre el estado y el registro del agente maestro provoca interbloqueos durante el inicio.
5042763	El c�digo del almac�n de archivos debe utilizar el comando FileChannel.force(false) para mejorar el rendimiento s�ncrono de E/S.
5046995	La implementaci�n de negociaci�n de protocolos de clientes Java de Message Queue no funciona de modo fiable.
5053565	Message Queue 3.5 SP1: el agente gira y quema la CPU en un cl�ster con un agente maestro.
5063625	El receptor de cola deja de recibir mensajes con mensajes remotos destinados a dicho receptor en cl�steres de dos agentes.
6021000	Se produce un interbloqueo en el agente al agregar y quitar consumidores durante una fase de carga elevada.
6057402	Se produce un interbloqueo en el agente maestro al reiniciar cuando ha eliminado un destino con suscriptores duraderos.
6057450	imqcmd: no se puede establecer el valor 0 para las colas en el comando maxNumBackupConsumers.
6155087	Un agente con un nombre incorrecto y un suscriptor duradero en cl�ster se bloquea durante el proceso de cierre.
6155091	JDBC: “el comando -reset store” tarda demasiado tiempo con mensajes grandes y Oracle
6157943	El servicio de imqbrokerd no se cierra correctamente al reiniciar Windows 2000.
6165743	Adaptador de recursos de Message Queue: un uso reiterado de connection.open/close en condiciones de tensi�n puede provocar IllegalStateException.
6165984	Se omite el comando imqSSLIsHostTrusted cuando se utiliza imqAddressList para especificar que el cliente establezca una conexi�n SSL.
6170578	Adaptador de recursos de Message Queue:ManagedConnectionFactory debe heredar las propiedades establecidas en el bean de Java del adaptador de recursos.
6170831	Adaptador de recursos de Message Queue: un problema de coordinaci�n de anulaci�n de implementaci�n de MDB puede provocar una excepci�n de puntero Null (nulo) si contin�an recibi�ndose mensajes.
6174532	Los agentes JMS vuelven a enviar mensajes ya consumidos por MDB.
6178549	Al volver a cargar cls, se pierde la lista de agentes configurados cuando se utiliza -D imq.cluster.url en la l�nea de comandos.
6189214	MQ_MESSAGE_ID_HEADER_PROPERTY (C) de un mensaje recibido no coincide con JMSMessageID del mensaje enviado (Java).

La Tabla 8 describe los errores solucionados en Message Queue 3 2005Q1 (3.6 SP1):

Tabla 8  Errores solucionados en Message Queue 3 2005Q1 (3.6 SP1) 

N�mero de error	Descripci�n
6198481	Los intentos de reconexi�n de Message Queue deber�an utilizar la configuraci�n de intentos de reconexi�n/intervalo de Application Server y permitir la interrupci�n de los mismos para MDB.
6205463	RichAccess: al crear mensajes de activaci�n de errores en el destino, se produce un error de memoria insuficiente a las tres horas.
6208728	Intentos de reconexi�n de Message Queue: excepci�n de punto final no disponible en el registro de Application Server para richAccess bigApp cuando se cierra o reinicia el agente de MQ.
6221802	Actualizaci�n de NSPR/NSS a SECURITY_3_9_5_RTM.

La Tabla 9 describe los errores solucionados en Message Queue 3 2005Q4 (3.6 SP2):

Tabla 9  Errores solucionados en Message Queue 3 2005Q4 (3.6 SP2) 

N�mero de error	Descripci�n
4737166	Adici�n de procesamiento de excepci�n no detectada para TODOS los subprocesos de agente.
4959114	Cuando imqBrokerServiceName tiene un nombre de servicio incorrecto, se produce una excepci�n poco �til.
4960331	Se produce una excepci�n java.lang.NullPointerException al cargar desde una base de datos da�ada.
4961780	El comando imqcmd metrics dst puede mostrar 0 msgs/sec aunque haya tr�fico de mensajes (reducido).
5017152	Se utiliza la misma clave de recurso tanto para la etiqueta del elemento de men� como para el t�tulo del cuadro de di�logo.
5029191	Se utilizan las mismas claves de cadena en el men� y en el men� emergente.
5055667	Al cerrar un agente, en ocasiones aparece el mensaje “Unknown Destination:temporary_destination”.
6172663	Al crear una conexi�n unificada, se establece de forma incorrecta el indicador interno isTopicConnection.
6172794	Los nuevos consumidores remotos no reciben mensajes cuando se crea autom�ticamente un destino (cl�ster/infrecuente)
6173336	Puede que el control de flujo del productor se bloquee cuando se agregan constantemente productores a destinos completos.
6175764	Problema de cl�ster: al cerrar y volver a abrir r�pidamente suscriptores duraderos puede producirse un error interno.
6176411	El agente no encuentra excepciones no detectadas en los subprocesos de aceptaci�n de servicios.
6186193	En ocasiones, se env�an mensajes a System.out/System.err en el agente.
6186329	Mensajes poco claros durante la inicializaci�n de cl�ster sin -tty
6186615	En la herramienta imqadmin, algunos campos de la interfaz gr�fica de usuario (GUI) tienen un tama�o tan peque�o que resulta imposible ver el contenido.
6189645	Cuando no se puede conectar con el agente durante connection.start(), se produce un interbloqueo en la reconexi�n de tiempo de ejecuci�n de cliente.
6191835	Cliente/adaptador de recursos de Message Queue debe solucionar c�mo se especifican los subprocesos de daemon para evitar la excepci�n AccessControlException actual.
6193884	Message Queue env�a mensajes residuales al registro del sistema en configuraciones regionales que no son C.
6195048	El agente de la versi�n 3.6 muestra una excepci�n al cargar el almac�n 3.5 con una transacci�n PREPARADA.
6196233	No funciona la selecci�n de mensajes al utilizar JMSMessageID
6198465	Se produce un cambio en el comportamiento de la escucha as�ncrona de mensajes de app-client entre las versiones 8.0 y 8.1 de Application Server.
6205641	La demostraci�n jaxm incluye ubicaciones incorrectas de Application Server.
6206595	Las versiones SPARC de SUNWiqcrt y SUNWiqcdv no deber�an depender de SUNWprx y SUNWtlsx de 64 bits.
6206611	Es necesario agregar bibliotecas de 64 bits a los paquetes de Message Queue x86 para que sean compatibles con amd64.
6208740	Al restablecer el almac�n con el agente maestro se intenta destruir la cola de mensajes inactivos (Dead Message Queue, DMQ).
6213561	web.xml en imq/jaxm/README deber�a actualizarse a la �ltima versi�n.
6215079	ActivationSpec en el adaptador de recursos de Message Queue no tiene ning�n nombre de usuario ni contrase�a configurable.
6216762	Compatibilidad con Solaris amd64
6226548	Se omite el intervalo de reconexi�n al realizar iteraciones en la lista de direcciones durante una conmutaci�n por error.
6226550	Los nuevos intentos de conmutaci�n por error de Message Queue se realizan de forma ininterrumpida cuando ninguno de los host de la lista mq-address est� disponible.
6229572	Los consumidores locales o internos reenviados tras restart-local dsts del agente dejan de ser locales al reiniciar el agente.
6237112	Falta com/sun/messaging/jmq/Version.class en imq.jar.
6240237	WeakValueHashMap no libera memoria, lo que provoca una p�rdida de memoria con los receptores de cola que utilizan selectores.
6240568	Se produce una p�rdida de memoria del agente cuando se rechazan mensajes nuevos en un destino completo.
6250207	El productor y consumidor temporal generan excepciones en un cl�ster.
6252146	La solicitud de contrase�a se interrumpe en imqcmd, imqusermgr.
6252184	El productor se bloquea con un error interno imprevisto del agente en un cl�ster con agente maestro y destinos temporales.

La Tabla 10 describe los errores solucionados en Message Queue 3 2005Q4 (3.6 SP3):

Tabla 10  Errores solucionados en Message Queue 3 2005Q4 (3.6 SP3) 

N�mero de error	Descripci�n
6256771	Las secuencias de comandos imq* imprimen un error de sintaxis cuando se utilizan en una instalaci�n basada en archivos.
6257306	No se puede iniciar Application Server despu�s de una actualizaci�n de Message Queue en Linux.
6269126	No se puede iniciar imqadmin sin haber instalado antes JavaHelp.
6271773	Eliminaci�n de la instalaci�n de componentes compartidos de mqinstall/mqupgrade.
6284769	Se producen p�rdidas de memoria de QueueBrowser aunque se cree un nuevo explorador y se cierre para cada enumeraci�n.

---

Informaci�n importante

Este apartado contiene la informaci�n m�s reciente no incluida en la documentaci�n principal del producto. En este apartado se describen los temas siguientes:

Notas de la instalaci�n
Problemas de compatibilidad
Actualizaciones de la documentaci�n de Message Queue

Notas de la instalaci�n

Consulte la Message Queue Installation Guide para obtener informaci�n acerca de instrucciones previas a la instalaci�n, procedimientos de actualizaci�n y cualquier otra informaci�n relevante para instalar Message Queue, Platform Edition en plataformas Solaris, Linux y Windows.

Consulte la Gu�a de instalaci�n de Sun Java Enterprise System para obtener informaci�n acerca de instrucciones previas a la instalaci�n y cualquier otra informaci�n relevante para instalar Message Queue, Enterprise Edition en plataformas Solaris y Linux.

Consulte la Gu�a de actualizaci�n y migraci�n de Sun Java Enterprise System para obtener informaci�n acerca de instrucciones de actualizaci�n y migraci�n relevantes para actualizar a Message Queue 3 2005Q1 (3.6) en plataformas Solaris y Linux.

Instalaci�n de paquetes Solaris que faltan (Message Queue 3 2005Q1 Enterprise Edition, s�lo distribuci�n (subconjunto de distribuci�n) con programa de instalaci�n de Java Enterprise System)

La distribuci�n de Message Queue 3 2005Q1 Enterprise Edition para Solaris no incluye los paquetes SUNWtlsu (Network Security Services Utilities) y SUNWtlsux (s�lo SPARC de 64 bits para Network Security Services Utilities).

Estos paquetes s�lo son necesarios para compatibilidad con clientes C SSL. En su sistema puede estar ya instalada una versi�n anterior de estos paquetes, pero debe actualizarlos a la versi�n incluida en Java Enterprise System 2005Q1.

Soluci�n del problema
En el sitio Web de Sun Java System, puede obtener la versi�n de SUNWtlsu y SUNWtlsux que acompa�a a Java Enterprise System 2005Q1 de los paquetes de Message Queue 3 2005Q1 Platform Edition. Despu�s de descargar los archivos de Message Queue, siga las instrucciones de la secci�n “Installing Message Queue” del Cap�tulo 2, “Solaris Installation”, de la Message Queue Installation Guide. En el paso 8, responda n (no) y contin�e con el paso 9 para instalar s�lo los paquetes SUNWtlsu y SUNWtlsux en su sistema.

Problemas de compatibilidad

Esta secci�n aborda los problemas de compatibilidad de Message Queue 3 2005Q1 (3.6).

Problemas de Message Queue 3 2005Q1 (3.6)

Los apartados siguientes describen problemas que afectan a: todas las plataformas, plataformas Solaris y Linux, y s�lo plataformas Linux.

Todas las plataformas

Estabilidad de interfaz     Sun Java System Message Queue utiliza distintas interfaces que pueden ayudar a los administradores a automatizar tareas. El Ap�ndice B de la Message Queue Administration Guide clasifica las interfaces seg�n su estabilidad. Cuanto m�s estable sea una interfaz, menores ser�n los posibles cambios en versiones posteriores del producto.

Opciones de contrase�a obsoletas     Por motivos de seguridad, se han dejado de utilizar las siguientes opciones:

-p
-password
-dbpassword
-ldappassword

Cuando en un comando se especifica una contrase�a del tipo:

imqcmd query bkr -u admin -p adminpassword

un usuario puede ver la contrase�a del administrador al mostrar o consultar los procesos de un equipo (por ejemplo, mientras se utiliza ps en Solaris).

Utilice en su lugar la opci�n -passfile. La opci�n passfile se explica en el cap�tulo acerca de la seguridad de la Message Queue Administration Guide.

Plataformas Solaris y Linux

Compatibilidad con clientes JDK 1.3     Los siguientes paquetes contienen archivos jar utilizados para admitir JNDI y JSSE en tareas de desarrollo e implementaci�n de clientes en JDK 1.3. Estos paquetes se incluyen s�lo en Message Queue, Platform Edition, pero no se proporcionar�n en versiones posteriores. Estos paquetes no se instalan de forma predeterminada:

SUNWiqsup -- plataforma Solaris
sun-mq-sup -- plataforma Linux

Para obtener m�s informaci�n acerca de la instalaci�n de paquetes de forma independiente, consulte la Message Queue Installation Guide.

Plataformas Linux

Este apartado describe los cambios que afectan a los paquetes y a las ubicaciones de instalaci�n en una plataforma Linux.

Nuevas ubicaciones de instalaci�n en Linux     La ubicaci�n de los directorios de instalaci�n de Message Queue en Linux ha cambiado.

Nota	No se han realizado cambios en la ubicaci�n de los directorios de instalaci�n entre Message Queue 3 2005Q1 (3.6) y Message Queue 3 2005Q4 (3.6 SP3).

La Tabla 11 muestra los directorios de instalaci�n predeterminados de RPM de Message Queue en Linux

Tabla 11  Ubicaciones de instalaci�n predeterminadas de RPM de Message Queue 3 2005Q1

Nombre de paquete RPM	Ubicaci�n de instalaci�n predeterminada
sun-mq-config	/etc/opt/sun
sun-mq-var	/var/opt/sun
RPM restantes	/opt/sun

Para obtener m�s informaci�n, consulte el Ap�ndice A, “Operating System-Specific Locations of Message Queue Data”, en la Message Queue Administration Guide.

Nombres de paquetes RPM de Linux modificados     Los nombres de los archivos de paquetes RPM de Message Queue para Linux han cambiado.

Nota	No se han realizado cambios en los nombres de los paquetes RPM de Message Queue para Linux entre las versiones Message Queue 3 2005Q1 y Message Queue 3 2005Q4.

La Tabla 12 muestra los nuevos nombres de los paquetes RPM de Message Queue 3 2005Q1 para Linux.

Tabla 12  Paquetes RPM de sistemas Linux 

RPM	Descripci�n	Notas
sun-mq-config	Archivos /etc
sun-mq-var	Archivos /var
sun-mq	Archivos /opt	Depende de sun-javahelp, sun-mq-jmsclient, sun-mq-config y sun-mq-var.
sun-mq-ent	Archivo de licencia de Enterprise Edition.	Este RPM s�lo se incluye en Message Queue, Enterprise Edition, disponible con Java Enterprise System.
sun-mq-jaxm	JAXM (Java API for XML Messaging) de Message Queue: API	Depende de sun-saaj.
sun-mq-jmsclient	JMS: API y tiempo de ejecuci�n	Sin dependencias
sun-mq-xmlclient	Cliente XML	Depende de sun-jmsclient y sun-saaj.
sun-mq-capi	C-API	Depende de sun-nspr y sun-nss.
sun-mq-compat	Symlinks a ubicaciones 3.5.	Depende de sun-mq. Este RPM no se instala de forma predeterminada. Nota: este paquete s�lo es necesario si los clientes disponibles dependen de ubicaciones de archivo de Message Queue 3.5.
sun-mq-sup	Necesario para compatibilidad con JDK 1.3.	Depende de sun-mq. Este RPM no se instala de forma predeterminada. Nota: este paquete se incluye s�lo en Message Queue, Platform Edition.
sun-mq-[locale]	Archivos L10N
sun-javahelp1	JavaHelp: API y tiempo de ejecuci�n	Compatible con el visor de JavaHelp para la ayuda de la consola de administraci�n
sun-nss1	Bibliotecas Network Security Services (NSS).	Necesarias para compatibilidad con clientes en lenguaje C.
sun-nspr1	Bibliotecas Netscape Portable Runtime (NSPR)	Necesarias para compatibilidad con clientes C.
sun-saaj1	SAAJ (SOAP with Attachments API for Java): API y tiempo de ejecuci�n	Necesario para compatibilidad con clientes Java que utilizan API SOAP/JAXM.
sun-jaxp1	Message QueueJAXP (Java API for XML Processing): API y tiempo de ejecuci�n	Necesario para compatibilidad con clientes Java que utilizan API SOAP/JAXM.
sun-javamail1	JavaMail: API y tiempo de ejecuci�n	Necesario para compatibilidad con clientes Java que utilizan API SOAP/JAXM.
sun-jaf1	JavaBeans Activation Framework: API y tiempo de ejecuci�n	Necesario para compatibilidad con clientes Java que utilizan API SOAP/JAXM.

1Distintos productos de Sun Java System comparten este paquete RPM. Se suministra con la distribuci�n de Message Queue, Platform Edition, pero no con Message Queue, Enterprise Edition.

Paquete de symlinks para clientes 3.5     Las ubicaciones de los archivos espec�ficos que se instalan con Message Queue en Linux han cambiado. Esto puede provocar errores en el funcionamiento de aplicaciones que dependan de la ubicaci�n anterior de algunos archivos de Message Queue. Por ejemplo, si los clientes utilizan secuencias de comandos para buscar archivos jar instalados con Message Queue 3.5, ya no podr�n encontrar dichos archivos.

Para solucionar este problema, se incluye en esta versi�n el paquete de Linux sun-mq-compat. Este paquete instala symlinks de ubicaciones de archivo de Message Queue 3.5 en las ubicaciones de archivo de Message Queue 3 2005Q1 (3.6) instaladas. Puede que este paquete no se proporcione en futuras versiones. Debe corregir las secuencias de comandos que apunten a ubicaciones de archivo anteriores de Message Queue.

El paquete sun-mq-compat se encuentra en las siguientes ubicaciones.

Distribuci�n de Message Queue, Platform Edition:
al descomprimir la distribuci�n, se crea un directorio rpms.
Message Queue, Enterprise Edition (incluido en la distribuci�n de Java Enterprise System):
Linux_x86/Product/message_queue/Packages

  Para instalar el paquete sun-mq-compat

Convi�rtase en superusuario.
En el directorio de paquetes rpm, utilice el siguiente comando:

rpm -ivh --nodeps sun-mq-compat-3.6-<ReleaseNo>.i386.rpm

Problemas relacionados con la siguiente versi�n principal de Message Queue

La siguiente versi�n principal de Message Queue puede incluir cambios que impidan la compatibilidad con sus clientes actuales. Esta informaci�n se proporciona ahora para permitirle anticipar dichos cambios.

�sta es la �ltima versi�n de Sun Java System Message Queue que ser� compatible con versiones anteriores de Sun One Message Queue 3.0.1. En concreto, las futuras versiones de Sun Java System Message Queue no admitir�n:
Conexi�n de clientes 3.0.1 a agentes de la versi�n m�s reciente
Actualizaci�n de un almac�n persistente 3.0.1 a la versi�n m�s reciente
Agrupaci�n en cl�steres de agentes de 3.0.1 con agentes de la versi�n m�s reciente
Uso de archivos de propiedades, almacenes de usuarios, listas de control de acceso, etc. de 3.0.1 con agentes de la versi�n m�s reciente
�sta es la �ltima versi�n de Sun Java System Message Queue que admitir� la integraci�n como “System JMS Messaging Provider” para Sun Java System Application Server 7.X. Las futuras versiones de Sun Java System Message Queue s�lo ser�n compatibles con Sun Java System Application Server 8.0 y superior.
�sta es la �ltima versi�n de Sun Java System Message Queue que incluir� el tiempo de ejecuci�n SOAP y ser� compatible con objetos administrados SOAP de Message Queue.
Las futuras versiones s�lo admitir�n SOAP junto a una versi�n de Java 2 Standard Edition Platform compatible con SOAP.
Sun Java System Dejar� de ofrecerse compatibilidad con clientes de Message Queue para todas las versiones de Java 2 Standard Edition 1.3. Java 2 Standard Edition 1.4 continuar� siendo compatible.
Podr�an cambiar las ubicaciones de archivos espec�ficos instalados con Sun Java System Message Queue. Esto puede provocar que no funcionen aplicaciones existentes que dependan de la ubicaci�n actual de algunos archivos de Message Queue.
Sun Java System Los clientes de Message Queue que utilicen una versi�n de Message Queue anterior a la siguiente versi�n principal puede que no tengan acceso a las nuevas funciones incluidas en dicha versi�n del producto.

Actualizaciones de la documentaci�n de Message Queue

Las siguientes secciones describen las actualizaciones de la documentaci�n de Message Queue 3 2005Q1 (3.6) y Message Queue 3 2005Q4 (3.6 SP3).

Actualizaciones de la documentaci�n de Message Queue 3 2005Q1 (3.6)
Actualizaciones de la documentaci�n de Message Queue 3 2005Q4 (3.6 SP3)

Actualizaciones de la documentaci�n de Message Queue 3 2005Q1 (3.6)

Se han actualizado los siguientes documentos de Message Queue de la versi�n 3.5 del producto:

Gu�a de instalaci�n

La Message Queue Installation Guide se ha actualizado para que incluya los cambios en la denominaci�n de productos e informaci�n espec�fica de las plataformas. Ahora, este documento contiene informaci�n de instalaci�n relevante para Message Queue, Platform Edition.

La informaci�n de instalaci�n de Message Queue Enterprise Edition ha pasado a la Gu�a de instalaci�n de Sun Java System.

Para obtener informaci�n acerca de la actualizaci�n y migraci�n a Message Queue 3 2005Q1 (3.6), Enterprise Edition, consulte la Gu�a de actualizaci�n y migraci�n de Sun Java System.

Visi�n general t�cnica

La Message Queue Technical Overview es un documento nuevo que se incluy� por primera vez en la versi�n Message Queue 3 2005Q1 (3.6) y se ha vuelto a redactar para la versi�n Message Queue 3 2005Q4 (3.6 SP3). Describe las funciones, arquitectura, tecnolog�a y terminolog�a del producto Message Queue. Este nuevo manual contiene informaci�n general incluida previamente en otros documentos y destinada a los usuarios de Message Queue, tanto a administradores como a desarrolladores, adem�s de a posibles usuarios.

Gu�a de administraci�n

La Message Queue Administration Guide se ha actualizado para que incluya los cambios en la denominaci�n de productos y las nuevas funciones. Tambi�n se ha reorganizado este documento para facilitar su uso a los administradores de Message Queue. La informaci�n general contenida anteriormente en este documento ha pasado a la Message Queue Technical Overview.

Message Queue Developer’s Guide for Java Clients

La Gu�a del desarrollador para clientes Java se ha actualizado para que incluya los cambios en la denominaci�n de productos y las nuevas funciones. Tambi�n se ha cambiado el nombre del documento por Message Queue Developer’s Guide for Java Clients.

Se ha reorganizado la Message Queue Developer’s Guide for Java Clients para facilitar su uso por parte de desarrolladores de clientes Java de Message Queue. La informaci�n general contenida anteriormente en este documento ha pasado a la Message Queue Technical Overview.

Gu�a del desarrollador para clientes C

La Gu�a del desarrollador para clientes C se ha actualizado para que incluya los cambios en la denominaci�n de productos y las nuevas funciones. Tambi�n se ha cambiado el nombre del documento por Message Queue Developer’s Guide for C Clients.

Se ha reorganizado la Message Queue Developer’s Guide for C Clients para facilitar su uso por parte de desarrolladores de clientes C de Message Queue. La informaci�n general contenida anteriormente en este documento ha pasado a la Message Queue Technical Overview.

Actualizaciones de la documentaci�n de Message Queue 3 2005Q4 (3.6 SP3)

Se han actualizado los siguientes documentos de Message Queue de la versi�n 3 2005Q1 (3.6) del producto:

Gu�a de instalaci�n

Se ha actualizado la Message Queue Installation Guide para que incluya los cambios realizados en la instalaci�n del producto desde la versi�n Message Queue 3 2005Q1 (3.6).

Visi�n general t�cnica

La Message Queue Technical Overview es un documento nuevo que se incluy� por primera vez en la versi�n Message Queue 3 2005Q1 (3.6) y se ha vuelto a redactar para la versi�n Message Queue 3 2005Q4 (3.6 SP3). Describe las funciones, arquitectura, tecnolog�a y terminolog�a del producto Message Queue. Este nuevo manual contiene informaci�n general incluida previamente en otros documentos y destinada a los usuarios de Message Queue, tanto a administradores como a desarrolladores, adem�s de a posibles usuarios.

Gu�a de administraci�n

Se ha reorganizado la Message Queue Administration Guide para facilitar su uso por parte de los administradores de Message Queue. La informaci�n general contenida anteriormente en este documento ha pasado a la Message Queue Technical Overview.

Message Queue Developer’s Guide for Java Clients

La Message Queue Developer’s Guide for Java Clients incluye un cap�tulo nuevo, “Using the Java API”.

---

Limitaciones y problemas conocidos

Esta secci�n contiene una lista de los problemas conocidos de Message Queue 3 2005Q1 (3.6). Se describen las siguientes �reas:

Problemas generales
Problemas de administraci�n y configuraci�n
Problemas de agentes

Para obtener una lista de los errores actuales, su estado y las soluciones, los miembros de Java Developer Connection™ deben consultar la p�gina “Bug Parade” en el sitio Web de Java Developer Connection. Compruebe la p�gina antes de informar de un nuevo error. No encontrar� aqu� todos los errores de Message Queue, se trata simplemente de un buen punto de partida para saber si se ha notificado un error.

La p�gina en cuesti�n es:

http://developer.java.sun.com/developer/bugParade

Nota	Aunque la suscripci�n a Java Developer Connection es gratuita, es necesario registrarse. Puede encontrar informaci�n detallada sobre c�mo hacerse miembro de Java Developer Connection en la p�gina Web “For Developers” de Sun.

Para informar de un nuevo error o enviar una solicitud de funci�n, env�e un mensaje de correo electr�nico a imq-feedback@sun.com.

Problemas generales

Esta secci�n aborda problemas generales de Message Queue 3 2005Q1 (3.6). Algunos ya se trataron en versiones anteriores de Message Queue. En este apartado se agrupan los problemas seg�n hagan referencia a Enterprise Edition y a Platform Edition de Message Queue o s�lo a Enterprise Edition.

En Enterprise Edition y Platform Edition

En Message Queue 3 2005Q1, el ejemplo de configuraci�n de agente para utilizar un servidor ldap como repositorio de usuarios se incluye en el �rea de delimitadores del archivo config.properties y el ejemplo de repositorio de usuarios ldap del archivo default.properties se ha marcado mediante un delimitador.

Si anteriormente utilizaba alg�n valor de propiedad del ejemplo de configuraci�n de propiedades de repositorio de usuarios ldap del archivo default.properties, el cliente de aplicaciones JMS recibir� una excepci�n de seguridad al intentar crear una conexi�n JMS. Esto se producir� despu�s de actualizar a Message Queue 3 2005Q1.

Cuando el cliente JMS intenta establecer conexi�n con el agente de Message Queue 3 2005Q1, se obtendr� un error en el registro del agente y el cliente JMS recibir� la siguiente excepci�n:

SecurityException.

20/Aug/2004:11:16:41 PDT] ERROR [B4064]: Ldap repository ldap property .uidattr not defined for authentication type basic:com.sun.messaging.jmq.auth.LoginException: [B4064]: Ldap repository ldap property .uidattr not defined for authentication type basic

Soluci�n del problema
Establezca la propiedad de agente imq.user_repository.ldap.uidattr seg�n las instrucciones de la Message Queue Administration Guide.

Un error de RedHat Linux 2.1 (Error de NSS n�mero 5078380) puede provocar el bloqueo de los m�todos C-API de Message Queue MQCreateConnection (biblioteca C-API de Message Queue 3 2005Q1) o MQInitializeSSL (biblioteca C-API de Message Queue 3 2005Q1 o 3.5) si se crea un subproceso en la aplicaci�n C-API de Message Queue antes de que se realice una llamada a estos dos m�todos.

Soluci�n del problema
Al utilizar la biblioteca C-API de Message Queue 3 2005Q1, existen cuatro opciones para evitar este problema:

Actualizar a RedHat Linux 3.0.
Establecer la variable de entorno MQ_NSS_5078380_WORKAROUND antes de ejecutar la aplicaci�n del cliente C de Message Queue y establecer la propiedad de agente de Message Queue en imq.authentication.type=basic.
Llamar a MQInistializeSSL(<cert-db-path>) antes de iniciar cualquier subproceso en la aplicaci�n de cliente C de Message Queue. Puede recurrir a la utilidad certutil para crear los archivos de base de datos de certificados.

Crear una conexi�n con el agente de Message Queue llamando a MQCreateConnection antes de iniciar cualquier subproceso. No puede editar un archivo de configuraci�n de la instancia del agente sin haber iniciado la instancia del agente al menos una vez. Esto se debe a que el archivo config.properties no existe hasta que se inicia por primera vez la instancia del agente. Si desea configurar un agente para que utilice la persistencia de conexi�n o para definir otras propiedades de configuraci�n, inicie el agente una vez (con el nombre de instancia que se debe utilizar para crear el agente) para crear el archivo config.properties:

Plataforma	Ubicaci�n
Solaris	/var/imq/instances/instanceName/props/config.properties
Linux	/var/opt/sun/mq/instances/instanceName/props/config.properties
Windows	IMQ_VARHOME\instances\instanceName\props\config.properties

Una vez creado el archivo config.properties, ed�telo para a�adir todos los valores de propiedad de configuraci�n y, a continuaci�n, reinicie el agente.

S�lo en Enterprise Edition

S�lo se admiten en esta versi�n los cl�steres de agentes totalmente conectados. Esto significa que todos los agentes de un cl�ster deben establecer comunicaci�n directamente con todos los dem�s agentes del cl�ster. Si conecta agentes mediante el argumento de l�nea de comandos imqbrokerd -cluster, aseg�rese de incluir todos los agentes del cl�ster.
Actualmente, un cliente conectado a un agente que forma parte de un cl�ster no puede utilizar QueueBrowser para examinar colas ubicadas en agentes remotos de dicho cl�ster. El cliente s�lo puede examinar el contenido de las colas que se encuentran en el agente al que est� directamente conectado. El cliente puede continuar enviando mensajes a cualquier cola o consumiendo mensajes desde una cola de cualquier agente del cl�ster; esta limitaci�n s�lo afecta a las funciones de exploraci�n.
Si no se utiliza un agente maestro en un cl�ster, la informaci�n persistente almacenada por un agente que se ha a�adido al cl�ster no se distribuir� a los dem�s agentes del cl�ster.
El servicio de conexi�n mediante SSL s�lo admite actualmente certificados de servidor firmados autom�ticamente, es decir, en el modo de host de confianza.
Cuando un cliente JMS con transporte HTTP finaliza repentinamente (por ejemplo, mediante Ctrl-C), el agente espera aproximadamente un minuto antes de liberar la conexi�n de cliente y todos los recursos asociados.

Si se inicia otra instancia de cliente durante ese per�odo de un minuto y si �sta intenta utilizar el mismo ClientID, la misma suscripci�n duradera o la misma cola, recibir� una excepci�n “ID de cliente ya en uso”. No se trata de un problema real, es simplemente un efecto secundario del proceso de finalizaci�n descrito anteriormente. Si el cliente se inicia despu�s de un retraso de aproximadamente un minuto, todo deber�a funcionar correctamente.

Problemas de administraci�n y configuraci�n

Las utilidades imqadmin e imqobjmgr muestran un error cuando la ruta de clase (CLASSPATH) contiene comillas dobles en equipos Windows (ID de error 5060769).

Soluci�n del problema
Puede hacer caso omiso de este mensaje de error; el agente responde correctamente e informa a los consumidores de cualquier error. Este error no afecta a la fiabilidad del sistema.

La opci�n -javahome de todas las secuencias de comandos de Solaris/Win no funciona si el valor incluye un espacio en blanco (ID de error 4683029).

Los comandos y utilidades de Message Queue utilizan la opci�n -javahome para especificar un tiempo de ejecuci�n alternativo, compatible con Java 2. Sin embargo, la ruta al tiempo de ejecuci�n Java alternativo no debe contener espacios en blanco.

�stos son ejemplos de rutas que contienen espacios:

     Windows:
     C:\jdk 1.4

     Solaris:
     /work/java 1.4

Soluci�n del problema
Instale el tiempo de ejecuci�n Java en una ubicaci�n o ruta que no contenga espacios en blanco.

Message Queue env�a mensajes residuales al registro del sistema en configuraciones regionales que no son C (ID de error 6193884).

Message Queue enviar� datos residuales al registro del sistema cuando el agente se ejecuta en una configuraci�n regional distinta a C.

Soluci�n del problema
Ejecute el agente en un una configuraci�n regional C.

Problemas de agentes

En un cl�ster de agentes, el agente env�a los mensajes a la cola de una conexi�n remota que no puede iniciarse (ID de error 4951010).

Soluci�n del problema
El consumidor recibir� los mensajes cuando se inicie la conexi�n. Los mensajes se reenviar�n a otro consumidor si la conexi�n del consumidor est� cerrada.

El comando HTTPS createQueueConnection muestra ocasionalmente una excepci�n en Windows 2000 (ID de error 4953348).

Soluci�n del problema
Vuelva a establecer la conexi�n.

Al utilizar Ctrl-C para cerrar el agente, puede que se limpien las transacciones una vez cerrado el almac�n (ID de error 4934446).

Puede que el agente muestre errores con el siguiente motivo “Acceso al m�todo de almac�n cuando el almac�n est� cerrado.” (“Store method accessed after the store is closed.”) si el agente se cierra mientras se procesan mensajes o transacciones.

Soluci�n del problema
Puede hacer caso omiso de este mensaje de error; el agente responde correctamente e informa a los consumidores de cualquier error. Este error no afecta a la fiabilidad del sistema.

No se puede tener acceso al agente cuando un almac�n persistente abre demasiados destinos (ID de error 4953354).

Soluci�n del problema
Esta situaci�n se produce cuando el agente alcanza el l�mite de descriptor de archivos abiertos del sistema. En Solaris y Linux, utilice el comando ulimit para aumentar el l�mite de descriptor de archivos.

Cuando se destruye un destino, los consumidores se quedan sin referencia (ID de error 5060787).

Los consumidores activos se quedan sin referencia cuando se destruye un destino. En ese caso, dejan de recibir mensajes (aunque se vuelva a crear el destino).

Soluci�n del problema
No hay soluci�n para este problema.

No funciona la selecci�n de mensajes al utilizar JMSMessageID (ID de error 6196233).

No funciona la selecci�n de mensajes al utilizar el selector “JMSMessageID = '<message_id>'”.

Env�e un mensaje a una cola.
Lea el c�digo JMSMessageID del mensaje enviado: <message_id>.
Cree un consumidor en la cola utilizando el selector con la configuraci�n "JMSMessageID = '<message_id>'".

No se recibir� el mensaje.

Soluci�n del problema
Cambie el selector:

JMSMessageID = "ID:message-id-string"

por:

JMSMessageID IN ('ID:message-id-string', 'message-id-string')

Message Queue QueueBrowser muestra tambi�n mensajes sin confirmar (ID de error 6264003).

Al explorar el contenido de una cola, los mensajes producidos en una transacci�n pero que todav�a no est�n confirmados pueden aparecer en la enumeraci�n de QueueBrowser.

Soluci�n del problema
No hay soluci�n para este problema.

---

Archivos que se pueden distribuir

Sun Java System Message Queue 3 2005Q1 (3.6) contiene el siguiente conjunto de archivos que puede utilizar y distribuir libremente en formato binario:

jms.jar
imq.jar
imqxm.jar
fscontext.jar
providerutil.jar
jndi.jar
ldap.jar
ldapbpjar
jaas.jar
jsse.jar
jnet.jar
jcert.jar
Asimismo, puede tambi�n redistribuir los archivos LICENSE y COPYRIGHT.

---

Funciones de accesibilidad para usuarios con discapacidad

Si desea disfrutar de las funciones de accesibilidad que se han comercializado tras la publicaci�n de este soporte, consulte las valoraciones de productos de la Secci�n 508, que se pueden obtener de Sun previa solicitud, para determinar las versiones m�s adecuadas para implementar soluciones accesibles. Puede encontrar versiones actualizadas de las aplicaciones en: http://sun.com/software/javaenterprisesystem/get.html.

Para obtener informaci�n sobre el compromiso de Sun con respecto a la accesibilidad, visite http://sun.com/access.

---

Informaci�n sobre problemas y respuestas de los clientes

Si experimenta problemas con Sun Java System Message Queue, p�ngase en contacto con el servicio de asistencia t�cnica de Sun usando uno de estos procedimientos:

Servicios de asistencia t�cnica en l�nea para el software de Sun en:
http://www.sun.com/service/sunone/software

Este sitio dispone de v�nculos a la base de datos de soluciones, al centro de asistencia t�cnica en l�nea y al rastreador de productos, as� como a programas de mantenimiento y n�meros de contacto de asistencia.

El n�mero de tel�fono del distribuidor asociado al contrato de mantenimiento.

Para que podamos ayudarle de forma �ptima en la resoluci�n de problemas, tenga a mano la siguiente informaci�n cuando se ponga en contacto con el servicio de asistencia t�cnica:

Descripci�n del problema, incluida la situaci�n en la que �ste se produce y la forma en que afecta al funcionamiento
Tipo de equipo, versi�n del sistema operativo y versi�n del producto, incluida cualquier revisi�n del producto y otro software que pudiera influir en el problema
Pasos detallados de los m�todos que haya usado para reproducir el problema
Cualquier registro de errores o volcados del n�cleo

Foro de software de Sun Java System

Puede encontrar un foro de Sun Java System Message Queue en la siguiente direcci�n:

http://swforum.sun.com/jive/forum.jspa?forumID=24

Apreciamos su participaci�n.

Foro de tecnolog�a de Java

Existe un foro de JMS en los foros de tecnolog�a de Java que puede interesarle.

http://forum.java.sun.com

---

Sun valora sus comentarios

Sun tiene inter�s en mejorar su documentaci�n y valora sus comentarios y sugerencias.

Para publicar sus comentarios, acceda a http://docs.sun.com y haga clic en “Send Comments” (Enviar comentarios). Se mostrar� un formulario en l�nea en el que deber� indicar el t�tulo del documento y el n�mero de referencia. El n�mero de referencia consta de siete o de nueve d�gitos y se encuentra en la p�gina que contiene el t�tulo de la gu�a o al principio del documento. Por ejemplo, el t�tulo de este libro es Sun Java System Message Queue 3 2005Q4 Notas de la versi�n y el n�mero de referencia, 819-3559.

---

Recursos adicionales de Sun

Puede encontrar informaci�n �til de Sun Java System en las siguientes direcciones de Internet:

Documentaci�n para Message Queue
http://docs.sun.com/coll/1307.1
Documentaci�n de Sun Java System
http://docs.sun.com/prod/java.sys
Servicios profesionales de Sun Java System
http://www.sun.com/service/sunps/sunone
Servicio y productos de software de Sun Java System
http://www.sun.com/software
Servicios de asistencia al cliente de software de Sun Java System
http://www.sun.com/service/sunone/software
Base de datos de soluciones y asistencia al cliente de Sun Java System
http://www.sun.com/service/support/software
Servicios de formaci�n y asistencia al cliente de Sun
http://training.sun.com
Servicios profesionales y de consultor�a de Sun Java System
http://www.sun.com/service/sunps/sunone
Informaci�n de desarrolladores de Sun Java System
http://developers.sun.com
Servicios de asistencia para programadores de Sun
http://www.sun.com/developers/support
Formaci�n sobre el software de Sun Java System
http://www.sun.com/software/training
Hojas de datos de software de Sun
http://wwws.sun.com/software

---

Copyright � 2005 Sun Microsystems, Inc. Reservados todos los derechos.

Sun Microsystems, Inc. tiene derechos de propiedad intelectual relacionados con la tecnolog�a del producto que se describe en este documento. Especialmente, aunque sin limitarse a ello, estos derechos de propiedad intelectual pueden incluir una o varias patentes en Estados Unidos, las cuales figuran en http://www.sun.com/patents, as� como una o varias patentes adicionales (o patentes pendientes de adjudicaci�n) en Estados Unidos y en otros pa�ses.

PROPIEDAD/CONFIDENCIAL DE SUN

Derechos del gobierno de Estados Unidos: Software comercial. Los usuarios gubernamentales est�n sujetos al acuerdo de licencia est�ndar de Sun Microsystems, Inc. y a las disposiciones aplicables de la regulaci�n FAR y sus suplementos.

El uso est� sujeto a las condiciones de la licencia.

Esta distribuci�n puede incluir materiales desarrollados por terceras partes.

Sun, Sun Microsystems, el logotipo de Sun, Java, Solaris y Sun™ ONE son marcas comerciales o marcas comerciales registradas de Sun Microsystems, Inc. en Estados Unidos y otros pa�ses.

Todas las marcas comerciales de SPARC se utilizan bajo licencia y son marcas comerciales o marcas registradas de SPARC International, Inc. en EE.UU. y en otros pa�ses.

UNIX es una marca comercial registrada en EE.UU. y en otros pa�ses, cuya licencia se otorga exclusivamente a trav�s de X/Open Company, Ltd.