Notas del release para WebSphere Business Integration Adapters Versión 2.3.1, para Solaris

Estas notas del release tratan de la información del release para WebSphere Business Integration Adapters, versión 2.3.1, para Solaris. Éstas contienen las secciones siguientes:
Novedades de este release API de WebSphere Business Integration Adapters
Historial de arreglos del producto Problemas conocidos y soluciones temporales
Requisitos de hardware y software Actualizaciones de la documentación
Información de instalación, migración, actualización y configuración

Nota: Es posible que información importante sobre este producto esté disponible en las Últimas noticias de soporte técnico (Technical Support Flashes) emitidas después de la publicación de estas notas del release. Éstas se pueden encontrar en el sitio Web de soporte de WebSphere Business Integration, http://www.ibm.com/websphere/integration/wbiserver/support. Seleccione el área del componente de su interés y realice búsquedas en la sección de últimas noticias (flashes).

Novedades de este release

Esta sección lista las nuevas características y mejoras realizadas en este release.

WebSphere Business Integration Adapters Framework

API de WebSphere Business Integration Adapters

Para ver detalles, consulte el manual Connector Development Guide for Java.

Historial de arreglos del producto

En este release se han arreglado las CR siguientes, basadas en casos de los que han informado los clientes.

API de WebSphere Business Integration Adapters

Número
de CR
Descripción
12271 Soporte para un manejador de objetos comerciales personalizados. Se ha añadido una nueva interfaz, CWCustomBOHandlerInterface, que tiene un método doVerbForCustom. Los adaptadores que utilizan manejadores de objetos comerciales personalizados deben implementar esta interfaz. Además, la información específica de la aplicación del verbo de objeto comercial debe cambiar de forma que CBOH=nombre_clase_manejador_OC_personalizados (asegúrese de utilizar el nombre completo de la vía de acceso, es decir, de empezar la vía de acceso con "com.").
17975 Cuando se produce una excepción, los métodos de la API de WebSphere Business Integration Adapters registran el mensaje de excepción e imprimen el rastreo de pila.
19664

Se ha añadido una nueva propiedad, EventStoreFactory. Si está establecida en la instancia de fábrica del almacén de sucesos del conector, es decir, com.crossworlds.connectors.JDBC.JDBCEventStoreFactoryInstance, se utiliza para obtener el almacén de sucesos; si no está establecida en esa instancia, la API intenta crear el nombre de clase de la instancia de fábrica del almacén de sucesos en base a la información del paquete. Además, TRUESTRING y FALSESTRING se han añadido a CWConnectorAttrType, y las cadenas codificadas "true" se han sustituido con esto.

19665 Si se especifica otro dato distinto de un entero para pollQuantity, pollForEvents devuelve un resultado no satisfactorio (FAIL).
19673 Se ha añadido un nuevo método, getAppText, que toma un delimitador y un nombre de propiedad, a CWConnectorBusObj. Basado en el nombre de propiedad y el delimitador, se devuelve el valor de la propiedad en la información específica de la aplicación.
22702 Se ha añadido un nuevo método, setDEEId, en la clase CWConnectorBusObj. Establece el atributo ObjectEventId en el ID de suceso:

public void setDEEId(String eventid)

devuelve AttributeNotFoundException, AttributeValueException.

22877 Se ha añadido un nuevo método, getEventStore, a la clase CWConnectorAgent. Este método obtiene el almacén de sucesos del conector y devuelve un objeto CWConnectorEventStore:

public CWConnectorEventStore getEventStore()

El método pollForEvents por omisión se ha cambiado para realizar una llamada a este método. Además, existe una implementación por omisión para este método. Primero comprueba la propiedad EventStoreFactory. La propiedad EventStoreFactory se debe establecer en la implementación de la interfaz CWConnectorEventStoreFactory. Si lo está, se crea la instancia de esta clase y obtiene el almacén de sucesos del conector. Si no está establecida la propiedad, el método intenta crear el nombre de implementación del paquete del conector.

El conector tiene la opción de alterar temporalmente este método y proporcionar su propio método. Esto es útil si el conector desea utilizar constructores distintos del constructor por omisión.

