WebSphere Development Tools for iSeries 5.1 - Remarques d'édition

Ce document contient des informations spécifiques de cette édition de WebSphere Development Tools for iSeries. Cette édition intègre des composants qui étaient disponibles précédemment en tant que produits distincts. Ce document précise les conditions matérielles requises (mémoire et espace disque), les conditions logicielles (en phase de développement et d'exécution) et offre des exemples de migration.

Le fichier README contient les informations concernant les conditions prérequises, les limitations du produit et des données qui ne sont pas incluses dans la documentation.

Le document Remarques sur l'installation contient toutes les informations et les procédures concernant l'installation. Il explique aussi comment utiliser les fichiers réponses, procéder à une désinstallation et ajouter ou supprimer des composants.

Table des matières

• Composants
• Conditions requises sur le poste de travail
• Matériel
• Logiciel
• Procédure de migration
• VisualAge for Java Version 3.5.3 Enterprise Toolkit for AS/400 - REMARQUES D'EDITION

Composants de l'édition 5.1

Les cinq composants sont les suivants :

1. L'outil WebFacing permet d'afficher des programmes Web traditionnels qui utilisent des fichiers écran DDS. Les beans Java et les fichiers JSP personnalisés remplacent le code DDS et rendent possible l'accès à Internet.
2. WebSphere Studio for iSeries fournit les assistants qui permettent de créer des beans et des servlets Java, et de déployer des applications e-business avec facilité.
3. VisualAge for Java for iSeries fournit un environnement puissant pour le développement en langage Java. Vous pouvez éventuellement installer ET/400 qui offre des outils, des assistants, des beans java et des classes AS/400 Toolbox for Java. Ces éléments facilitent grandement les tâches de développement des programmes serveur et client Java pour les serveurs iSeries.
4. Cooperative Development Environment (CODE) permet d'éditer, de compiler et de déboguer des programmes RPG, COBOL, C, C++, CL, DDS et Java (dont CODE Designer, un outil DOS WYSIWYG).
5. VisualAge RPG prend en charge les applications qui offrent une interface utilisateur Windows et l'accès transparent aux ressources iSeries et génère des applications et des applets Java.

L'intégration entre WebSphere Studio et VisualAge for Java permet à des équipes distinctes de communiquer et de collaborer pour :

• Créer de nouvelles applications e-business.
• Porter des applications e-business existantes vers d'autres serveurs.
• Activer des applications existantes à partir du Web.

En outre, l'installation de WebSphere Development Tools for iSeries a été simplifiée grâce à :

• Des procédures d'installation pilotées par menus et lancées automatiquement.
• Un assistant de configuration de l'hôte et du serveur qui permet d'établir des communications entre postes de travail et serveurs.

Conditions requises sur le poste de travail

Conditions matérielles requises

• Processeur Intel Pentium II (ou un processeur compatible plus rapide conseillé)
• Ecran SVGA 800x600 (définition conseillée 1024x768)
• Unité de CD-ROM ou DVD-ROM
• Souris ou autre unité de pointage
• Adaptateurs de communication appropriés (compatibles avec le système d'exploitation installé sur le poste de travail)
• Capacités de disque et de mémoire requises :

  Composant	Mémoire		Disque
  	Minimum	Recommandé	Minimum	Recommandé
  Outil WebFacing (première édition)	128 Mo		200 Mo
  WebSphere Studio for iSeries (3.5)	96 Mo	128 Mo	385 Mo	500 Mo
  VisualAge for Java for iSeries (3.5)	128 Mo	192 Mo	495 Mo	550 Mo
  CODE	64 Mo	96 Mo	235 Mo
  VisualAge RPG	64 Mo	96 Mo	285 Mo
  TOTAL des produits	128 Mo	256 Mo	1,2 Go	1,5 Go

Si vous choisissez d'installer uniquement les composants indispensables, les conditions matérielles requises diminuent.

Conditions logicielles requises

Procédure de migration

VisualAge for Java

Version 3.5.3

Enterprise Toolkit for AS/400

REMARQUES D'EDITION

Table des matières

1.0 Introduction
2.0 Conditions préalables
3.0 Restrictions et incidents connus
     3.1 SmartGuide Conversion de fichier écran
     3.2 Performances du bean AS400eList
     3.3 Génération de code dans les beans DFU
4.0 Conseils et astuces
      4.1 Fichiers d'exécution
      4.2 Déploiement d'une application VCE comportant des beans DFU
      4.3 Débogage
5.0 Sites Web Java AS/400
6.0 Documentation

1.0 Introduction

Ces remarques d'édition présentent les conditions préalables relatives au produit VisualAge for Java Enterprise Toolkit for AS/400. Elles décrivent également les restrictions spécifiques du produit et contiennent les informations qui ne figurent pas dans la documentation.

Le serveur AS/400 s'appelle désormais IBM eServer iSeries. Toutefois, pour la présente édition de VisualAge for Java, nous continuerons d'utiliser le terme "AS/400" pour parler du serveur AS/400.

2.0 Conditions préalables

• Il est généralement conseillé de charger les dernières PTF sur l'AS/400.
• Pour IBM Distributed Debugger, voici la liste des PTF requises pour chaque édition :
  

  Edition OS/400	Logiciel sous licence	Numéro de PTF
  V4R3M0	5769SS1*	SF49975*
  V4R3M0	5769999	MF19487
  V4R4M0	5769999	MF24806
  V4R4M0	5769SS1	GRS4092
  V4R4M0	5769SS1	SF56682
  V4R4M0	5769SS1	SF56281
  V4R4M0	5769SS1	SF63732
  V4R5M0	5769SS1	SF63034

*Remarque : Cette PTF sera bientôt remplacée par une autre.

Pour toute information concernant les dernières PTF relatives à IBM Distributed Debugger, consultez le site http://www-1.ibm.com/support/search.wss?rs=715&tc=SSZND2&dc=DA400.

• L'édition du support de code pour le Smartguide Conversion de fichier écran a été améliorée. Pour bénéficier de cette amélioration, vous devez appliquer la PTF appropriée :
  

  Edition OS/400	Logiciel sous licence	Numéro de PTF
  V3R1M0	5763PW100	SF47783
  V3R2M0	5763PW100	SF47784
  V3R6M0	5716PW100	SF47785
  V3R7M0	5716PW100	SF47786
  V4R2M0	5769PW100	SF47774

• L'action d'exécution d'ET/400 requiert la PTF suivante :
  

  Edition OS/400	Logiciel sous licence	Numéro de PTF
  V4R3M0	5769SS100*	SF49975*
  V4R4M0	5769SS100	SF63732
  V4R5M0	5769SS100	SF63034

*Remarque : Cette PTF sera bientôt remplacée par une autre.

• Plusieurs exemples utilisent les fichiers AS/400 mis à jour contenus dans la bibliothèque ADTSLAB. Pour pouvoir exécuter ces exemples, vous devez appliquer l'une des PTF appropriées ci-après pour le produit Application Development ToolSet/400.
  

  Edition OS/400	Logiciel sous licence	Numéro de PTF
  V4R2M0	5769PW100	SF63545
  V4R4M0	5769PW100	SF63703

Pour obtenir la liste d'autres PTF récentes, consultez le site :http://www.software.ibm.com/ad/as400/vajava/.

• Pour toute PTF relative à IBM AS/400 Toolbox for Java, reportez-vous au site Web suivant : http://www.as400.ibm.com/Toolbox.
• Avant de pouvoir établir une connexion avec un serveur AS/400, vous devez démarrer tous les serveurs hôte sur l'AS/400 à l'aide de la commande STRHOSTSVR *ALL et démarrer TCP/IP sur le serveur à l'aide de la commande STRTCPSVR *DDM.

3.0 Restrictions et incidents connus

3.1 SmartGuide Conversion de fichier écran

Sur les systèmes disposant d'une version antérieure de Communications Personnelles IBM, il ne sera peut-être pas possible de démarrer une session Communications Personnelles IBM pendant l'exécution du SmartGuide Conversion de fichier écran. Une fois l'exécution du SmartGuide terminée, une session Communications Personnelles IBM peut être ouverte.

Un bean généré par ce Smartguide peut être ouvert dans VCE et sauvegardé après avoir fait l'objet d'une opération de type Construct Visuals à partir du source. Le bean résultant peut apparaître ou se comporter différemment du bean d'origine.

3.2 Performances du bean AS400eList

Lors d'une extraction de listes à partir d'un serveur AS/400, la conversion de données peut prendre plus de temps pour aboutir si la liste est très longue ou si des zones binaires ou de date sont sélectionnées. Pour obtenir les performances optimales, suivez les recommandations ci-après.

1. Utilisez les formats OBJL0100 or OBJL0200, qui permettent la conversion de données en une seule étape.
2. Si le format OBJL0300 (ou un format suivant) est sélectionné, évitez de sélectionner les zones binaires ou de date ci-après, sauf si cela est nécessaire. Si une zone binaire ou de date est sélectionnée, la conversion des attributs de zone doit se faire individuellement pour chaque élément. Le processus général se trouve par conséquent ralenti, en particulier pour les longues listes.

Zones binaires
getInclude0300AuxiliaryStoragePool()
getInclude0500SaveSize()
getInclude0500SaveSizeMultiplier()
getInclude0500SaveSequenceNumber()
getInclude0600DaysUsedCount()
getInclude0700Size()
getInclude0700SizeMultiplier()

Zones de date
getInclude0300CreateDateTime()
getInclude0300ChangeDateTime()
getInclude0500SavedDateTime()
getInclude0500RestoredDateTime()
getInclude0500SaveActiveDateTime()
getInclude0600LastUsedDateTime()
getInclude0600ResetDateTime() 

3.3 Génération de code dans les beans DFU

Lors de la génération de code par les beans FormManager, ListManager ou RecordIOManager, il est possible que l'indicateur de progression apparaissent plusieurs fois, selon le nombre de méthodes générées pour la classe de condition.

N'essayez pas de fermer la fenêtre des propriétés du bean pendant la génération du code, car cela entraînerait l'interruption de Visual Composition Editor. En ce qui concerne les beans FormManager ou ListManager, la valeur de la propriété de recordIOManager change de manière appropriée lorsque la génération du code aboutit. La fenêtre des propriétés peut alors être fermée.

4.0 Conseils et astuces

4.1 Fichiers d'exécution

Les fichiers .jar et .zip ci-après sont disponibles pour l'exécution des exemples et des applications hors de VisualAge for Java. Ils se trouvent dans le répertoire 'eab\runtime30' :

• JT400.JAR (AS/400 Toolbox for Java)
• JT400MRI.ZIP (texte traduit pour les classes AS/400 Toolbox for Java)
• AS400UT.JAR (classes fournies dans les packages com.ibm.ivj.et400.util et
  com.ibm.ivj.et400.util.awt)

Ces fichiers Toolbox .jar se trouvent également dans le répertoire 'eab\runtime30' :

• DATA400.JAR
• JT400PROXY.JAR
• JT400SERVLET.JAR
• JUI400.JAR
• UITOOLS.JAR
• UTIL400.JAR
• X4J400.JAR
• JT400ACCESS.ZIP
• UTILITIES.ZIP

Reportez-vous à la Foire aux questions pour en savoir plus sur l'utilisation de AS/400 Toolbox for Java sur l'OS/400 (http://www-1.ibm.com/servers/eserver/iseries/toolbox/faq.htm).

4.2 Déploiement d'une application VCE disposant de beans DFU

4.3 Débogage

IBM Distributed Debugger est installé séparément de VisualAge for Java. Pour l'installer, réexécutez le programme de configuration de VisualAge for Java, puis choisissez Distributed Debugger.

5.0 Sites Web AS/400 Java

Pour en savoir plus sur IBM AS/400 Toolbox for Java, accédez au site Web suivant :
http://www-1.ibm.com/servers/eserver/iseries/toolbox/index.html

6.0 Documentation

1. La plus grande partie de l'aide d'Enterprise Toolkit for AS/400 (ET/400) a été modifiée depuis qu'elle a été traduite. Pour obtenir le texte d'aide le plus récent, vous devez vous reporter à la version anglaise de l'aide.
2. Les fonctions ET/400 qui ne sont décrites que dans la version anglaise de l'aide sont les suivantes :
   • Les beans DFU FormManager, ListManager et RecordIOManager. Les beans DFU, FormManager, ListManager et RecordIOManager constituent un ensemble de classes qui étendent le support de code pour accéder à un ou plusieurs fichiers base de données AS/400. Ces beans permettent de faire correspondre des formulaires de GUI, des tables et des listes aux bases de données AS/400 et de manipuler (extraire, ajouter et supprimer) des enregistrements de base de données.
   • Les beans de liste d'objets ET400List et AS400eList. Les beans de liste d'objets offrent une méthode d'accès aux noms d'objet AS/400. Ces beans vous permettent définir des propriétés de liste pour sélectionner le type d'objet désiré dans la liste d'objets. Les types de listes d'objets comprennent une liste de bibliothèques, une liste de fichiers dans une bibliothèque ou une liste d'ID utilisateur sur le système. Les paramètres de propriété peuvent être utilisés pour accéder à plusieurs types différents de listes d'objets.
   • Les nouveaux beans JFormatted (outre ceux qui existent déjà) JFormattedTable, JFormattedTableColumn, JFormattedTextFieldCellEditor,
     JFormattedComboBoxCellEditor, et JFormattedLabelCellRenderer.
   • Une nouvelle boîte de dialogue de connexion.
   • De nouvelles options dans les boîtes de dialogue d'exécution et de compilation.
   • Le démon ET/400 que vous pouvez démarrer de manière à éviter de vous connecter plusieurs fois au même serveur AS/400 lorsque vous accédez aux SmartGuides, boîtes de dialogue actives ou boîtes de dialogue de propriétés et que vous les utilisez.
3. Les concepts suivants ont été ajoutés depuis la dernière traduction de l'aide sur ET/400 :
   • "Beans de l'utilitaire de création-maintenance de fichiers (DFU)"
   • "Beans de liste d'objets"
4. Les tâches suivantes ont été ajoutées :
   • "Démarrage et arrêt du démon ET/400"
   • "Lancement de l'afficheur OLT pour le débogage"
5. Les références suivantes ont été ajoutées :
   • "Bean FormManager"
   • "Bean ListManager"
   • "Bean RecordIOManager"
   • "Propriétés de RecordIOManager"
   • "Considérations relatives aux appels de programme"
   • "Bean JFormattedTable"
   • "Bean JFormattedTableColumn"
   • "Bean JFormattedTextFieldCellEditor"
   • "Bean JFormattedComboBoxCellEditor"
   • "Bean JFormattedLabelCellRenderer"
   • "Bean ET400List"
   • "Bean AS400eList"
6. Des exemples associés aux nouveaux beans DFU, JFormatted et de liste d'objets ont été ajoutés.
7. Les concepts suivants ont été modifiés :
   • Dans les "beans JFormatted", des informations relatives aux beans JFormattedTable, JFormattedTableColumn, JFormattedTextFieldCellEditor, JFormattedComboBoxCellEditor, et JFormattedLabelCellRenderer ont été ajoutées.
8. Les références suivantes ont été modifiées :
   • "Considérations relatives aux fichiers écran"
   • "Mots clés des fichiers écran"
9. La fonction suivante a été enlevée depuis la dernière traduction de l'aide sur ET/400 :
   • Le SmartGuide de création de sous-fichier et toutes les références à la création de sous-fichiers ou à l'utilisation de ce SmartGuide ont été enlevés.
10. Les tâches suivantes ont été enlevées depuis la dernière traduction de l'aide sur ET/400 :
    • "Création d'une classe de sous-fichier"
11. Les références suivantes ont été enlevées depuis la dernière traduction de l'aide sur ET/400 :
    • "Considérations relatives aux E-S d'enregistrement pour les sous-fichiers"
12. Les exemples suivants ont été enlevés depuis la dernière traduction de l'aide sur ET/400 :
    • "Création d'une application client-serveur Java"
    • "Affichage d'une liste de noms et de numéros de téléphone"
    • "Extraction et affichage de données dans un sous-fichier"
    • "Remplissage d'un sous-fichier"
    • "Masquage d'une colonne dans un sous-fichier"
    • "Extraction d'un enregistrement dans un sous-fichier"
    • "Extraction de noms et de descriptions de zone pour un fichier base de données"
    • "Définition d'une présentation de sous-fichier"
    • "Ajout, retrait et insertion d'enregistrements de sous-fichier"
    • "Définition d'un mode de sélection de sous-fichier"
    • "AS/400 Toolbox for Java (démonstration)"