Migration des beans d'appel de programme
Migration des beans d'appel de programme dans les projets iSeries Java et Web depuis la version 5.1 ou 5.1.2 vers la version 6.0.1
La présente section explique comment migrer les beans d'appel de programme créés dans Development Studio Client pour iSeries version 5.1 ou 5.1.2 vers la version 6.0.1.
Dans la version 6.0.1, l'assistant Appel de programme place le fichier PCML d'un bean d'appel de programme dans le package de beans. Ce changement remonte aux versions précédentes. Si vous recréez un bean d'appel de programme depuis un fichier PCML existant qui ne figure pas dans le package de beans, vous pouvez supprimer le fichier PCML dès que l'assistant a fini de recréer le bean d'appel de programme.
Remarque :
Dans la version 6.0.1, vous pouvez
créer un service Web de programme iSeries à partir de code source ILE RPG ou COBOL ou de fichiers PCML en utilisant directement l'assistant Services Web. Vous n'êtes pas obligé d'exécuter les assistants Appel de programme et Services Web.
Migration des beans d'appel de programme dans un projet Java
- Si vous lancez la version 6.0.1 (en cliquant sur Démarrer > Programmes > IBM Rational > WebSphere Development Studio Client pour iSeries), le programme affiche une fenêtre de lancement dans laquelle vous pouvez définir le répertoire à utiliser pour la session. Précisez le répertoire de l'espace de travail version 5.x.
- Si un message vous demande de confirmer la conversion dans le format de la nouvelle interface utilisateur, cliquez sur OK.
- Supprimez les fichiers .jar d'exécution en modifiant le chemin de construction Java du projet :
- Cliquez avec le bouton droit de la souris sur le projet Java, puis sélectionnez Propriétés.
- Dans la sous-fenêtre de gauche, sélectionnez Chemin de construction Java.
- Cliquez sur l'onglet Bibliothèques, sélectionnez les fichiers .jar suivants et cliquez sur Supprimer pour les supprimer du chemin de classe :
RACINE_WDSC/plugins/com.ibm.etools.iseries.toolbox_5.1.0/runtime/jt400.jar
RACINE_WDSC/plugins/com.ibm.etools.iseries.webtools_5.1.0/lib/iwdtrt.jar
RACINE_WDSC_ECLIPSE/plugins/org.apache.xerces_4.1.3/xercesImpl.jar/
j2ee.jar
4. Relancez l'assistant Appel de programme sur tous les fichiers PCML. Si vous utilisiez un package par défaut, vous devez préciser un nom de package dans la version 6.0.1. Comme les nouveaux beans Java générés et le fichier PCML figurent dans le package que vous avez précisé, vous pouvez supprimer les anciens beans Java et le fichier PCML du package par défaut.
Migration des beans d'appel de programme dans un projet Web
Si vous utilisez des beans de service d'appel de programme, vous devez savoir que l'assistant Appel de programme génère toujours un fichier .config dans la version 6.0.1.
Le programme peut utiliser un fichier défini par l'utilisateur ou le fichier par défaut defaultPCW.config. Vous ne devez plus utiliser l'assistant Configuration d'exécution. Pour les projets Web antérieurs à la version 6.0.1, la procédure de migration des outils Web suivante puise des informations dans le fichier web.xml du projet et crée automatiquement le fichier defaultPCW.config si ce dernier n'existe pas déjà. Ensuite, la configuration d'exécution des appels de programme s'appuie sur les données du fichier .config au lieu du fichier web.xml.
- Si vous lancez la version 6.0.1 (en cliquant sur Démarrer > Programmes > IBM Rational > WebSphere Development Studio Client pour iSeries), le programme affiche une fenêtre de lancement dans laquelle vous pouvez définir le répertoire à utiliser pour la session. Précisez le répertoire de l'espace de travail version 5.1 ou 5.1.2 dans la fenêtre.
- Si un message vous demande de confirmer la conversion dans le format de la nouvelle interface utilisateur, cliquez sur OK.
- Utilisez l'assistant de migration J2EE pour migrer les beans d'appel de programme du niveau J2EE 1.2 vers un niveau J2EE supérieur (facultatif).
- Supprimez les fichiers iwdtrt.jar et jt400.jar du dossier WEB-INF\lib.
- Relancez l'assistant Appel de programme sur tous les fichiers PCML. Le programme crée le nouveau bean de services et les fichiers PCML dans le package que vous avez précisé. Supprimez les anciens fichiers PCML du projet Web.
- Relancez l'assistant Services Web sur le bean de service.
Le code généré par l'assistant Services Web nécessite une migration et un nettoyage manuels. Cette migration s'applique uniquement aux beans de service Web proprement dits.
Pour savoir comment migrer vos services Web, consultez les sections appropriées du guide de migration livré avec le produit Rational Software Developer Platform de base (voir Localisation des autres informations importantes pour connaître les liens vers ce guide).
Migration des beans d'appel de programme dans les projets iSeries Java et Web depuis la version 5.0 vers la version 6.0.1
La présente section explique comment migrer les beans d'appel de programme créés dans Development Studio Client pour iSeries version 5.0 vers la version 6.0.1.
Remarque :
Dans la version 6.0.1, vous pouvez
créer un service Web de programme iSeries à partir de code source ILE RPG ou COBOL ou de fichiers PCML en utilisant directement l'assistant Services Web. Vous n'êtes pas obligé d'exécuter les assistants Appel de programme et Services Web.
Migration des beans d'appel de programme dans un projet Java
- Si vous lancez la version 6.0.1 (en cliquant sur Démarrer > Programmes > IBM Rational > WebSphere Development Studio Client pour iSeries), le programme affiche une fenêtre de lancement dans laquelle vous pouvez définir le répertoire à utiliser pour la session. Indiquez l'emplacement de votre espace de travail version 5.0 dans cette fenêtre.
- Si un message vous demande de confirmer la conversion dans le format de la nouvelle interface utilisateur, cliquez sur OK.
- Supprimez les fichiers .jar d'exécution en modifiant le chemin de construction Java du projet :
- Cliquez avec le bouton droit de la souris sur le projet Java, puis sélectionnez Propriétés.
- Dans la sous-fenêtre de gauche, sélectionnez Chemin de construction Java.
- Cliquez sur l'onglet Bibliothèques, sélectionnez les fichiers .jar suivants et cliquez sur Supprimer pour les supprimer du chemin de classe :
RACINE_WDSC/plugins/com.ibm.etools.iseries.toolbox_5.0.0/runtime/jt400.jar
RACINE_WDSC/plugins/com.ibm.etools.iseries.webtools_5.0.0/lib/iwdtrt.jar
RACINE_WDSC_ECLIPSE/plugins/org.apache.xerces_4.0.7/xercesImpl.jar/
j2ee.jar
4. Relancez l'assistant Appel de programme sur tous les fichiers PCML. Sur la page Configuration de l'authentification de l'assistant, décochez l'option Générer un fichier de configuration.
Migration des beans d'appel de programme dans un projet Web
Les sections suivantes expliquent comment migrer le contenu des dossiers du contenu Web, du source Java et du projet Web.
Pour migrer le contenu du dossier du contenu Web :
- Si vous lancez la version 6.0.1 (en cliquant sur Démarrer > Programmes > IBM Rational > WebSphere Development Studio Client pour iSeries), le programme affiche une fenêtre de lancement dans laquelle vous pouvez définir le répertoire à utiliser pour la session. Utilisez l'emplacement par défaut comme espace de travail.
- Placez-vous dans la perspective Ressource.
- Créez un nouveau projet Web dynamique portant le même nom et utilisant la même version de servlet que le projet Web version 5.0 existant. Pour déterminer la version du servlet, recherchez la balise jsp-level dans le fichier .websettings du projet 5.0. Si le niveau JSP est 1.2, définissez la version du servlet sur 2.3. Sinon, définissez la version sur 2.2. Puis, cliquez sur Terminer. A l'invite, ne vous placez pas dans la perspective Web.
- Choisissez le dossier du contenu Web du nouveau projet créé, cliquez avec le bouton droit de la souris et sélectionnez Importer dans le menu contextuel.
- Sélectionnez Système de fichiers comme source d'importation, puis cliquez sur Suivant. Cliquez sur le bouton Parcourir, puis choisissez le dossier du contenu Web (baptisé Web Content, par défaut) du projet Web version 5.0 existant. Cliquez sur OK.
- Choisissez le dossier du contenu Web sans cocher la case. Cliquez sur Sélectionner tout. Dans le panneau de droite, désélectionnez et resélectionnez un fichier. En fait, le programme importe l'intégralité du contenu du dossier du contenu Web, sans importer le dossier proprement dit.
- Sélectionnez les options Créer seulement les dossiers sélectionnés et Ecraser les ressources existantes sans avertissement, puis cliquez sur Terminer. Normalement, le dossier du contenu Web du nouveau projet créé contient les mêmes ressources et la même structure que le dossier du contenu Web 5.0.
Pour migrer le contenu du dossier du source Java :
- Choisissez le dossier du source Java du nouveau projet créé, cliquez avec le bouton droit de la souris et sélectionnez Importer dans le menu contextuel.
- Sélectionnez Système de fichiers comme source d'importation, puis cliquez sur Suivant. Cliquez sur le bouton Parcourir, puis choisissez le dossier du source
Java (appelé Java Source, par défaut) du projet Web version 5.0 existant. Cliquez sur OK.
- Choisissez le dossier du source Java sans cocher la case. Cliquez sur Sélectionner tout. Dans le panneau de droite, désélectionnez et resélectionnez un fichier. En fait, le programme importe l'intégralité du contenu du dossier du source Java, sans importer le dossier proprement dit.
- Sélectionnez les options Créer seulement les dossiers sélectionnés et Ecraser les ressources existantes sans avertissement, puis cliquez sur Terminer. Normalement, le dossier du source Java du nouveau projet créé contient les mêmes ressources et la même structure que le dossier du source Java 5.0.
Pour migrer le contenu du dossier du projet Web :
- Choisissez le nouveau projet créé, cliquez avec le bouton droit de la souris et sélectionnez Importer dans le menu contextuel.
- Sélectionnez Système de fichiers comme source d'importation, puis cliquez sur Suivant. Cliquez sur le bouton Parcourir, puis choisissez le projet Web 5.0 existant.
- Dans le panneau de gauche, choisissez le dossier du projet et cliquez sur Sélectionner tout. Dans le panneau de droite, désélectionnez et resélectionnez un fichier. Dans le panneau de gauche, désélectionnez les dossiers du contenu Web et du source Java. En fait, le programme importe l'intégralité du contenu du dossier du projet Web à l'exception des dossiers du contenu Web et du source Java et du dossier du projet Web proprement dit.
- Dans le panneau de droite, désélectionnez les fichiers suivants s'ils apparaissent dans la liste :
- \WebContent\.classpath
- \WebContent\.project
- \WebContent\.websettings
- \WebContent\.serverPreference
Ces fichiers contiennent les informations de projet requises au stade de la conception. Comme les informations ne peuvent pas être migrées vers la version 6.0.1, le programme recrée les fichiers dès que nécessaire.
- Sélectionnez les options Créer seulement les dossiers sélectionnés et Ecraser les ressources existantes sans avertissement, puis cliquez sur Terminer. Normalement, le nouveau dossier du projet Web créé contient les mêmes ressources et la même structure que le dossier du projet Web 5.0.
- Utilisez l'assistant de migration J2EE pour migrer les beans d'appel de programme du niveau J2EE 1.2 vers un niveau J2EE supérieur (facultatif).
- Supprimez les fichiers iwdtrt.jar et jt400.jar du dossier WEB-INF\lib.
- Relancez l'assistant Appel de programme sur tous les fichiers PCML.
Cette migration s'applique uniquement aux beans de service proprement dits. Pour savoir comment migrer vos Services Web, consultez les sections appropriées du guide de migration livré avec le produit Rational Software Developer Platform de base (voir Localisation des autres informations importantes pour connaître les liens vers ce guide).
Migration des beans d'appel de programme dans les projets iSeries Java et Web depuis la version 4.0 vers la version 6.0.1
La présente section explique comment migrer les beans d'appel de programme créés dans Development Studio Client pour iSeries version 4.0 vers la version 6.0.1.
Remarque :
Dans la version 6.0.1, vous pouvez
créer un service Web de programme iSeries à partir de code source ILE RPG ou COBOL ou de fichiers PCML en utilisant directement l'assistant Services Web. Vous n'êtes pas obligé d'exécuter les assistants Appel de programme et Services Web.
Migration des beans d'appel de programme dans un projet Java
- Si vous lancez la version 6.0.1 (en cliquant sur Démarrer > Programmes > IBM Rational > WebSphere Development Studio Client pour iSeries), le programme affiche une fenêtre de lancement dans laquelle vous pouvez définir le répertoire à utiliser pour la session. Indiquez l'emplacement de votre espace de travail version 4.0 dans cette fenêtre.
- Si un message vous demande de confirmer la conversion dans le format de la nouvelle interface utilisateur, cliquez sur OK.
- Supprimez les fichiers .jar d'exécution en modifiant le chemin de construction Java du projet :
- Cliquez avec le bouton droit de la souris sur le projet Java, puis sélectionnez Propriétés.
- Dans la sous-fenêtre de gauche, sélectionnez Chemin de construction Java.
- Cliquez sur l'onglet Bibliothèques, sélectionnez les fichiers .jar suivants et cliquez sur Supprimer pour les supprimer du chemin de classe :
RACINE_ECLIPSE/plugins/com.ibm.etools.iseries.toolbox/runtime/jt400.jar
RACINE_ECLIPSE/plugins/com.ibm.etools.iseries.webtools/lib/wdt400rt.jar
RACINE_ECLIPSE/plugins/com.ibm.etools.websphere.runtime/lib/j2ee.jar
RACINE_ECLIPSE/plugins/com.ibm.etools.websphere.runtime/lib/xerces.jar
- Relancez l'assistant Appel de programme sur tous les fichiers PCML. Sur la page Configuration de l'authentification de l'assistant, décochez l'option Générer un fichier de configuration.
Cette migration s'applique uniquement aux beans d'appel de programme proprement dits. Le code généré par l'assistant Appel de programme nécessite une migration et un nettoyage manuels.
Migration des beans d'appel de programme dans un projet Web
Pour migrer le contenu du dossier du contenu Web :
- Si vous lancez la version 6.0.1 (en cliquant sur Démarrer > Programmes > IBM Rational > WebSphere Development Studio Client pour iSeries), le programme affiche une fenêtre de lancement dans laquelle vous pouvez définir le répertoire à utiliser pour la session. Utilisez l'emplacement par défaut comme espace de travail.
- Placez-vous dans la perspective Ressource.
- Créez un nouveau projet Web dynamique portant le même nom et utilisant la même version de servlet que le projet Web version 4.0 existant. Pour déterminer la version du servlet, recherchez la balise jsp-level dans le fichier .websettings du projet 4.0. Si le niveau JSP est 1.2, définissez la version du servlet sur 2.3. Sinon, définissez la version sur 2.2. Puis, cliquez sur Terminer. A l'invite, ne vous placez pas dans la perspective Web.
- Choisissez le dossier du contenu Web du nouveau projet créé, cliquez avec le bouton droit de la souris et sélectionnez Importer dans le menu contextuel.
- Sélectionnez Système de fichiers comme source d'importation, puis cliquez sur Suivant. Cliquez sur le bouton Parcourir, puis choisissez le dossier du contenu Web (appelé webApplication, par défaut) du projet Web 4.0 existant. Cliquez sur OK.
- Choisissez le dossier du contenu Web sans cocher la case. Cliquez sur Sélectionner tout. Dans le panneau de droite, désélectionnez et resélectionnez un fichier. En fait, le programme importe l'intégralité du contenu du dossier du contenu Web, sans importer le dossier proprement dit.
- Sélectionnez les options Créer seulement les dossiers sélectionnés et Ecraser les ressources existantes sans avertissement, puis cliquez sur Terminer. Normalement, le dossier du contenu Web du nouveau projet créé contient les mêmes ressources et la même structure que le dossier du contenu Web 4.0.
Pour migrer le contenu du dossier du source Java :
- Choisissez le dossier du source Java du nouveau projet créé, cliquez avec le bouton droit de la souris et sélectionnez Importer dans le menu contextuel.
- Sélectionnez Système de fichiers comme source d'importation, puis cliquez sur Suivant. Cliquez sur le bouton Parcourir, puis choisissez le dossier du source Java (appelé source, par défaut) du projet Web 4.0 existant. Cliquez sur OK.
- Choisissez le dossier du source Java sans cocher la case. Cliquez sur Sélectionner tout. Dans le panneau de droite, désélectionnez et resélectionnez un fichier. En fait, le programme importe l'intégralité du contenu du dossier du source Java, sans importer le dossier proprement dit.
- Sélectionnez les options Créer seulement les dossiers sélectionnés et Ecraser les ressources existantes sans avertissement, puis cliquez sur Terminer. Normalement, le dossier du source Java du nouveau projet créé contient les mêmes ressources et la même structure que le dossier du source Java 4.0.
Pour migrer le contenu du dossier du projet Web :
- Choisissez le nouveau projet créé, cliquez avec le bouton droit de la souris et sélectionnez Importer dans le menu contextuel.
- Sélectionnez Système de fichiers comme source d'importation, puis cliquez sur Suivant. Cliquez sur le bouton Parcourir, puis choisissez le projet Web 4.0 existant.
- Dans le panneau de gauche, choisissez le dossier du projet et cliquez sur Sélectionner tout. Dans le panneau de droite, désélectionnez et resélectionnez un fichier. Dans le panneau de gauche, désélectionnez les dossiers du contenu Web et du source Java. En fait, le programme importe l'intégralité du contenu du dossier du projet Web à l'exception des dossiers du contenu Web et du source Java et du dossier du projet Web proprement dit.
- Dans le panneau de droite, désélectionnez les fichiers suivants s'ils apparaissent dans la liste :
- \WebContent\.classpath
- \WebContent\.project
- \WebContent\.websettings
- \WebContent\.serverPreference
Ces fichiers contiennent les informations de projet requises au stade de la conception. Comme les informations ne peuvent pas être migrées vers la version 6.0.1, le programme recrée les fichiers dès que nécessaire.
- Sélectionnez les options Créer seulement les dossiers sélectionnés et Ecraser les ressources existantes sans avertissement, puis cliquez sur Terminer. Normalement, le nouveau dossier du projet Web créé contient les mêmes ressources et la même structure que le dossier du projet Web 5.0.
- Utilisez l'assistant de migration J2EE pour migrer les beans d'appel de programme du niveau J2EE 1.2 vers un niveau J2EE supérieur (facultatif).
- Supprimez les fichiers wdt400rt.jar et wdt400tb.jar du dossier WEB-INF\lib.
- Relancez l'assistant Appel de programme sur tous les fichiers PCML.
- Cette migration s'applique uniquement aux beans de service proprement dits.
A compter de la version 5.1, vous devez les générer dans un package nommé avant d'appeler l'assistant Services Web. Le code généré par l'assistant Services Web nécessite une migration et un nettoyage manuels.
Cette migration s'applique uniquement aux beans de service Web proprement dits. Pour savoir comment migrer vos Services Web, consultez les sections appropriées du guide de migration livré avec le produit Rational Software Developer Platform de base (voir Localisation des autres informations importantes pour connaître les liens vers ce guide).
(C) Copyright IBM Corporation 1992, 2006. All Rights Reserved.