23369 APPRESPONSETIMEOUT de la llamada del método doVerbFor no termina anormalmente el conector cuando doVerbFor es llamado desde dentro de pollForEvents. Para habilitar esto, el estado se debe propagar hacia arriba a pollforEvents y pollForEvents debe devolver APPRESPONSETIMEOUT.
23406 Las constantes de verbo EXISTS y RETRIEVEBYCONTENT se han añadido a la clase CWConnectorConstants.
23612 Para ver información específica de la aplicación a nivel de atributo u objeto comercial, los identificadores que no tienen valores como por ejemplo nombre_archivo_ior=;nombre_poa=server daban un resultado no satisfactorio con el mensaje "No such element found Exception". Esto se ha arreglado.
23620 El establecimiento del metaobjeto de configuración y la creación del manejador de datos no se realiza en un paso atómico (o sincronizado). Esto estaba causando problemas con la clase de base de manejador de datos cuando múltiples pasos de proceso entraban en la API de WebSphere Business Integration Adapters. Ahora el código para llamar a setConfigMO se ha sincronizado. Además, el método se llama sólo una vez, y las llamadas subsiguientes continúan creando el manejador de datos.

Instalador de WebSphere Business Integration Adapters

Número
de CR
Problema
11983, 12221,
13382, 17788,
20169
Se han arreglado múltiples problemas en la versión 4.2.1.0 del panel Selección de componentes. Éstos incluyen:
  • El panel renueva cada selección
  • Texto no legible en el panel al contraer componentes
  • La selección de componentes padre no selecciona todos los subcomponentes
  • La selección de un subcomponente seleccionaba todos los subcomponentes
21679 Si había instalado un adaptador utilizando la herramienta de instalación silenciosa, el adaptador no se iniciaba correctamente.

Requisitos de hardware y software

Los requisitos de hardware y software se incluyen en la documentación del producto. Consulte Información de instalación, migración, actualización y configuración para ver enlaces a estas guías.

Información de instalación, migración, actualización y configuración

Si está instalando el software desde el CD o descargándolo de Passport Advantage e instalándolo desde un directorio local, consulte la guía adecuada:

Estas guías también incluyen información de migración, actualización y configuración.

API de WebSphere Business Integration Adapters

Asegúrese de ejecutar los adaptadores con la API de WebSphere Business Integration Adapters (WBIA) versión 1.5.0 o posterior.

Verificación de la versión de la API de WBIA

Para comprobar la versión de la API de WBIA, localice el archivo de manifiesto (DirProducto/lib/WBIA.jar) y ábralo en un editor Java JAR adecuado. Busque las líneas siguientes:

Implementation-Title: "CWConnectorAPI"
Implementation-Version: 1.5.0
Implementation version (Versión de implementación) indica la versión actual de la API de WBIA.

Si la versión no es 1.5.0 o posterior, debe descargar la API de WBIA más reciente.

Descarga de la API de WBIA

Para descargar la versión más reciente de la API de WBIA:

  1. Vaya a http://www.ibm.com.
  2. Pulse la pestaña Support and downloads (Soporte y descargas).
  3. Bajo la cabecera Downloads (Descargas), pulse All downloads & drivers (Todas las descargas y controladores).
  4. En el campo Enter search terms (Entrar términos de búsqueda), escriba "wbia api" y pulse Submit (Someter).

Después de descargar e instalar la API, debe ver los archivos siguientes:

lib/WBIA.jar
lib/WBIA/3.0.0/WBIA.jar
lib/WBIA/4.0.0/WBIA.jar
lib/WBIA/4.1.1/WBIA.jar
bin/CWConnEnv.sh
bin/CWODAEnv.sh
connectors/messages/CwConnectorAgentMessages.txt

Habilitación de los adaptadores para versiones anteriores de Adapter Development Kit e InterChange Server

Para habilitar que un adaptador funcione con varias versiones de ADK o InterChange Server, siga el procedimiento adecuado de más abajo:

InterChange Server versiones 4.0.1, 4.1.0, ADK versión 2.0.x

En CWConnEnv.sh, establezca la variable CWVERSION en 4.X.

set CWVERSION="4.X"
InterChange Server versiones 4.1.x (excepto 4.1.0), ADK versión 2.1.x

