IBM Runtime Environment for Windows, Java  2 Technology Edition, Version 1.3.1, version 64 bits
- 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 du README s'applique à IBM Developer Kit for Windows, Java 2 Technology Edition, Version 1.3.1, version 64 bits, 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, version 64 bits. Vous devez vous y reporter si vous avez l'intention de distribuer le composant Runtime Environment avec votre produit.

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


Sommaire

  • Généralités
  • Fichiers du 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é)
  • Exécution de plusieurs machines JVM avec le compilateur JIT
  • Obtention du numéro de compilation et de version IBM
  • Lancement de l'interpréteur Runtime Environment
  • Interpréteur Java Runtime
  • Propriétés système
  • Exemple de programme
  • Installation de l'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
  • Documentation du composant Runtime Environment
  • Remarques
  • Marques

  • Généralités

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


    Fichiers de Runtime Environment

    Le composant Runtime Environment contient des fichiers .dll, ainsi que des classes nécessaires pour prendre en charge un programme Java Sun Microsystems lors de son exécution. 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.


    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. Ce compilateur JIT (jitc.dll) est activé par défaut.

    Désactivation du compilateur JIT

    Vous pouvez désactiver le compilateur JIT pour isoler un incident lié à l'application, à une applet 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 est utilisé, le message suivant s'affiche :

        JIT enabled: jitc
    

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

        JIT disabled
    

    Exécution de plusieurs machines JVM avec le compilateur JIT

    Lorsque plusieurs machines JVM sont exécutées, il est possible que le compilateur ait besoin qu'une grande quantité de mémoire pour compiler des méthodes importantes ou comportant des expressions arithmétiques complexes. Dans ce cas, il sera peut-être nécessaire d'augmenter de manière considérable la quantité de mémoire virtuelle sur le système.


    Obtention du numéro de compilation et de version IBM

    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.


    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 indiquée ci-après 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. Cette page Web est disponible à l'adresse suivante :

    http://java.sun.com

    1. Sélectionnez Products & APIs.
    2. Sélectionnez Java 2 Platform, Standard Edition (J2SE) sous Product Groups.
    3. Sélectionnez Java 2 SDK, Standard Edition, v1.3.1 sous Current Releases.
    4. Sélectionnez Browse sous Documentation à gauche.
    5. Sélectionnez Notes for Developers sous Java Runtime Environment and Java Plug-in.

    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-win64-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. 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

    IBM Developer Kit for Windows, Java 2 Technology Edition, version 1.3.1, 64-bit version 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 volumineux 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 :


    Documentation du composant 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.