Outils IBM J2EE Connector Version 6.0.1 - Notes sur l'édition

Pour IBM Rational Application Developer version 6.0.0.1 ou 6.0.1

Pour afficher la dernière version de ce fichier, consultez les notes sur l'édition à l'adresse www3.software.ibm.com/ibmdl/pub/software/rationalsdp/rad/601/J2C/html/nl/readme_fr_FR_601.html

Table des matières

1.0 A propos de cette édition
   1.1 Nouveautés de cette édition
   1.2 Historique des correctifs de produit
2.0 Informations relatives à l'installation
   2.1 Configuration matérielle requise
   2.2 Configuration logicielle requise
   2.2.1 WebSphere Application Server
   2.2.2 Adaptateurs de ressources
3.0 Limitations et incidents recensés et leurs solutions
   3.1 Limitations
   3.1.1 Exception lors du déploiement
   3.1.2 Plusieurs adaptateurs de ressources installés sur le même serveur d'exécution
   3.2 Incidents et solutions
   3.2.1 Impossible de modifier les spécifications de connexion (ConnectionSpec) par le biais des assistants J2C
   3.2.2 Impossible d'importer le fichier COBOL contenant des caractères DBCS
   3.2.3 Difficultés rencontrées lors de la saisie des valeurs de certaines propriétés IMSInteractionSpec dans l'assistant Nouveau bean Java J2C
4.0 Support client
5.0 Remarques et marques

1.0 A propos de cette édition

Les outils J2EE Connector (J2C) Architecture permettent de créer des applications J2EE qui intègrent et étendent les opérations et les données aux systèmes EIS (Enterprise Information System) existants.

Les outils J2C sont constitués des composants principaux suivants :

1.1 Nouveautés de cette édition

Cette édition inclut les mises à jour et fonctionnalités suivantes :

• L'assistant de création d'un bean de commande permet d'encapsuler l'exécution d'une opération spécifique dans l'EIS.
• L'assistant de migration J2C permet de migrer les fichiers WSDL créés à partir de WebSphere Application Developer Integration Edition dans un projet Rational Application Developer en cours.
• L'outil de migration de ligne de commande J2C permet de migrer les fichiers WSDL créés à partir de WebSphere Application Developer Integration Edition dans Rational Application Developer en utilisant la ligne de commande.
• IMS Connector for Java version 9.1.0.2 est mis à niveau vers la version 9.1.0.2.1
• IMS Connector for Java version 9.1.0.1.1 est mis à niveau vers la version 9.1.0.1.2
• CICS ECI version 6.0.0 est mis à niveau vers la version 6.0.1
• Les exemples suivants ont été mis à jour à l'aide du nouveau fichier RAR d'IMS version 9.1.0.1.2 :
  • IMS PhoneBook
  • Sortie multisegment
  • Tableaux d'entrée et de sortie
• Le même exemple d'entrée et de sortie a été mis à jour à l'aide du nouveau fichier RAR de CICSECI 6.0.1.
• Un nouvel exemple appelé Bean de commande J2C a été ajouté dans la Galerie d'exemples.

1.2 Historique des correctifs de produit

Les correctifs suivants sont inclus dans la présente édition des outils J2EE Connector de Rational Application Developer :