En CWConnEnv.sh, establezca la variable CWVERSION en 4.1.X.

set CWVERSION="4.1.X"
Ejecución de un Object Discovery Agent (ODA) contra InterChange Server versiones 4.0.1 y 4.1.x, ADK versiones 2.0.x y  2.1.x

En bin/CWODAEnv.sh, establezca la variable CWVERSION en 4.1.X.

set CWVERSION="4.1.X"

Problemas conocidos y soluciones temporales

Versión en tiempo de ejecución de WebSphere Business Integration Adapters

Número
de CR
Problema
23373

La ejecución de los conectores creados con la versión 2.1 de Connector Development Kit (CDK) con el build de 2.3.1 CDK devuelve errores en tiempo de ejecución.

Solución temporal: la solución es recompilar conectores con el parche de 2.1 CDK.

23374

La ejecución de los componentes creados con la versión 2.0 de Connector Development Kit (CDK) con el build de 2.3.1 CDK devuelve errores de tiempo de ejecución.

Solución temporal: La solución es recompilar los conectores con el parche de 2.0 CDK.

23482

Los adaptadores no pueden grabar texto de mensaje XML de más de 100 MB en la cola MQ para procesar debido a la limitación MQ. Este problema se produce cuando JMS es el transporte y el intermediario es WMQI o WAS. La versión en tiempo de ejecución del adaptador convierte el Objeto Comercial a mensaje XML que se hace enorme en el tamaño del mensaje para el intermediario WMOI y WAS.

Solución temporal: Evite crear más de 25000 objetos hijos por Objeto Comercial o intente reducir el tamaño de mensaje XML escrito en la cola MQ.

24108 La ejecución de los conectores incorporados creados con la versión 2.2 de Connector Development Kit (CDK) con el build de 2.3.1 CDK devuelve errores en tiempo de ejecución. Solución temporal: La solución es recompilar los conectores con el parche de 2.2 CDK.

Instalador de WebSphere Business Integration Adapters

Número
de CR
Problema
20679 Si InterChange Server es el intermediario de integración, asegúrese de instalar los adaptadores desde WebSphere Business Integration Adapters, versión 2.3.1, en el directorio donde ICS está instalado.
24023 Después de la instalación o desinstalación, es posible que vea el aviso siguiente en la consola:
Warning:
Name: scrollbar
Class: XmScrollbar
The scrollbar page increment is less than one

Este aviso no tiene ningún efecto en el resultado satisfactorio de la instalación o desinstalación.

24067 En el panel Selección de idioma, la lista desplegable de idiomas está sólo traducida parcialmente para portugués de Brasil. Esto se debe a la versión de Java Virtual Machine (JVM) que utiliza el Instalador. 

Solución temporal: Aunque IBM no recomienda esta solución temporal, se puede forzar al Instalador a utilizar el JRE que está instalado en la máquina ejecutando el mandato siguiente:

java -cp setup.jar run -swing

24147

Se produce corrupción de texto en todos los idiomas de doble byte no soportados:  japonés, coreano, chino simplificado y chino tradicional.  

Solución temporal: Ejecute el Instalador en modalidad de balanceo ejecutando el mandato siguiente:

./setupsolarisSparc.bin -swing

Instalador de terceros

Número
de CR
Problema
16868 Cuando utiliza el mandato de Java ./setupsolarisSparc.bin -Dtemp.dir=/home/user1/tmp para ejecutar el Instalador, el directorio tmp no se limpia. Esto aumenta el tamaño de la carpeta tmp.

Solución temporal: Suprima manualmente los archivos que no desee desde el directorio tmp.

23778 Es posible que el texto del título en el panel Selección de idiomas esté truncado según el entorno local de idioma que seleccione. No se puede cambiar el tamaño del diálogo Selección de idioma.

Actualizaciones de la documentación

La documentación del producto no se incluye como parte del paquete del producto, en soporte de CD ni mediante distribución electrónica del producto. La documentación de este producto se puede encontrar en los Centros de información siguientes:

Para obtener la documentación del producto, visite el sitio Web y descargue el conjunto de documentación actual para el release que esté utilizando. Siga las instrucciones proporcionadas en la página del Centro de información para completar la instalación.

Copyright IBM Corp. 1997, 2003