Notes d'édition pour WebSphere Business Integration Adapter Framework, Version 2.6.0, pour HP-UX

Ces notes d'édition concernent IBM WebSphere Business Integration Adapters, version 2.6.0, pour HP-UX. Elles sont composées des sections ci-dessous :
Nouveautés de cette édition Informations relatives à l'installation et à la configuration
Historique du correctif du produit Limitations
Compatibilité amont Problèmes recensés et solutions
Compatibilité du produit Mises à jour de la documentation
Exigences matérielles et logicielles

Remarque : Des informations importantes relatives à ce produit sont disponibles dans les Technical Support Flashes émis après la publication de ces notes sur l'édition. Elles se trouvent sur le site Web de WebSphere Business Integration http://www.ibm.com/websphere/integration/wbiserver/support. Sélectionnez la zone d'intérêt du composant et recherchez la section consacrée aux flashes.

Nouveautés de cette édition

Cette section répertorie les nouvelles fonctions et améliorations apportées à cette édition.

Historique du correctif du produit

Entre les éditions 2.4.0 et 2.6.0, les incidents suivants ont été corrigés en fonction des situations rapportées par les utilisateurs.

API de WebSphere Business Integration Adapters

Numéro de
suivi
Description
35632 DisableNumberFormatGrouping va être utilisé pour déterminer s'il faut utiliser le groupage lors de l'appel de CWConnectorBusObj.setintValue(..)/setfloatValue()/setdoubleValue(). Si aucune valeur n'est attribuée, la valeur par défaut est 'false'. Sans le groupage 1,234,567 est rendu 1234567. Une nouvelle propriété appelée DisableLocaleFormating va être utilisée pour déterminer s'il faut réaliser un formatage des numéros. La valeur par défaut de cette propriété est false.
33705 Deux nouvelles propriétés ont été ajoutées, MaxDoublePrecision et MaxFloatPrecision, pour définir les précisions en double ou flottantes indépendantes de l'environnement. Les méthodes setdoubleValue et setfloatValue utilisent désormais ces nouvelles valeurs si elles sont définies, à la place de la précision d'environnement local par défaut. Corrigé dans le Patch 1.6.1.
30617 Une nouvelle propriété (RetrieveVerb) a été introduite. Pour la compatibilité amont, la valeur RetrieveByContent va être attribuée par défaut au verbe. L'adaptateur peut remplacer cette valeur par défaut par RetrieveVerb. Si une valeur a été attribuée à la propriété, elle est utilisée en tant que verbe d'extraction dans getBO.
33784 Une nouvelle signature de méthode a été ajoutée pour fetchEvents.
La signature de méthode est : public Vector fetchEvents(int pollQuantity) throws ConnectionFailureException, FetchEventsFailedException.
Cette méthode détient également une implémentation par défaut pour la compatibilité amont composée d'un appel de la méthode originale et renvoie eventsToProcess Vector dans CWConnectorEventStore. StatusChangeFailedException est appelée et transformée en ConnectionFailureException.
Dans pollForEvents, la nouvelle méthode est appelée. APPRESPONSETIMEOUT est renvoyé s'il existe un ConnectionFailureException. Pour FetchEventsFailedException, un état FAIL est renvoyé de pollForEvents.

Phase d'exécution de WebSphere Business Integration Adapters