• (PK05710) Le bean Java J2C généré ne gère pas correctement l'exception.
• (PK05919) Impossible d'utiliser le caractère "/" dans les noms de référence de ressource.
• (PK04996) Exception de pointeur NULL lors de la sélection de la génération du code de style "Raccourcir les noms".
• (PK07730) Lors de l'exécution, IMSRequestType a la valeur zéro et non pas 1 qui est la valeur par défaut. Dans le code généré, cet élément a maintenant la valeur par défaut 1.
• Fournit la prise en charge de la méthode d'exécution par le biais de trois paramètres (IMSInteractionSpec, Input Record, Output Record) pour les interactions SYNC_SEND.
• Génère une exception contenant le message ICO0007E lorsque la propriété reRoute  est définie à la valeur TRUE sur une connexion de socket persistante dédiée.
• Vérifie qu'IMS Connector for Java a accusé réception en interne d'un message "DFS" émis par IMS afin qu'une exception java.lang.IllegalArgumentException contenant le message ICO0026E ne soit pas générée pour les interactions ultérieures suivant le message "DFS" . 
• Redéfinit la valeur du clientID interne utilisé par IMS Connector for Java à la suite de l'exception contenant le message ICO0085E.  Cette dernière est générée lorsqu'une application fournit un clientID spécifié par l'utilisateur pour une interaction sur une connexion de socket persistante partageable.  Avant cette mise à jour, la valeur de clientID persistait tant que l'application n'avait pas été redémarrée.  
• Vérifie que la connexion de socket reste ouverte une fois qu'une valeur non valide a été détectée pour la zone LL du message d'entrée.
• Corrige une exception de type pointeur Null lors du traçage.
• Génère une exception contenant le message ICO0056E lorsqu'une valeur est indiquée pour la propriété IMSConnectName mais qu'IMS Connector for Java ne s'exécute pas sur la plateforme 390. Si une valeur est indiquée pour la propriété IMSConnectName et qu'IMS Connector for Java s'exécute dans un environnement OS/390 ou z/OS, IMS Connector for Java tente de créer une connexion Local Option. Si IMS Connector for Java ne s'exécute pas dans un environnement OS/390 ou z/OS, l'exception ICO0056E n'est plus consignée par le serveur d'applications mais l'interaction continue et IMS Connector for Java tente de créer une connexion TCP/IP en utilisant les valeurs de nom d'hôte et de port par défaut.
• Génère une exception à la suite d'une tentative d'enregistrement d'une connexion non éligible dans la transaction en cours.
• Met à jour l'exception contenant le message ICO0078E avec des informations plus précises.
• La propriété reRoute d'IMS Connector for Java n'est plus ignorée pour les interactions sur des connexions de socket persistantes dédiées.  Avec la présente mise à jour, un message d'exception est émis.
• (PK05920) L'option Configuration du déploiement de l'adaptateur de ressources n'existe pas dans la page d'informations relatives au déploiement de l'assistant Page Web, service Web ou EJB issu d'un bean Java J2C.

2.0 Informations relatives à l'installation

Pour obtenir des informations sur l'installation de la fonction Rational Application Developer J2C, consultez le site www3.software.ibm.com/ibmdl/pub/software/rationalsdp/rad/601/install_instruction/ifeature_j2c/nl/install_fr_FR_601.html

2.1 Configuration matérielle requise

Pour connaître la configuration matérielle requise pour l'installation de la fonction Rational Application Developer J2C, voir les instructions d'installation.

2.2 Configuration logicielle

Si vous développez une application à l'aide des outils J2C dans Rational Application Developer et que vous l'exécutez dans WebSphere Application Server version 5, veillez à appliquer la maintenance requise à WebSphere Application Server version 5. Pour plus de détails, voir Section 2.2.1 WebSphere Application Server.

Pour plus de détails sur les logiciels et les spécifications pris en charge par la fonction Rational Application Developer J2C, voir les instructions d'installation.

Pour plus de détails sur les logiciels et les spécifications pris en charge par un outil spécifique dans Rational Application Developer, consultez l'aide en ligne.

Vous devez avoir installé IBM Rational Application Developer version 6.0.0.1 avant d'installer cette fonction.

2.2.1 WebSphere Application Server

