### IBM OS/2 WARP DEVELOPER KIT,
JAVA 2 TECHNOLOGY EDITION, 1.3.1
GUIDE D'INSTALLATION ET DE CONFIGURATION

(c) Copyright IBM Corporation 1999, 2002. Tous droits réservés.

Remarque : la notice de copyright complète est contenue dans la section Remarques de ce document.

Le présent manuel contient des informations sur le produit IBM OS/2 Warp Developer Kit, Java 2 Technology Edition, version 1.3.1 (kit de développement). Il traite de la préparation de l'installation des composants du kit, de leur installation proprement dite et des points à noter après l'installation.

Le Kit de développement est supporté par les produits OS/2 suivants :

- OS/2 Warp 4 avec FixPak 5 ou postérieur pour les pays SBCS (jeu de caractères à un octet)
  ou FixPak FX00505 pour les pays DBCS (jeux de caractères à deux octets)
- OS/2 Warp Server for e-business
- Convenience Package pour OS/2 Warp 4
- Convenience Package pour OS/2 Warp Server for e-business
- Convenience Package 2 pour OS/2 Warp 4
- Convenience Package 2 pour OS/2 Warp Server for e-business
- WorkSpace On-Demand version 2.0, avec le dernier FixPak

Remarque : pour plus d'informations sur les conditions requises pour les FixPack ou sur le site Web FixPack, reportez-vous à la section FixPaks.

Pour obtenir le numéro de compilation et de version IBM du Kit de développement, entrez la commande suivante sur une ligne de commande :

         java -version

### Sommaire

- 1.0 AVANT L'INSTALLATION
- 1.1 Conditions requises pur l'installation
- 1.2 Extraction des fichiers pour l'installation
- 1.3 Considérations sur les systèmes de fichiers
- 1.4 FixPaks
- 1.5 Installation du Kit de développement comme JVM par défaut

- 1.5.1 Informations relatives à la variable d'environnement JAVA_HOME

- 1.6 Informations relatives à Netscape Communicator
- 1.7 Réassemblage des fichiers découpés
- 2.0 INSTALLATION DU KIT DE DEVELOPPEMENT
- 2.1 Par interface graphique

- 2.1.1 Depuis le bureau
- 2.1.2 Depuis l'invite de commande
- 2.1.3 Composants non sélectionnables pendant l'installation
- 2.1.4 Nettoyage après un échec pendant l'installation
- 2.1.5 Niveau de FixPak correct mais installation impossible

- 2.2 Méthode d'installation automatique (CID)
  - 2.2.1 Modification du fichier de réponses CID
  - 2.2.1.1 Unités d'installation de composant
  - 2.2.2 Lancement de l'installation automatique
  - 2.2.3 Code retour de CID "opération réussie" et échec
  - 2.2.4 Niveau de FixPak correct mais installation impossible
- 2.3 Considérations sur l'installation de NVDM/2

- 2.3.1 Commande statique dans le profil NVDM/2

- 2.4 Installation du Kit de développement sous WorkSpace On-Demand 2.0

- 2.4.1 Installation du Kit de développement sur un serveur WorkSpace On-Demand 2.0
- 2.4.2 Installation du Kit de développement sur un client WorkSpace On-Demand 2.0

- 2.4.2.1 Installation automatique pour un client WorkSpace On-Demand 2.0
- 2.4.2.2 Modification des fichiers CONFIG.SYS pour les clients WorkSpace On-Demand 2.0
- 2.4.2.3 Modification des fichiers FIT et octroi d'accès aux clients WorkSpace On-Demand 2.0
- 2.4.2.4 Attribution d'un répertoire USER_HOME aux clients WorkSpace On-Demand 2.0
- 2.4.2.5 Activation des polices pour les clients WorkSpace On-Demand 2.0
- 2.4.2.6 Installation du plug-in Netscape Communicator pour les clients WorkSpace On-Demand 2.0
- 2.4.2.7 Installation de composants supplémentaires du Kit de développement sur le client WorkSpace On-Demand 2.0
- 2.4.2.8 Exécution des exemples Java depuis un client WorkSpace On-Demand 2.0
- 2.4.2.9 Emission d'une habilitation sur un client WorkSpace On-Demand 2.0
- 2.4.2.10 Compilateur JIT et client WorkSpace On-Demand 2.0
- 2.4.2.11 Création d'une application partagée pour l'exécution du panneau de commande du plug-in Java sur un client WorkSpace On-Demand 2.0

- 2.5 Installation IPL éloigné

- 2.5.1 Création de fichiers de réponses
- 2.5.2 Modification du fichier JAVA131.RSP
- 2.5.3 Mise à jour des fichiers pour Feature Install
- 2.5.4 Lancement de l'installation IPL éloigné
- 2.5.5 Exécution des exemples Java depuis un client IPL éloigné

- 2.5.5.1 Emission d'une habilitation sur un client IPL éloigné

- 3.0 APRES L'INSTALLATION
- 3.1 Sources d'information complémentaires
- 3.2 Installation de composants complémentaires
- Considérations relatives aux éléments de contrôle AWT TextField et TextArea
- 3.4 Modification des fichiers de propriétés de police non prise en charge
- 3.5 Problèmes d'heure dans les applets Java
- 3.6 Utilisation de OS/2 HMS (Support de mémoire haute) pour augmenter la taille de la mémoire dynamique de Java

- 3.6.1 Activation de OS/2 HMS
- 3.6.2 Activation de l'utilisation d'OS/2 HMS par la mémoire dynamique Java
- 3.6.3 Limitations lors de l'utilisation d'OS/2 HMS

- 3.7 Classe BigDecimal améliorée
- 3.8 Le plug-in Java
  - 3.8.1 Installation du plug-in Java après l'installation de Netscape Communicator
  - 3.8.2 Installation du plug-in Java après l'installation d'IBM Web Browser for OS/2
  - 3.8.3 Le panneau de configuration du plug-in Java
- 3.9 Désactivation du compilateur JIT
- 3.10 Changement de noms de fichier
- 3.11 Configuration du Visualiseur d'applet
- 3.12 Indication d'options et de propriétés système Java
- 3.13 RMI avec IIOP

- 3.13.1 Le compilateur IDL-Java

- 3.13.1.1 Restrictions du compilateur
- 3.13.1.2 Incidents connus avec le compilateur

- 3.13.2 Informations complémentaires
- 3.13.3 Termes RMI-IIOP

- 3.14 Service d'authentification et d'autorisation Java (JAAS)

- 3.14.1 Différence entre la version IBM et la version Sun de JAAS
- 3.14.2 Installation de base

- 3.15 Informations relatives à la programmation JNI
- 3.16 Remarques relatives aux performances
- 4.0 ENSEMBLES DE POLICES SUPPLEMENTAIRES
- 4.1 Installation de polices supplémentaires

- 4.1.1 Installation CID
- 4.1.2 Installation par palette de polices

- 5.0 INFORMATIONS RELATIVES AUX JEUX DE CARACTERES A DEUX OCTETS (DBCS)
- 5.1 Texte des écrans d'installation manquant ou trop long dans les pays DBCS
- 5.2 Les systèmes chinois doivent disposer des polices Truetype
- 5.3 Modifications provisoires de logiciel (PTF) et FixPaks pour les systèmes DBCS
- 5.4 Contrôle de l'affichage des chiffres arabes
- 5.5 Paramètres d'environnement japonais dans la version japonaise d'OS/2 Warp 4
- 5.6 Polices nécessaires sous la version japonaise d'OS/2 Warp
- 5.7 Amélioration de la qualité des polices sous OS/2 Warp Server for e-business
- 6.0 DESINSTALLATION DU KIT DE DEVELOPPEMENT
- 6.1 Depuis le bureau
- 6.2 Depuis l'invite de commande OS/2
- 6.3 Désinstallation du Kit de développement sous WorkSpace On-Demand 2.0
- 6.4 Désinstallation automatique
- 6.5 Retrait du Kit de développement comme JVM par défaut
- 7.0 LIMITATIONS CONNUES
- 8.0 REMARQUES
- 9.0 MARQUES

## 1.0 AVANT L'INSTALLATION

Le Kit de développement est constitué de deux modules : un environnement d'exécution et un Toolkit (module de développement). L'environnement d'exécution comprend des composants tels que le service d'authentification et d'autorisation Java (JAAS), les éléments d'exécution RMI-IIOP et le compilateur JIT (Just-in-Time). Le Toolkit comprend des composants tels que des outils de développement, le débogueur ICAT (Interactive Code Analysis Tool), et des exemples.

Remarque : vous ne pouvez pas installer le Toolkit sans installer le module d'exécution.

Si vous avez téléchargé les fichiers en plusieurs fois, reportez-vous à la section Réassemblage des fichiers découpés pour savoir comment réassembler les fichiers découpés en un fichier installable.

Avant d'installer le Kit de développement, faites une copie de votre fichier CONFIG.SYS, afin de pouvoir revenir à l'environnement initial en cas de problème lors de l'installation.

Les références dans ce guide sont les suivantes :

- OS/2 Warp 4 fait référence au système d'exploitation client OS/2 Warp 4 et au client WorkSpace On-Demand (2.0 ou 3.0).
- OS/2 Warp Server fait référence aux systèmes d'exploitation OS/2 Warp pour e-business et au serveur WorkSpace On-Demand (2.0 ou 3.0).
- Java 1.1.x fait référence à Java 1.1.1 pour OS/2, Java 1.1.4 pour OS/2 Warp, IBM OS/2 Warp Developer Kit, Java Edition, 1.1.6, IBM OS/2 Warp Developer Kit, Java Edition, 1.1.7 et IBM OS/2 Warp Developer Kit, Java Edition, 1.1.8
- Les objets spécifiques de ce produit sont appelés objets Java 1.3.1.
- Netscape Communicator fait référence, sauf indication spécifique, à Communicator version 4.04 et suivante.

### 1.1 Conditions requises pour l'installation

Espace disque nécessaire :

Voici la liste des composants du Kit de développement avec leur taille sur disque après installation. Avant d'effectuer l'installation, assurez-vous d'avoir suffisamment d'espace disque disponible.

Composant | Taille
--- | ---
Environnement d'exécution | 25 Mo
Toolkit | 35 Mo
Exemples | 5 Mo
Débogueur interactif pour Java OS/2 | 13 Mo
Espace total occupé après installation | 65 Mo
Liste des composants du kit de développement avec leur taille sur disque après installation.

Equipement nécessaire :

- Un minimum de 32 Mo de mémoire RAM donne généralement les meilleurs résultats avec les applications du Kit de développement.
- Un minimum de 48 Mo de RAM est recommandé pour les applets s'exécutant dans un navigateur avec le plug-in Java.
- IBM recommande fortement d'utiliser un processeur Intel Pentium (ou comparable) ou postérieur pour tous les systèmes OS/2.
- Le Kit de développement nécessite le mode 256 couleurs (ou plus). Il ne supporte pas les applications et applets Java qui utilisent l'Abstract Window Toolkit (AWT) en mode 16 couleurs.

Logiciels nécessaires :

- Feature Install 1.2.3 ou postérieur. Vous pouvez télécharger la version la plus récente de Feature Install à partir de la page IBM Software Choice Catalog of Features. Avant de la télécharger, vérifiez les conditions requises pour son installation.
- Netscape Communicator version 4.0.4 ou postérieure.
- TCP/IP version 4.3. pour OS/2 ou suivante. Vous pouvez télécharger ce produit à partir du catalogue IBM Software Choice Catalog of Features.

### 1.2 Extraction des fichiers pour l'installation

Pour extraire les fichiers contenus dans un fichier ZIP à auto-extraction, procédez comme suit :