Numéro de
suivi
Description
46029 Une aide RAS a été ajoutée pour toujours analyser la version de l'adaptateur utilisé.
46185 La méthode CxListBuffer's endsWith() ne renvoie pas correctement une valeur 'false' lorsqu'elle n'est pas en mesure de trouver la valeur de recherche spécifiée. IndexOutOfBoundsException de CxListBuffer a été corrigé.
30977 Les adaptateurs ne se comportent pas correctement lorsqu'une erreur 2019 est générée par MQSeries.
29963 Plusieurs adaptateurs portant le même nom ont été lancés. Une vérification a été ajoutée pour s'assurer qu'un adaptateur ne peut pas être démarré plusieurs fois sur la même plate-forme. Un message s'affiche si un autre adaptateur portant le même nom a été détecté.
33337, 33338, 33339 Un support d'objet LOB doit être ajouté.
32412 L'adaptateur C++ ne peut pas être démarré car le fichier CWConnector.dll est absent du module.
34350 En utilisant JDBCConnector, le verbe RetrieveByContent n'extrait pas l'objet métier si la requête de sélection rencontre plusieurs enregistrements.
46118 Le traitement du verbe RetrieveByContent n'a pas abouti dans l'adaptateur JDBC.
34472 L'adaptateur MQ renvoie une erreur OutOfMemory lors du traitement d'un événement volumineux. Un code a été ajouté pour vérifier une exception OutOfMemory dans l'unité d'exécution de l'interrogation. Si elle est trouvée, un message est consigné et l'adaptateur se ferme.
34726 Des messages invalides sont perdus lorsqu'ils sont reçus par l'adaptateur s'exécutant avec WebSphere Business Integration Message Broker. Des messages de ce type ne sont pas acheminés vers la file d'attente par défaut.
36131 Adapter Framework répond par une erreur ClassCastException lorsque des messages JMS d'un type imprévu sont reçus. La fonction de trace a été ajoutée pour indiquer l'erreur qui s'est produite.
36763, 58347 Les adaptateurs ne peuvent pas se connecter à InterChange Server après le redémarrage de Persistent Name Server.
36147 Les mises à jour dynamiques du niveau de trace de l'agent ne fonctionnent pas.
32199 Adapter Framework ajoute toujours en suffixe un nom de connecteur à ObjectEventId. Une nouvelle propriété de connecteur a été ajoutée pour les courtiers d'InterChange Server, EnableOidForFlowMonitoring. Cette propriété est une valeur booléenne avec la valeur par défaut 'false'. Si la valeur 'true' lui est attribuée, l'application developer's kit marque l'ObjectEventId entrant comme une clé externe pour le contrôle des flux.
29420, 30721 Une modification du script de l'adaptateur peut améliorer les performances d'un adaptateur. Les arguments JVM contiennent une option -mx (Taille de segment max). Vous pouvez améliorer les performances en ajoutant l'option -ms (Taille de segment min) et en lui attribuant une valeur égale à la moitié de la taille de segment maximale. Editez le fichier start_adapter.bat situé dans le répertoire \bin. Recherchez la ligne contenant "set JVMArgs" et ajoutez l'option -ms. Par exemple : set JVMArgs="-mx128m -ms64m %JVMArgs%"
29249 Les attributs d'objet métier auxquels ont été attribuée la valeur zéro peut engendrer une erreur d'interpréteur : org.xml.sax.SAXParseException: An invalid XML character (Unicode: 0x0) was found in the element.

Compatibilité amont

Il n'est pas conseillé d'utiliser WebSphere Business Integration Adapters version 2.6.0 lorsque des versions antérieures sont installées sur la même machine physique. Si différentes versions de WebSphere Business Integration Adapters version 2.6.0 sont requises, il est recommandé d'utiliser des machines distinctes.

Compatibilité du produit

Les versions prises en charge d'InterChange Server incluent les versions 4.2.2 à 4.3.
Les adaptateurs pris en charge comprennent toutes les éditions avec WebSphere Business Integration Adapters versions 2.3.1 à 2.6.0.

Exigences matérielles et logicielles

Les exigences matérielles et logicielles sont inclues dans la documentation du produit. Voir Informations d'installation, de migration, de mise à niveau et de configuration pour connaître les liens vers ces manuels.

Informations relatives à l'installation et à la configuration

Si vous installez le logiciel à partir d'un CD-ROM ou que vous le téléchargez depuis Passport Advantage et l'installez à partir d'un répertoire local, consultez le manuel Installing WebSphere Business Integration Adapters, V.2.6.

Note relative à la migration

Pour permettre à un adaptateur provenant d'une édition précédente d'Adapter Framework de fonctionner correctement avec cette édition, vous devez modifier les scripts de démarrage pour le connecteur et l'ODA. Veuillez consulter le manuel Adapter Migration Guide pour connaître les modifications particulières requises.