WebSphere version 5.0 et WebSphere version 5.1 prennent en charge J2C 1.0. Les niveaux de service de WebSphere Application Server requis pour les outils J2EE Connector sont répertoriés dans le tableau ci-dessous. Les environnements de test correspondant à un niveau de version antérieur disponibles avec Rational Application Developer version 6.0 requièrent le niveau de service répertorié dans la colonne Niveau de service requis pour WAS Distributed du tableau. Les correctifs cumulatifs de WebSphere Application Server, WAS 5.0.2.8 par exemple, sont disponibles à partir du site de support de WebSphere Application Server (www.ibm.com/software/webservers/appserv/was/support). Les correctifs de l'environnement d'exécution d'Integration Edition pour 5.0 et 5.1 sont disponibles à partir du site www.ibm.com/support/docview.wss?rs=180&context=SSEQTP&dc=D410&dc=D420&uid=swg24004796&loc=en_US&cs=utf-8&lang=en. Les PTF de WebSphere Application Server pour z/OS sont disponibles à partir du site de support de WebSphere Application Server pour z/OS www.ibm.com/software/webservers/appserv/zos_os390/support/

WebSphere version 6 prend en charge les applications J2C 1.5.

2.2.2 Adaptateurs de ressources

Les adaptateurs de ressources suivants sont pris en charge dans les outils J2C :

• CICS ECI 5.1 (J2C 1.0)
• CICS ECI 6.0.0, 6.0.1 (J2C 1.5) - Communications sortantes uniquement
• IMS 9.1.0.1.1, 9.1.0.1.2 (J2C 1.0)
• IMS 9.1.0.2, 9.1.0.2.1 (J2C 1.5) - Communications sortantes uniquement

3.0 Limitations et incidents recensés et leurs solutions

Ces notes sur l'édition contiennent des informations, telles que les incidents et les restrictions, qui n'ont été disponibles qu'après la finalisation de la documentation du produit.

3.1 Limitations

3.1.1 Exception lors du déploiement

Au cours de la création des pages Web, des EJB ou des services Web, une exception peut être émise dans la console du serveur WebSphere Application Server version 6. Ceci n'a aucune incidence sur le fonctionnement normal du serveur ou du bean J2C. Cette erreur a été corrigée dans WebSphere Application Server version 6.0.1, disponible sur le site www.ibm.com/software/webservers/appserv/was/support/

[2/21/05 18:55:49:781 EST] 00000017 SystemErr R java.lang.reflect.InvocationTargetException at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method) at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:85) at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:58) at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java(Compiled Code)) at java.lang.reflect.Method.invoke(Method.java(Compiled Code)) at com.ibm.ws.ffdc.DiagnosticModule.getDataForDirective(DiagnosticModule.java:316) at com.ibm.ws.ffdc.DiagnosticModule.getDataForDirectives(DiagnosticModule.java:287) at com.ibm.ws.ffdc.DiagnosticModule.dumpComponentData(DiagnosticModule.java:143) at com.ibm.ws.ffdc.DiagnosticEngine.processIncident(DiagnosticEngine.java:159) at com.ibm.ws.ffdc.FFDCFilter.filterEngine(FFDCFilter.java:434) at com.ibm.ws.ffdc.FFDCFilter.processException(FFDCFilter.java:195) at com.ibm.ws.management.AdminServiceImpl.outputWarningAndFFDC(AdminServiceImpl.java:1660) at com.ibm.ws.management.AdminServiceImpl.checkForOpDeprecation(AdminServiceImpl.java:1737) at com.ibm.ws.management.AdminServiceImpl.preInvoke(AdminServiceImpl.java:1670) at com.ibm.ws.management.AdminServiceImpl.access$400(AdminServiceImpl.java:100) at com.ibm.ws.management.AdminServiceImpl$1.run(AdminServiceImpl.java:899) at com.ibm.ws.security.util.AccessController.doPrivileged(AccessController.java(Compiled Code)) at com.ibm.ws.management.AdminServiceImpl.invoke(AdminServiceImpl.java:817) at com.ibm.ws.management.connector.AdminServiceDelegator.invoke(AdminServiceDelegator.java:139) at sun.reflect.GeneratedMethodAccessor23.invoke(Unknown Source) at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java(Compiled Code)) at java.lang.reflect.Method.invoke(Method.java(Compiled Code)) at com.ibm.ws.management.connector.soap.SOAPConnector.invoke(SOAPConnector.java:325) at com.ibm.ws.management.connector.soap.SOAPConnector.service(SOAPConnector.java:193) at com.ibm.ws.management.connector.soap.SOAPConnection.handleRequest(SOAPConnection.java:55) at com.ibm.ws.http.HttpConnection.readAndHandleRequest(HttpConnection.java:641) at com.ibm.ws.http.HttpConnection.run(HttpConnection.java:469) at com.ibm.ws.util.ThreadPool$Worker.run(ThreadPool.java(Compiled Code)) Caused by: java.lang.NullPointerException at com.ibm.ws.management.dm.JmxDM.processAdminService(JmxDM.java:50) at com.ibm.ws.management.dm.JmxDM.ffdcDumpDefaultJmx(JmxDM.java:34) ... 28 autres

