IBM Runtime Environment for Windows, Java  2 Technology Edition, Version 1.3.1, 32-bit version
- README -


Remarque : Avant d'utiliser le présent document et le produit associé, prenez connaissance des informations générales figurant à la section Remarques.

Cette édition s'applique à IBM Developer Kit for Windows, Java 2 Technology Edition, Version 1.3.1, 32-bit version, ainsi qu'aux versions et modifications suivantes, sauf indication contraire dans les nouvelles éditions.

(c) Copyright Sun Microsystems, Inc. 1997, 2001, 901 San Antonio Rd., Palo Alto, CA 94303 USA. All rights reserved.

(c) Copyright International Business Machines Corporation, 1999, 2002. All rights reserved.


Ce fichier README contient des informations sur le composant Runtime Environment fourni avec IBM Developer Kit for Windows, Java 2 Technology Edition, Version 1.3.1, 32-bit version. Vous devez vous y reporter si vous avez l'intention de distribuer le composant Runtime Environment avec votre produit.

Le composant Runtime Environment est pris en charge par les systèmes d'exploitation suivants :


Sommaire

  • Généralités
  • Fichiers inclus avec le composant Runtime Environment
  • Compilateur JIT (Just-In-Time)
  • Désactivation du compilateur JIT
  • Activation du compilateur JIT
  • Vérification de l'état du compilateur JIT (activé ou désactivé)
  • Obtention du numéro de compilation et de version IBM
  • Lancement du composant Runtime Environment
  • Conditions requises pour la redistribution
  • Interpréteur Java Runtime
  • Propriétés système
  • Exemple de programme
  • Installation d'une application sur le système d'un utilisateur
  • Définition des règles de récupération de place
  • Délai d'interruption
  • Réduction du délai d'interruption
  • Environnements à segments très saturés
  • Informations complémentaires sur la récupération de place
  • Exécution d'applications avec des technologies d'assistance natives
  • Documentation de Runtime Environment
  • Remarques
  • Marques

  • Généralités

    Le composant Runtime Environment contient la machine virtuelle Java (JVM), les classes Java Sun Microsystems et des fichiers de prise en charge. Il ne contient pas toutes les classes disponibles dans le composant Developer Kit package.


    Fichiers inclus avec le composant Runtime Environment

    Le composant Runtime Environment comprend des fichiers .dll, ainsi que des classes pour prendre en charge les programme Java lors de leur exécution. Le composant Runtime Environment ne comporte aucun outil de développement (comme appletviewer ou javac), ni aucune classe qui appartiendrait uniquement à un système de développement.

    Pour plus d'informations sur les fichiers à redistribuer avec les programmes Java, reportez-vous à la section Conditions requises pour la redistribution.


    Compilateur JIT (Just-In-Time)

    Le compilateur JIT génère dynamiquement le code machine utilisé par les séquences de code intermédiaire dans une application ou une applet Java en cours d'exécution. Le compilateur JIT (jitc.dll) est activé par défaut.

    Désactivation du compilateur JIT

    Vous pouvez désactiver le compilateur JIT afin d'isoler plus facilement les incidents liés à une application, à une applet Java ou au compilateur lui-même.

    Vous disposez de deux méthodes pour désactiver le compilateur JIT :

    Activation du compilateur JIT

    Pour activer le compilateur, tapez la commande suivante :

        set JAVA_COMPILER=jitc
    

    Vérification de l'état du compilateur JIT (activé ou désactivé)

    Pour vérifier si le compilateur JIT est activé ou non, tapez la commande suivante :

        java -version
    

    Si le compilateur JIT est utilisé, un message s'affiche et indique notamment :

        JIT enabled: jitc
    

    Si le compilateur JIT n'est pas utilisé, le message suivant s'affiche :

        JIT disabled
    

    Obtention du numéro de compilation et de version

    Pour obtenir les numéros de compilation et de version IBM, entrez la commande suivante :

        java -version
    

    Lancement du composant Runtime Environment

    Pour exécuter une application Java, tapez la commande suivante :

        java nom_classe
    

    nom_classe représente le nom du fichier de classe Java (application Java) que vous souhaitez exécuter. Pour plus d'informations sur les paramètres disponibles lors du lancement de l'outil Java, reportez-vous à la section Interpréteur Java Runtime.

    Remarque : Si vous n'avez pas installé le composant Runtime Environment en tant que machine java virtuelle, vous devez d'abord définir le chemin d'accès en spécifiant tous les répertoires. Pour mettre à jour le chemin, tapez la commande suivante :

        set path=rép_java\jre\bin;%path%
    

    rép_java représente le répertoire d'installation du composant Runtime Environment. Par défaut, il s'agit du répertoire C:\Program Files\IBM\Java131.


    Condition requise pour la redistribution

    Lors de la redistribution du composant Runtime Environment, vous devez inclure les fichiers disponibles dans le composant suivant :

    Pour obtenir des informations spécifiques sur les fichiers à redistribuer, reportez-vous au contrat de licence relatif au produit.

    Le terme requis signifie que les détenteurs de la licence qui distribuent le composant Runtime doivent inclure ces fichiers à leur programme, que ce programme utilise ces fichiers ou non.

    Le composant Runtime Environment comprend les répertoires \bin et \lib, ainsi que les sous-répertoires associées. Ces deux répertoires et leurs sous-répertoires doivent résider dans le même répertoire. Le répertoire bin contient des fichiers exécutables et des bibliothèques natives. Le répertoire lib contient des classes et des fichiers de propriétés.

    Tous les fichiers contenus dans les répertoires bin et lib sont nécessaires pour effectuer la redistribution.

    Remarque : La bibliothèque d'exécution du code C en mode natif (msvcrt.dll) se trouve dans le répertoire système Windows. Assurez-vous que le fichier se trouve à cet endroit. L'emplacement de ce répertoire varie en fonction du système d'exploitation mais il correspond généralement aux chemins d'accès suivants :


    Interpréteur Java Runtime

    L'outil Java lance l'interpréteur Java Runtime pour l'exécution des applications Java. La syntaxe à utiliser pour lancer l'outil java est la suivante :

    Un autre outil, javaw, est disponible. L'outil javaw est comparable à l'outil java mais il n'appelle pas la fenêtre de la console. La syntaxe à utiliser pour lancer l'outil javaw est la suivante :

        javaw [options] nom_classe <args>
    

    Les options de l'outil java sont définies comme suit :


    Propriétés système

    La propriété système ibm.jvm.bootclasspath peut être définie avec l'option -D décrite à la section Interpréteur Java Runtime. La valeur de cette propriété est utilisée comme chemin d'accès supplémentaire et est insérée entre une valeur définie par -Xbootclasspath/p: et le chemin d'accès à la classe d'amorçage. Le chemin d'accès aux classes d'amorçage est le chemin d'accès par défaut ou celui défini avec l'option -Xbootclasspath:.


    Exemple de programme

    La page Web de Sun contient un exemple "Hello World". Cet exemple explique comment créer une application Java de base qui s'exécute et s'intègre dans Java Runtime Environment. Consultez le site Web de Sun à l'adresse : http://java.sun.com Vous pouvez vous procurer l'exemple "Hello World" en recherchant "Hello World" et "Notes for Developers".

    Cet exemple explique comment développer une application avec Developer Kit et la déployer plus facilement avec Runtime Environment, très simplement et de façon complètement transparente.


    Installation d'une application sur le système d'un utilisateur

    Dans votre produit, vous devez proposer une méthode pour :

    Si vous redistribuez le composant Runtime Environment, vous devez vérifier que votre procédure d'installation ne remplace pas une installation existante (sauf s'il s'agit d'une version antérieure de Runtime Environment).

    La méthode recommandée consiste à prendre les fichiers disponibles dans le module zip de redistribution Runtime Environment (ibm-jre-n131p-win32-x86.zip) et de les installer dans la même structure de répertoires. Veillez à inclure tous les fichiers stockés dans les répertoires bin et lib, ainsi que dans les sous-répertoires associés. Ces répertoires sont décrits à la section Conditions requises pour la redistribution. Le composant Runtime Environment ne peut être redistribué que dans son intégralité. En effet, l'application que vous distribuez comporte sa propre copie de Runtime Environment.

    Si vous optez pour cette méthode, ne tentez pas d'émuler les étapes d'installation effectuées par le programme d'installation de Runtime Environment.

    Remarque : Lors de l'installation du composant Runtime Environment, vous devez enregistrer les données du programme dans le registre Windows de la manière suivante :


    Définition des règles de récupération de place

    Le composant Developer Kit propose l'option d'exécution JVM -Xgcpolicy pour définir les règles de récupération de place.

    -Xgcpolicy accepte deux valeurs, optthruput (par défaut) et optavgpause. Cette option contrôle le comportement du récupérateur en établissant des compromis entre le débit de l'application et l'ensemble du système et les délais d'interruption nécessités par la récupération de place.

    Le format et les valeurs de cette option sont les suivants :

    -Xgcpolicy:optthruput
    et
    -Xgcpolicy:optavgpause

    Délai d'interruption

    Lorsque l'espace disponible dans le segment ne permet pas à une application de créer un objet, la fonction de récupération de place identifie les objets non référencés et les supprime, ce qui rétablit l'état du segment et permet de répondre rapidement aux demandes d'affectation de ressources actuelles et ultérieures. Des cycles de récupération de place de ce type génèrent parfois des interruptions inattendues dans l'exécution du code d'application. A mesure que la taille et la complexité des applications augmentent, la taille des segments s'accroît et les interruptions causées par le processus de récupération de place deviennent plus longues et plus gênantes. La valeur de récupération de place par défaut, optthruput, offre un débit très élevé aux applications, au prix d'interruptions fréquentes, d'une durée comprise entre quelques millisecondes et plusieurs secondes, selon la taille du segment et la quantité de place à récupérer.

    Réduction du délai d'interruption

    La valeur optavgpause réduit sensiblement la durée des interruptions générées par le processus de récupération de place et réduit l'impact de l'augmentation de taille du segment sur la durée des interruptions. L'effet de cette option est le plus sensible dans des configurations comportant des segments de grande taille. (Un segment est considéré comme grand lorsqu'il atteint au moins 1 Go.) Les délais d'interruption sont réduits en faisant alterner les opérations de récupération de place et les exécutions normales du programme. Cette alternance réduit un peu le débit de l'application.

    Environnements à segments très saturés

    Si le segment Java est proche de la saturation et que la place à récupérer est très limitée, les demandes de nouveaux objets ne sont pas satisfaites rapidement car aucun espace n'est disponible immédiatement. Si le segment est utilisé au maximum de sa capacité ou presque, une baisse de performances se produit au niveau des applications, indépendamment du réglage des options définies ci-dessus. Si des demandes d'espace supplémentaire sont effectuées, l'application reçoit une exception Out of Memory qui entraîne l'arrêt de la JVM si cette dernière n'est pas interceptée et traitée. Dans ces cas de figure, il est recommandé d'augmenter la taille du segment à l'aide de l'option -Xmx ou de réduire le nombre d'objets d'application utilisés.

    Informations complémentaires sur la récupération de place

    Pour obtenir des informations sur l'ajustement de la taille du segment et sur les incidences de la récupération de place sur les performances des applications, consultez les sites Web suivants :


    Exécution d'applications Java avec des technologies d'assistance en mode natif

    Sun fournit le composant Java Access Bridge pour permettre aux technologies d'assistance Windows natives (par exemple, d'accéder au support Java Accessibility dans une application Java. Ces programmes d'assistance Windows natifs doivent avoir été écrits pour effectuer des appels à Java Access Bridge.

    Le composant Java Access Bridge disponible auprès de Sun comprend un programme d'installation qui place cinq fichiers dans les répertoires appropriés : access-bridge.jar, jaccess.jar, accessibility.properties, JavaAccessBridge.dll et WindowsAccessBridge.dll.

    Si vous avez déjà installé IBM Accessibility Bridge (JawBridge), qui permet à Windows 2000 Magnifier de fonctionner avec les applications Swing, et que vous souhaitez l'exécuter en même temps que Java Access Bridge, modifiez la ligne dans le fichier accessibility.properties pour obtenir :

    assistive_technologies=com.sun.java.accessibility.AccessBridge, JawBridge Pour désactiver les deux composants, mettez cette ligne en commentaire en la faisant précéder du caractère dièse #.

    Consultez ce site Web pour connaître les modalités de téléchargement du composant Java Access :


    Documentation de Runtime Environment

    Chaque fichier de propriétés contient des commentaires qui décrivent comment utiliser et modifier le fichier.


    Remarques

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

    IBM peut détenir des brevets ou des demandes de brevet couvrant les produits 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. Si vous désirez recevoir des informations concernant l'acquisition de licences, veuillez en faire la demande par écrit à l'adresse suivante :

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

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

    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.


    Marques

    IBM est une marque d'International Business Machines dans certains pays.

    Java et toutes les marques et logos incluant Java sont des marques de Sun Microsystems, Inc dans certains pays. La technologie Java est utilisée avec l'autorisation exclusive de la société Sun Microsystems, Inc.

    Microsoft, Windows, Windows NT et le logo Windows sont des marques de Microsoft 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.