Note relative à l'installation de l'adaptateur pour CORBA

Si vous installez l'adaptateur pour CORBA, lisez attentivement les notes sur l'édition de l'adaptateur pour obtenir des informations supplémentaires relatives au logiciel prérequis.

Limitations

Cette édition comprend les limitations suivantes :

Problèmes recensés et solutions

Les incidents ci-dessous ont été constatés dans la présente édition :

Phase d'exécution de WebSphere Business Integration Adapters

Numéro de
suivi
Incident
23482

En raison d'une limitation liée à WebSphere MQ, les adaptateurs ne peuvent pas écrire plus de 100 Mo de texte de message XML dans une file d'attente MQ pour traitement. Cet incident se produit lorsque JMS est le transfert et que WebSphere MQ Integrator ou WebSphere Application Server est le courtier d'intégration. L'exécution de l'adaptateur convertit les objets métier en messages XML, qui peuvent devenir très volumineux.

Pour trouver une solution palliative, évitez de créer plus de 25000 objets enfants par objet métier.

Non disponible Les adaptateurs qui trient des métadonnées ou des données de configuration dans des méta objets métier (comme partie intégrante des valeurs par défaut) ou des objets métier classiques (comme partie intégrante du contenu des instances d'exécution) risquent de ne pas totalement prendre en charge le traitement des données bidirectionnelles de la droite vers la gauche. Ce traitement incorrect risque de se produire uniquement si les métadonnées ou les données de configuration guident le connecteur dans le traitement des informations spécifiques à l'application et incluent des spécifications relatives aux chemins d'accès aux classes du gestionnaire de données, à l'encodage des données, aux noms de file d'attente et ainsi de suite. La solution palliative consiste à placer une définition spécifique pour chacun des méta objets métier. De manière plus spécifique, vous devez ajouter la spécification BIDI.METABUSINESSOBJECT=YES au niveau d'objet métier ASI de chaque méta objet métier.

WebSphere Business Integration Adapters Installer

Numéro de
suivi
Description
44407 Lorsque IBM 32-bit SDK à utiliser avec IBM WebSphere Business Integration Adapter Framework Installer fonctionne dans les environnement locaux chinois traditionnel, chinois simplifié et coréen, le texte de l'écran d'accueil du programme d'installation donne l'impression qu'il s'agit de la version ,2.6.0 de Software Development Kit (SDK). La version 2.6.0 se rapporte à IBM WebSphere Business Integration Adapter Framework et non à IBM SDK. Cet incident n'apparaît pas lorsque le programme d'installation fonctionne dans d'autres environnements locaux.
29755

L'installation échoue si vous sélectionnez un emplacement d'installation dont le nom de répertoire contient des caractères en chinois simplifié, en chinois traditionnel, en Coréen ou en japonais.

La solution palliative consiste à procéder à l'installation dans un chemin d'accès ne contenant pas ces caractères.

Outils de WebSphere Business Integration Adapters

Numéro de
suivi
Description
Non disponible Si une disposition de clavier non bidirectionnelle (en anglais, par exemple) est sélectionnée lorsque vous copiez des caractères bidirectionnels à partir d'un emplacement externe (Notepad, par exemple) et que vous les collez dans WebSphere Business Integration Tools with GUI basé sur C++, les caractères bidirectionnels s'affichent sous la forme de points d'interrogation. Pour éviter cet incident, il est recommandé d'utiliser le clavier bidirectionnel lors de la procédure de copie à partir de sources externes vers un composant WebSphere Business Integration Tools GUI basé sur C++.

Mises à jour de la documentation

La documentation du produit ne fait pas partie du module du produit, soit par CD ou par distribution électronique du produit. La documentation relative à ce produit est disponible dans les InfoCenters suivants :

Pour obtenir la documentation relative au produit, visitez le site Web et téléchargez la documentation en cours établie pour la version que vous utilisez. Suivez les instructions fournies sur la page de l'InfoCenter pour terminer l'installation.

Copyright IBM Corp. 1997, 2004