3.1.2 Plusieurs adaptateurs de ressources installés sur le même serveur d'exécution

Plusieurs versions autonomes du même adaptateur de ressources EIS ne peuvent pas être installées dans WebSphere Application Server, en particulier si elles sont destinées au même type de système EIS. Par exemple, si vous installez à la fois CICS ECI 5.1 et CICS ECI 6.0, des conflits risquent de se produire. Cela est dû au fait que tous les adaptateurs de ressources autonomes partagent le même chargeur de classes.

3.2 Incidents et solutions

3.2.1 Impossible de modifier les spécifications de connexion (ConnectionSpec) par le biais des assistants J2C

L'assistant J2C ne fournit pas d'interface utilisateur permettant de modifier les spécifications de connexion (ConnectionSpec). Vous devez modifier celles-ci directement dans le code Java d'implémentation généré. Ouvrez le fichier d'implémentation Java généré dans un éditeur, recherchez la méthode à modifier et modifiez, ajoutez ou supprimez ensuite les doclets de cette dernière.

3.2.2 Impossible d'importer le fichier COBOL contenant des caractères DBCS

Si vous importez un fichier COBOL qui inclut des caractères NL, vous devez modifier l'option Nom de l'environnement local de l'heure de compilation dans Fenêtre > Préférences > Outil d'importation > COBOL > Autres options COBOL. Vous obtenez une erreur pour le format par défaut en_US.

3.2.3 Difficultés rencontrées lors de la saisie des valeurs de certaines propriétés IMSInteractionSpec dans l'assistant Nouveau bean Java J2C

Dans l'assistant Nouveau bean Java J2C, si vous sélectionnez com.ibm.connector2.ims.ico.IMSInteractionSpec, des erreurs peuvent survenir lors de la saisie de valeurs dans les zones d'entrée avancées Nom de la redirection, Nom LTERM et Nom Map. Ces zones contenant des valeurs vides, effacez les espaces qu'elles contiennent avant de saisir des valeurs dans celles-ci. Sinon, vous recevrez un message d'erreur et vous ne pourrez plus continuer.

4.0 Support client

La page d'accueil du produit Rational Application Developer est www.ibm.com/software/awdtools/developer/application/. Pour consulter les questions les plus fréquentes, la liste des incidents recensés et des correctifs et toute autre information de support, voir la page www.ibm.com/software/awdtools/developer/application/support/

5.0 Remarques et marques

©Copyright IBM Corporation 2000, 2005. All Rights Reserved.

La documentation XDoclet incluse dans ce produit IBM est soumise à des droits d'utilisation et protégée par la mention de propriété intellectuelle suivante : Copyright (c) 2000-2005, XDoclet Team. All rights reserved.

Extraits de Design Patterns: Elements of Reusable Object-Oriented Software, d'Erich Gamma, Richard Helm, Ralph Johnson et John Vlissides, Copyright (c) 1995 by Addison-Wesley Publishing Company, Inc. All rights reserved.

