Note d'édition pour la version 2.7.0 d'IBM WebSphere Business Integration Adapter pour WebSphere MQ

Ces notes d'édition concernent la version 2.7.0 d'IBM WebSphere Business Integration Adapter pour WebSphere MQ. Ces notes sur l'édition sont composées des sections ci-dessous :
Nouveautés de cette édition API et phase d'exécution de WebSphere Business Integration Adapters
Historique du correctif du produit Problèmes recensés et solutions
Exigences matérielles et logicielles Mises à jour de la documentation
Installation, migration, mise à niveau, configuration

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. Cliquez sur le produit qui vous intéresse. Si des flashes sont disponibles, ils se trouvent dans Self help > Solve a problem > Flashes (Alerts).

Nouveautés de cette édition

Cette édition comprend un support bidirectionnel (bi-di) pour les différents attributs de métadonnées.

Consultez le manuel Adapter for WebSphere MQ User Guide pour obtenir des informations détaillées relatives à l'adaptateur et aux nouvelles fonctions.

Historique du correctif du produit

Entre les éditions 2.6.0 et 2.7.0, les incidents suivants ont été corrigés en fonction des situations rapportées par les utilisateurs.
Numéro de
suivi
Description
36128 L'adaptateur ne s'initialise pas lorsque la propriété de connecteur InputQueue n'est pas configurée. Cela a été corrigé dans le Fix Pack 2.5.2.
36438 En commençant par la version 2.5.x de l'adaptateur, les noms de propriété de conversion des métaobjets statiques et dynamiques sont dépendants des majuscules et des minuscules.
33728  Si les propriétés de conversion uniques ne sont pas configurées dans le métaobjet de configuration, l'adaptateur ne mappe pas correctement les événements et les objets métier.
37094 Si plusieurs files d'attente en entrée sont configurées pour l'adaptateur, le mécanisme d'extraction de propriété de conversion n'aboutit pas lors du traitement des indicateurs de déroulement.
34969 Lors du traitement des événements synchrones, l'adaptateur n'envoie pas les erreurs de gestionnaire de données au message de rapport.

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.

Installation, migration, mise à niveau et 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 approprié en fonction de votre courtier d'intégration :

Ces manuels contiennent également des informations générales relatives à la migration, la mise à niveau et la configuration.

Pour obtenir des informations relatives aux exigences matérielles et logicielles et à la configuration spécifiques à cet adaptateur, consultez le manuel Adapter for WebSphere MQ User Guide.

Notes de mise à niveau

API et phase d'exécution de WebSphere Business Integration Adapters

Vérifiez que vous exécutez cette version de l'adaptateur avec la version d'exécution WebSphere Business Integration Adapters 1.8.0 ou ultérieure.

Les fichiers .jar de l'API de WebSphere Business Integration Adapters et les scripts associés (CWConnEnv.bat et CWODAEnv.bat pour Windows(R); CWConnEnv.sh et CWODAEnv.sh pour les plate-formes UNIX) sont installés par l'API de WebSphere Business Integration Adapters. Avant d'installer l'adaptateur, vérifiez que la phase d'exécution WebSphere Business Integration Adapters est installée. S'il ne s'agit pas de la version 1.8.0 ou ultérieure, vous devez télécharger la dernière API. La présente section fournit des instructions permettant de vérifier la version de l'API, de télécharger la dernière version et d'activer l'adaptateur de sorte qu'il s'exécute sur différentes versions d'InterChange Server et Adapter Development Kit (ADK).

Vérification de la version d'exécution

Pour vérifier la version de l'exécution, recherchez le fichier de description (ProductDir\lib\WBIA.jar) et ouvrez-le dans un éditeur Java JAR adapté. Recherchez les lignes suivantes :

Implementation-Title: "CWConnectorAPI"
Implementation-Version: 1.8.0

La ligne Implementation-version indique la version installée de l'API. S'il ne s'agit pas de la version 1.8.0 ou ultérieure, vous devez télécharger la dernière version d'exécution.

Téléchargement de l'exécution

Pour télécharger la dernière version de l'exécution :

  1. Accédez au site Web http://www.ibm.com.
  2. Cliquez sur l'onglet Support & downloads.
  3. Sous l'en-tête Downloads, cliquez sur Downloads & drivers.
  4. Dans la zone Enter search terms, tapez "wbia api" puis cliquez sur Submit.

Après avoir téléchargé et installé l'exécution, les fichiers suivants doivent apparaître :

lib\WBIA.jar
bin\CWConnEnv.bat (Windows)
bin/CWConnEnv.sh (UNIX)
bin\CWODAEnv.bat (Windows)
bin/CWODAEnv.sh (UNIX)
connectors\messages\CwConnectorAgentMessages.txt

Activation des adaptateurs pour les versions précédentes d'Adapter Development Kit et d'InterChange Server

Cet adaptateur fonctionne uniquement sur la version 2.6.0 d'Adapter Framework en cours.

Problèmes recensés et solutions

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

Numéro de
suivi
Description
58988 L'adaptateur est suspendu lorsqu'il est déployé sur un système multiprocesseur Linux(TM). Cet incident est dû à un problème connu lié à Linux JDK 1.4.2 qui provoque la suspension lors d'un récupération de place (le numéro de PMR ouvert correspondant à ce problème JDK est 27182.001.866.)

La solution palliative consiste à modifier le script de démarrage de l'adaptateur pour attribuer l'option "-Xgcthreads1" à la variable JVMArgs, comme l'illustre l'exemple ci-dessous :
JVMArgs="-Xgcthreads1 %JVMArgs%"
34668 WebSphere MQ version ,5.3 en CSD06 ou inférieur ne prend pas en charge les données bidirectionnelles dans la zone JMSCorrelationID. Par conséquent, pour utiliser intégralement les possibilités bidirectionnelles de l'adaptateur, vous avez besoin de WebSphere MQ version 5.3 en CSD07.

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 Centres d'aide et d'information 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 du Centre d'aide et d'information pour terminer l'installation.

Copyright IBM Corp. 1997, 2004