### Environnement d'exécution du produit

#### IBM(*) OS/2(*) Warp Developer Kit, Edition Java(*) Technology, Version 1.1.8

Le produit IBM OS/2 Warp Developer Kit, Edition Java(*) Technology, Version 1.1.8 (Kit de développement) est basé sur le niveau de maintenance Java 1.1.2 de Sun Microsystems. Ce document décrit les modalités d'utilisation du composant d'exécution du Kit de développement.

- Installation
- Interpréteur Java
- Visualiseur d'appliquette
- Configuration
- Spécificité de la plateforme
- Désactivation du compilateur JIT
- Informations sur les environnements DBCS
- Informations complémentaires
- Remarques

  ## Installation

  Pour connaître les dernières instructions d'installation, reportez-vous au fichier README du Kit de développement, situé dans le répertoire \JAVA11. Lorsque le produit a été installé, ce fichier se trouve dans le répertoire dans lequel les fichiers du Kit de développement ont été décompressés.

  L'installation du composant d'exécution génère les modifications suivantes dans les instructions PATH et LIBPATH du fichier CONFIG.SYS :

        PATH        inclut x:\java11\bin;
        LIBPATH     inclut x:\java11\dll;

  où x est l'unité d'installation cible du composant d'exécution Java.

  ## Interpréteur Java

  L'interpréteur Java (JAVA) exécute le code pré-compilé. Ce code se trouve dans un fichier .class.

  Pour exécuter l'application Java hello.class, entrez la commande suivante à l'invite OS/2 :

              java  hello

  Remarque : Lorsque vous entrez le nom, vous devez faire une distinction entre les majuscules et les minuscules et l'extension du fichier ne doit pas être spécifiée (il doit s'agir d'un fichier .class).

  Les applications Java utilisant le composant AWT (Abstract Window Toolkit) peuvent être lancées via la commande JAVA. La commande JAVAPM permet de garantir la compatibilité avec les versions précédentes du Kit de développement ; toutefois, cette commande est désormais inutile.

  Le fichier .class est créé par le compilateur Java (JAVAC). Le compilateur Java est fourni avec le composant de développement (Toolkit) ; il n'est pas nécessaire de l'utiliser si vous n'écrivez pas de programmes.

  Si, à l'invite OS/2, vous entrez la commande JAVA sans indiquer d'options, la liste des options disponibles s'affiche.

  ## Visualiseur d'appliquette

  Le visualiseur d'appliquette (APPLET) permet d'exécuter rapidement des appliquettes Java. Si le fichier HTML indiqué ne contient pas d'appliquette Java, le système ne lance aucun processus.

  Pour exécuter l'appliquette du fichier tictactoe.html, entrez la commande suivante à l'invite OS/2 :

             applet  tictactoe.html

  Si, à l'invite OS/2, vous entrez la commande APPLET sans indiquer d'options, la liste des options disponibles s'affiche dans une fenêtre en incrustation.

  ## Configuration

  Un certain nombre de variables d'environnement permettent de modifier le fonctionnement du composant d'exécution Java :

  SET JAVA_AUDIO_RATE=n
    Permet de définir le taux d'échantillonnage en lecture pour la fonction audio. La valeur 8 pour la variable n définit un taux de 8000 échantillonnages par seconde. Indiquez la valeur 11 pour obtenir 11025 échantillonnages par seconde. Le composant d'exécution Java applique d'abord un taux d'échantillonnages de 8000, correspondant au débit des données en entrée ; il utilise ensuite 11025 échantillonnages.

    Certains pilotes de périphériques, comme ceux des systèmes ThinkPad 701C antérieurs à octobre 1995, prennent en charge un taux d'échantillonnage de 8000, puis génèrent une erreur. Toutefois, vous pouvez remédier à cela en définissant un taux de 11025.

  SET JAVA_AUDIO_VOLUME=v
    Règle le niveau sonore pour les données audio. La variable v correspond au pourcentage du volume maximum ; la valeur doit être comprise entre 0 et 100. La valeur par défaut est 75.

  SET JAVA_SOUND_MODE=ON
    Le son peut être produit selon deux méthodes : Memory Playlist et Direct Audio Real Time (DART). La méthode DART est utilisée par défaut et s'avère la plus performante en terme d'utilisation CPU et de temps de réponse. La méthode Memory Playlist, plus ancienne, supporte une compatibilité amont destinée aux données audio les moins performantes.

    Ces deux méthodes peuvent être utilisées indifféremment pour exécuter les programmes audio Java version 1.1.x ou antérieure. Si vous ne devez pas prendre en charge des données audio anciennes et peu performantes, il n'est pas nécessaire de choisir une méthode autre que la méthode DART par défaut. Vous trouverez, plus loin, des informations sur l'utilisation des méthodes Memory Playlist et DART.

    Pour utiliser la méthode Memory Playlist, entrez les données suivantes sur la ligne de commande ou dans le fichier CONFIG.SYS :

        SET JAVA_SOUND_MODE=ON

    Pour désactiver la variable d'environnement et utiliser la méthode DART, entrez les données suivantes sur la ligne de commande ou dans le fichier CONFIG.SYS :

        SET JAVA_SOUND_MODE=

  SET JAVA_COMPILER=<xyz>
    Définit le nom du compilateur JIT (Just In Time) à charger. La valeur par défaut est JAVAX.

    Pour désactiver le compilateur JIT, consultez la rubrique Désactivation du compilateur JIT.

  SET JAVA_CONSOLE=<1>
    Indique que les programmes Java lancés par JAVA et APPLET sont exécutés sur la console.

  SET JAVA_HOME=<dir>
    Définit le chemin d'accès aux répertoires d'exécution partagés Java.

  SET JAVA_NLS_SBCS=1
    Indique que les applications Java doivent être exécutées en mode SBCS (Single Byte Character Set), même dans les environnements DBCS (Double Byte Character Set).

  SET JAVA_NOPRINTDLG=1
    Indique que les applications Java doivent supprimer l'affichage de la boîte de dialogue définissant les propriétés de l'imprimante avant le lancement d'une impression. Il est possible d'imprimer des travaux sans requérir l'intervention de l'utilisateur, en appliquant les valeurs par défaut.

  SET JAVA_USER=<dir>
    Définit le chemin d'accès aux répertoires contenant les fichiers d'un utilisateur spécifique, comme le fichier hotjava\property.

  SET JAVA_WEBLOGS=<dir>
    Définit le chemin d'accès au répertoire contenant les fichiers Weblog de chaque processus Java.

  SET JAVA_NORESTART=1
    Indique que la commande JAVA ne doit pas être lancée sous forme de processus Presentation Manager.

  SET JAVA_CLOCK_RESOLUTION
    Permet de spécifier la résolution du délai nécessaire à partir de la méthode currentTimeMillis de la classe java.lang.System. La résolution est spécifiée en millisecondes. Par exemple :

        SET JAVA_CLOCK_RESOLUTION = 1

    Définit une résolution de délai minimum de 1 milliseconde (résolution la plus élevée) pour les applications Java utilisant currentTimeMillis.

    Les résolutions de délai dépendent de celles fournies par le système d'exploitation OS/2. Le système Java les arrondit à la résolution disponible la plus proche. La résolution la plus élevée (1 milliseconde) est toujours disponible. La valeur par défaut de JAVA_CLOCK_RESOLUTION est de 10 millisecondes, avec une précision de plus ou moins 1 milliseconde.

    Pour tirer pleinement profit des performances Java avec currentTimeMillis, utilisez :

        set JAVA_CLOCK_RESOLUTION = 32

    Cela peut être important lors de l'exécution de tests Java.

  ## Spécificité de la plateforme

  Sous OS/2, on note certains changements spécifiques de la plateforme :

  ### Généralités

  - La variable d'environnement HOME s'appelle JAVA_USER.

  ### Visualiseur d'appliquette

  - Le visualiseur d'appliquette s'appelle APPLET.

  - stdin, stdout et stderr sont dirigés vers la fenêtre OS/2 utilisée pour le lancement du Visualiseur d'appliquette.

  - Lorsque le visualiseur d'appliquette est lancé directement sous la forme d'un programme Presentation Manager (comme dans la commande suivante), les sorties stdout et stderr sont redirigées vers le répertoire WEBLOGS. Il convient pour cela d'utiliser la commande suivante :

             start /PM applet.exe exemple1.html

    Pour arrêter l'opération, indiquez l'option -nore.

  ### Applications Java

  - Si une application utilisant Abstract Window Toolkit (AWT) est exécutée via la commande JAVA, elle est relancée sous forme de processus Presentation Manager. Lors de la relance, stdin, stdout et stderr sont redirigées vers la fenêtre OS/2 de saisie de la commande JAVA.

  - Pour éviter de relancer la commande JAVA sous la forme d'un processus Presentation Manager, indiquez l'option -norestart. La variable d'environnement JAVA_NORESTART permet également d'éviter la relance de la commande. Si un programme Java utilisant AWT est lancé avec la commande java -norestart dans une session autre que Presentation Manager, il ne sera pas en mesure de générer de nouvelle fenêtre en raison des limites de Presentation Manager (PM) OS/2.

  - Pour visualiser les données stdout et stderr des programmes exécutés comme processus PM OS/2 via les commandes JAVA ou APPLET, vous disposez d'une console Java. Pour exécuter les programmes sur la console, indiquez l'option -cons ou définissez la variable d'environnement JAVA_CONSOLE.

  - Si vous lancez une application Java appelant un programme autre que Presentation Manager, utilisez l'option -norestart. Par exemple, si l'application Java JavaApp appelle un programme autre que Presentation Manager, lancez-la en entrant la commande suivante à l'invite OS/2 :

        java -norestart JavaApp

    Des erreurs sont générées si vous n'utilisez pas l'option -norestart.

  ## Désactivation du compilateur JIT

  Le compilateur Just-In-Time (JIT) est fourni avec le Kit de développement. 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'appliquettes Java. Le compilateur est activé par défaut.

  Lorsqu'un incident se produit dans une application Java, une appliquette 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 :

       -nojit

  La machine virtuelle interprète directement le code pré-compilé, sans le convertir en code natif.

  ## Informations sur les environnements DBCS

  - Les polices à chasse sur octet unique des jeux de caractères DBCS (Double Byte Character Set), comme les polices Katakana des jeux de caractères japonais, ne peuvent pas être affichées avec les composants AWT.

    Comme pour les spécifications JavaSoft, le Kit de développement ne supporte que les jeux de polices de langue anglaise. Pour afficher le langage DBCS avec les composants AWT, le Kit de développement utilise la fonction d'association de polices DBCS. En raison des limites de cette fonction, le Kit de développement ne peut pas afficher les polices à chasse sur octet unique des langues DBCS avec les composants AWT.

  - Les noms de classes ne peuvent pas contenir des caractères de type DBCS.

  - Les appliquettes ne peuvent pas accéder, à l'aide de la méthode getParameter(), aux chaînes DBCS pour les codes "parameter" lors de leur exécution sur le visualiseur d'appliquette APPLET.

  ## Informations complémentaires

  Pour connaître les dernières innovations de Java et d'IBM, consultez la Page d'accueil Java d'IBM ou le Site Web Java de Sun.

  ## Remarques

  Marques

  Les marques suivantes sont des marques d'International Business Machines Corporation dans certains pays :

  - IBM
  - OS/2

  Les termes qui suivent sont des marques d'autres sociétés :

  - Java est une marque de Sun Microsystems, Inc.
  - La technologie Java* est la propriété de Sun Microsystems Inc., seule société à pouvoir en accorder la licence. Java est une marque de Sun Microsystems Inc. dans certains pays.

  Copyrights

  - (c) Copyright Sun Microsystems, Inc. 1992-1998. All rights reserved.
  - (c) Copyright IBM Corporation, 1996-1998. All rights reserved.
  - (c) Copyright IBM France, 1996-1998. Tous droits réservés.
  - Ce produit repose en partie sur le travail du groupe indépendant JPEG.