Le présent document peut contenir des informations ou des références concernant certains produits, logiciels ou services IBM non annoncés dans ce pays. Pour plus de détails, référez-vous aux documents d'annonce disponibles dans votre pays, ou adressez-vous à votre partenaire commercial IBM. Toute référence à un produit, logiciel ou service IBM n'implique pas que seul ce produit, logiciel ou service puisse être utilisé. Tout autre élément fonctionnellement équivalent peut être utilisé, s'il n'enfreint aucun droit d'IBM. Il est de la responsabilité de l'utilisateur d'évaluer et de vérifier lui-même les installations et applications réalisées avec des produits, logiciels ou services non expressément référencés par IBM.

IBM peut détenir des brevets ou des demandes de brevet couvrant les produits décrits dans le présent document. La remise de cette documentation ne vous donne aucun droit de licence sur ces brevets ou demandes de brevet. Si vous désirez recevoir des informations concernant l'acquisition de licences, veuillez en faire la demande par écrit à l'adresse suivante :

IBM Director of Licensing
IBM Corporation
Tour Descartes La Défense 5 2,
avenue Gambetta 92066 -
Paris-La Défense CEDEX France

Les informations sur les licences concernant les produits utilisant un jeu de caractères double octet peuvent être obtenues par écrit à l'adresse suivante :

IBM World Trade Asia Corporation
Licensing
2-31 Roppongi 3-chome, Minato-ku
Tokyo 106, Japan

Le paragraphe suivant ne s'applique ni au Royaume-Uni, ni dans aucun pays dans lequel il serait contraire aux lois locales : LE PRESENT DOCUMENT EST LIVRE EN L'ETAT. IBM DECLINE TOUTE RESPONSABILITE, EXPLICITE OU IMPLICITE, RELATIVE AUX INFORMATIONS QUI Y SONT CONTENUES, Y COMPRIS EN CE QUI CONCERNE LES GARANTIES DE VALEUR MARCHANDE OU D'ADAPTATION A VOS BESOINS. Certaines juridictions n'autorisent pas l'exclusion des garanties implicites, auquel cas l'exclusion ci-dessus ne vous sera pas applicable.

Le présent document peut contenir des inexactitudes ou des coquilles. Des modifications sont régulièrement apportées à ces informations ; ces modifications seront intégrées dans les nouvelles éditions de la publication. IBM peut modifier sans préavis les produits et logiciels décrits dans ce document.

Les références à des sites Web non IBM sont fournies à titre d'information uniquement et n'impliquent en aucun cas une adhésion aux données qu'ils contiennent. Les éléments figurant sur ces sites Web ne font pas partie des éléments du présent produit IBM et l'utilisation de ces sites relève de votre seule responsabilité.

IBM pourra utiliser ou diffuser, de toute manière qu'elle jugera appropriée et sans aucune obligation de sa part, tout ou partie des informations qui lui seront fournies.

Les licenciés souhaitant obtenir des informations permettant : (i) l'échange des données entre des logiciels créés de façon indépendante et d'autres logiciels (dont celui-ci), et (ii) l'utilisation mutuelle des données ainsi échangées, doivent adresser leur demande à :

Intellectual Property Dept. for Rational Software
IBM Corporation
3600 Steeles Avenue East
Markham, Ontario
Canada L3R 9Z7

Ces informations peuvent être soumises à des conditions particulières, prévoyant notamment le paiement d'une redevance.

Le logiciel sous licence décrit dans ce document et tous les éléments sous licence disponibles s'y rapportant sont fournis par IBM conformément aux dispositions de l'ICA, des Conditions internationales d'utilisation des logiciels IBM ou de tout autre accord équivalent.

Les données de performance indiquées dans ce document ont été déterminées dans un environnement contrôlé. Par conséquent, les résultats peuvent varier de manière significative selon l'environnement d'exploitation utilisé. Certaines mesures évaluées sur des systèmes en cours de développement ne sont pas garanties sur tous les systèmes disponibles. En outre, elles peuvent résulter d'extrapolations. Les résultats peuvent donc varier. Il incombe aux utilisateurs de ce document de vérifier si ces données sont applicables à leur environnement d'exploitation.

