### Ambiente de Tempo de Execução para o

#### IBM(R) OS/2(R) Warp Developer Kit, Java(TM) Technology Edition, Versão 1.1.8

O IBM OS/2 Warp Developer Kit, Java(TM) Technology Edition, 1.1.8 (Developer Kit) é baseado no nível de suporte Java 1.1.8 da Sun Microsystems. Este arquivo descreve a utilização do componente Tempo de Execução do Developer Kit.

- Instalação
- Interpretador de Java
- Visualizador de Miniaplicativos
- Configuração
- Especificações da Plataforma
- Como desativar o Compilador JIT
- Informações para ambientes DBCS
- Onde encontrar mais informações
- Avisos

  ## Instalação

  Consulte o arquivo README no diretório \JAVA11 para obter as informações mais recentes relativas à instalação. Após a instalação do produto, o arquivo README estará localizado no diretório em que os arquivos do Developer Kit foram descompactados.

  A instalação do componente Tempo de Execução faz as seguintes alterações nas instruções PATH e LIBPATH do arquivo CONFIG.SYS:

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

  onde x é a unidade na qual o componente Tempo de Execução do Java está instalado.

  ## Interpretador de Java

  O Interpretador de Java (JAVA) executa códigos de byte Java. O código de byte Java reside em um arquivo com uma extensão .class.

  Para executar o aplicativo Java hello.class, em um prompt de comandos, digite:

              java  hello

  Nota:O nome do arquivo considera maiúsculas e minúsculas e a extensão do arquivo não deve ser especificada (mas deve ser um arquivo .class).

  As aplicações Java que utilizam o Abstract Window Toolkit (AWT) podem ser iniciadas com o comando JAVA. O comando JAVAPM é fornecido para compatibilidade com as versões anteriores do Developer Kit, porém não é mais necessário.

  O arquivo .class é criado pelo Compilador de Java (JAVAC). O Compilador de Java está incluído como parte do componente Java Toolkit e só é necessário se você for escrever programas Java.

  Se você digitar JAVA sem qualquer opção em um prompt de comandos, uma lista de opções disponíveis será exibida.

  ## Visualizador de Miniaplicativos

  O Visualizador de Miniaplicativos Java (APPLET) fornece uma maneira rápida de executar os miniaplicativos Java. Se o arquivo HTML especificado não contiver um miniaplicativo Java, nenhuma função será executada.

  Para executar o miniaplicativo contido no arquivo tictactoe.html, digite em um prompt de comandos:

             applet  tictactoe.html

  Se digitar APPLET sem qualquer opção em um prompt de comando do OS/2, uma lista de opções disponíveis será exibida em uma janela sobreposta.

  ## Configuração

  Algumas variáveis de ambiente estão disponíveis para modificar o comportamento do componente Tempo de Execução do Java:

  SET JAVA_AUDIO_RATE=n
    Define a velocidade de amostragem de reprodução preferida para áudio. O valor 8 para n define a velocidade de reprodução para 8.000 amostras por segundo. Utilize um valor 11 para 11.025 amostras por segundo. O tempo de execução do Java normalmente tenta uma velocidade de amostragem de 8.000, o que corresponde à taxa de fluxo de dados de recepção e, em seguida, 11.025.

    Alguns drivers, como alguns do ThinkPad 701C anteriores a outubro de 1995, parecem suportar uma velocidade de amostragem de 8.000, mas falham. Isso pode ser corrigido definindo uma velocidade de amostragem de reprodução de 11.025.

  SET JAVA_AUDIO_VOLUME=v
    Ajusta o nível de volume para a saída de áudio. v é a porcentagem do volume máximo, de 0 a 100. O padrão é 75.

  SET JAVA_SOUND_MODE=ON
    Há dois métodos para produzir som, Memory Playlist e Direct Audio Real Time (DART). DART é o padrão e resulta em melhor utilização e tempo de resposta da CPU. Memory Playlist é o método mais antigo de produzir som e suporta compatibilidade descendente para áudio de execução mais antiga e lenta.

    Você pode usar um destes métodos para executar o Java 1.1.x ou programas de áudio anteriores. No entanto, se não for necessário o suporte para áudio mais antigo e lento, não há necessidade de alterar o padrão DART. As informações sobre como usar o Memory Playlist ou DART são fornecidas abaixo.

    Para utilizar o método Memory Playlist, digite o seguinte comando em uma linha de comandos ou coloque-o no arquivo CONFIG.SYS:

        SET JAVA_SOUND_MODE=ON

    Para desativar a variável de ambiente e utilizar o método DART, digite o seguinte comando em uma linha de comandos ou coloque-o no arquivo CONFIG.SYS:

        SET JAVA_SOUND_MODE=

  SET JAVA_COMPILER=<xyz>
    Especifica o nome do compilador just-in-time (JIT) a ser carregado. O padrão do JIT é JAVAX.

    Para desativar o JIT, consulte Como Desativar o Compilador JIT.

  SET JAVA_CONSOLE=<1>
    Especifica que os programas Java iniciados por JAVA e APPLET são executados com um console Java.

  SET JAVA_HOME=<dir>
    Especifica o caminho para os diretórios Java de tempo de execução compartilhados.

  SET JAVA_NLS_SBCS=1
    Especifica que os aplicativos Java devem ser executadas no modo de conjunto de caracteres com bytes simples (SBCS), mesmo em ambientes de conjunto de caracteres de duplo byte (DBCS).

  SET JAVA_NOPRINTDLG=1
    Especifica que os aplicativos Java devem suprimir a exibição da caixa de diálogo de propriedades da impressora antes da impressão. Isso permite que os jobs sejam impressos, sem a intervenção do usuário, utilizando as características padrão da impressora.

  SET JAVA_USER=<dir>
    Especifica o caminho para o diretório de arquivos específicos do usuário, como o arquivo hotjava\property.

  SET JAVA_WEBLOGS=<dir>
    Especifica o caminho para o diretório no qual estão gravados os arquivos weblog de cada processo Java iniciado.

  SET JAVA_NORESTART=1
    Especifica que o comando JAVA não deve se auto-reiniciar como um processo do Presentation Manager.

  SET JAVA_CLOCK_RESOLUTION
    Permite especificar a resolução do temporizador necessária do método currentTimeMillis na classe java.lang.System. A resolução é especificada em milissegundos. Por exemplo:

        SET JAVA_CLOCK_RESOLUTION = 1

    define a resolução mínima do temporizador para 1 milissegundo (a resolução mais alta) para aplicativos Java que utilizam currentTimeMillis.

    As resoluções do temporizador disponíveis são dependentes das fornecidas pelo sistema operacional OS/2. O sistema Java arredonda para baixo para a resolução mais próxima disponível. A resolução mais alta, 1 milissegundo, está sempre disponível. O padrão para JAVA_CLOCK_RESOLUTION é 10 milissegundos e geralmente é arredondado para 1 milissegundo de precisão.

    Para garantir o melhor desempenho do Java ao utilizar currentTimeMillis, utilize:

        set JAVA_CLOCK_RESOLUTION = 32

    Isso pode ser importante ao executar avaliações do Java.

  ## Específicos da Plataforma

  Existe uma série de alterações específicas da plataforma para OS/2:

  ### Geral

  - A variável de ambiente HOME chama-se JAVA_USER.

  ### Visualizador de Miniaplicativos

  - O programa Visualizador de Miniaplicativos chama-se APPLET.

  - stdin, stdout e stderr são direcionados à janela do OS/2 onde o Visualizador de Miniaplicativos foi iniciado.

  - Quando o Visualizador de Miniaplicativos é iniciado diretamente como um programa do Presentation Manager (como no comando a seguir) as saídas stdout e stderr são redirecionadas para o diretório WEBLOGS. Isso pode ser feito utilizando o seguinte comando:

             start /PM applet.exe example1.html

    Especifique a opção -nore para parar esse redirecionamento.

  ### Aplicativos Java

  - Uma aplicação Java utilizando o Abstract Window Toolkit (AWT), que é iniciada pelo comando JAVA, faz com que a aplicação seja reinicializada como um processo do Presentation Manager. Quando esse reinício ocorre, stdin, stdout e stderr são redirecionados para a janela do OS/2, onde o comando JAVA foi emitido.

  - Para impedir que o comando JAVA seja reinicializado automaticamente como um processo do Presentation Manager, especifique a opção -norestart. A variável de ambiente JAVA_NORESTART também pode ser utilizada para impedir essa reinicialização. Se um programa Java que utiliza AWT for iniciado com java -norestart em uma sessão não-Presentation Manager, ele não conseguirá criar nenhuma janela devido a uma restrição do Presentation Manager (PM) do OS/2.

  - Para visualizar as saídas stdout e stderr para programas Java executados como processos do PM do OS/2, utilizando JAVA ou APPLET, é fornecido um console Java. Para executar sob o console Java, especifique a opção -cons ou defina a variável de ambiente JAVA_CONSOLE.

  - Se você iniciar uma aplicação Java que chama um programa não-Presentation Manager, utilize a opção -norestart. Por exemplo, se o aplicativo Java JavaApp chamar um programa não-Presentation Manager, inicie-o digitando o seguinte no prompt de comandos do OS/2:

        java -norestart JavaApp

    Ocorrerão erros se não for utilizada a opção -norestart.

  ## Como Desativar o Compilador JIT

  É fornecido um compilador just-in-time (JIT) com o Developer Kit. O compilador JIT gera um código de máquina para seqüências de códigos de bytes utilizadas freqüentemente em uma aplicação ou miniaplicativo Java durante a execução. O JIT é ativado por padrão.

  Você pode desativar o JIT para ajudar no isolamento de um problema com um aplicativo Java, um miniaplicativo ou o próprio compilador passando o seguinte comando para o interpretador de tempo de execução do Java:

       -nojit

  A máquina virtual interpreta diretamente os códigos de byte, sem convertê-los para o código nativo.

  ## Informações para Ambientes DBCS

  - Fontes de largura de bytes simples em conjuntos de fontes de idiomas do conjunto de caracteres de duplo byte (DBCS), como por exemplo, fontes Katakana com metade da largura em conjuntos de fontes japonesas, não podem ser adicionadas em componentes do AWT.

    Conforme a especificação JavaSoft, o Developer Kit suporta somente conjuntos de fontes do inglês. Para adicionar um idioma DBCS aos componentes do AWT, o Developer Kit utiliza a função de associação de fontes DBCS. Devido a uma restrição na função de associação de fontes DBCS, o Developer Kit não pode adicionar fontes com largura de bytes simples aos idiomas DBCS em componentes do AWT.

  - Os nomes das classes não devem conter caracteres DBCS.

  - Os miniaplicativos não podem obter (utilizando o método getParameter()) valores da cadeia DBCS definidos para marcações do parâmetro ao executar sob o Visualizador de Miniaplicativos, APPLET.

  ## Onde encontrar mais Informações

  Para manter-se informado sobre as última novidades do Java e da IBM, visite a Home Page do Java da IBM ou o site da Web do Java da Sun.

  ## Observações

  Marcas

  Os seguintes termos são marcas da International Business Machines Corporation nos Estados Unidos ou em outros países, ou em ambos:

  - IBM
  - OS/2

  Os termos a seguir são marcas de outras empresas:

  - Java é uma marca da Sun Microsystems, Inc.
  - A tecnologia Java(TM) pertence e é exclusivamente licenciada pela Sun Microsystems, Inc. Java é marca da Sun Microsystems, Inc. nos Estados Unidos e em outros países.

  Copyrights

  - (c) Copyright Sun Microsystems, Inc. 1992-1998. Todos os direitos reservados.
  - (c) Copyright IBM Corporation, 1996-1998. Todos os direitos reservados.
  - Esse produto é baseado, em parte, no trabalho do Independent JPEG Group.
  - US Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.