1. Créez un sous-répertoire (si vous ne l'avez pas déjà fait) sur votre disque dur pour le fichier ZIP à auto-extraction.
2. Exécutez le fichier en tapant son nom et en spécifiant l'option "-o", sur une ligne de commande depuis le répertoire dans lequel vous l'avez téléchargé.

   Par exemple, pour le Kit de développement, tapez :

       javaintk.exe -o

   Pour l'environnement d'exécution, tapez :

       javainrt.exe -o

Si vous avez téléchargé des fichiers découpés et que vous devez les réassembler en un fichier installable, reportez-vous à la section Réassemblage des fichiers découpés. L'installation du Kit de développement est traitée dans la section Installation du Kit de développement.

### 1.3 Considérations sur les systèmes de fichiers

Notez les remarques ci-après pour l'installation du Kit de développement :

- Si vous installez le Toolkit, l'environnement d'exécution est automatiquement sélectionné et est installé sur la même unité que le Toolkit.
- Le Toolkit et les exemples doivent être installés sur une unité HPFS ou JFS.
- L'environnement d'exécution et le débogueur ICAT peuvent être installés dans une partition FAT (table d'allocation de fichiers).
- Si vous n'installez pas le Toolkit, vous pouvez installer l'environnement d'exécution dans une partition FAT, HPFS ou JFS. Pour de meilleures performances, installez-les sur une partition HPFS ou JFS, qui prend en charge les noms de fichier longs.

Si vous n'avez qu'un seul disque dur et qu'il est formaté en une seule partition FAT, vous pouvez :

- laisser votre système tel qu'il est et n'installer que le composant d'exécution et, si vous le souhaitez, le composant de débogage ICAT ;
- formater la partition FAT pour HPFS ou JFS et réinstaller tous les logiciels.
- acheter un programme de partitionnement de disque, tel que PartitionMagic ; si vous avez suffisamment d'espace, un tel programme vous permet de réduire la taille de votre partition (unité C) et de créer une nouvelle partition (unité logique D) pouvant être formatée pour HPFS.

Remarque : dans ce document, le terme "partition" désigne indifféremment toute unité physique ou logique.

### 1.4 FixPaks

Notez les remarques ci-après :

Niveau de FixPak système requis pour OS/2 Warp 4
SBCS | DBCS
FixPak 5 ou postérieur | FixPak FX00505
Considérations sur les niveaux FixPak

Pour utiliser l'euro dans les applications et les applets Java
OS/2 Warp 4 | FixPak 6 ou postérieur
Niveaux FixPak pour l'euro

Remarque : l'affichage et la conversion de code de l'euro sont pris en charge avec les pages de codes qui le contiennent.

Pour l'entrée du caractère euro, il faut la version SBCS (jeu de caractères à un octet) d'OS/2. Le clavier international américain, UX103, permet la saisie de ce caractère, mais pas le clavier anglais standard. Dans tous les cas, si votre clavier ne permet pas l'entrée de ce caractère, vous pouvez l'afficher mais vous ne pouvez pas l'entrer.

Pour des informations sur le téléchargement d'un FixPak particulier, visitez le site Web FixPak IBM à l'adresse suivante :
http://ps.software.ibm.com/pbin-usa-ps/getobj.pl?/pdocs-usa/otherservices.html

### 1.5 Installation du Kit de développement comme JVM par défaut

L'installation du Kit de développement comme machine virtuelle Java (JVM) par défaut permet d'exécuter le kit depuis une invite de commande par défaut. Vous pouvez définir le Kit de développement votre JVM par défaut permanente ou temporaire. Pour plus d'informations, reportez-vous aux sections qui suivent.

#### Définition permanente du Kit de développement comme JVM par défaut

Pour définir le Kit de développement comme JVM par défaut permanente, vous pouvez :

- le sélectionner lors de l'installation par interface graphique,
- apporter cette modification manuellement, si vous avez déjà installé le Kit de développement (version 1.3), en modifiant l'instruction PATH dans le fichier CONFIG.SYS file.

La modification consiste à ajouter x:\JAVA131\JRE\BIN; à l'instruction PATH.

Si vous décidez de conserver une version précédente de Java comme JVM par défaut, ne cochez pas la case lors de l'installation par interface graphique ou, si le Kit de développement est déjà installé, n'ajoutez pas x:\JAVA131\JRE\BIN; à l'instruction PATH dans votre fichier CONFIG.SYS. Si vous avez déjà une version 1.1.x de Java installée comme JVM par défaut, elle restera la JVM par défaut.

Remarque : vous pouvez améliorer les performances en supprimant les références aux versions antérieures de Java dans le fichier CONFIG.SYS. Cependant, certaines applications ne fonctionnent pas correctement si le kit de développement est installé (version 1.3.x) comme JVM par défaut.

#### Utilisation temporaire du Kit de développement dans une session Java

Si le Kit de développement n'est pas installé comme JVM par défaut et que vous souhaitez l'utiliser dans une session Java, modifiez l'instruction PATH. Par exemple,

         SET PATH=x:\JAVA131\JRE\BIN;%PATH%

où x représente l'unité sur laquelle vous avez installé le kit de développement.

Vous pouvez améliorer les performances en modifiant les instructions BEGINLIBPATH et CLASSPATH de la manière suivante :

         SET BEGINLIBPATH=x:\JAVA131\JRE\BIN;x:\JAVA131\JRE\DLL;%beginlibpath%

         SET CLASSPATH=

Remarque : l'instruction CLASSPATH possède une valeur null car la JVM du kit de développement ne l'utilise pas rechercher les fichiers de classe du système ; elle est utilisée pour les fichiers de classe d'application.

#### Utilisation temporaire d'une JVM Java 1.1.x dans une session Java

Si le Kit de développement est installé comme JVM par défaut et que vous souhaitez utiliser une JVM Java 1.1.x dans une session Java, modifiez l'instruction PATH. Par exemple,

        SET PATH=x:\JAVA11\BIN;%PATH%

où x représente l'unité sur laquelle vous avez installé le Kit de développement 1.1.x.

Si vous avez supprimé les références JAVA11 du fichier CONFIG.SYS, vous devez modifier les instructions PATH, BEGINLIBPATH et CLASSPATH de la manière suivante :

        SET PATH=x:\JAVA11\BIN;%PATH%

        SET BEGINLIBPATH=x:\JAVA11\BIN;x:\JAVA11\DLL;%beginlibpath%

        SET CLASSPATH=x:\JAVA11\LIB\CLASSES.ZIP;x:\JAVA11\SWING\SWINGALL.JAR;\;

Remarque : CLASSPATH a pour valeur les fichiers de bibliothèque Java 1.1.x. Cette valeur peut varier d'un système à l'autre.

Pour que le kit de développement et le plug-in Java soient exécutés, vous devez modifier l'instruction PATH comme indiqué ci-dessus.

#### Informations relatives à 1.5.1 JAVA_HOME Environment Variable

Si vous avez installé le kit de développement (version 1.3) comme machine JVM et que :

- vous avez ajouté manuellement une variable d'environnement JAVA_HOME à votre fichier CONFIG.SYS pour une version précédente du kit de développement ;
- vous disposez de fichiers de commandes qui définissent la variable d'environnement JAVA_HOME :

Vous devez :

- supprimer ou mettre à jour la variable d'environnement JAVA_HOME dans le fichier CONFIG.SYS ;
- modifier les fichiers de commandes en supprimant ou modifiant les instructions qui définissent la variable d'environnement JAVA_HOME.

### 1.6 Informations relatives à Netscape Communicator

La liste ci-après fournit des informations relatives à l'utilisation du Kit de développement et de Netscape Communicator version 4.04 ou postérieure :

- #### Netscape Communicator en fonctionnement lors de l'installation du Kit de développement

  Vous ne pouvez pas installer le kit si Netscape Communicator est en fonctionnement lorsque vous exécutez la commande INSTALL. Vous devez fermer Netscape Communicator avant d'exécuter cette commande.

- #### Netscape Communicator version 4.04 et le compilateur JIT

  Pour l'exécution d'applets avec Netscape Communicator 4.04, le compilateur JIT (Just-in-Time) doit être activé. Toutefois, si vous voulez que le compilateur JIT soit désactivé tout en utilisant Netscape Communicator version 4.04, vous devez être équipé de la dernière actualisation de Netscape Communicator version 4.04. Pour obtenir des informations sur la dernière mise à jour, visitez le site Web suivant :

  http://ps.software.ibm.com

- #### Cases à cocher d'installation fantômes et Netscape Communicator 4.61

  Si vous êtes équipé de Netscape Communicator version 4.61 et que vous n'avez pas téléchargé la dernière mise à jour, il est possible que des cases à cocher "fantômes" apparaissent pendant l'installation. Bien que ces cases à cocher n'affectent pas l'installation du Kit de développement, vous pouvez y remédier en téléchargeant la dernière mise à jour depuis le site Web suivant :
  http://ps.software.ibm.com

- Si, après avoir installé le kit de développement, vous supprimez les entrées JAVA11 du fichier CONFIG.SYS ou supprimez de votre système la version 1.1.x du kit de développement, vous ne pouvez pas exécuter d'applets dont les pages HTML comportent la balise <APPLET>, si elles sont lancées à partir d'un navigateur Netscape 4.x.Pour exécuter ces applets à partir d'un navigateur Netscape 4.x, vous devez installer le plug-in Java du kit de développement, puis convertir le fichier HTML de l'applet de façon à ce qu'il puisse utilis er le plug-in Javaa. Les applets lancées à partir d'IBM Web Browser for OS/2 fonctionnent telles quelles, même si la JVM Java 1.1.x n'est pas installée sur le système.

### 1.7 Réassemblage des fichiers découpés

Vous pouvez réassembler les fichiers découpés avec l'utilitaire de fusion ou manuellement depuis l'invite de commande. Les sous-sections qui suivent vous expliquent comment procéder.

Avant de commencer, assurez-vous :

- Que vous avez téléchargé tous les morceaux du composant concerné et indiqué le bon nom de fichier. Si vous n'avez pas téléchargé tous les morceaux du composant ou que vous avez changé leur nom lors du téléchargement, l'utilitaire de fusion affiche un message d'erreur et ne reconstitue pas le composant.
- Que vous avez indiqué tous les noms de fichier et que vous les avez placés dans le bon ordre. Si vous avez changé les noms de fichier lors du téléchargement, vous devez indiquer les noms que vous avez utilisés.
- Que le nom de fichier cible que vous avez indiqué est bien le nom de fichier complet du composant initial (par exemple, le nom de fichier complet du composant d'exécution est javainrt.exe). Ce nom doit être respecté pour que l'utilitaire d'installation reconnaisse le fichier.

#### Réassemblage des fichiers découpés avec l'utilitaire de fusion

Avant de réassembler les fichiers découpés, vous devez télécharger l'utilitaire d'assemblage et le placer dans le même répertoire que les fichiers. (fichier joiner.exe). L'utilitaire d'assemblage contient l'utilitaire Merge (fusion), qui permet d'assembler les fichiers découpés en un fichier installable. L'utilitaire d'assemblage peut être téléchargé depuis la même page que les composants du kit de développement dans le Software Choice Catalog of Features.

Tapez `joiner` sur la ligne de commande depuis le répertoire dans lequel vous avez téléchargé l'utilitaire d'assemblage. Cette commande extrait l'utilitaire de fusion (merge.exe) et les fichiers de données dont il a besoin. L'utilitaire de fusion permet de réunir les fichiers découpés.

Tapez `merge` sur la ligne de commande depuis le répertoire dans lequel vous avez téléchargé l'utilitaire d'assemblage. Cela reconstitue les modules scindés en plusieurs fichiers. Pour installer le fichier, lisez la section Installation du Kit de développement

#### Réassemblage manuel des fichiers découpés depuis l'invite de commande

1. Vérifiez que vous avez bien téléchargé dans le même répertoire tous les fichiers découpés du composant que vous voulez installer.
2. Sur la ligne de commande, depuis le répertoire dans lequel vous avez téléchargé les fichiers découpés, tapez leur nom et le nom de fichier complet du composant. Par exemple, pour réassembler les fichiers découpés dans l'environnement d'exécution, entrez la commande suivante :

         copy /b javainrt.ex1 + javainrt.ex2 + javainrt.ex3 + javainrt.ex4 javainrt.exe

Cela reconstitue les modules scindés en plusieurs fichiers. Pour installer le fichier, lisez la section Installation du Kit de développement

## 2.0 INSTALLATION DU KIT DE DEVELOPPEMENT

Les sections qui suivent fournissent des instructions et des informations pour l'installation du Kit de développement. Avant d'installer le kit ou les composants associés, lisez la section Avant l'installation, qui explique comment extraire les fichiers et indique les conditions requises pour l'installation.

### 2.1 Installation par interface graphique

Vous pouvez installer le Kit de développement depuis le bureau ou depuis l'invite de commande. Pour les instructions, reportez-vous aux sections qui suivent.

#### 2.1.1 Depuis le bureau

Remarque : si Netscape Communicator est en fonctionnement lors de l'installation du Kit de développement, celle-ci échoue. Vous devez arrêter Netscape Communicator avant de commencer l'installation.

Pour effectuer l'installation avec l'objet INSTALL.EXE, procédez comme suit :

1. Ouvrez le dossier OS/2.
2. Ouvrez l'objet Unités.
3. Ouvrez l'unité sur laquelle se trouve les fichiers du kit qui ont été extraits.
4. Ouvrez le dossier dans lequel se trouvent les fichiers du kit qui ont été extraits.
5. Cliquez deux fois sur l'objet INSTALL.EXE pour lancer le programme d'installation.

La commande INSTALL.EXE affiche une interface graphique avec des boutons indiquant les langues dans lesquelles installer le programme. Cliquez sur la langue de votre choix. Le programme d'installation vous fait alors suivre les étapes d'installation.

Un dossier Developer Kit for OS/2 est créé dans le dossier Programmes sous OS/2 Warp 4 et sur le bureau de toutes les autres plateformes prises en charge.

Une fois l'installation terminée, si vous souhaitez nettoyer le répertoire dans lequel se trouvent les fichiers du Kit de développement qui ont été extraits, sélectionnez l'objet DELINST.CMD dans le dossier Developer Kit. Cela supprime de ce répertoire les fichiers et les sous-répertoires du kit. Les fichiers et sous-répertoires qui ne proviennent pas du kit ne sont pas supprimés. Vous pouvez aussi supprimer manuellement les fichiers que vous avez téléchargés.

#### 2.1.2 Depuis la ligne de commande

Remarque : si Netscape Communicator est en fonctionnement lors de l'installation du Kit de développement, celle-ci échoue. Vous devez arrêter Netscape Communicator avant de commencer l'installation.

Pour lancer l'installation, placez-vous dans le répertoire dans lequel se trouvent les fichiers du Kit de développement qui ont été extraits, puis, sur la ligne de commande OS/2, tapez :

         INSTALL

La commande d'installation affiche une interface graphique avec des boutons indiquant les langues dans lesquelles le programme peut être installé. Cliquez sur la langue de votre choix, Le programme d'installation vous fait alors suivre les étapes d'installation.

Un dossier Developer Kit for OS/2 est créé dans le dossier Programmes sous OS/2 Warp 4 et sur le bureau de toutes les autres plateformes prises en charge.

Une fois l'installation terminée, si vous souhaitez nettoyer le répertoire dans lequel se trouvent les fichiers du Kit de développement qui ont été extraits, sélectionnez l'objet DELINST.CMD dans le dossier Developer Kit. Cela supprime de ce répertoire les fichiers et les sous-répertoires du kit. Les fichiers et sous-répertoires qui ne proviennent pas du kit ne sont pas supprimés. Vous pouvez aussi supprimer manuellement les fichiers que vous avez téléchargés.

#### 2.1.3 Composants non sélectionnables lors de l'installation

Si vous effectuez l'installation du Kit de développement avec l'interface graphique et qu'un composant n'est pas sélectionnable, il se peut que vous n'ayez pas téléchargé le fichier ZIP contenant ce composant et extrait son contenu. Retournez à la page Software Choice Catalog of Features et téléchargez le fichier ZIP à auto-extraction dont vous avez besoin.

Tous les composants du Kit de développement nécessitent que vous téléchargiez et installiez le composant environnement d'exécution (ou qu'il soit déjà installé), et que vous redémarriez le système.

#### 2.1.4 Nettoyage après un échec d'installation

Si l'installation du Kit de développement échoue, regardez si elle a laissé des objets et, le cas échéant, supprimez-les. Si vous ne supprimez pas ces objets d'installation, les installations suivantes risquent d'échouer, avec un message indiquant qu'un ou plusieurs composants n'ont pas été installés car l'objet est en lecture seulement ou utilisé par un autre processus.

Pour une installation CID (Configuration, installation et distribution), l'icône de l'objet d'installation est un rectangle bleu avec un ruban rouge et elle se trouve dans le bureau. Pour une installation effectuée par un opérateur, l'objet se trouve dans le dossier x:\os2\install\ (où x est l'unité d'amorçage). Pour supprimer l'objet, cliquez dessus avec le bouton droit de la souris, puis cliquez sur Suppression dans le menu.

Vous pouvez aussi accéder au répertoire contenant l'objet et supprimer toute l'arborescence. Le répertoire s'appelle "Install object" ou "Java 1.3 for OS/2", suivant le moment de l'échec de l'installation.

Après avoir supprimé l'objet d'installation, arrêtez le système et redémarrez-le.

#### Impossible de supprimer l'objet d'installation ?

Si vous suivez les instructions précédentes mais que cela ne supprime pas l'objet d'installation, procédez comme suit :

1. Accédez à une invite de commande OS/2.
2. Passez sur l'unité d'amorçage, puis dans le répertoire os2\install.
3. Supprimez le répertoire Java 1.3.1 for OS/2 et tous ses sous-répertoires.
4. Redémarrez le système.

#### 2.1.5 Niveau de FixPak correct mais installation impossible

Si vous êtes certain que votre système satisfait aux niveaux de FixPak requis et que vous ne parvenez pas à effectuer l'installation à cause du contrôle de FixPak automatisé, vous pouvez désactiver ce contrôle. Pour cela, utilisez l'une ou l'autre des méthodes ci-après :

Méthode un :

1. Ajoutez dans votre fichier CONFIG.SYS l'instruction JAVANOFPK=YES.
2. Redémarrez le système et effectuez à nouveau l'installation du Kit de développement.

Méthode deux :

1. Placez-vous dans le répertoire dans lequel vous avez exécuté les fichiers à auto-extraction, puis dans celui correspondant à la langue dans laquelle vous souhaitez installer le produit.
2. Ouvrez dans un éditeur le fichier CHECK.CMD. Recherchez l'instruction suivante :

            disablecheck="NO"

   Remplacez "NO" par "YES" (cette instruction se trouve à ou vers la ligne 12).
3. Revenez dans le répertoire dans lequel vous avez exécuté les fichiers à auto-extraction et exécutez-les à nouveau.

### 2.2 Méthode d'installation automatique (CID)

Les installations automatiques ou CID (configuration, installation et distribution) du Kit de développement sont traitées par une interface ligne de commande avec Feature Install (CLIFI) et peuvent prendre 15 à 20 minutes ou plus. Une fois l'exécution du programme d'installation terminée, il faut redémarrer le système pour achever l'installation.

CLIFI nécessite deux fichiers de réponses : le fichier de réponses du Kit de développement (JAVA131.RSP) et un fichier de réponses dans lequel les utilisateurs peuvent ignorer les sélections par défaut. Le package d'installation comprend un exemple de fichier de réponses personnalisé, CID.RSP ; pour une installation automatique, vous devez modifier ce fichier et le fichier CID.CMD.

Remarque : pour les installations automatiques (CID), il faut Feature Install version 1.2.3 ou suivante. Par ailleurs, si Netscape Communicator est en fonctionnement lors de l'installation du Kit de développement, celle-ci échoue. Vous devez arrêter Netscape Communicator avant de commencer l'installation.

#### 2.2.1 Modification du fichier de réponses CID

Lorsque c'est approprié, le fichier CID.RSP contient des variables qui permettent d'indiquer les composants à installer, l'unité et le répertoire cible. Par défaut, ce fichier est configuré pour installer tous les composants du Kit de développement. Vous pouvez le modifier en indiquant ceux que vous souhaitez installer. Veillez à bien télécharger tous les fichiers dont vous avez besoin et en extraire le contenu avant de lancer l'installation. Par ailleurs, si vous installez le Toolkit, installez aussi le module environnement d'exécution, même s'il est déjà installé.

Le tableau ci-après fournit la liste des composants sélectionnables et indique le nom des variables associées :

Composant | Variable
Environnement d'exécution | JV13Runtime
Toolkit | JV13Toolkit
Exemples | JV13Samples
Débogueur interactif OS/2 pour Java | JV13Debugger
Liste des composants sélectionnables et nom des variables

Dans le fichier CID.RSP, indiquez "selection=1" pour chaque composant que vous souhaitez installer, et "selection=0" pour chacun des autres composants. Par exemple, pour :

- installer le composant environnement d'exécution et le composant débogueur ICAT OS/2,
- configurer le plug-in Java pour Netscape 4.x,
- configurer le plug-in Java pour IBM Web Browser for OS/2,
- installer le Kit de développement comme JVM par défaut,
- mais ne pas installer le composant Toolkit ni le composant d'exemples,

définissez les variables suivantes comme indiqué :

         Java13.Continue=UNATTENDED

         Java13.LicenseAgree=AGREE

         JV13Runtime.Selection=1

         JV13RuntimeConfig.Selection=1

         JV13RuntimeUrls.Selection=1

         JV13NSFiles.Selection=1

         JV13MZFiles.Selection=1

         Java13.RUNDRV=x:

         JV13DefaultJVM.Selection=1

         JV13Samples.Selection=0

         JV13SamplesConfig.Selection=0

         JV13Samplesurls.Selection=0

         JV13Samples.SMPDRV=x:

         JV13Toolkit.Selection=0

         JV13ToolkitConfig.Selection=0

         JV13Debugger.Selection=1

         JV13Debuggerurls.Selection=1

         JV13Debugger.DBGDRV=x:

Ceci n'est qu'un exemple. Reportez-vous au fichier CID.RSP pour les différents composants et leur variable associée. x représente l'unité sur laquelle le composant est installé.

A chaque variable JV13xx.Selection est associée une variable JV13xx.ConfigSelection. La variable JV13xxConfig.Selection doit être définie avec la même valeur que la variable JV13xx.Selection. Par exemple, si vous indiquez JV13Toolkit.Selection=0, vous devez également indiquer JV13ToolkitConfig.Selection=0 (où xx est le nom du composant).

Dans l'exemple ci-dessus, plusieurs variables doivent être définies pour que le Kit de développement s'installe correctement. Ces variables sont les suivantes :

JV13.LicenseAgree | Contrat de licence Les valeurs de cette variable sont DISAGREE et AGREE. Donnez à cette variable la valeur AGREE pour indiquer que vous avez lu le contrat de licence et que vous en acceptez les termes. Si vous ne remplacez pas la valeur de cette variable par AGREE, le Kit de développement ne s'installera pas.
JV13DefaultJVM.Selection | JVM Donnez à cette variable la valeur "1" si vous souhaitez installer le kit comme JVM par défaut.
JV13MZFiles | Plug-in pour IBM Web Browser for OS/2 Donnez à cette variable la valeur "1" si vous souhaitez configurer le plug-in pour IBM Web Browser for OS/2.
JV13NSFiles | Plug-in Netscape Donnez à cette variable la valeur "1" si vous souhaitez configurer le plug-in Netscape.

Si vous souhaitez supprimer les fenêtres de confirmation du processus d'installation, définissez la variable ci-après comme indiqué :

        java13.continue=UNATTENDED

##### 2.2.1.1 Unité d'installation des composants

Le Toolkit est installé dans le répertoire \JAVA131 de l'unité cible et l'environnement d'exécution est installé automatiquement sur la même unité. Ce dernier est nécessaire pour le Toolkit, les exemples et le débogueur.

L'unité cible pour les exemples et le débogueur se définit en donnant à l'unité la valeur voulue. Si le Kit de développement est déjà présent sur l'unité cible, le programme d'installation le remplace.

#### 2.2.2 Lancement de l'installation automatique

Le fichier CID.CMD contient un exemple de commande CLIFI d'installation CID. Le processus d'installation a été modifié pour inclure une installation multilingue ; par conséquent, vous devez indiquer votre variable de langue dans les fichiers CID.RSP. Les variables de langue sont les suivantes :

Langue | Variable de langue
Anglais | en
Français | fr
Allemand | de
Italien | it
Japonais | jp
Portugais, version brésilienne | br
Chinois simplifié | cn
Espagnol | es
Chinois traditionnel | tw
Langue et variable de langue qui lui est associée

La commande CLIFI peut également être entrée en une seule ligne sur une ligne de commande OS/2, comme indiqué ci-après :

         clifi /a:c /r2:cid.rsp /r:xx\JAVA131.rsp /b:c: /s:d:\tmp\xx

         /l1:ciderr.log /l2:cidhist.log

Utilisez la liste ci-après comme référence pour définir les variables dans les fichiers mentionnés ci-dessus.

Où :

/r2 | représente l'unité, le chemin et le nom du fichier de réponses utilisateur.
/r | indique l'emplacement complet du fichier de réponses Feature Install.
xx | indique la variable de langue voulue.
/b | indique l'unité d'amorçage.
/s | indique l'emplacement complet des fichiers du Kit de développement qui ont été extraits.
/l1 et /l2 | indiquent l'emplacement complet des fichiers journaux facultatifs. Consultez ces fichiers, en plus du fichier \os2\install\wpinstal.log sur l'unité d'amorçage, en cas de problèmes au cours de l'installation.

Si vous souhaitez supprimer les fenêtres de confirmation du processus d'installation, définissez la variable ci-après comme indiqué :

        java13.continue=UNATTENDED

#### 2.2.3 Code retour de CID "opération réussie" et échec de l'installation

Si vous obtenez un code retour de CID "opération réussie" à l'issue de l'installation du Kit de développement et que l'installation a en fait échoué, la raison peut en être :

- Vous n'avez pas indiqué "AGREE" pour la variable Java13LicenseAgree dans votre fichier de réponses.
- Le niveau de FixPak correct n'est pas présent sur votre système.

Il est recommandé que les administrateurs CID effectuent un contrôle de FixPak pour s'assurer que le niveau de FixPak correct est disponible (pour plus d'informations, voir la section FixPaks). Vous pouvez utiliser comme exemple le fichier check.cmd qui se trouve dans le répertoire x:\Java131 pour écrire un script de contrôle des niveaux de FixPak. (x:\ étant l'unité sur laquelle le Kit de développement est installé).

#### 2.2.4 Niveau de FixPak correct mais impossible d'effectuer l'installation

Si vous êtes certain que votre système satisfait aux niveaux de FixPak requis et que vous ne parvenez pas à effectuer l'installation à cause du contrôle de FixPak automatisé, vous pouvez désactiver ce contrôle. Pour cela, utilisez l'une ou l'autre des méthodes ci-après :

Méthode un :

1. Ajoutez dans votre fichier CONFIG.SYS l'instruction JAVANOFPK=YES.
2. Redémarrez le système et effectuez à nouveau l'installation du Kit de développement.

Méthode deux :

1. Placez-vous dans le répertoire dans lequel vous avez exécuté les fichiers à auto-extraction, puis dans celui correspondant à la langue voulue.
2. Ouvrez dans un éditeur le fichier CHECK.CMD. Recherchez l'instruction suivante :

            disablecheck="NO"

   Remplacez "NO" par "YES" (cette instruction se trouve à ou vers la ligne 12).
3. Exécutez à nouveau le processus CID.

### 2.3 Considérations sur l'installation de NVDM/2

L'installation CID NetView Distribution Manager/2 (NVDM/2) requiert la création d'un profil puis la construction et le catalogage d'un fichier de changement. Le profil NVDM/2 permet de n'indiquer qu'un seul fichier de réponses ; toutefois, l'installation automatique du Kit de développement en requiert deux. Par ailleurs, le traitement des variables et des arguments dans NVDM/2 est différent de celui utilisé dans Feature Install, qui est utilisé pour l'installation du kit.

Remarque : si Netscape Communicator est en fonctionnement lors de l'installation du Kit de développement, celle-ci échoue. Vous devez arrêter Netscape Communicator avant de commencer l'installation.

La section qui suit fournit deux méthodes pouvant être utilisées pour l'installation du Kit de développement avec NVDM/2.

#### 2.3.1 Commande statique dans le profil NVDM/2

Dans le profil NVDM/2, indiquez toutes les options CLIFI dans la variable PARMS. Les paramètres doivent être sur une seule ligne et délimités par des guillemets :

         Program=c:\os2\install\clifi.exe

         Parms="/a:c /r2:cid.rsp /r:\xx\JAVA131.rsp /b:c: /s:d:\tmp\xx

         /l1:ciderr.log /l2:cidhist.log"

Cette méthode nécessite que vous modifiiez le profil lorsque le répertoire source ou le nom des fichiers journaux changent. Vous pouvez aussi remplacer ces valeurs par des valeurs de variable spécifiques au poste de travail, comme indiqué ci-après :

         Program=c:\os2\install\clifi.exe

         Parms="/a:c /r2:$(FichRéponse) /r:$(RépSource)\xx\JAVA131.rsp

         /b:c: /s:$(RépSource\xx) /l1:$(FichJournal1) /l2:$(FichJournal2)"

         FichRéponses=$(NomPosteTrav).rsp

         RépSource=d:\tmp

         FichJournal1=$(NomPosteTrav).log

         FichJournal2=$(NomPosteTrav).lg2

Cette seconde méthode requiert un fichier de réponses distinct pour chaque poste de travail et nécessite que NomPosteTrav soit définie de façon appropriée.

Utilisez la liste ci-après comme référence pour définir les variables dans les fichiers mentionnés ci-dessus.

Où :

d: | indique le répertoire temporaire.
/r | indique l'emplacement complet du fichier de réponses Feature Install.
xx | indique la variable de langue voulue.
/b | indique l'unité d'amorçage.
/s | indique l'emplacement complet des fichiers du Kit de développement qui ont été extraits.
/l1 et /l2 | indiquent l'emplacement complet des fichiers journaux facultatifs. Consultez ces fichiers, en plus du fichier \os2\install\wpinstal.log sur l'unité d'amorçage, en cas de problèmes au cours de l'installation.

### 2.4 Installation du Kit de développement sous WorkSpace On-Demand 2.0

Remarque : si Netscape Communicator est en fonctionnement lors de l'installation du Kit de développement, celle-ci échoue. Vous devez arrêter Netscape Communicator avant de commencer l'installation.

Le produit WorkSpace On-Demand 2.0 comprend Java 1.1.6 pour OS/2 Warp. Vous pouvez installer le kit de développement (version 1.3) sur les serveurs et clients Workspace On-Demand. Il coexiste avec Java 1.1.x pour OS/2 Warp. Les sections qui suivent expliquent comment installer le Kit de développement sur les serveurs et les clients WorkSpace On-Demand et fournissent des informations sur l'installation du kit comme JVM par défaut.

#### 2.4.1 Installation du Kit de développement sur un serveur WorkSpace On-Demand 2.0

Pour installer le Kit de développement sur un serveur WorkSpace On-Demand, utilisez l'interface graphique. Pour les instructions, reportez-vous à la section Installation par interface graphique de ce guide.

#### 2.4.2 Installation du Kit de développement sur un client WorkSpace On-Demand 2.0

Pour installer le Kit de développement sur un client WorkSpace On-Demand, utilisez l'installation automatique (CID). Vous pouvez suivre les instructions de la section Installation automatique (CID) et utiliser les fichiers CID.CMD et WSOD2.RSP inclus dans le package d'installation du Kit de développement. Les étapes d'installation s'effectuent sur un serveur Workspace On-Demand 2.0.

Remarque : si vous voulez installer le Kit de développement comme JVM par défaut sur des clientsWorkSpace On-Demand, vérifiez que les références aux répertoires et fichiers `z:\JAVA131` sont placées avant les références `z:\JAVA11` dans le fichier CONFIG.SYS.

##### 2.4.2.1 Installation automatique pour un client WorkSpace On-Demand 2.0

Effectuez les étapes suivantes :

1. Dans le fichier CID.CMD, remplacez `/r2:cid.rsp` par `/r2:wsod2.rsp` (`/r2` étant l'unité, le chemin et le nom du fichier de réponses utilisateur).
2. Comme expliqué dans la section Lancement de l'installation automatique de ce guide :
   - Remplacez `/s:d:\tmp\xx` dans le fichier CID.CMD par l'unité et le répertoire dans lequel vous avez dézippé le package d'installation, (où `xx` indique la variable de langue voulue).
   - Veillez à ce que `/b:z` dans le fichier CID.CMD pointe sur l'unité d'amorçage du client.
3. Vérifiez que les sélections dans les fichiers WSOD2.RSP correspondent bien à ce que vous souhaitez installer. Par défaut, seul le composant d'exécution est sélectionné. Veillez à bien télécharger tous les fichiers dont vous avez besoin et en extraire le contenu. Par ailleurs, une fois que vous avez lu le contrat de licence et accepté les termes, vous devez donner à la variable de sélection Java13.LicenseAgree la valeur AGREE dans le fichier WSOD2.RSP. Si vous ne remplacez pas la valeur de cette variable par AGREE, l'environnement d'exécution ne sera pas installé.
4. Exécutez le fichier CID.CMD mis à jour en entrant son nom sur une ligne de commande.

Pour achever l'installation automatique, voyez les sections qui suivent.

##### 2.4.2.2 Modification des fichiers CONFIG.SYS pour les clients WorkSpace On-Demand 2.0

Pour permettre l'utilisation de l'environnement d'exécution du Kit de développement, l'administrateur WorkSpace On-Demand doit effectuer les ajouts ci-après dans le fichier CONFIG.SYS des clients.

Ajoutez les éléments suivants :

`z:\JAVA131\jre\dll` | à l'instruction LIBPATH, et
`z:\JAVA131\jre\bin;` | à l'instruction SET PATH

Pour modifier le fichier CONFIG.SYS des clients WorkSpace On-Demand, vous pouvez procéder de deux façons différentes :

- Depuis le serveur pour un utilisateur donné, le fichier CONFIG.SYS se trouve dans l'unité et le répertoire suivants :

         [unitérpl]:\ibmlan\rpl\machines\[nom client]\config.sys

- Pour modifier le CONFIG.SYS par défaut de chaque machine créée avec la classe de machine individuelle, le fichier à modifier se trouve à l'emplacement (unité et répertoire) suivants :

         [unitérpl]:\ibmlan\rpl\machines\BB20.xx\[classe machine]\config.sys

Où :

[unitérpl] | est l'unité sur laquelle est installé le répertoire RPL,
[nom_client] | indique le nom du client WorkSpace On-Demand.
xx | indique le code de pays ou de région.
[classe_machine] | est le nom de la machine.

##### 2.4.2.3 Modification des fichiers FIT et octroi d'accès aux clients WorkSpace On-Demand 2.0

Pour permettre l'utilisation de l'environnement d'exécution, l'administrateur WorkSpace On-Demand doit effectuer l'ajout ci-après dans les fichiers FIT (File Index Table) des clients WorkSpace On-Demand :

Ajoutez l'élément suivant :

         z:\JAVA131      BB20.xx\JAVA131

Pour modifier les fichiers FIT des clients WorkSpace On-Demand, vous pouvez procéder de deux façons différentes :

- Depuis le serveur pour un utilisateur donné, le fichier [nom_client].FIT se trouve à l'emplacement (unité et répertoire) suivant :

         [unitérpl]:\ibmlan\rpl\fits\[nom_client].FIT

- Pour modifier le FIT par défaut, le fichier à modifier est DFBB20xx.FIT à l'emplacement (unité et répertoire) suivant :

         [unitérpl]:\ibmlan\rpl\fits\DFBB20xx.FIT

Il faut également que l'administrateur WorkSpace On-Demand donne aux clients WorkSpace On-Demand l'accès en lecture et en exécution au répertoire JAVA131.

Exécutez les commandes LAN Server suivantes :

      NET ACCESS [unitérpl]\ibmlan\rpl\bb20.xx\JAVA131 /ADD RPLGROUP:RX

      NET ACCESS [unitérpl]\ibmlan\rpl\bb20.xx\JAVA131 /APPLY

Où :

[unitérpl] | est l'unité sur laquelle est installé le répertoire RPL,
[nom_client] | indique le nom du client WorkSpace On-Demand.
xx | indique le code de pays ou de région.

##### 2.4.2.4 Attribution d'un répertoire USER_HOME aux clients WorkSpace On-Demand 2.0

Le répertoire USER_HOME doit disposer de droits d'accès en lecture/écriture : c'est à cet emplacement que les certificats de sécurité et les fichiers de propriétés du plug-in sont créés et consultés. Par exemple, pour définir `z:\JAVA13_RW` comme répertoire USER_HOME et attribuer à ce répertoire des droits d'accès en lecture/écriture, ajoutez la ligne suivante au fichier FIT (cette syntaxe doit tenir sur une ligne) :

         z:\JAVA13_RW      \\nom_serveur\WRKFILES\nom_client\JAVA_RW

Remplacez les noms du serveur et du client WorkSpace On-Demand par nom_serveur et nom_client. z est l'unité sur laquelle est installé l'environnement d'exécution. Ces lignes peuvent aussi être placées dans le fichier FIT par défaut.

De plus, l'administrateur WorkSpace On-Demand doit effectuer l'ajout ci-après dans le fichier OS2.INI des clients WorkSpace On-Demand. L'ajout doit être terminé par le caractère NULL.

Ajoutez les éléments suivants :

         Application = Java131

         Key = USER_HOME

         Value = z:\JAVA13_RW

Pour savoir comment ajouter des entrées de fichier INI pour les clients WorkSpace On-Demand à l'aide d'un éditeur d'INI ou de la commande NET APPPARM, reportez-vous au WorkSpace On-Demand Handbook 2.0. Pour modifier le fichier OS2.INI des clients WorkSpace On-Demand, vous pouvez procéder de deux façons différentes :

- A partir du serveur pour un utilisateur spécifique :

           [unitérpl]:\ibmlan\rpluser\[nom client]\os2\os2.ini

- Pour modifier l'OS2.INI par défaut de chaque machine créée avec la classe de machine individuelle, le fichier à modifier se trouve à l'emplacement (unité et répertoire) suivant :

           [unitérpl]:\ibmlan\rpl\machines\BB20.xx\[classe machine]\os2\os2.ini

Où :

z | est l'unité sur laquelle l'environnement d'exécution est installé pour le client.
[unitérpl] | est l'unité sur laquelle est installé le répertoire RPL,
[nom_client] | indique le nom du client WorkSpace On-Demand.
xx | indique le code de pays ou de région.
[classe machine] | indique le nom de la classe de machine utilisée par un client WorkSpace On-Demand.

##### 2.4.2.5 Activation des polices pour les clients WorkSpace On-Demand 2.0

Pour activer les polices pour l'environnement d'exécution, l'administrateur WorkSpace On-Demand doit effectuer les ajouts ci-après dans le fichier OS2.INI des clients WorkSpace On-Demand. Tous les ajouts sont terminés par le caractère NULL. z représente l'unité sur laquelle l'environnement d'exécution est installé pour le client.

Ajoutez les éléments suivants :

       Application = PM_Fonts

      Key = courtbi_.ttf

      Value = z:\JAVA131\jre\lib\fonts\COURTBI_.TTF

      Application = PM_Fonts

      Key = courtb_.ttf

      Value = z:\JAVA131\jre\lib\fonts\COURTB_.TTF

      Application = PM_Fonts

      Key = courti_.ttf

      Value = z:\JAVA131\jre\lib\fonts\COURTI_.TTF

      Application = PM_Fonts

      Key = court_.ttf

      Value = z:\JAVA131\jre\lib\fonts\COURT_.TTF

      Application = PM_Fonts

      Key = lucb.ttf

      Value = z:\JAVA131\jre\lib\fonts\LUCB.TTF

      Application = PM_Fonts

      Key = lucbb.ttf

      Value = z:\JAVA131\jre\lib\fonts\LUCBB.TTF

      Application = PM_Fonts

      Key = lucbbi.ttf

      Value = z:\JAVA131\jre\lib\fonts\LUCBBI.TTF

      Application = PM_Fonts

      Key = lucbi.ttf

      Value = z:\JAVA131\jre\lib\fonts\LUCBI.TTF

      Application = PM_Fonts

      Key = lucs.ttf

      Value = z:\JAVA131\jre\lib\fonts\LUCS.TTF

      Application = PM_Fonts

      Key = lucsb.ttf

      Value = z:\JAVA131\jre\lib\fonts\LUCSB.TTF

      Application = PM_Fonts

      Key = lucsbi.ttf

      Value = z:\JAVA131\jre\lib\fonts\LUCSBI.TTF

      Application = PM_Fonts

      Key = lucsi.ttf

      Value = z:\JAVA131\jre\lib\fonts\LUCSI.TTF

      Application = PM_Fonts

      Key = luct.ttf

      Value = z:\JAVA131\jre\lib\fonts\LUCT.TTF

      Application = PM_Fonts

      Key = luctb.ttf

      Value = z:\JAVA131\jre\lib\fonts\LUCTB.TTF

      Application = PM_Fonts

      Key = luctbi.ttf

      Value = z:\JAVA131\jre\lib\fonts\LUCTBI.TTF

      Application = PM_Fonts

      Key = lucti.ttf

      Value = z:\JAVA131\jre\lib\fonts\LUCTI.TTF

      Application = PM_Fonts

      Key = thonbi_.ttf

      Value = z:\JAVA131\jre\lib\fonts\THONBI_.TTF

      Application = PM_Fonts

      Key = thonburi.ttf

      Value = z:\JAVA131\jre\lib\fonts\THONBURI.TTF

      Application = PM_Fonts

      Key = thonb_.ttf

      Value = z:\JAVA131\jre\lib\fonts\THONB_.TTF

      Application = PM_Fonts

      Key = thoni_.ttf

      Value = z:\JAVA131\jre\lib\fonts\Thoni_.TTF

Pour savoir comment ajouter des entrées de fichier INI pour les clients WorkSpace On-Demand à l'aide d'un éditeur d'INI ou de la commande NET APPPARM, reportez-vous au WorkSpace On-Demand Handbook 2.0. Pour modifier le fichier OS2.INI des clients WorkSpace On-Demand, vous pouvez procéder de deux façons différentes :

- Depuis le serveur pour un utilisateur donné, le fichier OS2.INI se trouve à l'emplacement (unité et répertoire) suivant :

         [unitérpl]:\ibmlan\rpluser\[nom client]\os2\os2.ini

- Pour modifier l'OS2.INI par défaut de chaque machine créée avec la classe de machine individuelle, le fichier à modifier se trouve à l'emplacement (unité et répertoire) suivant :

         [unitérpl]:\ibmlan\rpl\machines\BB20.xx\[classe machine]\os2\os2.ini

Où :

[unitérpl] | est l'unité sur laquelle est installé le répertoire RPL.
[nom client] | indique le nom du client WorkSpace On-Demand.
xx | indique le code de pays ou de région.
[classe machine] | indique le nom de la classe de machine utilisée par un client WorkSpace On-Demand.

##### 2.4.2.6 Installation du plug-in Netscape pour les clients WorkSpace On-Demand 2.0

Pour installer le plug-in Java pour le navigateur Netscape 4.x, l'administrateur WorkSpace On-Demand doit recopier le fichier npjava.dll dans le répertoire de plug-ins Netscape 4.x des clients WorkSpace On-Demand. Pour copier le fichier, tapez :

         copy d:\JavaTemp\package\npjava.dll  [unitérpl]:\ibmlan\rpl\bb20.xx\NETSCAPE\PROGRAM\PLUGINS\*.*

Pour installer le plug-in Java pour IBM Web Browser for OS/2, copiez le fichier npoji6.dll dans le répertoire de plug-ins du navigateur Web des clients WorkSpace On-Demand Clients. Pour copier le fichier, tapez :

         copy d:\JavaTemp\package\npoji6.dll  [unitérpl]:\ibmlan\rpl\bb20.xx\os2\os2web\PLUGINS\*.*

Où :

d:\JavaTemp | est l'emplacement complet des fichier de l'environnement d'exécution qui ont été extraits,
[unitérpl] | est l'unité sur laquelle est installé le répertoire RPL,
xx | indique le code de pays ou de région.

L'administrateur WorkSpace On-Demand doit aussi effectuer l'ajout ci-après dans le fichier OS2.INI des clients WorkSpace On-Demand. Tous les ajouts sont terminés par le caractère NULL.

Ajoutez les éléments suivants :

         Application = Java Plug-in

         Key = JAVA_HOME

         Value = z:\JAVA131\jre

où z représente l'unité sur laquelle l'environnement d'exécution est installé pour le client.

Reportez-vous au manuel WorkSpace On-Demand Handbook 2.0 pour savoir comment ajouter des entrées de fichier INI pour les clients WorkSpace On-Demand à l'aide d'un éditeur d'INI ou de la commande NET APPPARM. Pour modifier le fichier OS2.INI des clients WorkSpace On-Demand, vous pouvez procéder de deux façons différentes :

- Depuis le serveur pour un utilisateur donné, le fichier OS2.INI se trouve à l'emplacement (unité et répertoire) suivant :

         [unitérpl]:\ibmlan\rpluser\[nom client]\os2\os2.ini

- Pour modifier l'OS2.INI par défaut de chaque machine créée avec la classe de machine individuelle, le fichier à modifier se trouve à l'emplacement (unité et répertoire) suivant :

         [unité rpl]:\ibmlan\rpl\machines\BB20.xx\[classe machine]\os2\os2.ini

Où :

[unitérpl] | est l'unité sur laquelle est installé le répertoire RPL,
[nom client] | indique le nom du client WorkSpace On-Demand.
xx | indique le code de pays ou de région.
[classe machine] | indique le nom de la classe de machine utilisée par un client WorkSpace On-Demand.

##### 2.4.2.7 Installation de composants supplémentaires du Kit de développement sur les clients WorkSpace On-Demand 2.0

Si vous souhaitez installer des composants autres que l'environnement d'exécution pour les clients WorkSpace On-Demand, vous pouvez les sélectionner dans le fichier WSOD2.RSP.

Si vous installez le Toolkit, un administrateur WorkSpace On-Demand doit effectuer les ajouts ci-après dans le fichier CONFIG.SYS des clients.
Ajoutez les éléments suivants :

`x:\java131\bin;` | à l'instruction SET PATH
`z:\JAVA131\lib;` | à l'instruction SET LIB,
`z:\JAVA131\include;` | à l'instruction SET INCLUDE.

où z:\JAVA131 est l'emplacement où le Toolkit est installé pour le client.

##### 2.4.2.8 Exécution des exemples Java depuis un client WorkSpace On-Demand 2.0

L'administrateur du serveur WorkSpace On-Demand doit ajouter les lignes suivantes au fichier RPL\FITS\nom_client.FIT pour permettre au client WorkSpace On-Demand d'exécuter les exemples fournis dans le composant d'exemples :

         z:\JAVA131\WEBLOGS \\nom_serveur\WRKFILES\nom_client\JAVA131\WEBLOGS

         z:\JAVA131\HOTJAVA \\nom_serveur\WRKFILES\nom_client\JAVA131\HOTJAVA

Remplacez respectivement nom_serveur et nom_client par le nom du serveur IPL éloigné et le nom du client IPL éloigné.z est l'unité sur laquelle est installé le Kit de développement. Ces spécifications peuvent également être entrées dans le fichier FIT par défaut.

Les clients IPL éloignés peuvent compiler le code d'exemple si les exemples sont placés dans un répertoire auquel ils ont accès en écriture.

##### 2.4.2.9 Emission d'une habilitation sur les clients WorkSpace On-Demand 2.0

Si vous émettez une habilitation (que vous accordez l'accès) pour la connexion à un serveur Web, le fichier IDENTITYDB.OBJ doit être accessible en lecture et en écriture. Ajoutez les lignes ci-après au fichier FIT pour établir la connexion :

         z:\JAVA131\WEBLOGS        \\nom_serveur\WRKFILES\nom_client\JAVA131\WEBLOGS

         z:\JAVA131\HOTJAVA        \\nom_serveur\WRKFILES\nom_client\JAVA131\HOTJAVA

         z:\JAVA131\IDENTITYDB.OBJ \\nom_serveur\WRKFILES\nom_client\JAVA131\IDENTITYDB.OBJ

##### 2.4.2.10 Compilateur JIT et client WorkSpace On-Demand 2.0

Sur les systèmes clients WorkSpace on Demand, la commande ci-après est ajoutée dans le fichier CONFIG.SYS si la version 1.1.6 du Kit de développement a été installée lors de l'installation du serveur WorkSpace On-Demand :

        set java_compiler=xxx

Cette commande active le compilateur JIT (Just-In-Time).

Pour activer le compilateur JIT, supprimez la commande ci-dessus du fichier CONFIG.SYS. Pour modifier le fichier CONFIG.SYS des clients, vous pouvez procéder de deux façons différentes :

- Depuis le serveur pour un utilisateur donné, le fichier CONFIG.SYS se trouve à l'emplacement (unité et répertoire) suivant :

         [unitérpl]:\ibmlan\rpl\machines\[classe machine]\config.sys

- Pour modifier le CONFIG.SYS par défaut de chaque machine créée avec la classe de machine individuelle, le fichier à modifier se trouve à l'emplacement (unité et répertoire) suivant :

         [unitérpl]:\ibmlan\rpl\machines\BB20.xx\[classe machine]\config.sys

Utilisez la liste ci-après comme référence pour définir les variables dans les fichiers mentionnés ci-dessus :

Où :

[unitérpl] | indique la liste de paramètres de requête (RPL).
xx | indique le code de pays ou de région.
[classe machine] | indique le nom de la classe de machine utilisée par un client WorkSpace On-Demand.

##### 2.4.2.11 Création d'une application partagée pour l'exécution du panneau de commande du plug-in Java WorkSpace On-Demand 2.0

Pour créer une application partagée pour le panneau de commande du Plug-in Java exécuté sur un client WorkSpace On-Demand 2.0, vous devez fournir un accès aux fichiers Netscape. Les paramètres d'accès sont définis dans le fichier Netscape APPPOST.FIT.

Voici un exemple de création d'une application partagée pour l'exécution du panneau de commande du Plug-in Java :

         net app jctrlpnl /remark:"Panneau de commande du Plug-in Java"

           /appdir:z:\java131\jre\bin

           /command:"jctrlpnl.cmd"

           /type:wsod /interface:pm /add

        net appparm jctrlpnl NCC_POSTFITS=z:\netscape\program\apppost.fit

           /add /placement:b

z:\java131 est le répertoire dans lequel est installée l'image du kit de développement et z:\netscape celui où l'image Netscape est installée.

### 2.5 Installation IPL éloigné

Une installation IPL éloigné nécessite la création de deux fichiers de réponses et la préparation des répertoires et fichiers appropriés sur le serveur IPL éloigné.

Suivez les étapes ci-après pour chaque client concerné par l'installation :

1. Placez sur le serveur IPL éloigné les fichiers d'installation du Kit de développement qui ont été extraits.
2. Exécutez la commande GENFIRPL (Pour plus d'informations, reportez-vous à la section Création de fichiers de réponses.)
3. Exécutez la commande CLIFI pour un client IPL éloigné. (Pour plus d'informations, reportez-vous à la section Lancement de l'installation IPL éloigné.)
4. Modifiez le fichier FIT du client (voir les sections Mise à jour des fichiers pour Feature Install et Exécution des exemples Java depuis un client IPL éloigné.)

#### 2.5.1 Création des fichiers de réponses

Placez sur le serveur IPL éloigné les fichiers d'installation du Kit de développement qui ont été extraits. Lancez ensuite la commande GENFIRPL pour générer deux fichiers de réponses : FILES.RSP pour le serveur IPL éloigné et JAVA131.RSP pour le client IPL éloigné. Un exemple de commande GENFIRPL est fourni ci-après. Cette commande doit être entrée sur une seule ligne.

         genfirpl /m:c:\javacode\xx  /r:c:\ibmlan\rpl

         /u:c:\ibmlan\rpluser  /f:c:\javacode\xx\JAVA131.rsp

         /c:nom_client  /b:x:

Le client IPL éloigné ne doit pas être en fonctionnement lors de l'exécution de la commande GENFIRPL. Vous devez exécuter une commande GENFIRPL pour chaque client IPL éloigné, en indiquant le nom de client et l'unité d'amorçage appropriés.

Utilisez la liste ci-après comme référence pour définir les variables dans les fichiers mentionnés ci-dessus :

Où :

/m | indique le répertoire du serveur IPL éloigné qui contient les fichiers d'installation du Kit de développement.
xx | indique la variable de langue voulue.
/r | indique le répertoire RPL.
/u | indique le répertoire RPLUSER.
/f | indique le nom complet du fichier de réponses du client IPL éloigné.
/c | indique le nom du client IPL éloigné.
/b | indique l'unité d'amorçage du client IPL éloigné.
/nf | Supprime le transfert de fichiers Java. Utilisez cette option lorsque vous effectuez l'installation sur plusieurs clients IPL éloigné, à partir du deuxième, pour éviter que les fichiers du Kit de développement ne soient installés à nouveau pour chaque client.

#### 2.5.2 Modification du fichier JAVA131.RSP

Le fichier JAVA131.RSP contient des variables qui vous permettent de sélectionner les composants à installer, ainsi que l'unité et le répertoire. Par défaut, ce fichier est configuré pour installer tous les composants du Kit de développement. Vous pouvez le modifier en indiquant ceux que vous souhaitez installer. Veillez à bien télécharger tous les fichiers dont vous avez besoin et en extraire le contenu avant de lancer l'installation.

Vous devez utiliser un éditeur de texte acceptant les lignes de plus de 255 octets, tel que TEDIT, afin d'éviter de tronquer les longues lignes de ce fichier. Comme ce fichier est très gros, les modifications peuvent prendre du temps et introduire des erreurs. Afin d'éviter tout risque de perte de données, effectuez une copie de sauvegarde de JAVA131.RSP avant de le modifier.

#### 2.5.3 Mise à jour des fichiers pour Feature Install

Vous devez inclure dans le fichier nom_client.FIT de chaque client IPL éloigné la commande ci-après, sur une seule ligne :

         z:\os2\install\install.inv \\nom_serveur\WRKFILES\nom_client

         \os2\install\install.inv

Remplacez nom_serveur et nom_client par le nom du serveur IPL éloigné et celui du client IPL éloigné. z est l'unité sur laquelle est installé le Kit de développement.

#### 2.5.4 Lancement de l'installation IPL éloigné

Les installations RIPL (procédure de téléchargement initial) sont traitées par CLIFI (le programme d'installation Feature Install) et peuvent prendre 15 à 20 minutes ou plus. Après vous être connecté au serveur IPL éloigné comme administrateur, lancez la commande CLIFI à l'aide du fichier de réponses créé pour le fichier FILES.RSP du serveur IPL éloigné :

         clifi /a:i  /r:c:\javacode\files.rsp

Il est nécessaire de redémarrer le serveur IPL éloigné après l'exécution de CLIFI si le transfert de fichiers n'a pas été supprimé.

Exécutez la commande CLIFI sur chaque client IPL éloigné après avoir exécuté pour lui la commande GENFIRPL.

         clifi /a:i  /r:z:\xx\JAVA131.rsp

Utilisez la liste ci-après comme référence pour définir les variables dans les fichiers mentionnés précédemment :

Où :

/r | indique le nom complet du fichier de réponses du client IPL éloigné, comme indiqué dans la commande GENFICMD.
xx | indique la variable de langue voulue.

#### 2.5.5 Exécution des exemples Java depuis un client IPL éloigné

L'administrateur de serveur IPL éloigné doit ajouter les lignes ci-après dans le fichier RPL\FITS\nom_client.FIT pour donner à un client IPL éloigné la possibilité d'exécuter les exemples fournis dans le composant d'exemples :

         z:\JAVA131\WEBLOGS \\nom_serveur\WRKFILES\nom_client\JAVA131\WEBLOGS
         z:\JAVA131\HOTJAVA \\nom_serveur\WRKFILES\nom_client\JAVA131\HOTJAVA

Remplacez nom_serveur et nom_client par le nom du serveur IPL éloigné et celui du client IPL éloigné. z est l'unité sur laquelle est installé le Kit de développement.

Les clients IPL éloigné peuvent compiler le code d'exemple si les exemples sont placés dans un répertoire auquel ils ont accès en écriture.

##### 2.5.5.1 Emission d'une habilitation sur un client IPL éloigné

Si vous émettez une habilitation pour la connexion à un serveur Web, le fichier IDENTITYDB.OBJ doit être accessible en lecture et en écriture. Ajoutez les lignes ci-après au fichier FIT pour établir la connexion :

         z:\JAVA131\WEBLOGS \\nom_serveur\WRKFILES\nom_client\JAVA131\WEBLOGS
         z:\JAVA131\HOTJAVA \\nom_serveur\WRKFILES\nom_client\JAVA131\HOTJAVA

         z:\JAVA131\IDENTITYDB.OBJ  \\server\WRKF\client\JAVA131\IDENTITYDB.OBJ

Remplacez nom_serveur et nom_client par le nom du serveur IPL éloigné et celui du client IPL éloigné. z est l'unité sur laquelle est installé le Kit de développement.

Ces lignes peuvent aussi être placées dans le fichier FIT par défaut dans le cadre de l'installation du Kit de développement pour WorkSpace On-Demand lors de l'exécution de la commande WSOD.CMD.

## 3.0 APRES L'INSTALLATION

Les sections qui suivent fournissent des informations complémentaires dont vous pourriez avoir besoin après l'installation du Kit de développement.

### 3.1 Sources d'information complémentaires

Les objets de la liste ci-après sont affichés dans le dossier Developer Kit OS/2 uniquement si vous utilisez OS/2 Warp Server 4. Si vous utilisez OS/2 Warp Server for e-business, vous pouvez accéder aux documents associés à l'emplacement suivant :

- Centre IBM pour la technologie Java :
  http://www.ibm.com/java/jdk/index.html
- Documentation Java :
  http://www.javasoft.com/doc.html
- Débogueur interactif pour Java OS/2 :
  `x:\JAVA131\ICATJAVA\help\icatjvo.htm`
- Fichier README du Kit de développement :
  `x:\JAVA131\`

x représente l'unité sur laquelle vous avez installé le kit de développement.

Si vous avez installé le Toolkit ou le débogueur interactif pour Java OS/2 dans un autre répertoire que l'environnement d'exécution, indiquez le répertoire approprié pour ces deux objets. Les liens vers la documentation de l'environnement d'exécution et le débogueur interactif pour Java OS/2 ne fonctionnent pas si les composants sont dans des répertoires différents ou ne sont pas installés.

### 3.2 Installation de composants complémentaires

Après l'installation initiale du Kit de développement, vous pouvez installer des composants supplémentaires en réexécutant la procédure d'installation. Pour cela, vous devez soit télécharger à nouveau les fichiers depuis le site Web Software Choice, soit avoir conservé sur votre système tous les fichiers extraits ou les fichiers ZIP initiaux.

### 3.3 Considérations relatives aux éléments de contrôle AWT TextField et TextArea

Les éléments de contrôle AWT TextField et TextArea ne prennent pas en charge les caractères qui ne se trouvent pas dans la page de code courante. Avec le système anglais U.S., il est possible d'obtenir des caractères supplémentaires dans ces éléments de contrôle en sélectionnant la page de codes 850 (page de codes multilingue supportant les langues d'Europe de l'ouest).

### 3.4 Modification des fichiers de propriétés de police non prise en charge

La modification des fichiers de propriétés de police fournis avec le Kit de développement n'est pas supportée.

### 3.5 Problèmes d'heure dans les applets Java

Si vous avez des problèmes d'heure dans vos applets Java, il faut peut-être que vous définissiez ou modifiez la variable de fuseau horaire (TZ). Pour cela, vous pouvez procéder de deux façons différentes :

- Accédez à la page Général du bloc-notes Configuration TCP/IP. Renseignez le champ du fuseau horaire, en faisant éventuellement appel à l'aide en ligne.
- Ouvrez le fichier CONFIG.SYS dans un éditeur et ajoutez ou modifiez l'instruction SET TZ=.

### 3.6 Utilisation de HMS (Support de mémoire haute) pour augmenter la taille de la mémoire dynamique de Java

Dans un environnement OS/2 standard, l'espace d'adresses virtuelles maximum à la disposition d'une application est de 512 Mo et la mémoire disponible pour la mémoire dynamique de Java est limitée à environ 256 Mo. Il est possible de dépasser cette limite en utilisant OS/2 HMS (Support de mémoire haute), qui augmente à 3 Go l'espace d'adresses virtuelles maximum disponible pour une application.

OS/2 HMS est supporté par les plateformes suivantes :

- Serveurs WorkSpace On-Demand
- OS/2 Warp Server for e-business

#### 3.6.1 Activation de OS/2 HMS

La mémoire haute disponible est déterminée par le paramètre VIRTUALADDRESSLIMIT dans le fichier CONFIG.SYS. Sa valeur est exprimée en Mo dans ce fichier. Par exemple :

            VIRTUALADDRESSLIMIT=2048

La plus petite valeur autorisée est 512 Mo. Ceci assure la compatibilité avec les versions précédentes d'OS/2 qui permettaient l'accès à 512 Mo. Une valeur supérieure à 512 Mo peut avoir pour effet de réduire le nombre de processus pouvant s'exécuter simultanément sur le système.

#### 3.6.2 Activation de l'utilisation d'OS/2 HMS par la mémoire dynamique Java

Pour indiquer à la machine virtuelle Java (JVM) qu'elle doit tenter de placer sa mémoire dynamique dans OS/2 HMS, définissez la variable d'environnement ci-après comme indiqué :

        SET JAVA_HIGH_MEMORY=1

Si OS/2 HMS n'est pas disponible, cette option est ignorée et la mémoire dynamique est allouée dans l'espace d'adresses standard.

#### 3.6.3 Limitations lors de l'utilisation d'OS/2 HMS

Si la mémoire dynamique Java est placée dans OS/2 HMS, les objets qui y sont alloués ne sont pas accessibles au code 16 bits. Ceci n'est un problème que si une application Java comporte des DLL de méthodes natives compilées avec un compilateur 16 bits ou appelant d'autres DLL qui contiennent du code 16 bits.

### 3.7 Classe BigDecimal améliorée

Cette version comprend la classe BigDecimal (com.ibm.math.BigDecimal). Cette classe est fournie (avec sa classe de support MathContext) comme alternative à la classe java.math.BigDecimal. Si vous utilisez cette dernière dans un programme Java et que vous souhaitez accéder à la nouvelle classe, vous devez modifier l'instruction d'importation dans le code source comme indiqué ci-après :

Remplacez :

         import java.math.*;

par :

         import com.ibm.math*;

Il n'y a pas d'autre code à modifier.

### 3.8 Le plug-in Java

Les sections qui suivent fournissent des informations sur l'installation et l'utilisation du plug-in Java pour Netscape 4.x et IBM Web Browser for OS/2.

#### 3.8.1 Installation du plug-in Java après l'installation deNetscape Communicator

Si vous avez installé Netscape Communicator après le Kit de développement et que vous souhaitez activer le plug-in Java, effectuez les étapes suivantes :

1. Repérez le fichier plugin.exe dans le répertoire \JAVA131\ns\ de l'environnement d'exécution. Recopiez-le dans un répertoire temporaire.
2. Placez-vous dans le répertoire où vous avez copié le fichier plugin.exe et exécutez le fichier en entrant son nom dans une invite de commande. Cette exécution extrait les fichiers suivants :
   - instplug.cmd : commande CLIFI servant à exécuter l'installation du plug-in Java
   - npjava.dll : dll du plug-in Java
   - nscheck2.exe : exit utilisateur servant à localiser Netscape
   - nsfiles.rsp : fichier de réponses Feature Install (FI) - Ne modifiez pas ce fichier.
   - nsuser.rsp : exemple de fichier de réponses utilisateur partiel
   - package.ctl : fichier de regroupement requis par FI.
3. Revenez dans le répertoire \JAVA131\ns\.
4. Modifiez le fichier instplug.cmd pour qu'il pointe sur les chemins et l'unité d'amorçage corrects.
5. Modifiez le fichier nsuser.rsp de façon à activer le Plug-in Java. La dernière version de Netscape Communicator est activée. (Si vous souhaitez activer une version particulière de Netscape, définissez la valeur JAVANSFILES.NSDRV du fichier nsuser.rsp de manière à indiquer le chemin complet.)
6. Exécutez le fichier instplug.cmd.
7. Redémarrez le système.

Utilisez la liste ci-après comme référence pour définir les variables dans les fichiers mentionnés précédemment :

Où :

xx | indique la variable de langue voulue.
/r | indique l'emplacement complet du fichier de réponses Feature Install.
/r2 | indique l'unité, le chemin et le nom du fichier de réponses utilisateur.
/b | indique l'unité d'amorçage.
/s | indique l'emplacement complet des fichiers du Kit de développement qui ont été extraits.
/l1 et /l2 | indiquent l'emplacement complet des fichiers journaux facultatifs. Consultez ces fichiers, en plus du fichier \os2\install\wpinstal.log sur l'unité d'amorçage, en cas de problèmes au cours de l'installation.

#### 3.8.2 Installation du plug-in Java après l'installation d'IBM Web Browser for OS/2

Si vous avez installé IBM Web Browser for OS/2 après le Kit de développement et que vous souhaitez activer le plug-in Java, effectuez les étapes suivantes :

1. Repérez le fichier mzplugin.exe dans le répertoire \JAVA131\ns\ de l'environnement d'exécution. Recopiez-le dans un répertoire temporaire.
2. Placez-vous dans le répertoire où vous avez copié le fichier mzplugin.exe et exécutez le fichier en entrant son nom dans une invite de commande. Cette exécution extrait les fichiers suivants :

- insmzplg.cmd : commande CLIFI servant à exécuter l'installation du plug-in Java
- npoji6.dll : dll du plug-in Java
- mzcheck2.exe : exit utilisateur servant à localiser Netscape
- mzfiles.rsp : fichier de réponses Feature Install (FI). Ne modifiez pas ce fichier.
- mzuser.rsp : exemple de fichier de réponses utilisateur partiel
- package.ctl : fichier de regroupement requis par FI.

3. Revenez dans le répertoire \JAVA131\ns\.
4. Modifiez le fichier insmzplg.cmd pour qu'il pointe sur les chemins et l'unité d'amorçage corrects.
5. Modifiez le fichier mzuser.rsp de façon à activer le plug-in Java. La versionn la plus récente d'IBM Web Browser for OS/2 est activée. (Si vous souhaitez activer une version particulière d'IBM Web Browser for OS/2, définissez la valeur JAVAMZFILES.NSDRV du fichier mzuser.rsp de manière à indiquer le chemin complet.)
6. Exécutez le fichier insmzplg.cmd.
7. Redémarrez le système.

Utilisez la liste ci-après comme référence pour définir les variables dans les fichiers mentionnés ci-dessus.
Où :

xx | indique la variable de langue voulue.
/r | indique l'emplacement complet du fichier de réponses Feature Install.
/r2 | indique l'unité, le chemin et le nom du fichier de réponses utilisateur.
/b | indique l'unité d'amorçage.
/s | indique l'emplacement complet des fichiers du Kit de développement qui ont été extraits.
/l1 et /l2 | indiquent l'emplacement complet des fichiers journaux facultatifs. Consultez ces fichiers, en plus du fichier \os2\install\wpinstal.log sur l'unité d'amorçage, en cas de problèmes au cours de l'installation.

#### 3.8.3 Panneau de commande du plug-in Java

Une fois le plug-in Java installé, vous pouvez contrôler son comportement à l'exécution. Par exemple, lors de son exécution, vous pouvez indiquer si la console Java doit ou non s'afficher au démarrage de celui-ci.

Le panneau de commande est une application Java lancée par le fichier de commandes qui se trouve dans le fichier [x:\JAVA131]\jre\bin\jctrlpnl.cmd. Il y a une icône pour ce fichier de commandes dans le répertoire [x:\JAVA131] où x représente l'unité sur laquelle vous avez installé le Kit de développement. Par défaut, le nom de répertoire est JAVA131.

### 3.9 Désactivation du compilateur JIT

Avec le Kit de développement est fourni un compilateur JIT (Just-In-Time). Il permet de générer un code machine pour les séquences de code pré-compilé les plus fréquentes lors de l'exécution d'applications ou d'applets Java. Le compilateur est activé par défaut. Lorsqu'un incident se produit dans une application Java, une applet ou dans le compilateur lui-même, vous pouvez désactiver le compilateur en transmettant la commande suivante à l'interpréteur d'exécution Java :

    SET JAVA_COMPILER=none

### 3.10 Changement de noms de fichier

Certains noms de fichier courts basés sur le format 8.3 requis par OS/2 diffèrent des noms de fichier longs requis par des plates-formes comme Windows ou Linux. Ces noms de fichier sont les suivants :

Nom de fichier long | Nom de fichier court OS/2
cmm.dll | orb.dll
fontmanager.dll | font.dll
ioser12.dll | iosr12.dll
java-rmi.exe | jrmi.exe
| policytool.exe | policy.exe

keytool.exe | keytol.exe
appletviewer.exe | applet.exe
tnameserv.exe | tnames.exe
rmiregistry.exe | rmireg.exe
.keystore | keystore.prp
Noms de fichiers abrégés et complets répertoriés qui ne sont pas conformes à la convention d'appellation 8.3.

### 3.11 Configuration du Visualiseur d'applet

Pour configurer le visualiseur d'applet pour la connexion à Internet via une passerelle proxy, procédez comme suit :

1. Cliquez sur Propriétés d'applet.
2. Cliquez sur Propriétés.
3. Indiquez le serveur proxy et le port dans les zones correspondantes.
Par exemple :

         Serveur proxy http : monproxy.monentreprise.com

         Port proxy http :   80

Si votre navigateur Web est déjà configuré pour la connexion à Internet, utilisez les valeurs indiquées dans cette configuration. Par exemple, avec WebExplorer, utilisez les valeurs de passerelle proxy de la page Configure Servers, en omettant le 'http://' de début et le '/' de fin.
Si vous ne savez pas quelle est votre passerelle proxy, demandez à votre administrateur système si vous êtes autorisé à utiliser les services proxy.
4. Cliquez sur Validation pour enregistrer les modifications.
5. Fermez le visualiseur d'applet.

### 3.12 Indication d'options et de propriétés système Java

Vous pouvez spécifier des options et des propriétés système Java en créant une variable d'environnement nommée IBM_JAVA_OPTIONS et en lui affectant les valeurs voulues. Toutes les options ou propriétés système Java indiquées doivent être précédées d'un espace, sauf la première option. Par exemple, vous pourriez définir IBM_JAVA_OPTIONS comme suit :

    IBM_JAVA_OPTIONS=-Dmysysprop1=tcpip -Dmysysprop2=wait

Si vous spécifiez les mêmes options ou propriétés depuis la ligne de commande (ou depuis un programme JNI), les nouvelles valeurs remplacent celles spécifiées par la variable d'environnement IBM_JAVA_OPTIONS. la seule exception à cette règle est lorsque vous indiquez -Xt, -Xtm ou -Xdebug car toutes ces options impliquent qu'aucun JIT ne sera utilisé.

Gardez à l'esprit que :

- La variable IBM_JAVA_OPTIONS n'a pas d'effet en cas d'exécution avec JNI_VERSION_1_1.
- Spécifiez les options Java dans leur format actuel. Par exemple, -verbose:gc et non -verbosegc.

La propriété système ibm.jvm.bootclasspath permet de définir un chemin d'accès supplémentaire. La valeur de cette propriété est insérée entre une valeur définie par -Xbootclasspath/p: et le chemin d'accès aux classes d'amorçage. Le chemin d'accès aux classes d'amorçage est une valeur par défaut ou celle définie avec l'option -Xbootclasspath:. Pour plus d'informations concernant ces options, reportez-vous à la section 3.1 Sources d'information complémentaires.

### 3.13 RMI avec IIOP

L'appel de méthode éloignée (RMI) Java offre un mécanisme simple pour la programmation Java répartie. RMI avec IIOP (RMI-IIOP) étend le RMI Java de base pour permettre la communication avec le protocole IIOP (Internet Inter-ORB Protocol) de la norme CORBA (Common Object Request Broker Architecture). Ceci permet l'interaction directe avec tout autre Object Request Broker (ORB) CORBA, qu'il ait été mis en oeuvre dans Java ou dans un autre langage de programmation.

Le Kit de développement comprend un support pour les applications développées pour utiliser RMI avec IIOP (RMI-IIOP). Ce support fait partie de l'installation standard de l'environnement d'exécution et ne nécessite pas d'installation ou de configuration spéciale.

#### 3.13.1 Le compilateur IDL-Java

Avec cette version est fourni un compilateur IDL-Java. Cet outil convertit le langage IDL (Interface Definition Language) CORBA en Java. Pour plus d'informations, reportez-vous au manuel IDL-to-Java Compiler User's Guide. Vous trouverez ce manuel dans le répertoire suivant :

         [x:\JAVA131]\DOCS\RMI-IIOP\toJavaPortableUG.htm

[x:\JAVA131] est l'emplacement où vous avez installé le Kit de développement. JAVA131 est le nom de répertoire par défaut.

Le compilateur IDL-Java supporte la spécification CORBA 2.3, qui comprend la construction "valuetype" et son mappage d'IDL à Java. Vous trouverez les détails sur les sites FTP suivants :

- ftp://ftp.omg.org/
  Depuis cette page principale, cliquez sur pub --> docs --> formal --> 99-07-53.pdf
  (mappage IDL-Java)
- ftp://ftp.omg.org/
  Depuis cette page principale, cliquez sur pub --> docs --> formal --> 98-12-01.pdf
  (noyau CORBA 2.3)

Le compilateur IDL-Java est fourni pour que vous puissiez expérimenter l'IDL généré par la commande "rmic -idl". Cet IDL généré et le compilateur IDL-Java ne sont pas nécessaires pour l'utilisation RMI-IIOP dans le cas Java-Java. L'IDL généré sert à permettre l'interfonctionnement de RMI-IIOP avec d'autres langages tels que le C++. Pour l'interfonctionnement avec le C++, il faut utiliser un compilateur IDL-C++ supportant la spécification CORBA 2.3 pour la compilation de l'IDL généré.

##### 3.13.1.1 Restrictions du compilateur IDL-Java

Notez les remarques ci-après pour l'utilisation du compilateur IDL-Java :

- Les identificateurs avec caractère d'échappement dans la portée globale ne peuvent pas avoir la même orthographe que les types primitifs IDL, Object ou ValueBase. Ceci est dû au fait que la table de symboles est préchargée avec ces identificateurs ; leur redéfinition remplacerait leur définition initiale.
- Il n'y a pas de raccords (stubs) locaux ni de sémantique de copie lors des transmissions locales de valeurs.
- Le type IDL fixe n'est pas supporté.
- Les raccords (stubs) générés ne supportent pas la sérialisation, suite à la section 25.3.1.3 de la spécification de mappage IDL et Java datée du 22/08/1998 qui n'indiquent pas les éléments requis.
- Il n'est pas possible de déclarer des constantes de type octet.

##### 3.13.1.2 Incidents connus avec le compilateur IDL-Java

Le compilateur IDL-Java présente les problèmes suivants :

- Il peut effectuer une compilation sans erreur et ne pas générer de sortie. Dans ce cas, spécifiez l'option -emitAll pour forcer la génération de toutes les classes. Il est recommandé d'accompagner cette option de l'option -pkgPrefix pour ajouter un préfixe à tout nom de classe commençant par 'java' pour éviter les conflits de nom avec les classes dans la machine JVM.
- Le compilateur ne reconnaît pas le type déconseillé CORBA::Principal.
- La déclaration d'une constante et d'une méthode ou d'un attribut ayant le même nom dans la même portée ne provoque pas d'erreur. Le code IDL ci-après risque de causer une erreur :

               interface t {

                 const long foo = 1;

                 attribute long foo;

               };

- Le code IDL ci-après provoque une erreur car "S est un type non déclaré" dans interface B. Ce ne devrait pas être le cas.

               interface A { struct S { short s; }; };

               interface B:A { typedef S new_S;

                           exception ex {S f1;}; // Erreur pour "S" ici

               };

- Si une union définit une autre union dans sa clause par défaut, la classe Java résultante donne des erreurs de compilation. Pour remédier à cet incident, il suffit de définir l'union imbriquée en dehors de l'autre.

#### 3.13.2 Informations complémentaires

Pour des informations sur IBM et RMI-IIOP, visitez le site Web IBM suivant :
http://www.ibm.com/java/jdk/rmi-iiop/index.html

Autre documentation disponible :

- Le fichier README du Kit de développement, qui se trouve dans le répertoire dans lequel vous avez installé le Kit de développement.
- Le manuel RMI-IIOP Programmer's Guide, qui est une introduction à l'écriture de programmes RMI-IIOP ; vous le trouverez aux emplacements suivants :

- http://www.ibm.com/java/jdk/rmi-iiop/docs/win130/rmi_iiop_pg.html
- [x:\JAVA131]\DOCS\RMI-IIOP\rmi_iiop_pg.html

- Le manuel IDL-to-Java Compiler User's Guide, qui explique l'utilisation de l'outil qui génère du code Java à partir de code IDL ; vous le trouverez aux emplacements suivants :
  - http://www.ibm.com/java/jdk/rmi-iiop/docs/win130/toJavaPortableUG.htm
  - [x:\JAVA131]\DOCS\RMI-IIOP\toJavaPortableUG.htm
- Le répertoire d'exemples contient :
  - un exemple Hello World interchangeable entre les protocoles JRMP et IIOP ([x:/JAVA131]/rmi-iiop/samples/Hello)
  - un exemple Hello World interfonctionnant avec un programme IDL standard ([x:/JAVA131]/rmi-iiop/samples/idl)

  [x:\JAVA131] est l'emplacement où vous avez installé le Kit de développement. JAVA131 est le nom de répertoire par défaut.

- Le document Java Language to IDL Mapping, qui est une spécification technique détaillée de RMI-IIOP ; vous le trouverez sur le site FTP suivant :
  ftp://ftp.omg.org/
  Depuis cette page principale, cliquez sur pub --> docs --> formal --> 99-07-59.pdf
- Vous pouvez trouver les informations sur l'interface API (Application Programming Interface) de Sun Microsystems sur le site Web suivant : http://java.sun.com/products/?frontpage-main

#### 3.13.3 Termes RMI-IIOP

API | Application Programming Interface
CORBA | Common Object Request Broker Architecture
IDL | Interface Definition Language
IIOP | Internet Inter-ORB Protocol
| ORB | Object Request Broker

RMI | Remote Method Invocation

### 3.14 Service d'authentification et d'autorisation Java (JAAS)

La plateforme Java 2 offre un moyen d'imposer des contrôles d'accès en fonction de la provenance du code et de son signataire. Ces contrôles d'accès sont nécessaires en raison de la nature répartie de la plateforme Java où, par exemple, une applet éloignée peut être téléchargée par un réseau public puis exécutée localement.

En revanche, la plateforme Java 2 n'offre pas de moyen d'imposer des contrôles d'accès similaires en fonction de qui exécute le code. Pour fournir ce type de contrôle d'accès, l'architecture de la sécurité Java 2 nécessite :

- un support complémentaire pour authentification (détermination de qui effectivement exécute le code) ;
- des extensions aux composants d'autorisation existants pour imposer de nouveaux contrôles d'accès basés sur la personne authentifiée.

Le cadre JAAS (Service d'authentification et d'autorisation Java) offre ces améliorations.

Pour une présentation générale de JAAS, visitez le site Web suivant :

http://java.sun.com

Dans cette page principale, cliquez sur Products & APIs et faites défiler jusqu'à la section Optional Packages. Les documents de ce site Web contiennent des liens vers de nombreuses autres sources d'information Web.

#### 3.14.1 Différence entre la version IBM et la version Sun de JAAS

La version IBM de JAAS pour OS/2 diffère de la version Sun pour Windows en ce que les packages com.sun.* ont été placés dans des packages com.ibm.*.

#### 3.14.2 Installation de base

Cette section indique où se trouvent les fichiers JAAS.

- Les fichiers jaas.jar et jaas_lm.jar se trouvent dans le sous-répertoire jre\lib\ext du répertoire dans lequel vous avez installé l'environnement d'exécution
.
- JAAS comprend un LoginModule simple qui fournit les informations de connexion courantes du système d'exploitation aux programmes Java. Pour assurer cette fonction, les fichiers ci-après sont installés dans les sous-répertoires indiqués du répertoire dans lequel est installé l'environnement d'exécution :

             JAVA131\jre\bin:

                       jaas.dll

                       jaas_g.dll

- Le répertoire de documentation JAVA131\docs\jaas contient la documentation relative aux API JAAS et un fichier module.html. Dans le répertoire de documentation JAAS, localisez le fichier JaasDocs.jar (contenant la documentation relative aux API JAAS documentation) et décompactez-le (jar -xvf JaasDocs.jar) dans une partition HPFS ou JFS. Le fichier index.html vous permet, avec un navigateur, d'accéder au reste de la documentation des API.

Remarque : l'environnement d'exécution est installé dans le répertoire x:\JAVA131, (où x est l'unité sur laquelle est installé le Kit de développement. JAVA131 est le nom de répertoire par défaut.)

### 3.15 Informations relatives à la programmation JNI

Les programmes C peuvent accéder aux objets Java à l'aide de l'interface JNI (interface native Java), qui est apparue avec Java 1.1.1. L'interface JNI est plus stable que l'interface NMI (Native Method Interface) précédente.

Les applications JNI ont généralement besoin d'interagir avec les types Java long, float et double pour une ou plusieurs des raisons suivantes :

- pour recevoir les variables comme paramètres de méthode natifs ;
- pour inspecter ou modifier directement les variables d'instance ou de classe ;
- pour retourner la variable comme valeur de retour de méthode native ;
- pour transmettre les variables comme données paramètres lors de l'appel d'autres méthodes Java depuis une méthode native.

### Types natifs JNI

Pour chacun des types Java, l'interface JNI fournit des types natifs que vous pouvez utiliser dans votre application JNI. Ces types sont présentés dans le tableau ci-après :

Types natifs JNI
Type Java | Type natif JNI | Taille en octets
--- | --- | ---
long | jlong | 8
double | jdouble | 8
float | jfloat | 4
Types natifs JNI

Remarque : vous n'avez pas besoin d'utiliser ces types si votre application ne manipule pas les types Java long, double et float.

Utilisez les types natifs JNI lorsque vous définissez une mise en oeuvre de méthode native afin que le compilateur établisse la correspondance entre la signature de la méthode native et celle présente dans le fichier d'en-tête généré avec l'utilitaire javah.

### Fonctions et macros d'aide

Les types natifs JNI jlong, jdouble et jfloat sont incompatibles respectivement avec les types C/C++ long, double et float. Si vous tentez un transtypage entre l'un de ces types JNI et son homologue C/C++, vous obtiendrez une erreur de compilation ou un comportement inattendu à l'exécution. Ne tentez pas de telle conversion car les formats des types natifs JNI sont internes au Kit de développement.

Le fichier d'en-tête JNI (jni.h) comprend un autre fichier d'en-tête fourni avec le Kit de développement, nommé int64_md.h. Ce fichier définit des fonctions et des macros d'aide dont vous pouvez vous servir pour l'utilisation des types natifs.

Les fonctions et macros de int64_md.h (se rapportant à jlong) comprennent généralement ll soit au début, soit à la fin de leur nom. Les fonctions se rapportant à jdouble ou jfloat comprennent généralement dbl, double, flt ou float dans leur nom. Des constantes jlong, jdouble et jfloat sont également définies.

Voici des exemples de macro :

- La macro ll_add() effectue l'addition de deux jlongs et retourne un jlong.
- La macro int2ll() convertit un int en un jlong.
- La fonction ll2str() convertit un jlong en une représentation chaîne ASCII de la valeur 64 bits.
- La fonction flt2dbl() convertit un jfloat et retourne un jdouble.
- La macro dbl2nat() convertit un jdouble en un double natif OS/2.
.
- La macro dbl_sqrt() calcule la racine carrée d'un jdouble et retourne un jdouble.
- Les fonctions dbl2str() et flt2str() convertissent leur argument en une représentation chaîne ASCII.

### 3.16 Remarques relatives aux performances

Les utilisateurs remarqueront peut-être que le chargement et le lancement de certaines applications est plus long avec la version 1.3.1 du Kit de développementOS/2 Warp, Java 2 Technology Edition qu'avec la version 1.3.0. Dans ces cas, il peut être utile de faire appel au paramètre de la ligne de commande JAVA.EXE, -Xquickstart.

Le compilateur JIT d'OS/2 Java 1.3.1 effectue, par défaut, des optimisations supplémentaires qui peuvent augmenter le temps de chargemetn d'une application. Or, l'objectif de ces optimisations supplémentaires est d'améliorer les performances d'exécution de l'application. La quantité d'amélioration des performances d'exécution et celle de dégradation du temps de chargement varient avec les applications. Pour certaines, la variation par rapport à Java 1.3.0 sera infime. Le paramètre -Xquickstart spécifie l'utilisation d'un jeu d'optimisations plus simple qui risque d'améliorer les temps de démarrage. Les différences de performances entre l'utilisation ou non de -Xquickstart varient selon les applications.

## 4.0 ENSEMBLE(S) DE POLICES SUPPLEMENTAIRE(S)

Si vous avez téléchargé un ou plusieurs des ensembles de polices en un seul fichier, passez directement aux sections Installation de polices supplémentaires pour l'installation. Si vous avez téléchargé des fichiers découpés, suivez d'abord les étapes ci-après pour les assembler en un fichier installable puis passez aux sections d'installation.

1. Assurez-vous que tous les fichiers découpés correspondant à la police désirée se trouvent dans le même répertoire.
2. Depuis l'invite de commande et dans le répertoire dans lequel vous avez téléchargé les fichiers découpés, assemblez ceux-ci avec la commande copy. Vous devez indiquer les noms des morceaux et le nom de fichier de la police. Par exemple, si vous avez téléchargé trois fichiers découpés, entrez la commande suivante :

         Copy /b Exemple.txx + Exemple.txx + Exemple.txx Exemple.ttf

Où :

Exemple.txx | représente les noms des fichiers découpés téléchargés, (xx étant le numéro de morceau), Assurez-vous de bien spécifier les fichiers découpés dans l'ordre correct.
Exemple.ttf | représente le nom complet de la police.

### 4.1 Installation de polices supplémentaires

Les sections qui suivent expliquent comment effectuer l'installation CID et l'installation par Palette de polices OS/2.

#### 4.1.1 Installation CID

Pour installer une police supplémentaire en utilisant une installation CID, procédez comme suit :

1. Trouvez le fichier wtfont.exe dans le répertoire x:\JAVA131\fonti du Kit de développement.x représente l'unité sur laquelle vous avez installé le Kit de développement.
2. Exécutez le fichier wtfont.exe en entrant son nom sur la ligne de commande. Cette exécution extrait les fichiers suivants :

- wtfnt.cmd : fichier de commandes exécutant CLIFI ;
- wtfonts.rsp : fichier de réponses Feature Install (FI) - Ne modifiez pas ce fichier.
- wtfntusr.rsp : fichier de réponses utilisateur ; sélectionnez-y les polices que vous souhaitez installer ;
- PACKAGE.CTL : fichier de regroupement requis par Feature Install.

3. Recopiez le fichier PACKAGE.CTL dans le répertoire dans lequel vous avez téléchargé les ensembles de polices supplémentaires.
4. Modifiez le fichier wtfnt.cmd pour qu'il pointe sur les chemins et l'unité d'amorçage corrects. Voir la liste de paramètres ci-après.
5. Sélectionnez dans le fichier wtfntusr.rsp les polices que vous souhaitez installer.
6. Exécutez le fichier wtfnt.cmd.
7. Redémarrez le système.

Remarque : si CLIFI vous demande d'"introduire le support", vous devez soit définir le paramètre /s: correctement dans le fichier wtfnt.cmd, soit placer le fichier PACKAGE.CTL dans le même répertoire que les ensembles de polices que vous souhaitez installer.

Utilisez la liste ci-après comme référence pour définir les variables dans les fichiers mentionnés ci-dessus.

Où :

/s: | indique la source des ensembles de polices et du fichier PACKAGE.CTL.
/b: | indique l'unité d'amorçage.
/r2: | indique l'unité, le chemin et le nom du fichier de réponses utilisateur.
/r: | indique le fichier Feature Install (wtfntusr.rsp).
/l1 et /l2 | indiquent l'emplacement complet des fichiers journaux facultatifs. Consultez ces fichiers, en plus du fichier \os2\install\wpinstal.log sur l'unité d'amorçage, en cas de problèmes au cours de l'installation.

#### 4.1.2 Installation par palette de polices

Pour installer une police supplémentaire à l'aide de la Palette de polices, procédez comme suit :

1. Ouvrez le dossier OS/2.
2. Cliquez sur le dossier Configuration du système.
3. Cliquez sur Palette de polices.
4. Cliquez sur le bouton Changement police.
5. Cliquez sur le bouton Ajout.
6. Indiquez l'unité et le répertoire où vous avez téléchargé les fichiers de police.
7. Sélectionnez la police que vous souhaitez installer et cliquez sur Ajout.

## 5.0 INFORMATIONS RELATIVES AUX JEUX DE CARACTERES A DEUX OCTETS (DBCS)

Les sections qui suivent fournissent des informations relatives aux jeux de caractères à deux octets (DBCS).

### 5.1 Texte des écrans d'installation manquant ou trop long dans les pays DBCS

Lors de l'installation du Kit de développement sous une version DBCS d'OS/2, les écrans d'installation peuvent ne pas afficher les caractères DBCS, ou les lignes peuvent dépasser le bord droit de la fenêtre d'affichage même lorsqu'elle est agrandie à sa taille maximale.

Pour corriger ces problèmes, quittez le programme d'installation, ouvrez l'objet Netscape Navigator ou Netscape Communicator pour OS/2, et cliquez sur l'élément de menu Options. Ouvrez le bloc-notes Préférences générales et cliquez sur l'onglet Polices. Choisissez le codage correct pour votre pays, puis indiquez MINCHO pour les polices à espacement proportionnel et fixe.Cliquez sur OK pour enregistrer les modifications. Si vous relancez à présent l'installation du Kit de développement, le texte devrait être affiché correctement.

### 5.2 Les systèmes chinois doivent disposer des polices Truetype

Sur les systèmes chinois simplifié ou traditionnel, assurez-vous que toutes les polices TrueType OS/2 disponibles soient installées. Pour installer ces polices, procédez comme suit :

1. Depuis la ligne de commande OS/2, lancez le programme d'installation sélective en entrant la commande suivante (C: étant l'unité d'amorçage) :

            C:\OS2\INSTALL\INSTALL

   Un écran intitulé "Configuration du système" s'affiche.
2. Passez à l'écran Configuration et installation d'OS/2 en cliquant sur le bouton Suivant (pour OS/2 Warp 4.0) ou sur le bouton OK (pour OS/2 Warp Server pour e-business).
3. Dans l'écran Configuration et installation d'OS/2, cochez la case Polices TrueType.
4. Cliquez sur le bouton Suite à droite de cette case à cocher.
5. Toutes les cases de police doivent être cochées. Cochez celles qui ne le sont pas. Cliquez sur OK.
6. Introduisez le CD-ROM du système d'exploitation (OS/2 Warp Server 4.0 ou OS/2 Warp Server for e-business) dans l'unité de CD.
7. Cliquez sur OK dans l'écran Répertoire source.

Le système devrait installer les polices appropriées. Une fois l'installation terminée, redémarrez-le.

### 5.3 Modifications provisoires de logiciel (PTF) et FixPaks pour les systèmes DBCS

Certains utilisateurs DBCS peuvent rencontrer les incidents ci-après se rapportant au fonctionnement de la méthode d'entrée asiatique. La plupart de ces erreurs ont été corrigées dans les versions les plus récentes du système d'exploitation. Toutefois, si vous ne pouvez pas effectuer une mise à niveau récente, adressez-vous à votre technicien IBM local pour connaître la disponibilité d'éventuels PTF (Program Temporary Fixes) ou FixPaks.

Le tableau ci-après indique les problèmes relatifs au fonctionnement de la méthode d'entrée asiatique et les systèmes DBCS concernés.

Description | Système DBCS concerné
--- | ---
Lorsque la mise en évidence est placée sur un autre cadre, un déroutement survient dans IME. | Chinois traditionnel
Lorsque la mise en évidence est placée sur un autre cadre lors de l'affichage de la fenêtre de recherche, l'opération de conversion ne fonctionne pas correctement. | Chinois traditionnel
Lorsque la mise en évidence est placée sur un autre cadre lors de l'affichage de la fenêtre de recherche, cette dernière ne disparaît pas. | Japonais
L'indicateur de mode d'entrée n'affiche pas le mode d'entrée correct. | Japonais, Chinois simplifié, Chinois traditionnel
Une chaîne de conversion au niveau du client actif ne disparaît pas avec la touche Echap. | Chinois traditionnel
Lorsque l'utilisateur passe à l'IME natif JAVA, une clé de conversion ne fonctionne pas correctement. | Japonais, Chinois simplifié, Chinois traditionnel
Le système s'arrête lorsqu'un trop grand nombre d'images IM sont ouvertes. | Chinois traditionnel
Poursuite de l'entrée impossible si retour au mode entrée anglais sans sélection de caractères DBCS dans la fenêtre de recherche. | Chinois simplifié, Chinois traditionnel
Une chaîne de conversion au niveau du client actif ne disparaît pas avec la combinaison de touches Ctrl+Echap. | Chinois simplifié
L'utilisation de la touche retour arrière pendant l'affichage de la fenêtre de recherche entraîne un trap dans IME. | Chinois simplifié
Description relative à l'utilisation de la méthode d'entrée pour les langues asiatiques et le système DBCS concerné.

### 5.4 Contrôle de l'affichage des chiffres arabes

Dans certains pays, des chiffres arabes peuvent apparaître inopinément. Certaines versions d'OS/2 spécifiques à un pays associent les caractères x'00B0' à x'00B9' aux chiffres arabes zéro (0) à neuf (9). Pour obtenir les caractères voulus, changez les attributs bidirectionnels dans le fichier CONFIG.SYS ou utilisez la page Langue dans le bloc-notes Propriétés (bloc-notes Paramètres dans OS/2 Warp Server for e-business) de l'objet.

### 5.5 Paramètres d'environnement japonais dans la version japonaise d'OS/2 Warp 4

Pour OS/2 Warp 4 version japonaise, utilisez les paramètres d'environnement japonais suivants :

Page de codes : | 932
Code ShiftJIS : | New JIS

### 5.6 Polices nécessaires sous la version japonaise d'OS/2 Warp

Pour l'utilisation du Kit de développement, votre système doit disposer des polices suivantes :

Nom | Style
GOTHIC | Normal
GOTHIC | HeiseiKakuGothic-W5-H-90-TT
MINCHO | HeiseiMincho-W3-H-90-TT
Polices requises pour la version japonaise d'OS/2 Warp

Vous pouvez vérifiez leur présence en accédant à la Palette de polices, qui se trouve dans le dossier Configuration du système dans le dossier OS/2.

- La police GOTHIC Normal est incluse dans la police japonaise système GOTHIC.
- La police GOTHIC HeiseiKakuGothic-W5-H-90-TT est la police TrueType IBM HeiseiKakuGothic avec l'ordre New JIS.
- La police MINCHO HeiseiMincho-W3-H-90-TT est la police TrueType IBM HeiseiMincho avec l'ordre New JIS.

Vous pouvez installer ces polices à l'aide de l'objet programme d'installation sélective qui se trouve dans le dossier Install/Remove du dossier System Setup sur les systèmes OS/2 Warp 4 et OS/2 Warp Server for e-business.

### 5.7 Amélioration de la qualité des polices sous OS/2 Warp Server for e-business

Sous OS/2 Warp Server pour e-business, vous pouvez améliorer la qualité d'une petite police en activant une association entre une police contour et une police bitmap. Pour activer une telle association, procédez comme suit :

1. Ouvrez le dossier OS/2.
2. Ouvrez le dossier Configuration du système.
3. Ouvrez l'objet Système.
4. Ouvrez la page d'association à une police bitmap.
5. Cliquez sur le bouton Activation.
6. Cliquez deux fois sur l'icône du menu système pour refermer l'objet Système.

Pour plus d'informations sur l'association de police bitmap, cliquez sur le bouton Aide de la page d'association à une police bitmap.

## 6.0 DESINSTALLATION DU KIT DE DEVELOPPEMENT

Les sections qui suivent expliquent comment désinstaller le Kit de développement.

Si vous avez installé des composants du kit plusieurs fois sans les désinstaller, les références à JAVA131 subsistent dans le fichier CONFIG.SYS. Si vous souhaitez les supprimer, supprimez-les de ce fichier.

Remarque : si Netscape Communicator est en fonctionnement lors de la désinstallation du Kit de développement, celle-ci échoue. Vous devez arrêter Netscape Communicator avant de commencer la désinstallation.

### 6.1 Depuis le bureau

Pour désinstaller le kit avec l'objet Remove the Developer Kit, procédez comme suit :

1. Ouvrez le dossier OS/2.
2. Ouvrez le dossier Configuration du système.
3. Ouvrez le dossier Désinstallation des fonctions. Sous OS/2 Warp 4, ouvrez le dossier Installation/Retrait puis le dossier Désinstallation des fonctions.
4. Cliquez deux fois sur l'objet Remove the Developer Kit for OS/2 pour lancer le programme de désinstallation.

Si vous avez extrait des fichiers de polices supplémentaires ou des fichiers de plug-in Java commeplugin.exe ou mzplugin.exe, et que vous voulez les supprimer de votre système, passez dans le répertoire où vous les avez installés et supprimez-les.

### 6.2 Depuis l'invite de commande OS/2

Pour lancer la désinstallation, passez dans la racine de l'unité sur laquelle est installé l'environnement d'exécution, puis entrez la commande suivante :

         JAVA131/UNINSTAL/UNINSTAL

Le programme de désinstallation vous fait suivre les étapes de désinstallation. Seuls les fichiers et répertoires créés par le processus d'installation sont supprimés. Par exemple, le répertoire HOTJAVA créé en exécutant le visualiseur d'applet n'est pas supprimé par la désinstallation.

Si vous avez extrait des fichiers de polices supplémentaires ou des fichiers de plug-in Java commeplugin.exe ou mzplugin.exe, et que vous voulez les supprimer de votre système, passez dans le répertoire où vous les avez installés et supprimez-les.

### 6.3 Désinstallation du Kit de développement sous WorkSpace On-Demand 2.0

Le support pour la désinstallation du kit de développement requiert l'accès à un objet d'inventaire (Java 1.3) dans le répertoire Installed Features (\os2\install\installed features). Si vous avez installé le Kit de développement pour le Client et pour le Serveur WorkSpace On-Demand 2.0, l'objet d'inventaire Java 1.3 est endommagé ou remplacé. Par conséquent, n'utilisez pas le programme de désinstallation pour supprimer de l'espace client les composants du kit.

Supprimez plutôt la structure de répertoire [unitérpldrive]\ibmlan\rpl\bb20.xx\JAVA131 et toutes les références à ce répertoire qui ont été ajoutées dans les répertoires d'image de client WorkSpace On-Command (telles que dans les fichiers CONFIG.SYS, OS2.INI et FIT).

Pour supprimer du serveur le Kit de développement, supprimez l'arborescence \JAVA131. Vous pouvez la supprimer dans le dossier Unités du dossier OS/2.

### 6.4 Désinstallation automatique

Pour désinstaller le Kit de développement, entrez la commande ci-après en une seule ligne :

         clifi /a:u /f:"<WP_INSTALLED>" /o:INV_JAVA13 /set:Selection=ALL

### 6.5 Retrait du Kit de développement comme JVM par défaut

Pour supprimer ou remplacer le Kit de développement comme JVM par défaut, supprimez x:\JAVA131\JRE\BIN; de l'instruction PATH dans le fichier CONFIG.SYS. Pour que la modification prenne effet, vous devez redémarrer le système.

## 7.0 LIMITATIONS CONNUES

- Si vous installez le Kit de développement comme JVM par défaut, certaines applications ne fonctionneront pas correctement. Il s'agit de :
  - LVMGUI : interface graphique du gestionnaire de volume logique,
  - certains composants de TCP/IP.

- Le Kit de développement ne peut pas écrire ni lire dans les fichiers dont la taille est de 2 Go ou plus.

- Si vous téléchargez et installez les extensions de sécurité JCE (Java Cryptography Extensions), supprimez le fichier jar JCA (Java Cryptography Archictecture) (jre/lib/ext/ibmjca.jar) lors de l'installation. Comme la fonctionnalité JCA est un sous-ensemble de JCE, le Kit de développement risque de fonctionner de façon incorrecte si elles sont toutes les deux installées.

- Le pont JDBC-ODBC (connectivité base de données Java-connectivité base de données ouverte) n'est pas pris en charge.

- Le Plug-in Java ne supporte pas la fonction d'impression dans cette version du kit de développement.

- Certaines applications peuvent être codées de façon non paramétrée pour la recherche des exécutables du Kit de développement dans le répertoire JAVA131\bin. Ces exécutables se trouvent dans le répertoire x:\JAVA131\jre\bin\. Si vous avez affaire à une telle application, entrez ce qui suit sur une ligne de commande pour les recopier dans le répertoire JAVA131\bin :

           copy x:\JAVA131\jre\bin\*.exe to x:\JAVA131\bin

  où x représente l'unité sur laquelle vous avez installé le kit de développement. JAVA131 est le nom du répertoire par défaut.

  Si vous appliquez un niveau de maintenance au Kit de développement, refaites après cela l'étape précédente.

- Lorsque vous utilisez le plug-in Java d'IBM, laissez aux applets le temps de finir leur chargement pour éviter un "blocage" du navigateur. Par exemple, si vous cliquez sur les boutons Précédent, puis Suivant, pendant le chargement d'une applet, il est possible que le chargement des pages HTML échoue.

- Bien que le plug-in Java d'IBM prenne en charge le même niveau de fonctionnalité LiveConnect que celui de la version Sun actuelle du plug-in Java (1.3.0_01), certains échecs Live Connect ont été identifiés dans les deux plug-ins. Lorsque vous faites état d'échecs liés à LiveConnect, veuillez indiquer s'ils surviennent avec la version Sun ou IBM du plug-in.

- La taille maximale de la mémoire cache sur disque HPFS est de deux méga-octets. Cela peut limiter les performances du Kit de développement. Dans un grand nombre d'environnements, les performances système et la durée de chargement des applications peuvent être améliorées en utilisant une mémoire cache de plus grande taille. Les systèmes de fichiers OS/2 prenant en charge une mémoire cache de plus grande taille sont les suivants :

  - JFS inclus dans OS/2 Warp Server for e-business d'IBM
  - HPFS 386 inclus dans OS/2 Warp Server Advanced
- Si vous rencontrez des incidents de retraçage sur une machine Pentium MMX (ou modèle inférieur), vous pouvez les corriger en définissant la variable d'environnement JAVA_COMPILER=NONE.

## 8.0 REMARQUES

(c) Copyright International Business Machines Corporation 1999, 2002. Tous droits réservés.

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 mentionnés dans le présent document. La remise de ce document ne vous donne aucun droit de licence sur ces brevets ou demandes de brevet. Vous pouvez envoyer, par écrit, vos demandes de renseignements relatives aux licences au :

IBM Director of Licensing
IBM Corporation
North Castle Drive
Armonk, NY 10504-1758
Etat-Unis

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-0032, Japon

Le paragraphe suivant ne s'applique ni au Royaume-Uni, ni dans aucun autre 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. Il est mis à jour périodiquement. Chaque nouvelle édition inclut les mises à jour. IBM peut modifier sans préavis les programmes et les logiciels qu'il décrit.

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 à :

JTCMAIL@uk.ibm.com
[Hursley Java Technology Center (JTC)]

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 termes du Contrat sur les produits et services IBM, 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.

LICENCE DE COPYRIGHT :

Le présent document 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 lesquelles 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.

La présente édition s'applique à la version 1.3.1 du produit IBM OS/2 Warp Developer Kit, Java 2 Technology Edition, et toutes les versions et modifications ultérieures, jusqu'à ce que de nouvelles indications figurent dans les nouvelles éditions.

Ce programme est, pour partie, le fruit des travaux du Free Type Project. Pour plus d'informations, connectez-vous au site http://www.freetype.org

## 9.0 MARQUES

Les termes qui suivent sont des marques d'International Business Machines Corporation dans certains pays :

IBM
OS/2
OS/2 Warp
NetView
WebExplorer

Java et toutes les marques et logos incluant Java sont des marques de Sun Microsystems, Inc. dans certains pays.

Microsoft et Windows NT sont des marques de Microsoft Corporation dans certains pays.

Intel et Pentium sont des marques déposées d'Intel Corporation dans certains pays.

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

[FIN-DU-GUIDE D'INSTALLATION ET DE CONFIGURATION]