Les informations concernant des produits non IBM ont été obtenues auprès des fournisseurs de ces produits, par l'intermédiaire d'annonces publiques ou via d'autres sources disponibles. IBM n'a pas testé ces produits et ne peut confirmer l'exactitude de leurs performances ni leur compatibilité. Elle ne peut recevoir aucune réclamation concernant des produits non IBM. Toute question concernant les performances de produits non IBM doit être adressée aux fournisseurs de ces produits.

Toute instruction relative aux intentions d'IBM pour ses opérations à venir est susceptible d'être modifiée ou annulée sans préavis, et doit être considérée uniquement comme un objectif.

Le présent document peut contenir des exemples de données et de rapports utilisés couramment dans l'environnement professionnel. Ces exemples mentionnent des noms fictifs de personnes, de sociétés, de marques ou de produits à des fins illustratives ou explicatives uniquement. Toute ressemblance avec des noms de personnes, de sociétés ou des données réelles serait purement fortuite.

LICENCE DE COPYRIGHT :

Le présent logiciel contient des exemples de programmes d'application en langage source destinés à illustrer les techniques de programmation sur différentes plateformes d'exploitation. Vous avez le droit de copier, de modifier et de distribuer ces exemples de programmes sous quelque forme que ce soit et sans paiement d'aucune redevance à IBM, à des fins de développement, d'utilisation, de vente ou de distribution de programmes d'application conformes aux interfaces de programmation des plateformes pour lesquels ils ont été écrits ou aux interfaces de programmation IBM. Ces exemples de programmes n'ont pas été rigoureusement testés dans toutes les conditions. Par conséquent, IBM ne peut garantir expressément ou implicitement la fiabilité, la maintenabilité ou le fonctionnement de ces programmes.

Toute copie totale ou partielle de ces programmes exemples et des oeuvres qui en sont dérivées doit comprendre une notice de copyright, libellée comme suit :

© (nom de votre société) (année). Des segments de code sont dérivés des Programmes exemples d'IBM Corp. © Copyright IBM Corp. 2000, 2005. All rights reserved.

Si vous visualisez ces informations en ligne, il se peut que les photographies et illustrations en couleur n'apparaissent pas à l'écran.

Informations sur l'interface de programmation

Les informations sur l'interface de programmation vous aident à créer des logiciels à l'aide de ce programme.

Les interfaces de programmation génériques permettent d'écrire des applications qui obtiennent les services des outils de ce programme.

Cependant ces informations peuvent également contenir des informations sur les diagnostics, les modifications et la configuration. Ces informations doivent vous permettre de déboguer vos applications.

Avertissement : N'utilisez pas ces informations comme interface de programmation car elles sont sujettes à modification.

Marques et logos

Les termes qui suivent sont des marques d'International Business Machines Corporation aux Etats-Unis et/ou dans certains autres pays :

• CICS
• IBM
• IMS
• OS/390
• Rational
• WebSphere
• z/OS

Java ainsi que tous les logos et toutes les marques incluant Java sont des marques de Sun Microsystems, Inc. aux Etats-Unis et/ou dans certains autres pays.

Windows et Windows NT sont des marques de Microsoft Corporation aux Etats-Unis et/ou dans certains autres pays.

Intel et Pentium sont des marques d'Intel Corporation ou de ses filiales aux Etats-Unis et/ou dans certains autres pays.

UNIX est une marque enregistrée de The Open Group aux Etats-Unis et/ou dans certains autres pays.

Linux est une marque de Linus Torvalds aux Etats-Unis et/ou dans certains autres pays.

D'autres sociétés sont propriétaires des autres marques, noms de produits ou logos qui pourraient apparaître dans ce document.