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

Estas notas del release tratan de la información del release para WebSphere Business Integration Adapters, versión 2.3.1, para AIX. É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 Actualización 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 técnico de WebSphere Business Integration, http://www.ibm.com/websphere/integration/wbiserver/support. Seleccione el área del componente de su interés y realice la búsqueda 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

Las CR siguientes, basadas en casos de los que ha informado el cliente, se han arreglado en este release.

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 instancia, CWCustomBOHandlerInterface, que tiene el método doVerbForCustom. Los adaptadores que utilizan los 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 de vía de acceso completa, es decir, empiece el nombre con "com.").
17975 Al producirse una excepción, los métodos de la API de WebSphere Business Integration Adapters ahora 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 esta instancia, la API intenta crear el nombre de clase de instancia de fábrica de almacén de sucesos basándose en la información del paquete. Además, se ha añadido TRUESTRING y FALSESTRING a CWConnectorAttrType, y las cadenas codificadas "true" han sido sustituidas por esto.

19665 Si se especifica un dato que no sea un entero para pollQuantity, pollForEvents devuelve un resultado no satisfactorio (FAIL).
19673 Un nuevo método, getAppText, que toma un delimitador y un nombre de propiedad, se ha añadido a CWConnectorBusObj. Basado en el nombre de propiedad y el delimitador, se devuelve el valor para 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 que realice una llamada a este método. Además, existe una implementación por omisión para este método. En primer lugar, comprueba la propiedad EventStoreFactory. La propiedad EventStoreFactory debe estar establecida 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 la propiedad no está establecida, el método intenta crear el nombre de implementación a partir 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 quiere utilizar constructores distintos del constructor por omisión.

23369 APPRESPONSETIMEOUT de la llamada de método doVerbFor no termina anormalmente el conector cuando se llama a doVerbFor desde dentro de pollForEvents. Para permitir esto, el estado se debe propagar hacia arriba a pollforEvents y pollForEvents debe devolver APPRESPONSETIMEOUT.
23406 Se han añadido las constantes de verbo EXISTS y RETRIEVEBYCONTENT a la clase CWConnectorConstants.
23612 Para información específica de la aplicación en el nivel de atributo o de objeto comercial, los identificadores que no tienen valores como por ejemplo nombre_archivo_ior=;nombre_poa=server han fallado con "No such element found Exception" (No se ha encontrado dicho elemento en la excepción). Esto se ha arreglado.
23620 El establecimiento del metaobjeto de configuración y la creación del manejador de datos no se realiza en el paso atómico (o sincronizado). Esto causaba problemas con la clase base del manejador de datos cuando múltiples pasos de proceso entraban en la API de WebSphere Business Integration Adapters. Ahora se ha sincronizado el código para llamar a setConfigMO. 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. Estos incluyen:
  • El panel se renueva después de cada selección
  • Texto no legible en el panel al contraer los componentes
  • La selección de los componentes padre no selecciona todos los subcomponentes
  • La selección de un subcomponente seleccionada todos los subcomponentes
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 está instalado ICS.

Requisitos de hardware y software

Los requisitos de hardware y software se incluyen con 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 versión 1.5.0 o posterior.

Verificación de la versión de la API

Para comprobar la versión de la API, 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

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

  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 and  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 2.3.1 de CDK devuelve errores de tiempo de ejecución.

Solución temporal: Vuelva a compilar los conectores con el parche de 2.1 CDK.

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

Solución temporal: Vuelva a compilar los conectores con el parche 2.0 de CDK.

23482

Debido a una limitación de WebSphere MQ, los adaptadores no pueden grabar más de 100 MB de mensaje XML en una cola MQ para su proceso. Este problema se produce cuando JMS es el transporte y WMQI o WAS es el intermediario de integración. El tiempo de ejecución del adaptador convierte los objetos comerciales en mensajes XML, que pueden hacerse muy grandes.

Solución temporal: Evite la creación de más de 25000 objetos hijo por objeto comercial.

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

Solución temporal: Vuelva a compilar los conectores con el parche 2.2 de CDK.

23699

En un entorno de plataforma AIX 5.3 con mucha carga de trabajo (que ejecuta adaptadores con transporte = JMS; intermediario = WMQI o WAS; un gran número de objetos comerciales hijo; tamaños de objeto comercial mayores de 1 MB; y sesiones de consumo concurrentes mayores que 1, es posible que note un error de OutOfMemory (Sin memoria) después de la ejecución continuada del agente de conector durante un periodo de 10 a 12 horas.

Solución temporal: mantenga las sesiones concurrentes en 1 sesión

Instalador de WebSphere Business Integration Adapters

Número
de CR
Problema
11600 El arranque inicial del Instalador puede ser lento durante la inicialización de una Java Virtual Machine (JVM). 

Solución temporal: Inicie el Instalador sólo una vez; no intente iniciarlo varias veces.

17529,
21358,
21858,
21901
Si actualiza desde un release anterior de WebSphere Business Integration Adapters a WebSphere Business Integration Adapters 2.3.1, al desinstalar WebSphere Business Integration Adapters 2.3.1 algunas carpetas y archivos no se eliminarán.

Solución temporal: Elimine manualmente los archivos o directorios que no desee después de que la desinstalación se haya completado.

24023 Después de la instalación o desinstalación, es posible que vea el siguiente aviso en la consola:
Aviso:
Nombre: barra de desplazamiento
Clase: XmScrollbar
El incremento de la página de la barra de desplazamiento es inferior a uno

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

Instalador de terceros

Número de
CR
Problema
15011, 17268 El producto de instalación de terceros no detiene la instalación cuando no hay suficiente espacio disponible.

Solución temporal: Asegúrese de tener suficiente espacio de disco en el directorio de instalación antes de iniciar la instalación.

23778 El texto del título en el panel Selección de componentes puede estar truncado en función del entorno local de idioma que seleccione. No se puede modificar el tamaño del diálogo Selección de idioma.

Actualización 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 para 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