# IBM 32-bit SDK and Runtime Environment for Windows, Java 2 Technology Edition, Version 5.0

# Guia do Usuário

# Informações de Copyright

Nota: Antes de utilizar estas informações e o produto que elas suportam, certifique-se de ler as informações gerais em Avisos.

Esta edição do Guia do Usuário aplica-se ao IBM 32-bit SDK and Runtime Environment for Windows, Java 2 Technology Edition, Version 5.0 e a todos os releases, modificações e Atualizações de Serviços subseqüentes, até que seja indicado de outra maneira em novas edições.

(c) Copyright Sun Microsystems, Inc. 1997, 2004, 901 San Antonio Rd., Palo Alto, CA 94303 USA. Todos os direitos reservados.

(c) Copyright International Business Machines Corporation, 1999, 2005. Todos os direitos reservados.

Direitos Restritos para Usuários do Governo dos Estados Unidos - Uso, duplicação e divulgação restritos pelo documento GSA ADP Schedule Contract com a IBM Corporation.

# Prefácio

Este Guia do Usuário oferece informações gerais sobre o IBM(R) 32-bit SDK and Runtime Environment for Windows(R), Java(TM) 2 Technology Edition, Version 5.0 e informações específicas sobre as diferenças da implementação da IBM comparadas com a implementação da Sun. Leia este Guia do Usuário juntamente com a documentação mais extensa encontrada no Web site da Sun: http://java.sun.com.

O SDK e o Runtime Environment são suportados nos seguintes produtos:

- Windows 2000
- Windows XP
- Windows Server 2003

Observe que o IPv6 é suportado apenas no Windows XP e Windows Server 2003.

O Manual de Diagnóstico fornece informações mais detalhadas sobre o IBM Virtual Machine para Java.

As alterações técnicas deste Guia do Usuário para a Versão 5.0, com exceção das alterações menores ou evidentes, como a atualização de "1.4.2" para "5.0", estão indicadas em vermelho ao visualizar em HTML ou em uma cópia impressa colorida e por barras verticais à esquerda das alterações.

Os termos "Runtime Environment" e "Java Virtual Machine" são utilizados alternadamente neste Guia do Usuário.

# Índice

Informações de Copyright
Prefácio
Visão Geral
Compatibilidade entre Versões
Fazendo Upgrade do SDK
Migrando de Outros IBM JVMs
Conteúdo do SDK e Runtime Environment
Ferramentas do Runtime Environment
Ferramentas do SDK
Instalando e Configurando o SDK e Runtime Environment
Antes de Instalar
Instalação (Interativa) Assistida
Instalando os Pacotes
Instalando o Runtime Environment como a Java Virtual Machine do Sistema
Instalação Não-assistida
Ativando o IBM Accessibility Bridge
Desativando o Suporte de Acessibilidade Java
Informações para Usuários de Idiomas Europeus
Definindo o PATH
Definindo o CLASSPATH
Desinstalação
Utilizando o Runtime Environment
Opções
Especificando Opções Java e Propriedades de Sistema
Opções Padrão
Opções Não Padrão
Obtendo o Número de Compilação e Versão IBM
Globalização do Comando Java
Executando um Arquivo Java Automaticamente
Executando Aplicativos Java com Tecnologias Auxiliares Nativas
O Compilador JIT (Just-In-Time)
Desativando o JIT
Ativando o JIT
Determinando se o JIT Está Ativado
Especificando a Política de Coleta de Lixo
Opções de Coleta de Lixo
Tempo de Pausa
Redução do Tempo de Pausa
Ambiente com Heaps Muito Cheios
Como a JVM Processa Sinais
Sinais Utilizados pela JVM
Vinculando um Driver de Código Nativo à Biblioteca de Cadeia de Sinais
Transformando Documentos XML
Utilizando uma Versão Mais Antiga do Xerces ou Xalan
Utilizando o SDK para Desenvolver os Aplicativos Java
Depurando os Aplicativos Java
JDB (Java Debugger)
Determinando se o Aplicativo Está Sendo Executado em uma JVM de 32 ou 64 bits
Escrevendo Aplicativos JNI
Trabalhando com Applets
Executando Applets com o Applet Viewer
Depurando Applets com o Applet Viewer
| |
Configurando a Alocação da Memória de Página Grande
Suporte ao CORBA
Suporte para GIOP 1.2
Suporte para Interceptadores Portáteis
Suporte para Serviço de Nomes Interoperável
Propriedades do Sistema para Rastrear o ORB
Propriedades do Sistema para Ajustar o ORB
Permissões de Segurança do Java 2 para o ORB
Classes de Implementação do ORB
RMI sobre IIOP
Implementando o Conjunto da Rotina de Tratamento de Conexão para RMI
Suporte ao BiDirectional Avançado
BigDecimal Avançado
Suporte ao Símbolo Euro
Utilizando o Java Communications API (JavaComm)
Instalando o Java Communications API
Configurando o Java Communications API
Limitação ao Imprimir com o Java Communications API
Desinstalando o Java Communications API
Documentação do Java Communications API
Implementando os Aplicativos Java
Utilizando o Plug-in Java
Navegadores Suportados
Suporte a DOM (Document Object Model)
Utilizando Parâmetros DBCS
Utilizando Web Start
Executando o Web Start
Remessa dos Aplicativos Java
| |
Compartilhamento de Dados de Classe Entre JVMs
| |
Visão Geral sobre o Compartilhamento de Classe
| |
Conteúdo do Cache
| |
Atualização Dinâmica do Cache
| |
Ativando o Compartilhamento de Classe
| |
Segurança do Cache
| |
Tempo de Vida do Cache
| |
Utilitários do Cache
| |
Utilizando as Opções da Linha de Comandos para Compartilhamento de Classe
| |
Criando, Preenchendo, Monitorando e Excluindo um Cache
| |
Desempenho e Consumo de Memória
| |
Limitações e Considerações sobre Como Utilizar o Compartilhamento de Classe
| |
Limites no Tamanho do Cache
| |
Modificação do Bytecode de Tempo de Execução
| |
Limitações do Sistema Operacional
| |
Utilizando SharedClassPermissions
| |
Adaptando Carregadores de Classe Personalizados às Classes de Compartilhamento
Serviço e Suporte para Fornecedores Independentes de Software
Acessibilidade
Acessibilidade iKeyman
Keyboard Traversal dos Componentes JComboBox no Swing
Acessibilidade do Web Start
Nota Geral Sobre Segurança
Limitações Conhecidas
Algum Comentário sobre este Guia do Usuário?
Avisos
Marcas Registradas

# Visão Geral

O IBM SDK é um ambiente de desenvolvimento para gravação e execução de applets e aplicativos compatíveis com o IBM Java 5.0 Core Application Program Interface (API).

O SDK inclui o Runtime Environment para Windows, que permite somente a execução de aplicativos Java. Se você instalou o SDK, o Runtime Environment está incluído.

O Runtime Environment contém a Java Virtual Machine e os arquivos de suporte que incluem os arquivos de classe. O Runtime Environment contém apenas um subconjunto das classes localizadas no SDK e permite suportar um program Java no tempo de execução, mas não permite compilar programas Java. O Runtime Environment para Windows não inclui nenhuma das ferramentas de desenvolvimento, como appletviewer.exe, o compilador Java (javac.exe) ou as classes que pertençam apenas aos sistemas de desenvolvimento.

Além das plataformas o pacote Java Communications API (Application Programming Interface) é fornecido para utilização com o Runtime Environment para Windows. Informações sobre ele podem ser encontradas em Utilizando o Java Communications API (JavaComm).

## Compatibilidade entre Versões

Em geral, qualquer applet ou aplicativo que seja executado com uma versão anterior do SDK deverá ser executado corretamente com o IBM 32-bit SDK for Windows, v5.0. Não há garantia de que as classes compiladas com esta versão funcionem com as versões anteriores.

|O IBM 32-bit SDK for Windows, V5.0, |foi criado com o Microsoft Visual Studio .NET 2003.

Para ler a documentação da Sun sobre compatibilidade, consulte o Web site da Sun em http://java.sun.com.

## Fazendo Upgrade do SDK

Se você estiver fazendo upgrade do SDK de um release anterior, faça backup de todos os arquivos de configuração e arquivos de política de segurança antes de continuar com o upgrade.

Depois do upgrade, pode ser necessário restaurar ou reconfigurar esses arquivos porque o processo de upgrade pode tê-los excluídos. Verifique a sintaxe dos novos arquivos antes de restaurar os arquivos originais porque o formato ou opções de tais arquivos podem ter sido alteradas.

## Migrando de Outros IBM JVMs

Na Versão 5.0, o IBM Runtime Environment para Windows contém novas versões do IBM Java Virtual Machine e do compilador JIT (Just-In-Time). Se você estiver migrando de um IBM Runtime Environment mais antigo, observe que:

- A JVM biblioteca de link dinâmico jvm.dll é instalada no diretório jre\bin\j9vm. Isso é diferente, por exemplo, no Runtime Environment para Windows para a Versão 1.4.2, onde está instalado em jre\bin\classic. Os aplicativos nativos que utilizam a interface de chamada JNI podem precisar incluir o novo caminho de diretório em sua variável ou variáveis de ambiente para localizar a biblioteca de link dinâmico JVM.
- |A JVMMI (JVM Monitoring Interface) não está mais disponível. |Você deve reescrever os aplicativos que utilizem essa API. Em vez disso, recomenda-se |a utilização da JVMTI (JVM Tool Interface). A JVMTI não é funcionalmente o |equivalente da JVMMI. Para obter informações sobre a JVMTI, consulte http://java.sun.com/j2se/1.5.0/docs/guide/jvmti/ e o Manual de Diagnóstico.
- |A nova implementação do JNI está em conformidade com a especificação do JNI, |porém é diferente da implementação antiga. Ela retorna cópias de objetos em vez |de atribuir os objetos. Essa diferença pode expor erros no código do aplicativo |JNI. Para obter informações sobre a depuração do código JNI, consulte -Xcheck:jni em Opções Não Padrão.
- |O formato e o conteúdo dos logs detalhados do coletor de lixo obtidos |utilizando -verbose:gc foram alterados. Os dados agora são formatados |como XML. O conteúdo dos dados reflete as alterações na implementação da coleta de lixo |na JVM, e a maioria das estatísticas produzidas foi alterada. |Você deve alterar quaisquer programas que processem o resultado do GC detalhado para que |funcionem com o novo formato e os novos dados. Consulte o Manual de Diagnóstico para obter um exemplo dos novos dados do GC detalhado.
- Versões anteriores do IBM JRE enviadas com um arquivo chamado rt.jar no diretório jre/lib. No Java v1.4 e versões posteriores, esse arquivo foi substituído por vários arquivos JAR que residem no diretório jre/lib.
- |Para obter informações adicionais sobre compatibilidade de segmento de |mercado e APIs obsoletas, consulte Sun's |Java 5 Compatibility Documentation e |Sun's Java 5 Depreciated API List

# Conteúdo do SDK e Runtime Environment

O SDK contém várias ferramentas de desenvolvimento e um JRE (Java Runtime Environment). Esta seção descreve o conteúdo das ferramentas do SDK e o Runtime Environment.

Os aplicativos escritos totalmente em Java não devem ter dependências na estrutura de diretório do IBM SDK (ou arquivos desses diretórios). Qualquer dependência na estrutura de diretório do SDK (ou os arquivos desses diretórios) poderiam resultar em problemas de portabilidade do aplicativo. Os aplicativos do JNI (Java Native Interface) terão algumas dependências menores.

## Ferramentas do Runtime Environment

- Classes Críticas -- Esses são os arquivos das classes compartilhadas para a plataforma e devem permanecer compactados para que o compilador e o interpretador os acessem. Não modifique essas classes; em vez disso, crie subclasses e substitua onde for necessário.
- Ferramentas JRE -- As ferramentas a seguir são parte do Runtime Environment e estão no diretório jre\bin, a menos se especificado de outra forma.
  - java.exe (Intepretador Java)
    - Executa classes Java. O Interpretador Java executa programas que são escritos na linguagem de programação Java.
  - javaw.exe (Interpretador Java)
    - Executa as classes Java da mesma forma que o comando java, porém não utiliza uma janela do console.
  - keytool.exe (Ferramenta de Gerenciamento de Chaves e Certificados)
    - Gerencia um armazenamento (banco de dados) de chaves privadas e suas cadeias de certificados X.509 associadas que autenticam as chaves públicas correspondentes.
  - policytool.exe (Ferramenta de Criação e Gerenciamento de Arquivos de Políticas)
    - Cria e modifica os arquivos de configuração de política externa que definem a política de segurança Java da instalação.
  - rmid.exe (daemon do sistema de ativação do RMI)
    - Inicia o daemon do sistema de ativação para que esses objetos possam ser registrados e ativados em um JVM (Java Virtual Machine).
  - tnameserv.exe (Serviço de Nomes do CORBA (Common Object Request Broker Architecture))
    - Inicia o serviço de nomes do transiente CORBA.
  - rmiregistry.exe (Registro do Objeto Remoto Java)
    - Cria e inicia um registro de objeto remoto na porta especificada do host atual.
  - ikeyman.exe (utilitário GUI do iKeyman)
    - Permite gerenciar chaves, certificados e pedidos de certificado. Para obter mais informações, consulte o Security Guide acompanhante e http://www.ibm.com/developerworks/java/jdk/security. O SDK também fornece uma versão da linha de comandos desse utilitário. Consulte Acessibilidade iKeyman para obter detalhes.
  - jextract.exe (Extrator de dump)
    - Converte um dump produzido pelo sistema em um formato comum que pode ser utilizado pelo jdmpview. Para obter mais informações, consulte Manual de Diagnóstico.
  - javaws.exe (Java Web Start)
    - Ativa a implementação e a manutenção automática dos aplicativos Java.

## Ferramentas do SDK

- As seguintes ferramentas fazem parte do SDK e estão localizadas no diretório C:\Arquivos de Programas\IBM\Java50\bin:
  - javac.exe (Compilador Java)
    - Compila programas que são escritos na linguagem de programação Java em bytecodes (código Java compilado).
  - appletviewer.exe (Java Applet Viewer)
    - Testa e executa applets fora de um navegador da Web.
  - jdb.exe (Depurador Java)
    - Ajuda a depurar os programas Java.
  - javap.exe (Class File Disassembler)
    - Desmonta os arquivos compilados e pode imprimir uma representação dos bytecodes.
  - javadoc.exe (Java Documentation Generator)
    - Gera páginas HTML da documentação de API nos arquivos de origem Java.
  - javah.exe (Gerador de Cabeçalho C e Arquivo Stub)
    - Permite associar métodos nativos ao código escrito na linguagem de programação Java.
  - jar.exe (Java Archive Tool)
    - Combina vários arquivos em um único arquivo JAR (Java Archive).
  - jarsigner.exe (Ferramenta de Assinatura e Verificação JAR)
    - Gera assinaturas para arquivos JAR e verifica as assinaturas dos arquivos JAR assinados.
  - jconsole.exe (JConsole Monitoring and Management Tool - experimental)
    - Ferramenta gráfica compatível com JMX (não suportada) experimental para monitoramento de JVMs locais e remotas.
  - native2ascii.exe (Conversor de Nativo para ASCII)
    - Converte um arquivo de codificação nativa em um arquivo ASCII que contenha caracteres codificados em Latino 1 ou Unicode ou ambos.
  - rmic.exe (Conversor Stub do Java RMI (Remote Method Invocation))
    - Gera stubs, estruturas e conexões para objetos remotos. Inclui o suporte RMI sobre Internet Inter-ORB Protocol (RMI-IIOP).
  - idlj.exe (IDL para Compilador Java)
    - Gera ligações Java de um determinado arquivo IDL.
  - serialver.exe (Comando da Versão Serial)
    - Retorna o serialVersionUID para uma ou mais classes em um formato adequado para copiar em uma classe envolvida.
  - extcheck.exe (Utilitário Extcheck)
    - Detecta os conflitos da versão entre um arquivo jar de destino e os arquivos jar de extensão instalados atualmente.
  - jdmpview.exe (Formatador dump entre plataformas)
    - Uma ferramenta que permite analizar dumps. Para obter mais informações, consulte Manual de Diagnóstico.
  - htmlconverter.exe (Conversor HTML do Java Plug-in)
    - Converte uma página HTML que contenha applets em um formato que possa utilizar o Java Plug-in.
- ARQUIVOS DE INCLUSÃO
  - Cabeçalhos C para programas JNI.
- DEMOS
  - O diretório demo contém vários subdiretórios que contêm código fonte de amostra, demos, aplicativos e applets, que você pode utilizar.
- DIREITOS AUTORAIS
  - Aviso de direitos autorais para o software SDK para Windows.
- LICENÇA
  - O arquivo LICENSE, C:\Arquivos de Programas\IBM\Java50\license, contém o contrato de licença do software SDK para Windows . Para exibir ou imprimir o contrato de licença, abra o arquivo em um navegador da Web.

Nota: os Guias do Usuário e Javadoc, e as licenças, arquivos de direitos autorais e diretório demo acompanhantes, são a única documentação incluída nesse SDK para Windows. No Web site da Sun, é possível tanto visualizar quanto fazer download do pacote de documentação de software da Sun: http://java.sun.com.

# Instalando e Configurando o SDK e Runtime Environment

## Antes de Instalar

Para instalar o pacote SDK ou Runtime Environment, faça download do pacote de instalação pertinente. Certifique-se de fazer o download de todos os pacotes para o mesmo diretório. Os pacotes e seus nomes de arquivo são listados em Instalação (Interativa) Assistida; não altere os nomes dos arquivos dos pacotes.

Antes de iniciar a instalação, certifique-se de que há espaço suficiente no diretório C:\WINDOWS\TEMP para uso durante a instalação. A quantidade de espaço temporário necessária no diretório TEMP durante a instalação é:

- Pacote SDK instalável: 130 MB
- Pacote Runtime Environment instalável: 85 MB

Se não existir espaço temporário suficiente, o programa de instalação gerará um erro e interromperá a instalação. Se você realmente tiver espaço temporário suficiente, mas ainda visualizar esta mensagem, verifique se os pacotes que está tentando instalar foram transferidos completamente por download. Para fazer isto, compare os tamanhos dos arquivos de seus pacotes com os tamanhos dos arquivos mostrados nas páginas da Web utilizadas para download dos pacotes.

## Instalação (Interativa) Assistida

Os pacotes que você pode instalar são:

- Pacote SDK instalável: ibm-java2-sdk-50-win-i386.exe
- Pacote Runtime Environment instalável: ibm-java2-jre-50-win-i386.exe
- Pacote Runtime Environment instalável (somente hardware IBM): ibm-java2-jre-50-ibmpc-win-i386.exe

Outros pacotes são fornecidos como arquivos zip:

- Pacote Runtime Environment: ibm-java2-jre-50-win-i386.zip
- Pacote SDK: ibm-java2-sdk-50-win-i386.zip
- Pacote Java Communications API (Application Programming Interface) para Windows: ibm-java2-javacomm-50-win-i386.zip. Consulte a seção Instalando o Java Communications API para obter instruções de instalação.
- Pacote de documentação: ibm-java2-docs-50-win-i386.zip
- Pacote Demos: ibm-java2-demos-50-win-i386.zip

### Instalando os Pacotes

1. Ative o ibm-java2-sdk-50-win-i386.exe (para o SDK) ou ibm-java2-jre-50-win-i386.exe (para o Runtime Environment somente).
2. Siga as instruções do assistente de instalação.

O Runtime Environment é instalado por padrão no diretório C:\Arquivos de Programas\IBM\Java50\jre.

Se você fizer download do pacote SDK instalável, poderá optar por instalar:

- As ferramentas de desenvolvimento SDK (por exemplo, o compilador Java)
- O Runtime Environment
- O código fonte das bibliotecas de classes da Sun, utilizadas por algumas ferramentas para depurar aplicativos.

É possível instalar os componentes individualmente ou em combinações.

No assistente de instalação, são apresentadas as seguintes opções:

- Típica - essa opção instala os três componentes.
- Compacta - essa opção instala apenas o Runtime Environment.
- Personalizada - essa opção permite escolher quais componentes serão instalados.

### Instalando o Runtime Environment como a Java Virtual Machine do Sistema

Durante a instalação do Runtime Environment (como parte do pacote instalável SDK ou a partir do pacote instalável Runtime Environment), o programa pergunta se você deseja instalar o Runtime Environment como a JVM (Java Virtual Machine) do sistema. Se você o instalar como a JVM do sistema, o programa de instalação copia os arquivos java.exe e javaw.exe no diretório do sistema Windows. Se existir atualmente uma versão do java.exe ou javaw.exe no diretório do sistema Windows, será solicitado que você substitua a versão existente pela versão atual. A instalação destes arquivos no diretório do sistema Windows torna esse Runtime Environment a JVM padrão do sistema. Além disso, a chave de registro "Current Version" é definida para corresponder a esta instalação.

Nota:
A instalação do Runtime Environment como a JVM do sistema copia somente o java.exe e javaw.exe para o diretório de sistema do Windows. Nenhum outro executável (como javac.exe ou appletviewer.exe) é copiado.

## Instalação Não-assistida

Para criar uma instalação não-assistida, é necessário concluir primeiro uma instalação assistida e criar um arquivo de resposta (setup.iss) que registra as opções feitas durante a instalação. O arquivo de resposta criado precisa ser correto para os computadores em que será utilizado. Se necessário, crie vários arquivos de resposta para instalação de pacotes em computadores que tenham diferentes configurações.

Para criar um arquivo de resposta durante a instalação, em um prompt de comandos digite:

    ibm-java2-sdk-50-win-i386 /r

ou

    ibm-java2-jre-50-win-i386 /r

Dependendo de seu produto Windows, um arquivo de resposta (setup.iss) é criado no diretório C:\Windows ou C:\Winnt, em que C: é a unidade de inicialização.

A seguinte mensagem poderá ser exibida durante uma instalação interativa:

    Outro Java Runtime Environment está atualmente
       instalado como o System JVM. Selecione Sim para
       substituir esta versão ou Não para sair desta
       instalação.

Se esta mensagem for exibida, selecione Não e saia da instalação. Vá para o diretório do sistema Windows e exclua os seguintes dois arquivos:

- java.exe
- javaw.exe

Após ter excluído os arquivos, reinicie a instalação interativa, utilizando o comando mostrado no início desta seção.

No sistema no qual você executará a instalação não-assistida, copie o arquivo de resposta setup.iss no diretório C:\Windows. Depois de copiar o arquivo, em um prompt de comandos digite:

    ibm-java2-sdk-50-win-i386 /s /f1c:\Windows\setup.iss /f2c:\setup.log
    ibm-java2-jre-50-win-i386 /s /f1c:\Windows\setup.iss /f2c:\setup.log

Notas:

1. Não há espaços após `/f1` ou `/f2`.
2. O sinalizador `/f1` especifica o nome e a localização do arquivo de resposta. O sinalizador `/f2` especifica o nome e a localização do arquivo de log.

Se a instalação for bem-sucedida, o arquivo de log conterá a cadeia `ResultCode=0`.

## Ativando o IBM Accessibility Bridge

O IBM Accessibility Bridge é instalado mas, por padrão, fica desativado. Para ativar o IBM Accessibility Bridge, exclua o sinal de número do início da seguinte linha no arquivo Accessibility.properties, no diretório jre/lib:

    #assistive_technologies=JawBridge

Este Web site informa sobre os Utilitários de Acessibilidade:

http://java.sun.com/products/jfc/accessibility.html

## Desativando o Suporte de Acessibilidade Java

É possível desativar o suporte de Acessibilidade Java para melhorar o desempenho de carregamento dos aplicativos Java da JVM que não fornecem suporte de tecnologia assistida Java, especialmente em links da rede.

Para desativar o suporte de Acessibilidade Java, defina a variável de ambiente JAVA_ASSISTIVE como OFF. Uma tecnologia assistida, como o JawBridge, não ficará disponível se essa variável de ambiente for definida como OFF, mesmo que a tecnologia esteja ativada no arquivo Accessibility.properties.

## Informações para Usuários de Idiomas Europeus

No Windows, um processo tem duas páginas de códigos: o página de códigos ANSI (ou Windows) e a página de códigos OEM (ou DOS).

A janela de comandos normalmente utiliza a página de códigos OEM. A saída do console Java utiliza a página de códigos da janela de comandos a partir da qual o Java é iniciado. No entanto, o comando javaw sempre utiliza a página de códigos ANSI. Você especifica a página de códigos para utilizar para a saída do console com a opção -Dconsole.encoding no comando java. Por exemplo, -Dconsole.encoding=Cp1252 faz com que todas as saídas do console estejam na página de códigos ANSI Latino 1 (1252) do Windows.

## Definindo o PATH

Observe que, se você alterar a variável de ambiente PATH como descrito a seguir, substituirá quaisquer arquivos executáveis Java existentes em seu caminho.

Depois de instalar o SDK, você poderá executar uma ferramenta digitando seu nome em um aviso de shell com um nome de arquivo como um argumento.

É possível especificar o caminho para uma ferramenta digitando a cada vez o caminho antes do nome da ferramenta. Por exemplo, se o SDK para Windows estiver instalado em C:\Arquivos de Programas\IBM\Java50\bin, você poderá compilar um arquivo denominado myfile.java, digitando o seguinte em um prompt de comando:

      "C:\Arquivos de Programas\IBM\Java50\bin\javac" myfile.java

Para evitar que o caminho completo seja digitado a cada vez:

1. Inclua os seguintes diretórios na variável de ambiente PATH:
   - C:\Arquivos de Programas\IBM\Java50\bin (somente SDK)
   - C:\Arquivos de Programas\IBM\Java50\jre\bin (SDK e Runtime Environment)

   Se você instalou o SDK ou Runtime Environment em um diretório diferente, substitua C:\Arquivos de Programas\IBM\Java50\ pelo diretório em que instalou o SDK ou Runtime Environment

2. Compile o arquivo com a ferramenta javac. Por exemplo, para compilar o arquivo myfile.java, em um prompt de comando, digite:

         javac myfile.java

   A variável de ambiente PATH ativa o Windows para localizar arquivos executáveis, como javac, java e javadoc, de qualquer diretório atual. Para exibir o valor atual de seu PATH, digite o seguinte em um prompt de comandos:

         echo %PATH%

## Definindo o CLASSPATH

O CLASSPATH informa as ferramentas do SDK, como java, javac e javadoc, onde localizar as bibliotecas da classe Java.

Será necessário definir o CLASSPATH explicitamente somente se uma das seguintes opções se aplicar:

- Você requer uma biblioteca ou arquivo de classe diferente, como aquela que você desenvolveu, mas ela não está no diretório atual.
- Você altera o local dos diretórios bin e lib de forma que eles não tenham mais o mesmo diretório pai comum.
- Você pretende desenvolver ou executar aplicativos que estão utilizando ambientes de tempo de execução diferentes no mesmo sistema.

Para exibir o valor atual do CLASSPATH, digite o seguinte em um prompt de comandos:

      echo %CLASSPATH%

Se pretende desenvolver e executar aplicativos que utilizem ambientes de tempo de execução diferentes, incluindo outras versões que você tenha instalado separadamente, deverá definir o CLASSPATH (e o PATH) explicitamente para cada aplicativo. Se você pretende executar vários aplicativos simultaneamente e utilizar ambientes de tempo de execução diferentes, cada aplicativo deverá ser executado em sua própria janela de comandos.

Se você pretende executar apenas uma versão do Java por vez, poderá utilizar um script batch para alternar entre os ambientes de tempo de execução diferentes.

## Desinstalação

Para desinstalar o SDK, caso o tenha instalado utilizando a instalação assistida ou não-assistida:

1. Clique duas vezes em Meu Computador no desktop do Windows.
2. Clique duas vezes em Painel de Controle.
3. Dê um clique duplo em Adicionar ou Remover programas.
4. Clique em IBM 32-bit SDK for Java 2 V5.0 na lista e depois clique em Alterar/Remover.
5. Clique em OK.

Esse procedimento remove todos os pacotes que estão instalados com o Instalador. Ele não remove o pacote Java Communications API (consulte Java Communications API) ou quaisquer arquivos adicionais que foram extraídos dos pacotes zip.

Nota:
Mensagens de aviso podem ser exibidas notificando que nem todos os arquivos, ou entradas de registro, ou ambos, foram removidos. Esses avisos são emitidos porque o Windows considera que determinados arquivos ainda estão em uso; esses arquivos ou entradas de registro, ou ambos, serão removidos durante a próxima reinicialização.

Quando várias instalações entre o IBM 32-bit SDK for Windows, v5.0 e as versões V1.3.1 e anteriores são mantidas, se você desinstalar a versão anterior enquanto uma versão V5.0 ainda está instalada no sistema, o desinstalador da V1.3.1 removerá as seguintes chaves de registro, e todas as subchaves, que são exigidas pela versão V5.0, corrompendo, portanto, a instalação do V5.0:

- HKEY_LOCAL_MACHINE/Software/IBM/Java2 Runtime Environment
- HKEY_LOCAL_MACHINE/Software/IBM/Java Development Kit

Portanto, reinstale o V5.0 depois de desinstalar a versão V1.3.1. Essa limitação do desinstalador foi corrigida na V1.4.0 e em todas as versões subseqüentes.

# Utilizando o Runtime Environment

A ferramenta java ativa um aplicativo Java iniciando um Java Runtime Environment e carregando uma classe especificada.

A JVM procura a classe inicial (e outras classes utilizadas) em três conjuntos de locais: no caminho de classe de auto-inicialização, nas extensões instaladas e no caminho de classe do usuário. Os argumentos especificados após o nome da classe ou o nome do arquivo JAR são passados para a função principal.

O comando javaw é idêntico ao java, exceto que o javaw não possui janela de console associada. Utilize javaw quando não desejar que uma janela de prompt de comandos seja exibida. O ativador javaw exibirá uma caixa de diálogo com informações sobre erros se houver falha na ativação.

Os comandos java e javaw utilizam a seguinte sintaxe:

    java [ opções ] class [ argumentos ... ]
    java [ opções ] -jar file.jar [ argumentos ... ]
    javaw [ opções ] class [ argumentos ... ]
    javaw [ opções ] -jar file.jar [ argumentos ... ]

Os itens entre colchetes são opcionais.

opções
  Opções de linha de comandos.
class
  Nome da classe a ser chamada.
file.jar
  Nome do arquivo jar a ser chamado. Ele é utilizado apenas com -jar.
argumentos
  Argumentos passados para a função main.

Se a opção -jar for especificada, o arquivo JAR nomeado irá conter arquivos de classe e recurso para os aplicativos com a classe de inicialização indicada pelo cabeçalho do manifesto Main-Class.

## Opções

O ativador possui um conjunto de opções padrão suportadas no ambiente de tempo de execução atual e que serão suportadas em releases futuros. Além disso, há um conjunto de opções fora do padrão. As opções padrão foram escolhidas para o melhor uso geral. Uma ação deve ser tomada se decidir fazer alterações.

### Especificando Opções Java e Propriedades de Sistema

Você pode especificar as opções do Java e as propriedades do sistema de 3 diferentes modos. São, por ordem de preferência:

1. Especificar a opção ou propriedade na linha de comando, por exemplo`java -Dmysysprop1=tcpip -Dmysysprop2=wait -Xdisablejavadump MyJavaClass`.
2. Criar um arquivo que contenha as opções e especificá-lo na linha de comando com -Xoptionsfile=<filename> .
3. Criar uma variável de ambiente denominada IBM_JAVA_OPTIONS contendo as opções, por exemplo, `set IBM_JAVA_OPTIONS="-Dmysysprop1=tcpip -Dmysysprop2=wait -Xdisablejavadump"`.

As opções mais à direita na linha de comandos têm preferência em relação às mais a esquerda; por exemplo, se especificar as opções `-Xint -Xjit myClass`, -Xjit tem a preferência.

### Opções Padrão

- -D<property_name>=<valor>
  - Define uma propriedade do sistema.
- -assert
  - Imprime ajuda para opções relacionadas à declaração.
- -cp ou -classpath <diretórios e arquivos zip ou jar separados por ;>
  - Define o caminho da procura por classes e recursos de aplicativos. Se as opções -classpath e -cp não forem utilizadas e CLASSPATH não estiver definido, o usuário classpath será, por padrão, o diretório atual (.).
- -help ou -?
  - Exibe uma mensagem de utilização.
- -showversion
  - Imprime a versão do produto e continua.
- -verbose:[class,gcterse,gc,dynload,stackwalk,sizes,stack,debug,jni]
  - Ativa a saída verbosa.
- -version
  - Exibe a versão do produto.
- -version:<value>
  - Requer a versão especificada para ser executado.
- -jre-restrict-search
  - Inclui JREs privados do usuário na procura de versão
- -no-jre-restrict-search
  - Exclui JREs privados do usuário da procura de versão
- -agentlib:<libname>[=<options>]
  - carrega a biblioteca de agentes nativos <libname>, por exemplo -agentlib:hprof. Para obter mais informações, especifique -agentlib:jdwp=help e -agentlib:hprof=help na linha de comandos.
- -agentpath:libname[=<options>]
  - Carregar biblioteca de agentes nativos por nome de caminho completo
- -javaagent:<jarpath>[=<options>]
  - Carregar agente da linguagem de programação Java; para obter mais informações; consulte a documentação da API java.lang.instrument.
- -X
  - Imprime a ajuda sobre opções não padrão.

### Opções Não Padrão

As opções -X listadas a seguir não são opções padrão e, portanto, estão sujeitas a alterações sem aviso prévio.

Para opções que utilizam o parâmetro <tamanho>, você deve sufixar o número com "k" ou "K" para indicar kilobytes, "m" ou "M" para indicar megabytes ou "g" ou "G" para indicar gigabytes.

- -Xargencoding
  - Permite colocar seqüências de escape Unicode na lista de argumentos. Por padrão, essa opção é definida como desligada.
- -Xbootclasspath:<diretórios e arquivos zip ou jar separados por ;>
  - Define o caminho da procura por classes e recursos de auto-inicialização. O padrão é procurar classes e recursos de auto-inicialização dentro dos diretórios internos da VM e dos arquivos .jar.
- -Xbootclasspath/a:<diretórios e arquivos zip ou jar separados por ;>
  - Anexa os diretórios, arquivos zip ou arquivos jar especificados ao final do caminho de classe de auto-inicialização. O padrão é procurar classes e recursos de auto-inicialização dentro dos diretórios internos da VM e dos arquivos .jar.
- -Xbootclasspath/p:<diretórios e arquivos zip ou jar separados por ;>
  - Anexa os diretórios, arquivos zip ou arquivos jar especificados ao começo do caminho de classe de auto-inicialização. Não implemente aplicativos que utilizem a opção -Xbootclasspath: ou -Xbootclasspath/p: para substituir uma classe na API padrão, pois tal implementação violaria a licença do código binário do Java 2 Runtime Environment. O padrão é procurar classes e recursos de auto-inicialização dentro dos diretórios internos da VM e dos arquivos .jar.
- -Xcheck:jni
  - Executa verificações adicionais das funções JNI. Também é possível utilizar -Xrunjnichk. Por padrão, nenhuma verificação é executada.
- -Xcheck:nabounds
  - Executa verificações adicionais das operações de array JNI. Também é possível utilizar -Xrunjnichk. Por padrão, nenhuma verificação é executada.
- |-Xclassgc |
  |
  - Essa opção ativa a coleta de objetos de classe em cada coleta de lixo. |Essa opção está, por padrão, ativada.
- -Xcompactexplicitgc
  - Compacta todas as chamadas para `System.gc()`. Consulte também -Xnocompactexplicitgc. Por padrão, a compactação ocorre somente quando acionada internamente.
- -Xcompactgc
  - Compacta todos os ciclos do Coletor de Lixo. Consulte também -Xnocompactgc. Por padrão, a compactação ocorre somente quando acionada internamente.
- |-Xconcurrentbackground <number> |
  |
  - Essa opção especifica o número de encadeamentos de segundo plano de baixa prioridade conectados |para ajudar os encadeamentos mutadores na marcação simultânea. O padrão é 1.
- |-Xconcurrentlevel <number> |
  |
  - Essa opção especifica a taxa de alocação "tax". Ela indica a proporção |entre a quantidade de heap alocado e a quantidade de heap marcado. O padrão é 8.
- |-Xconmeter:<soa | loa | dynamic> |
  |
  - Essa opção determina qual uso da área, LOA ou SOA, é medido e, |portanto, quais alocações são taxadas durante a marcação simultânea. A utilização de -Xconmeter:soa aplica-se à taxa de alocação de SOA (Área de |Objeto Pequena); a utilização de -Xconmeter:loa aplica-se à |taxa de alocação de LOA (Área de Objeto Grande). Se -Xconmeter:dynamic for especificado, o coletor determinará dinamicamente |qual área será medida, com base em qual área é esgotada primeiro, se é |a SOA ou a LOA. A opção está configurada, por padrão, como -Xconmeter:soa.
- -Xdbg:<opções>
  - Carrega bibliotecas de depuração para suporte da depuração remota de aplicativos. Equivale a -Xrunjdwp. Por padrão, as bibliotecas de depuração não são carregadas e a instância VM não é ativada para depuração.
- -Xdbginfo:<caminho para arquivo de símbolos>
  - Carrega e transmite opções para o servidor de informações de depuração. Por padrão, o servidor de informações de depuração é desativado.
- -Xdebug
  - Inicia a JVM com o depurador ativado. Por padrão, o depurador é desativado.
- |-Xdisableexcessivegc |
  |
  - Essa opção desativa a emissão de uma exceção OutOfMemory se for gasto |tempo excessivo no GC. Por padrão, essa opção é desativada.
- -Xdisableexplicitgc
  - Informa a VM que as chamadas para `System.gc()` não devem ter nenhum efeito. Por padrão, as chamadas para `System.gc()` acionam uma coleta de lixo.
- |-Xdisablestringconstantgc |
  |
  - Essa opção impede que as cadeias existentes na tabela interna de cadeias sejam coletadas. |Essa opção está, por padrão, desativada.
- -Xdisablejavadump
  - Desliga a geração de javadump em erros e sinais. Por padrão, a geração de javadump é ativada.
- |-Xenableexcessivegc |
  |
  - Se for gasto um tempo excessivo no GC, essa opção retornará NULL para um |pedido de alocação e fará com que uma exceção OutOfMemory seja emitida. Essa ação |ocorre somente quando o heap tiver sido totalmente expandido e o tempo gasto |estiver completando no mínimo 95%. Esse comportamento é o padrão.
- |-Xenablestringconstantgc |
  |
  - Essa opção ativa as cadeias da tabela interna de cadeias a serem coletadas. |Essa opção está, por padrão, ativada.
- -Xfuture
  - Ativa verificações completas em formatos de arquivos de classe. Utilize esse sinalizador ao desenvolver um novo código, pois verificações mais completas serão o padrão em releases futuros. Por padrão, as verificações completas de formato são desativadas.
- -Xgcpolicy:[optthruput]|[optavgpause]|[gencon]
  - Controla o comportamento do Coletor de Lixo. A opção optthruput é a padrão e proporciona um rendimento do processamento muito alto aos aplicativos, embora isso implique a ocorrência de pausas ocasionais. A opção optavgpause reduz o tempo gasto nessas pausas para coleta de lixo e limita o efeito do aumento do tamanho de heap durante a pausa para coleta de lixo. Utilize optavgpause se a sua configuração apresentar um heap muito grande. A opção gencon solicita o uso combinado de GC simultâneo e geracional para ajudar a minimizar o tempo gasto com qualquer pausa para coleta de lixo. Para obter informações adicionais, consulte Especificando a Política de Coleta de Lixo.
- -Xgcthreads<número de encadeamentos>
  - Define o número de encadeamentos auxiliares que são utilizados para operações paralelas durante a coleta de lixo. Por padrão, o número de encadeamentos é definido como o número de CPUs físicas presentes -1, com um mínimo de 1.
- |-Xgcworkpackets <number> |
  |
  - Essa opção especifica o número total de pacotes de trabalho disponíveis no |coletor global. Se não for especificado, o coletor alocará um número de pacotes |com base no tamanho máximo de heap.
- -Xint
  - Faz com que a JVM utilize apenas o Interpretador, desativando o compilador JIT (Just-In-Time). Por padrão, o compilador JIT é ativado.
- -Xiss<size>
  - Define o tamanho inicial da pilha de encadeamentos Java. Por padrão, 2 kilobytes.
- -Xjit[:<suboption>,<suboption>,...]
  - Ativa o JIT. Para obter detalhes sobre as subopções, consulte o Manual de Diagnóstico. Consulte também -Xnojit. Por padrão, o JIT é ativado.
- -Xlinenumbers
  - Exibe os números das linhas nos rastreios de pilha, para depuração. Consulte também -Xnolinenumbers. Por padrão, os números de linhas são ativados.
- |-Xloa |
  |
  - Esta opção aloca uma LOA (Área de Objeto Grande). Os objetos serão |alocados nessa LOA em vez de no SOA. Por padrão, a LOA é ativada para todas as políticas |GC, exceto para subconjunto, em que a LOA não está disponível. Consulte |também -Xnoloa.
- |-Xloainitial <number> |
  |
  - <number> entre 0 e 0,95, especifica a porcentagem inicial do espaço |permitido atual alocado para a LOA (Área de Objeto Grande). O padrão é 0,05 ou 5%.
- |-Xloamaximum <number> |
  |
  - <number> entre 0 e 0,95, especifica a porcentagem máxima do espaço |permitido atual alocado para a LOA (Área de Objeto Grande). O padrão é 0,5 ou 50%.
- |-Xlp (Windows 2003) |
  |
  - Solicita à JVM para alocar o heap Java com páginas grandes. Se páginas |grandes não estiverem disponíveis, a JVM não será iniciado, exibindo a mensagem de erro `GC: a configuração do sistema não suporta a opção --> '-Xlp'`. Páginas |grandes suportadas por sistemas executando o Windows 2003, quando o |sistema operacional está configurado para utilizá-las. Por padrão, |as páginas grandes não são utilizadas. Consulte Configurando a Alocação da Memória de Página Grande.
- -Xmaxe<tamanho>
  - Define o tamanho máximo de acordo com o qual o coletor de lixo expande o heap. Normalmente, o coletor de lixo expande o heap quando a quantidade de espaço livre cai abaixo de 30% (ou a quantidade especificada com -Xminf), até atingir a quantidade necessária para restaurar o espaço livre para 30%. A opção -Xmaxe limita a expansão ao valor especificado; por exemplo, `-Xmaxe10M` limita a expansão a 10 MB. Por padrão, não há um tamanho máximo de expansão.
- -Xmaxf<tamanho>
  - Especifica a porcentagem máxima de heap que deve estar livre após uma coleta de lixo. Se o espaço livre exceder esse valor, a JVM tentará reduzir o heap. Especifique o tamanho como um valor decimal no intervalo de 0 a 1. Por exemplo, `-Xmaxf0.5` define o espaço livre máximo como 50%. O valor padrão é 0,6 (60%).
- -Xmca<tamanho>
  - Define a etapa de expansão para a memória alocada para armazenar a parte RAM das classes carregadas. Toda vez que mais memória for necessária para armazenar classes na RAM, a memória alocada será aumentada de acordo com essa quantidade. Por padrão, a etapa de expansão é 32 K.
- -Xmco<tamanho>
  - Define a etapa de expansão para a memória alocada para armazenar a parte ROM das classes carregadas. Toda vez que mais memória for necessária para armazenar classes na ROM, a memória alocada será aumentada de acordo com essa quantidade. Por padrão, a etapa de expansão é 128 K.
- -Xmine<tamanho>
  - Define o tamanho mínimo de acordo com o qual o Coletor de Lixo expande o heap. Normalmente, o coletor de lixo expande o heap de acordo com a quantidade necessária para restaurar o espaço livre para 30% (ou a quantidade especificada com o uso de -Xminf). A opção -Xmine define a expansão de forma que ela corresponda no mínimo ao valor especificado; por exemplo, `-Xmine50M` define o tamanho da expansão como um mínimo de 50 MB. Por padrão, o tamanho mínimo de expansão é 1 MB.
- -Xminf<tamanho>
  - Especifica a porcentagem mínima de heap que deve estar livre após uma coleta de lixo. Se o espaço livre estiver abaixo desse valor, a JVM tentará expandir o heap. Especifique o tamanho como um valor decimal no intervalo de 0 a 1; por exemplo, um valor de `-Xminf0.3` solicita que o espaço livre mínimo corresponda a 30% do heap. Por padrão, o valor mínimo é 0,3.
- -Xmn<tamanho>
  - Configura os tamanhos inicial e máximo do novo heap (nursery) para o valor especificado ao utilizar -Xgcpolicy:gencon. Equivale à definição de ambos -Xmns e -Xmnx. |Se você definir -Xmns ou -Xmnx, não poderá definir -Xmn. Se você |tentar definir -Xmn com -Xmns ou -Xmnx, a VM não será iniciada e retornará um |erro. Por padrão, -Xmn é selecionado internamente de acordo com a capacidade do sistema. É possível utilizar a opção -verbose:sizes para encontrar os valores que a VM está utilizando atualmente.
- -Xmns<size>
  - Configura o tamanho inicial do novo heap (nursery) para o valor especificado ao utilizar -Xgcpolicy:gencon. Por padrão, essa opção é selecionada internamente de acordo com a capacidade do sistema. |Essa opção retornará um erro se você tentar |utilizá-la com -Xmn.
- -Xmnx<size>
  - Configura o tamanho máximo do novo heap (nursery) para o valor especificado ao utilizar -Xgcpolicy:gencon. Por padrão, essa opção é selecionada internamente de acordo com a capacidade do sistema. |Essa opção retornará um erro se você tentar |utilizá-la com -Xmn.
- -Xmo<tamanho>
  - Configura os tamanhos inicial e máximo do heap antigo (tenured) para o valor especificado ao utilizar -Xgcpolicy:gencon. Equivale à definição de ambos -Xmos e -Xmox. |Se você definir -Xmos ou -Xmox, não poderá definir -Xmo. Se você |tentar definir -Xmo com -Xmos ou -Xmox, a VM não será iniciada e retornará um |erro. Por padrão, -Xmo é selecionado internamente de acordo com a capacidade do sistema. É possível utilizar a opção -verbose:sizes para encontrar os valores que a VM está utilizando atualmente.
- -Xmos<size>
  - Configura o tamanho inicial do heap antigo (tenure) para o valor especificado ao utilizar -Xgcpolicy:gencon. Por padrão, essa opção é selecionada internamente de acordo com a capacidade do sistema. |Essa opção retornará um erro se você tentar |utilizá-la com -Xmo.
- -Xmox<size>
  - Configura o tamanho inicial do heap antigo (tenure) para o valor especificado ao utilizar -Xgcpolicy:gencon. Por padrão, essa opção é selecionada internamente de acordo com a capacidade do sistema. |Essa opção retornará um erro se você tentar |utilizá-la com -Xmo.
- -Xmoi<tamanho>
  - Configura o valor de incremento do heap Java ao utilizar -Xgcpolicy:gencon. Se for definida como zero, nenhuma expansão será permitida. Por padrão, o tamanho do incremento é calculado sobre o tamanho da expansão, -Xmine e -Xminf.
- -Xmr<tamanho>
  - Configura o tamanho do "conjunto memorizado" de Coleta de Lixo ao utilizar -Xgcpolicy:gencon. Essa é a lista de objetos no heap antigo (tenured) que possui referências aos objetos no novo (nursery) heap. Por padrão, essa opção é definida como 16 kilobytes.
- -Xms<tamanho>
  - Define o tamanho de heap Java inicial. É possível também utilizar -Xmo. O padrão é definir internamente de acordo com a capacidade do sistema.
- -Xmso<tamanho>
  - Configura o tamanho da pilha C dos encadeamentos Java bifurcados. Por padrão, essa opção é definida como 32 kilobytes em plataformas de 32 bits e 256 kilobytes em plataformas de 64 bits.
- -Xmx<tamanho>
  - Define o tamanho máximo do heap Java. Por padrão, essa opção é definida internamente de acordo com a capacidade do sistema.
- -Xnoclassgc
  - Desativa coleta de lixo da classe. Isso desativa a coleta de lixo do armazenamento associado a classes Java que deixaram de ser utilizadas pela JVM. O comportamento padrão é -Xclassgc.
- -Xnocompactgc
  - Desativa a compactação para o Coletor de Lixo. Consulte também -Xcompactgc. Por padrão, a compactação é ativada.
- -Xnocompactexplicitgc
  - Desativa a compactação numa chamada para `System.gc()`. Consulte também -Xcompactexplicitgc. Por padrão, a compactação é ativada em chamadas para `System.gc()`.
- -Xnojit
  - Desativa o compilador JIT. Consulte também -Xjit. Por padrão, o compilador JIT é ativado.
- -Xnolinenumbers
  - Desativa os números de linhas para depuração. Consulte também -Xlinenumbers. Por padrão, os números de linhas são ativados.
- |-Xnoloa |
  |
  - Esta opção impede a alocação de uma LOA (Área de Objeto Grande). Todos os |objetos serão alocados no SOA. Por padrão, a LOA é ativada para todas as políticas |GC, exceto para subconjunto, em que a LOA não está disponível. Consulte |também -Xloa.
- -Xnopartialcompactgc
  - Desativa a compactação incremental. Consulte também -Xpartialcompactgc. Por padrão, essa opção não é definida, portanto, todas as compactações são completas.
- -Xnosigcatch
  - Desativa o código de manipulação de sinal da JVM. Consulte também -Xsigcatch. Por padrão, a manipulação de sinal é ativada.
- -Xnosigchain
  - Desativa o encadeamento da rotina de tratamento de sinal. Consulte também -Xsigchain. Por padrão, o encadeamento da rotina de tratamento de sinal é ativado.
- -Xoptionsfile=<file>
  - Especifica um arquivo que contém opções e definições JVM. Por padrão, nenhum arquivo de opções é utilizado.
- -Xoss<tamanho>
  - Configura o tamanho da pilha Java e da pilha C para qualquer encadeamento. Essa opção é fornecida para compatibilidade e é equivalente a configurar tanto -Xss quanto -Xmso para o valor especificado.
- -Xpartialcompactgc
  - Ativa a compactação parcial. Consulte também -Xnopartialcompactgc.
- -Xquickstart
  - Melhora o tempo de inicialização atrasando a compilação JIT e as otimizações. Por padrão, o início rápido é desativado e não há retardo na compilação JIT.
- -Xrdbginfo:<host>:<port>
  - Carrega e transmite opções para o servidor remoto de informações de depuração. Por padrão, o servidor remoto de informações de depuração é desativado.
- -Xrs
  - Reduz o uso de sinais de sistema operacional. Por padrão, a VM utiliza totalmente os sinais do sistema operacional, consulte Sinais Utilizados pela JVM .
- -Xrun<library name>[:options]
  - Carrega bibliotecas assistentes. Para carregar múltiplas bibliotecas, especifique-a mais de uma vez na linha de comandos. Exemplos dessas bibliotecas são:
    - -Xrunhprof[:help] | [:<opção>=<valor>, ...]
      - Executa o perfil do heap, da CPU ou do monitor. Para obter mais informações, consulte Manual de Diagnóstico.
    - -Xrunjdwp[:help] | [:<opção>=<valor>, ...]
      - Carrega bibliotecas de depuração para suporte da depuração remota de aplicativos. Equivale a -Xdbg. Para obter informações adicionais, consulte Depurando os Aplicativos Java.
    - -Xrunjnichk[:help] | [:<option>=<value>, ...]
      - Executa verificações adicionais nas funções do JNI para rastrear erros em programas nativos que acessam a JVM utilizando o JNI. Para obter mais informações, consulte Manual de Diagnóstico.
- |-Xscmx<size>[k|m|g] |
  |
  - Para obter detalhes sobre o -Xscmx, consulte Utilizando as Opções da Linha de Comandos para Compartilhamento de Classe.
- |-Xshareclasses:<subopções> |
  |
  - Para obter detalhes sobre as subopções -Xshareclasses, consulte Utilizando as Opções da Linha de Comandos para Compartilhamento de Classe.
- -Xsigcatch
  - Ativa o código de manipulação de sinal da VM. Consulte também -Xnosigcatch. Por padrão, a manipulação de sinal é ativada
- -Xsigchain
  - Ativa o encadeamento da rotina de tratamento de sinal. Consulte também -Xnosigchain. Por padrão, o encadeamento da rotina de tratamento de sinal é ativado.
- |-Xsoftrefthreshold<number> |
  |
  - Essa opção define o número de GCs após o qual uma referência do software será |limpa se seu referente não tiver sido marcado. O padrão é 3; isso significa que |no terceiro GC onde o referente não é marcado a referência do software será |limpa.
- -Xss<tamanho>
  - Configura o tamanho de pilha Java máximo para qualquer encadeamento. Por padrão, essa opção está definida para 256 KB.
- -Xthr:<options>
  - Define opções de encadeamento.
- -Xverbosegclog:<caminho para o arquivo><nome do arquivo>[X, Y]
  - Faz com que a saída verboseGC seja gravada no arquivo especificado. Se o arquivo sair, ele será sobrescrito. Caso contrário, se um arquivo existente não puder ser aberto ou um novo arquivo não puder ser criado, a saída será redirecionada para stderr. Se você especificar os argumentos X e Y (ambos inteiros), a saída verboseGC será redirecionada ao número X de arquivos, cada um contendo o número Y de ciclos de coleta de lixo adequados para a saída verboseGC. Esses arquivos possuem o formato nome de arquivo1, nome de arquivo2 e assim por diante. Por padrão, nenhum log de coleta de lixo detalhado ocorre.
- -Xverify
  - Ativa a verificação completa de classes para cada classe carregada. Por padrão, a verificação completa de classes é desativada.
- -Xverify:none
  - Desativa a verificação completa de classes. Por padrão, a verificação completa de classes é desativada.

## Obtendo o Número de Compilação e Versão IBM

Para obter o número de construção e versão IBM, em um prompt de comando command, digite:

    java -version

## Globalização do Comando Java

O comando java e outros comandos do ativador java (por exemplo, javaw) permitem que um nome de classe seja especificado com qualquer caractere pertencente ao conjunto de caracteres do código de idioma atual.

Também é possível especificar qualquer caractere Unicode nos argumentos e no nome de classe utilizando seqüências de escape java. Para fazê-lo, será necessário especificar -Xargencoding. Para especificar um caractere Unicode, utilize seqüências de escape no formato `\u####`, em que # é um dígito hexadecimal (0 a 9, A a F).

Como alternativa, para especificar que o nome de classe e os argumentos de comando possuem a codificação UTF8, utilize -Xargencoding:utf8 ou, na codificação ISO8859_1, utilize -Xargencoding:latin.

Por exemplo, para especificar uma classe denominada "HelloWorld" utilizando a codificação Unicode para ambas as letras maiúsculas, utilize este comando:

    java -Xargencoding '\u0048ello\u0057orld'

Os comandos java e javaw fornecem mensagens de saída traduzidas. Essas mensagens são diferentes com base no código do idioma em que o Java está sendo executado. As descrições detalhadas de erros e outras informações de depuração retornadas por java estão em inglês.

## Executando um Arquivo Java Automaticamente

Para definir uma classe java ou arquivo jar para execução automática a partir do arquivo, utilize a opção Ferramentas->Opções de Pasta->Tipos de Arquivo do Windows Explorer. Como alternativa, você pode digitar em um prompt de comandos:

    assoc .class=javaclass
    ftype javaclass=C:\Arquivos de Programas\IBM\Java50\jre\bin\java.exe %l %*

Notas:

1. `%l` é a letra l e não o número 1.
2. Se o Java estiver instalado em um diretório que não seja o C:\Arquivos de Programas\IBM\Java50\, substitua o diretório.

## Executando Aplicativos Java com Tecnologias Auxiliares Nativas

A Sun fornece o Java Access Bridge para fornecer tecnologias auxiliares nativas do Windows, tais como leitoras de tela, acesso ao suporte de Acessibilidade Java em um aplicativo Java. Essas tecnologias auxiliares nativas do Windows devem suportar chamadas ao Java Access Bridge.

O Java Access Bridge, disponível na Sun, inclui um instalador que coloca cinco arquivos nos diretórios corretos: access-bridge.jar, jaccess.jar, accessibility.properties, JavaAccessBridge.dll e WindowsAccessBridge.dll. A IBM envia uma cópia do jaccess.jar no diretório apropriado para ser utilizada com o JawBridge.

Se você já tiver ativado o IBM Accessibility Bridge (JawBridge), o qual permite que a Lente de Aumento do Windows 2000 funcione com aplicativos Swing, e desejar ativar o JawBridge ao mesmo tempo que o Java Access Bridge, edite a linha no arquivo accessibility.properties para ler o seguinte:

    assistive_technologies=com.sun.java.accessibility.AccessBridge,
    JawBridge

Marque a linha como comentário inserindo um `#` no começo da linha para desativar ambas as pontes. Este site mostra como fazer download do Java Access Bridge:

http://java.sun.com/products/jfc/accessibility.html

## O Compilador JIT (Just-In-Time)

O compilador IBM Just-In-Time (JIT) gera dinamicamente o código da máquina para seqüências de bytecodes utilizadas com freqüência em aplicativos e applets Java durante a execução. |O compilador JIT V5.0 |entrega novas otimizações como resultado da pesquisa do compilador, |melhora as otimizações implementadas em versões anteriores do JIT e fornece |exploração de hardware aprimorada.

O IBM SDK e o Runtime Environment incluem o JIT, que está ativado por padrão tanto nos aplicativos de usuário quanto nas ferramentas SDK. Normalmente, não há nenhuma necessidade de chamar explicitamente o JIT; a compilação do bytecode Java para o código da máquina ocorre de modo transparente. Contudo, se encontrar um problema com o Runtime Environment durante a execução de um aplicativo ou applet Java, há a possibilidade de desativar o JIT para facilitar o isolamento do problema. A desativação do JIT deve ser um medida temporária apenas; ele é necessário para um desempenho adequado.

### Desativando o JIT

Há três maneiras de desativar o JIT:

- Configurar a variável de ambiente do JAVA_COMPILER para "NONE", ou esvaziar a cadeia antes da execução do aplicativo Java.

  No prompt de comandos no qual o aplicativo está executando, digite:

      set JAVA_COMPILER=NONE

  É possível, também, configurar permanentemente JAVA_COMPILER, por meio da interface gráfica com o usuário. Abra o Painel de Controle, selecione Sistema e, na guia Avançadas, selecione Variáveis de Ambiente.

- Utilize a opção -D n linha de comandos da JVM para configurar a propriedade java.compiler para "NONE", ou para uma cadeia vazia:

      java -Djava.compiler=NONE MyApp

- Utilize a opção -Xint na linha de comandos da JVM. Exemplo:

      java -Xint MyApp

Ambas as opções da linha de comandos substituem a variável de ambiente JAVA_COMPILER.

### Ativando o JIT

Para ativar o JIT explicitamente, configure a variável de ambiente JAVA_COMPILER como "jitc" ou utilize a opção -D para configurar a propriedade java.compiler como "jitc". Como alternativa, utilize a opção -Xjit (e omita a opção -Xint) na linha de comandos da JVM para ativar o JIT.

Se a variável de ambiente JAVA_COMPILER ou a propriedade java.compiler estiver definida para "" (cadeia vazia), o JIT permanecerá desativado. Para remover a configuração da variável de ambiente apropriadamente, digite `set JAVA_COMPILER=` no prompt de comandos.

### Determinando se o JIT Está Ativado

Para determinar se o JIT está ativado, digite o seguinte no prompt de comandos:

    java -version

Se o JIT não estiver sendo utilizado, será exibida uma mensagem que inclui o seguinte:

    (JIT disabled)

Se o JIT estiver sendo utilizado, será exibida uma mensagem que inclui o seguinte:

    (JIT ativado)

Para obter mais informações sobre o JIT, consulte o Manual de Diagnóstico.

## Especificando a Política de Coleta de Lixo

O Coletor de Lixo gerencia a memória utilizada pelo Java e pelos aplicativos em execução na VM.

Quando o Coletor de Lixo recebe um pedido para armazenamento, a memória não utilizada no heap será colocada à parte - "allocation". O Coletor de Lixo também procura por áreas de memória que não são mais referenciadas e libera-as para reutilização - "collection".

A fase de coleta pode ser acionada por um falha na alocação de memória, que ocorre quando não é deixado espaço para um pedido de armazenamento ou por uma chamada System.gc() explícita.

A coleta de lixo pode afetar significativamente o desempenho do aplicativo; portanto, o IBM Virtual Machine oferece vários métodos de otimizar a forma com que a coleta de lixo é executada, reduzindo, dessa forma, o efeito no aplicativo.

Para obter informações mais detalhadas sobre a coleta de lixo, consulte o Manual de Diagnóstico.

### Opções de Coleta de Lixo

A opção -Xgcpolicy especifica a política de coleta de lixo.

-Xgcpolicy utiliza os valores optthruput (o padrão e o valor recomendado), optavgpause ou gencon. A opção controla o comportamento do coletor de lixo, fazendo trocas entre o throughput do aplicativo e o sistema geral, e faz com que os tempos de pausa sejam causados pela coleta de lixo.

O formato da opção e seus valores são:

> -Xgcpolicy:optthruput

> -Xgcpolicy:optavgpause

> -Xgcpolicy:gencon

### Tempo de Pausa

Quando a tentativa de um aplicativo em criar um objeto não pode ser atendida imediatamente no espaço disponível no heap, o coletor de lixo é responsável pela identificação de objetos não referidos (lixo), por excluí-los e retornar o heap para um estado no qual pedidos de alocação imediatos e subseqüentes possam ser atendidos rapidamente. Tais ciclos de coleta de lixo introduzem pausas inesperadas ocasionais na execução do código do aplicativo. Como os aplicativos aumentam de tamanho e complexidade e os heaps tornam-se correspondentemente maiores, esse tempo de pausa da coleta de lixo tende a aumentar de tamanho e importância. O valor padrão da coleta de lixo, -Xgcpolicy:optthruput, fornece um rendimento alto para aplicativos, mas com o custo das pausas ocasionais, que podem variar de alguns milissegundos até vários segundos, dependendo do tamanho do heap e da quantidade de lixo.

### Redução do Tempo de Pausa

A JVM utiliza duas técnicas para reduzir tempos de pausa:

- Coleta de lixo simultânea
- Coleta de lixo com base em gerações

A opção de linha de comandos -Xgcpolicy:optavgpause solicita o uso da coleta de lixo simultânea para reduzir significativamente o tempo gasto em pausas para coletas de lixo. A Coleta de Lixo Simultânea reduz o tempo de pausa executando algumas atividades de coleta de lixo simultaneamente à execução normal de programas para minimizar a interrupção causada pela coleta do heap. A opção -Xgcpolicy:optavgpause também limita o efeito do aumento do tamanho de heap durante a pausa para coleta de lixo. A opção -Xgcpolicy:optavgpause é mais útil para configurações que apresentam grandes heaps. Com o tempo de pausa reduzido, você poderá perceber uma certa redução no rendimento do processamento dos aplicativos.

Durante a coleta de lixo simultânea, um tempo significativo é gasto com a identificação de objetos relativamente resistentes que não conseguem ser coletados. Se a Coleta de Lixo concentrar-se apenas nos objetos com a maior tendência de serem recicláveis, será possível reduzir ainda mais os tempos de pausa de alguns aplicativos. A Coleta de Lixo com Base em Gerações obtém o mesmo resultado dividindo o heap em duas "gerações", as áreas de "desenvolvimento" e "estabilidade". Os objetos são colocados em uma dessas áreas dependendo da duração. A área de desenvolvimento é a menor e contém objetos mais recentes, enquanto a área de estabilidade é maior e contém objetos mais antigos. Os objetos são alocados primeiro à área de desenvolvimento; se persistirem por um período suficiente, avançarão em algum momento para a área de estabilidade.

A Coleta de Lixo com Base em Gerações depende da curta duração da maioria dos objetos. Ela reduz os tempos de pausa concentrando-se na tentativa de reivindicar o armazenamento na área de desenvolvimento, pois essa área inclui a maioria do espaço reciclável. Em vez de tempos de pausa ocasionais, mas demorados, para coletar todo o heap, a área de desenvolvimento é coletada com mais freqüência e, se essa área for pequena o bastante, os tempos de pausa serão relativamente menores. Entretanto, a Coleta de Lixo com Base em Gerações apresenta a desvantagem da possibilidade de que, com o passar do tempo, a área de estabilidade fique lotada se vários objetos persistirem por muito tempo. Para minimizar o tempo de pausa quando essa situação ocorrer, utilize uma combinação da Coleta de Lixo Simultânea com a Coleta de Lixo com Base em Gerações. A opção -Xgcpolicy:gencon solicita o uso combinado dessas duas técnicas para ajudar a minimizar o tempo gasto com qualquer pausa para coleta de lixo.

### Ambiente com Heaps Muito Cheios

Se o heap Java estiver quase cheio, e houver pouco lixo para ser recuperado, os pedidos de novos objetos poderão não ser atendidos rapidamente por não haver espaço disponível de imediato. Se o heap for operado com capacidade quase cheia, o desempenho do aplicativo poderá ser afetado, independentemente de quais opções anteriores forem utilizadas; e, se os pedidos de mais espaço para o heap continuarem a ser feitos, o aplicativo receberá uma exceção OutofMemory, o que resultará na finalização da JVM caso a exceção não seja capturada e tratada. Nesse ponto, a JVM produz um arquivo de diagnósticos "javadump". Nessas condições, recomenda-se aumentar o tamanho do heap utilizando a opção -Xmx ou reduzir o número de objetos do aplicativo em uso. Para obter mais informações, consulte Manual de Diagnóstico.

## Como a JVM Processa Sinais

Quando surge um sinal que é do interesse da JVM, uma rotina de tratamento de sinais é chamada. Essa rotina de tratamento de sinais determina se o sinal foi chamado por causa de um encadeamento Java ou não-Java.

Se o sinal for por causa de um encadeamento Java, a JVM assumirá o controle do tratamento do sinal. Se uma rotina de tratamento de aplicativo para esse sinal for instalada e você não tiver especificado a opção de linha de comandos -Xnosigchain, após o término do processamento da JVM, essa rotina de tratamento será chamada.

Se o sinal for por causa de um encadeamento não-Java e o aplicativo que instalou a JVM tiver instalado anteriormente sua própria rotina de tratamento para o sinal, o controle será fornecido a essa rotina de tratamento. Caso contrário, se o sinal for solicitado pela JVM ou pelo aplicativo Java, ele será ignorado ou a ação padrão será executada.

A exceção a essa regra está no Windows, em que para um sinal gerado externamente (por exemplo, quando você pressiona CTRL-BREAK) um novo encadeamento é criado para executar a rotina de tratamento de sinais. Nesse caso, a rotina de tratamento de sinal da JVM executa seu processamento e, se uma rotina de tratamento de aplicativo para esse sinal for instalada e você não tiver especificado a opção de linha de comandos -Xnosigchain, essa rotina de tratamento de aplicativo será chamada.

Com relação aos sinais de exceção e erro, a JVM:

- Trata a condição e se recupera, ou
- Insere uma seqüência de encerramento controlado em que ela:
  1. Produz um Javadump, para descrever o estado da JVM em um ponto da falha
  2. Chama a rotina de tratamento de sinais do aplicativo em razão desse sinal.
  3. Chama todos os ganchos de interrupção instalados pelo aplicativo.
  4. Executa a limpeza necessária para fornecer um encerramento limpo.

Para obter informações sobre como gravar um ativador que especifique os ganchos acima, consulte: http://www-106.ibm.com/developerworks/java/library/i-signalhandling/. Esse item foi gravado para o Java V1.3.1, mais ainda se aplica a versões mais recentes.

Com relação aos sinais de interrupção, a JVM insere também uma seqüência de encerramento controlado, mas dessa vez ela é tratada como uma terminação normal:

- Chama a rotina de tratamento de sinais do aplicativo em razão desse sinal.
- Executa todos os ganchos de encerramento do aplicativo.
- Chama todos os ganchos de saída instalados pelo aplicativo.
- Executa a limpeza necessária da JVM.

O encerramento é idêntico ao encerramento iniciado por uma chamada para o método `System.exit()`.

Outros sinais utilizados pela JVM destinam-se a propósitos de controle interno e não causam a sua terminação. O único sinal de controle de interesse é SIGBREAK, o que faz com que um Javadump seja gerado.

### Sinais Utilizados pela JVM

A Tabela 1 a seguir mostra os sinais utilizados pela JVM. Os sinais são agrupados na tabela por tipo ou uso, como se segue:

- Exceções: O sistema operacional faz surgir sincronicamente um sinal de exceção apropriado sempre que uma condição fatal ocorre.
- Erro: A JVM fará surgir um SIGABRT caso detecte uma condição da qual ela não pode recuperar-se.
- Interrupções: Os sinais de interrupção surgem de maneira assíncrona, de fora de um processo JVM, para solicitar encerramento.
- Controles: Outros sinais são utilizados pela JVM para propósitos de controle.

Tabela 1. Sinais Utilizados pela JVM
Nome do Sinal | Tipo de Sinal | Descrição | Desativado pelo -Xrs
--- | --- | --- | ---
SIGINT | Interrupção | Atenção interativa (CTRL-C). A JVM sai normalmente. | Sim
SIGTERM | Interrupção | Pedido de finalização. A JVM sairá normalmente. | Sim
SIGBREAK | Controle | Um sinal de pausa proveniente de um terminal. A JVM utiliza isso para efetuar Javadumps. | Sim

|O IBM JVM utiliza a manipulação de exceção estruturada e as APIs |SetConsoleCtrlHandler(). Essas são desativadas com -Xrs. -Xnosigchain é ignorado no Windows.

Utilize a opção -Xrs (reduz uso de sinais) para evitar que a JVM manipule a maior parte dos sinais. Para obter informações adicionais, consulte a página do ativador de aplicativos Java da Sun em http://java.sun.com/j2se/1.4.2/docs/tooldocs/windows/java.html.

Os sinais `2 (SIGINT)` e `15 (SIGTERM)` nos encadeamentos da JVM fazem com que ela seja encerrada. Assim, uma rotina de tratamento de sinais de aplicativo não deve tentar uma recuperação desse sinal a menos que a JVM não seja mais necessária.

### Vinculando um Driver de Código Nativo à Biblioteca de Cadeia de Sinais

O Runtime Environment contém um recurso de encadeamento de sinais. A cadeia de sinais permite que a JVM interopere mais eficazmente com o código nativo que instala suas próprias rotinas de tratamento de sinais.

O recurso de encadeamento de sinais permite que um aplicativo estabeleça um vínculo e carregue a biblioteca compartilhada jsig.dll antes da biblioteca compartilhada msvcrt.dll. A biblioteca jsig.dll assegura que as chamadas para `signal()` sejam interceptadas para que suas rotinas de tratamento não substituam as rotinas de tratamento de sinais da JVM. Em vez disso, essas chamadas salvam as novas rotinas de tratamento de sinais ou as "encadeia" ocultas sob as rotinas de tratamento instaladas pela JVM. Mais tarde, quando qualquer um desses sinais surgir e for verificado que eles não se destinam à JVM, as rotinas de tratamento pré-instaladas serão chamadas.

Para utilizar jsig.dll, efetue o link com o aplicativo que cria ou incorpora uma JVM.

## Transformando Documentos XML

O IBM SDK contém o processador XSLT4J e o analisador XML4J que estão em conformidade com a especificação do JAXP 1.3. Essas ferramentas permitem que você analise e transforme documentos XML, independentemente de qualquer implementação de processamento XML específico. Ao utilizar "Factory Finders" para localizar as implementações SAXParserFactory, DocumentBuilderFactory e TransformerFactory, seu aplicativo poderá alternar entre diferentes implementações sem precisar alterar qualquer código.

|A tecnologia XML incluída com o IBM SDK é semelhante ao |Apache Xerces Java e Apache Xalan Java. Consulte | http://xml.apache.org/xerces2-j/ e |http://xml.apache.org/xalan-j/ para obter |mais informações.

O processador XSLT4J permite que você escolha entre o processador Interpretativo XSLT original ou o novo processador de Compilação XSLT. O processador Interpretativo foi projetado para aprimorar e depurar ambientes. Ele suporta as funções de extensão XSLT não suportadas pelo processador de Compilação XSLT. O processador de Compilação XSLT foi projetado para ambientes de tempo de execução de alto desempenho; ele gera um mecanismo de transformação, ou translet, de uma folha de estilo XSL. Essa abordagem separa a interpretação das instruções da folha de estilo de seu aplicativo de tempo de execução para dados XML.

O processador Interpretativo XSLT é o processador padrão. Para selecionar o processador de Compilação XSLT você pode:

- Alterar a entrada no arquivo jaxp.properties (localizado em C:\Arquivos de Programas\IBM\Java50\jre\lib), ou
- Definir a propriedade do sistema da chave javax.xml.transform.TransformerFactory para org.apache.xalan.xsltc.trax.TransformerFactoryImpl.

Para implementar propriedades no arquivo jaxp.properties, copie jaxp.properties.sample para jaxp.properties em C:\Arquivos de Programas\IBM\Java50\. Esse arquivo também contém detalhes completos sobre o procedimento utilizado para determinar as implementações que serão utilizadas para o TransformerFactory, o SAXParserFactory e o DocumentBuilderFactory.

Para melhorar o desempenho ao transformar um objeto StreamSource com um processador de Compilação XSLT, especifique a classe com.ibm.xslt4j.b2b2dtm.XSLTCB2BDTMManager como o fornecedor do serviço org.apache.xalan.xsltc.dom.XSLTCDTMManager. Para determinar o fornecedor de serviços, tente cada uma das etapas até localizar org.apache.xalan.xsltc.dom.XSLTCDTMManager:

1. Verifique a configuração da propriedade de sistema org.apache.xalan.xsltc.dom.XSLTCDTMManager.
2. Verifique o valor da propriedade org.apache.xalan.xsltc.dom.XSLTCDTMManager no arquivo C:\Arquivos de Programas\IBM\Java50\lib\xalan.properties.
3. Verifique o conteúdo do arquivo META-INF\services\org.apache.xalan.xsltc.dom.XSLTCDTMManager para um nome de classe.
4. Utilize o fornecedor de serviços padrão, org.apache.xalan.xsltc.dom.XSLTCDTMManager.

O processador de Compilação XSLT detecta o fornecedor de serviços para o serviço org.apache.xalan.xsltc.dom.XSLTCDTMManager quando um objeto javax.xml.transform.TransformerFactory é criado. Quaisquer objetos javax.xml.transform.Transformer ou javax.xml.transform.sax.TransformerHandler criados utilizando esse objeto TransformerFactory utilizarão o mesmo fornecedor de serviços. Os fornecedores de serviços só podem ser alterados modificando uma das configurações descritas acima e depois criando um novo objeto TransformerFactory.

### Utilizando uma Versão Mais Antiga do Xerces ou Xalan

Se você estiver utilizando uma versão mais antiga do Tomcat, essa limitação poderá existir.

Se você estiver utilizando uma versão mais antiga do Xerces (anterior a 2.0) ou Xalan (anterior a 2.3) na substituição confirmada, poderá obter uma exceção de ponteiro nulo quando ativar o aplicativo. Essa exceção ocorre porque essas versões mais antigas não manipulam o arquivo jaxp.properties corretamente.

Para evitar essa situação, utilize uma das seguintes soluções alternativas:

- Faça upgrade para uma versão mais recente do aplicativo que implemente a especificação do Java API para XML Programming (JAXP) mais recente (http://java.sun.com/xml/jaxp/index.html).
- Remova o arquivo jaxp.properties de C:\Arquivos de Programas\IBM\Java50\jre\lib.
- Remova o comentário das entradas do arquivo jaxp.properties em C:\Arquivos de Programas\IBM\Java50\jre\lib.
- Defina explicitamente o SAX Parser, DocumentBuilder ou Transformer Factory utilizando a variável de ambiente IBM_JAVA_OPTIONS. Exemplo:

      set IBM_JAVA_OPTIONS=-Djavax.xml.parsers.SAXParserFactory=
        org.apache.xerces.jaxp.SAXParserFactoryImpl

  ou

      set IBM_JAVA_OPTIONS=-Djavax.xml.parsers.DocumentBuilderFactory=
        org.apache.xerces.jaxp.DocumentBuilderFactoryImpl

  ou

      set IBM_JAVA_OPTIONS=-Djavax.xml.transform.TransformerFactory=
        org.apache.xalan.processor.TransformerFactoryImpl

- Defina a propriedade do sistema para javax.xml.parsers.SAXParserFactory , javax.xml.parsers.DocumentBuilderFactory ou javax.xml.transform.TransformerFactory a partir do seu código de aplicativo. Para obter um exemplo, consulte a especificação JAXP 1.3.

# Utilizando o SDK para Desenvolver os Aplicativos Java

As seções a seguir fornecem informações sobre como utilizar o SDK para Windows para desenvolver aplicativos Java. Consulte Ferramentas do SDK para obter detalhes sobre as ferramentas disponíveis.

## Depurando os Aplicativos Java

Para depurar os programas Java, utilize o aplicativo JDB (Java Debugger) ou outros depuradores que comunicam utilizando o JPDA (Java Platform Debugger Architecture) fornecido pelo SDK para Windows.

### JDB (Java Debugger)

O JDB (Java Debugger) é incluído no SDK para Windows. O depurador é chamado pelo comando jdb; ele "conecta-se" à JVM utilizando o JPDA. Para depurar um aplicativo Java:

1. Inicie a JVM com as seguintes opções:

       java -Xdebug -Xrunjdwp:transport=dt_socket,server=y,address=<port>
            MyApp <MyApp args>

2. A JVM é iniciada, porém suspende a execução antes de iniciar o aplicativo Java. Em uma sessão separada, você pode conectar o depurador à JVM:

       jdb -attach <número da porta>

   O depurador será conectado à JVM e você, agora, poderá emitir uma série de comandos para examinar e controlar o aplicativo Java; por exemplo, digite `run` para permitir a execução do aplicativo Java.

Para obter mais informações sobre as opções do JDB, digite:

    jdb -help

Para obter mais informações sobre os comandos do JDB:

1. Digite `jdb`
2. No prompt do jdb, digite `help`

O JDB também pode ser utilizado para depurar aplicativos JDB em JPDA de máquinas remotas que utilizem um soquete TCP/IP para se conectar à JVM remota.

1. Inicie a JVM como antes.
2. Conecte o depurador à máquina remota:

       jdb -attach <nome da máquina ou endereço ip>:<número da porta>

Ao ativar uma sessão de depuração utilizando o transporte dt_socket, verifique se as portas especificadas estão livres para utilização.

|A JVMDI (Java Virtual Machine Debugging Interface) |não é suportada neste release. Ela foi substituída pela JVMTI (Java |Virtual Machine Tool Interface).

Para obter mais informações sobre o JDB e o JPDA e seu uso, consulte estes Web sites:

- http://java.sun.com/products/jpda/
- http://java.sun.com/j2se/1.5.0/docs/guide/jpda/
- http://java.sun.com/j2se/1.5.0/docs/guide/jpda/jdb.html

## Determinando se o Aplicativo Está Sendo Executado em uma JVM de 32 ou 64 bits

Alguns aplicativos Java devem ser capazes de determinar se estão sendo executados em uma JVM de 32 ou de 64 bits. Por exemplo, se o aplicativo tiver uma biblioteca de códigos nativos, ela deverá ser compilada separadamente nos formatos 32 e 64 bits das plataformas que suportam ambos os modos de operação, 32 e 64 bits. Nesse caso, seu aplicativo deverá carregar a biblioteca correta no tempo de execução, pois não será possível misturar código de 32 e 64 bits.

A propriedade de sistema com.ibm.vm.bitmode permite que os aplicativos determinem o modo em que a JVM está executando. Ela retorna os seguintes valores:

- 32 - a JVM está executando no modo de 32 bits
- 64 - a JVM está executando no modo de 64 bits

Você pode verificar o com.ibm.vm.bitmode a partir do código do aplicativo utilizando a chamada:

    System.getProperty("com.ibm.vm.bitmode");

## Escrevendo Aplicativos JNI

Os números de versão válidos do JNI que os programas nativos podem especificar na chamada de API JNI_CreateJavaVM() são:

- JNI_VERSION_1_2(0x00010002)
- JNI_VERSION_1_4(0x00010004)

Esse número de versão determina somente o nível da interface nativa do JNI a ser utilizada. O nível real da JVM criado é especificado pelas bibliotecas J2SE (isto é, v5.0). A API da interface do JNI não afeta a especificação de idioma implementada pela JVM, as APIs da biblioteca de classes ou qualquer outra área do comportamento da JVM. Para obter informações adicionais, consulte http://java.sun.com/j2se/1.5.0/docs/guide/jni.

Se seu aplicativo precisar de duas bibliotecas do JNI, uma criada para 32 bits e outra para 64 bits, utilize a propriedade do sistema com.ibm.vm.bitmode para determinar se está executando com um JVM de 32 bits ou 64 bits e escolha a biblioteca de propriedades.

Nota:
A Versão 1.1 do JNI (Java Native Interface) não é suportada.

## Trabalhando com Applets

Com o Applet Viewer, você pode executar um ou mais applets que sejam chamados pela referência em uma página da Web (arquivo HTML) utilizando a tag APPLET. O Applet Viewer localiza as tags APPLET no arquivo HTML e executa os applets, em janelas separadas, como especificado pelas tags.

Como o Applet Viewer destina-se à visualização de applets, ele não pode exibir uma página da Web inteira que contenha muitas tags HTML. Ele analisa apenas as tags APPLET e nenhum outro HTML na página da Web.

### Executando Applets com o Applet Viewer

Para executar um applet com o Applet Viewer, digite o seguinte em um prompt de shell:

       appletviewer nome

em que nome é uma das seguintes opções:

- O nome de um arquivo HTML que chama um applet
- A URL de uma página da Web que chama um applet

Por exemplo, para chamar o Applet Viewer em um arquivo HTML que chama um applet, digite em um prompt de shell:

    appletviewer <demo>\GraphLayout\example1.html

em que <demo> é substituído pelo caminho completo onde você descompactou o pacote demo.

Por exemplo, `http://java.sun.com/applets/NervousText/example1.html` é a URL de uma página da Web que chama um applet. Para chamar o Applet Viewer nessa página da Web, digite em um prompt shell:

    appletviewer http://java.sun.com/applets/NervousText/example1.html

O Applet Viewer não reconhece a opção charset da tag <META>. Se o arquivo que o appletviewer carregar não for codificado como o padrão do sistema, poderá ocorrer uma exceção de E/S. Para evitar a exceção, utilize a opção -encoding ao executar o appletviewer. Exemplo:

    appletviewer -encoding JISAutoDetect sample.html

### Depurando Applets com o Applet Viewer

É possível depurar applets utilizando a opção -debug do Applet Viewer. Ao depurar applets, será recomendado que você chame o Applet Viewer do diretório que contém o arquivo HTML que chama o applet. Exemplo:

    cd <demo>\TicTacToe
    appletviewer -debug example1.html

Onde <demo> é substituído pelo caminho completo onde você descompactou o pacote demo.

A documentação sobre como depurar applets utilizando o Applet Viewer pode ser localizada no Web site da Sun: http://java.sun.com.

| | |

## Configurando a Alocação da Memória de Página Grande

|

É possível ativar o suporte a páginas grandes, nos sistemas com suporte |para tal, iniciando o Java com a opção -Xlp.

|

O uso da página grande é pretendido principalmente para fornecer melhorias de desempenho |para aplicativos que aloquem muita memória e freqüentemente acessem essa memória. |As melhorias de desempenho de página grande são ocasionadas principalmente pelo número reduzido |de falhas no TLB (Translation Lookaside Buffer). Os TLB mapeia um intervalo maior |de memória virtual e, portanto, causa esse aprimoramento.

|

Para que a JVM utilize páginas grandes, seu sistema deverá ter um número adequado |de páginas grandes contíguas disponíveis. Se, mesmo quando há paginas |suficientes disponíveis, não foi possível alocar páginas grandes, |possivelmente as páginas grandes não são contíguas.

|

Alocações grandes de página obterão êxito somente se a política |administrativa local do usuário JVM estiver configurada para permitir |"Lock pages in memory".

## Suporte ao CORBA

O Java 2 Platform, Standard Edition (J2SE) suporta, pelo menos, as especificações definidas em Official Specifications for CORBA support in J2SE (V1.5). Em alguns casos, o IBM J2SE ORB suporta as versões mais recentes das especificações.

### Suporte para GIOP 1.2

Este SDK suporta todas as versões de GIOP, como definido nos capítulos 13 e 15 da especificação do CORBA 2.3.1, documento OMG formal/99-10-07, o qual pode ser obtido em:

http://www.omg.org/cgi-bin/doc?formal/99-10-07

O GIOP bidirecional não é suportado.

### Suporte para Interceptadores Portáteis

Este SDK suporta Interceptadores Portáteis, como definido pelo OMG no documento ptc/01-03-04, o qual pode ser obtido em:

http://www.omg.org/cgi-bin/doc?ptc/01-03-04

Os Interceptadores Portáteis são ganchos para o ORB por meio dos quais os serviços ORB podem interceptar o fluxo normal de execução do ORB.

### Suporte para Serviço de Nomes Interoperável

Este SDK suporta o Serviço de Nomes Interoperável, como definido pelo OMG no documento ptc/00-08-07, o qual pode ser obtido em:

http://www.omg.org/cgi-bin/doc?ptc/00-08-07

A porta padrão utilizada pelo Servidor de Nomes Transientes (o comando `tnameserv`), quando nenhum parâmetro ORBInitialPort é fornecido, foi alterada de 900 para 2809, que é o número da porta registrado no IANA (Internet Assigned Number Authority) para um Serviço de Nomes do CORBA. Os programas que dependem desse padrão podem precisar ser atualizados para funcionarem com esta versão.

O contexto inicial retornado do Servidor de Nomes Transientes agora é `org.omg.CosNaming.NamingContextExt`. Os programas existentes que reduzem a referência a um contexto `org.omg.CosNaming.NamingContext` ainda funcionam e não precisam ser recompilados.

O ORB suporta os parâmetros -ORBInitRef e -ORBDefaultInitRef que são definidos pela especificação do Serviço de Nomes Interoperável; a operação ORB::string_to_object agora suporta os formatos de cadeia ObjectURL (corbaloc: e corbaname:) que são definidos pela especificação do Serviço de Nomes Interoperável.

O OMG especifica um método ORB::register_initial_reference para registrar um serviço no Serviço de Nomes Interoperável. No entanto, esse método não está disponível na API do Sun Java Core em Versão 5.0. Os programas que precisam registrar um serviço na versão atual devem chamar esse método na classe de implementação do ORB interno da IBM. Por exemplo, para registrar um serviço "MyService":

    ((com.ibm.CORBA.iiop.ORB)orb).register_initial_reference("MyService",
    serviceRef);

em que `orb` é uma instância de `org.omg.CORBA.ORB`, retornada de `ORB.init()` , e `serviceRef` é um objeto CORBA, conectado ao ORB. Esse é um mecanismo intermediário, e não é compatível com versões futuras ou portáteis para ORBs não-IBM.

### Propriedades do Sistema para Rastrear o ORB

Um recurso de depuração de tempo de execução fornece capacidade de utilização aprimorada. Você pode considerá-lo útil para diagnóstico de problemas ou ele pode ser solicitado pela equipe de serviços da IBM. O rastreio é controlado por três propriedades de sistema.

- Para ativar o rastreio, defina `com.ibm.CORBA.Debug=true` .
- Para formatar e incluir nas mensagens GIOP de rastreio enviadas e recebidas, defina `com.ibm.CORBA.CommTrace=true`. Por padrão, o rastreio ORB busca arquivos que possuem nomes no formato orbtrc.DDMMYYYY.HHmm.SS.txt.
- Para enviá-lo para um outro arquivo, defina `com.ibm.CORBA.Debug.Output=<nome do arquivo>`.

Por exemplo, para rastrear eventos e mensagens GIOP formatadas, digite:

     java -Dcom.ibm.CORBA.Debug=true
    		-Dcom.ibm.CORBA.CommTrace=true myapp

Não ative o rastreio para operação normal, pois ele pode causar degradação no desempenho. Mesmo que você tenha desativado o rastreio, o FFDC (First Failure Data Capture) ainda funciona, de forma que apenas os erros sérios sejam relatados. Se um arquivo de saída de depuração for gerado, examine-o para analisar o problema. Por exemplo, o servidor pode ter parado sem executar um ORB.shutdown().

O conteúdo e o formato da saída de rastreio variam de acordo com a versão.

### Propriedades do Sistema para Ajustar o ORB

As seguintes propriedades ajudam você a ajustar o ORB:

- Para controlar a fragmentação do GIOP 1.2, defina a propriedade de sistema com.ibm.CORBA.FragmentSize.

  Por exemplo, para definir o tamanho do fragmento para 4096 bytes:

      java -Dcom.ibm.CORBA.FragmentSize=4096 myapp

  O tamanho padrão do fragmento é 1024 bytes. Você pode desativar a fragmentação definindo o tamanho do fragmento como 0.

- Em uma rede heterogênea, a resposta para um Pedido CORBA pode ser retardada ou perdida. Você pode definir o tempo máximo de espera utilizando a propriedade de sistema com.ibm.CORBA.RequestTimeout. Pode também utilizar com.ibm.CORBA.LocateRequestTimeout para controlar o tempo limite para LocateRequests. Por exemplo, para restringir ambos os retardos para 30 segundos, digite:

      java -Dcom.ibm.CORBA.RequestTimeout=30
           -Dcom.ibm.CORBA.LocateRequestTimeout=30 myapp

  Por padrão, o ORB aguarda indefinidamente por uma resposta. Para impedir que as conexões sejam encerradas desnecessariamente, não defina um valor muito baixo para o tempo limite.

- Se seu programa estiver fornecendo um serviço na rede, poderá ser necessário definir, para um valor conhecido, o número da porta da qual o ORB lê os pedidos recebidos. Isso pode ser controlado utilizando a propriedade de sistema com.ibm.CORBA.ListenerPort.

  Por exemplo, para que o ORB utilize a porta 1050, digite:

      java -Dcom.ibm.CORBA.ListenerPort=1050 myapp

  Se essa propriedade for definida, o ORB começará a atender assim que for inicializado. Caso contrário, ele começará a atender somente quando for solicitado.

### Permissões de Segurança do Java 2 para o ORB

Ao executar um Java 2 SecurityManager, a chamada de alguns métodos nas classes de API do CORBA pode fazer com que seja feita verificações de permissões, o que pode resultar em um SecurityException. Os métodos afetados incluem o seguinte:

Tabela 2. Métodos afetados ao executar com o Java 2 SecurityManager
Classe/Interface | Método | Permissão Necessária
--- | --- | ---
org.omg.CORBA.ORB | init | java.net.SocketPermission resolve
org.omg.CORBA.ORB | connect | java.net.SocketPermission listen
org.omg.CORBA.ORB | resolve_initial_references | java.net.SocketPermission connect
org.omg.CORBA. portable.ObjectImpl | _is_a | java.net.SocketPermission connect
org.omg.CORBA. portable.ObjectImpl | _non_existent | java.net.SocketPermission connect
org.omg.CORBA. portable.ObjectImpl | OutputStream _request (String, boolean) | java.net.SocketPermission connect
org.omg.CORBA. portable.ObjectImpl | _get_interface_def | java.net.SocketPermission connect
org.omg.CORBA. Pedido | invoke | java.net.SocketPermission connect
org.omg.CORBA. Pedido | send_deferred | java.net.SocketPermission connect
org.omg.CORBA. Pedido | send_oneway | java.net.SocketPermission connect
javax.rmi. PortableRemoteObject | narrow | java.net.SocketPermission connect

Se seu programa utilizar qualquer um desses métodos, assegure-se de que ele tenha as permissões necessárias.

### Classes de Implementação do ORB

As classes de implementação do ORB neste release são:

- org.omg.CORBA.ORBClass=com.ibm.CORBA.iiop.ORB
- org.omg.CORBA.ORBSingletonClass=com.ibm.rmi.corba.ORBSingleton
- javax.rmi.CORBA.UtilClass=com.ibm.CORBA.iiop.UtilDelegateImpl
- javax.rmi.CORBA.StubClass=com.ibm.rmi.javax.rmi.CORBA.StubDelegateImpl
- javax.rmi.CORBA.PortableRemoteObjectClass= com.ibm.rmi.javax.rmi.PortableRemoteObject

Esses são os valores padrão e é aconselhável que você não defina essas propriedades ou faça referência às classes de implementação diretamente. Para obter portabilidade, faça referência somente às classes de API do CORBA e não à implementação. Esses valores podem ser alterados em releases futuros.

## RMI sobre IIOP

O Java RMI (Remote Method Invocation) fornece um mecanismo simples para executar a programação Java distribuída. O RMI sobre IIOP (RMI-IIOP) utiliza o protocolo IIOP (Internet Inter-ORB) padrão do CORBA (Common Object Request Broker Architecture) para estender o Java RMI base para executar a comunicação. Isso permite direcionar a interação com quaisquer outros ORBs (Object Request Brokers) do CORBA, independentemente de terem sido implementados no Java ou em outra linguagem de programação.

A seguinte documentação está disponível:

- O Guia do Programador do RMI-IIOP é uma introdução para escrever programas RMI-IIOP. O guia é instalado quando você instala esta documentação.
- O diretório demo contém:
  - Um exemplo "Hello World" que pode alternar entre o JRMP (Java Remote Method Protocol) e os protocolos IIOP (demo\rmi-iiop\hello)
  - Um exemplo "Hello World" que interage com um programa IDL padrão (demo\rmi-iiop\idl)
- O documento Linguagem Java para Mapeamento IDL é uma especificação técnica detalhada do RMI-IIOP e pode ser encontrado em:
  http://www.omg.org/cgi-bin/doc?ptc/00-01-06.pdf

## Implementando o Conjunto da Rotina de Tratamento de Conexão para RMI

O conjunto de encadeamento para as Rotinas de Tratamento de Conexão do RMI não é ativado por padrão.

Para ativar o conjunto de conexão implementado no nível TCPTransport do RMI, defina a opção

    -Dsun.rmi.transport.tcp.connectionPool=true (ou qualquer valor que não seja nulo)

Essa versão do Runtime Environment não possui nenhuma definição que você possa utilizar para limitar o número de encadeamentos no conjunto de conexão.

Para obter informações adicionais, consulte o site do Java da Sun: http://java.sun.com.

## Suporte ao BiDirectional Avançado

O IBM SDK inclui suporte ao BiDirectional avançado. Para obter mais informações, consulte http://www-106.ibm.com/developerworks/java/jdk/bidirectional/index.html.O Javadoc para o pacote BiDirectional é fornecido com o SDK no arquivo docs/apidoc.zip.

## BigDecimal Avançado

| |

No Java 5.0, a classe IBM BigDecimal foi adotada pela Sun como java.math.BigDecimal. | A IBM não mantém mais o com.ibm.math.BigDecimal e está sinalizado como desaprovado. | Recomenda-se migrar o código Java existente para utilizar o java.math.BigDecimal.

|

O novo java.math.BigDecimal utiliza os mesmos métodos que o |java.math.BigDecimal e o com.ibm.math.BigDecimal anteriores. O código existente que utiliza o java.math.BigDecimal |continua funcionando corretamente.

|

Para migrar o código Java existente para utilizar a classe java.math.BigDecimal, altere |a instrução de importação no início do arquivo java de: `importar com.ibm.math.*;` para `importar java.math,*;`.

## Suporte ao Símbolo Euro

O IBM SDK and Runtime Environment define o Euro como a moeda padrão para os países da EMU (União Monetária Européia) para datas em ou após 1º de janeiro de 2002.

Para utilizar a moeda nacional antiga, especifique `-Duser.variant=PREEURO` na linha de comandos Java.

Se você estiver executando os códigos do idioma inglês (Reino Unido), dinamarquês ou suéco e desejar utilizar o Euro, especifique `-Duser.variant=EURO` na linha de comandos Java.

# Utilizando o Java Communications API (JavaComm)

O pacote do Java Communications API (Application Programming Interface) (JavaComm) é um pacote opcional fornecido para ser utilizado com o Runtime Environment para Windows. Instale o JavaComm independentemente do SDK ou Runtime Environment.

O JavaComm API fornece aos aplicativos Java uma forma independente de plataforma de executar comunicações das portas seriais e paralelas para tecnologias como correio de voz, fax e cartões inteligentes. Depois de gravar as comunicações das portas seriais e paralelas para seus aplicativos, inclua esses arquivos em seu aplicativo.

O Java Communications API suporta as portas seriais Electronic Industries Association (EIA)-232 (RS232) e as portas paralelas Institute of Electrical and Electronics Engineers (IEEE) 1284; ela é suportada em sistemas que tenham o Runtime Environment da IBM, Versão 5.0.

Utilizando o Java Communications API, você pode:

- Listar portas em um sistema
- Abrir e reivindicar direito à propriedade de portas
- Resolver contenção de direito à propriedade de porta entre aplicativos que utilizam o Java Communications API
- Executar monitoração de porta de E/S assíncrona e síncrona por meio de notificação de eventos
- Receber eventos de estilo bean que descrevem as alterações de estado da porta

## Instalando o Java Communications API

Você precisa certificar-se de que uma cópia do SDK ou Runtime Environment esteja instalada antes de instalar o Java Communications API.

Para instalar o Java Communications API de um arquivo zip :

1. Coloque o arquivo zip do Java Communications API, ibm-java2-javacomm-50-win-i386.zip, no diretório de instalação do SDK ou Runtime Environment. Se você instalou no diretório padrão, este é C:\Arquivos de Programas\IBM\Java50\.
2. Descompacte o arquivo.Esses arquivos são extraídos desta forma:
   - jre\lib\ext\comm.jar
   - jre\bin\ibmcomm.dll
   - jre\lib\javax.comm.properties
   - docs\javacomm\License.html

   Se você aceitou o diretório padrão quando instalou o Runtime Environment, o arquivo comm.jar está em C:\Arquivos de Programas\IBM\Java50\jre\lib\ext.

   Se o arquivo for descompactado em outro diretório, os arquivos serão colocados na mesma estrutura de diretório; porém C:\Arquivos de Programas\IBM\Java50\ é substituído pelo diretório onde você descompactou o arquivo.

## Configurando o Java Communications API

Depois de instalar o Java Communications API, é necessário:

- Alterar o modo de acesso das portas seriais e paralelas.
- Definir o PATH, se você não o definiu quando instalou o Java. Consulte Definindo o PATH.

## Limitação ao Imprimir com o Java Communications API

Ao imprimir com o Java Communications API, poderá ser necessário pressionar "Avanço do Papel", "Continuar" ou similar na impressora.

## Desinstalando o Java Communications API

Para desinstalar o Java Communications API, exclua os seguintes arquivos do diretório em que o Runtime Environment foi instalado:

- jre\lib\ext\comm.jar
- jre\bin\ibmcomm.dll
- jre\lib\javax.comm.properties
- docs\javacomm\License.html

Por padrão, o Runtime Environment é instalado no diretório C:\Arquivos de Programas\IBM\Java50\.

## Documentação do Java Communications API

A documentação da API e as amostras do Java Communications API podem ser localizadas no Web site da Sun: http://java.sun.com.

# Implementando os Aplicativos Java

## Utilizando o Plug-in Java

O Plug-in Java é um plug-in de navegador da Web. Ao utilizar o Java Plug-in, você pode ignorar a JVM padrão de seu navegador da Web e utilizar um Runtime Environment de sua preferência para executar os applets ou beans no navegador.

É necessário permitir o término do carregamento dos applets para evitar que o navegador seja 'interrompido'. Por exemplo, se você utilizar o botão Voltar e depois o botão Avançar enquanto um applet estiver sendo carregado, pode ser que as páginas HTML não sejam carregadas.

O Java Plug-in é documentado pela Sun em: http://java.sun.com/j2se/1.5.0/docs/guide/plugin/developer_guide/.

### Navegadores Suportados

|

|Tabela 3. Navegadores suportados pelo Plug-in Java
|Sistema Operacional | |Internet Explorer | |Netscape | |Mozilla
--- | --- | --- | ---
| Windows 2000 | |5.5 SP2, 6.0 | |4.78, 6.2.2, 7.2 | |1.4.x, 1.5.x, 1.6.x, 1.7.x, Firefox 1.0.x
|Windows XP | |6.0 | |4.78, 6.2.2, 7.2 | |1.4.x, 1.5.x, 1.6.x, 1.7.x, Firefox 1.0.x
|Windows Server 2003 | |6.0 | |4.78, 6.2.2, 7.2 | |1.4.x, 1.5.x, 1.6.x, 1.7.x, Firefox 1.0.x

|

Observe que o Internet Explorer 5.01, o navegador padrão do Windows 2000, |não é suportado.

### Suporte a DOM (Document Object Model)

Por causa das limitações em determinados navegadores, você talvez não consiga implementar todas as funções do pacote org.w3c.dom.html.

- Uma sun.plugin.dom.exception.NotSupportedException é lançada para algumas dessas funções.
- Uma sun.plugin.dom.exception.InvalidStateException é lançada quando o navegador não suporta um função específica.

### Utilizando Parâmetros DBCS

O Java Plug-in suporta caracteres de byte duplo (por exemplo, chinês tradicional BIG-5, coreano, japonês) como parâmetros para as marcações `<APPLET>`, `<OBJECT>` e `<EMBED>`. Será necessário selecionar a codificação de caractere correta para seu documento HTML, para que o Plug-in Java possa analisar o parâmetro. Especifique a codificação de caracteres para o documento HTML utilizando a marcação `<META>` na seção `<HEAD>` desta forma:

    <meta http-equiv="Content-Type" content="text/html; charset=big5">

Esse exemplo pede que o navegador utilize a codificação de caracteres Chinese BIG-5 para analisar a utilização do arquivo HTML. Todos os parâmetros são aprovados para o Plug-in Java corretamente. No entanto, algumas das versões mais antigas dos navegadores podem não interpretar essa marcação corretamente. Nesse caso, você poderá fazer com que o navegador ignore essa marcação, mas poderá ter de alterar a codificação manualmente.

Você poderá especificar qual codificação você deseja utilizar para analisar o arquivo HTML:

- Internet Explorer 5/6 Exibir Menu -> Codificação
- Netscape 4: Exibir Menu -> Conjunto de Caracteres
- Netscape 6: Exibir Menu -> Código de Caractere

## Utilizando Web Start

Você pode utilizar o Java Web Start para implementar os aplicativos Java. O Web Start permite que o usuário ative e gerencie aplicativos diretamente da Web. Com o Java Web Start, você pode iniciar aplicativos facilmente da Web, certo de que esteja executando a versão mais recente, eliminando procedimentos de instalação ou upgrade. O Java Web Start elimina a necessidade de fazer download e instalar software, ignorando as opções de instalação demoradas.

|Além do java-vm-args documentado em http://java.sun.com/j2se/1.5.0/docs/guide/javaws/developersguide/syntax.html#resources, o Web Start suporta -Xgcpolicy para definir a política de |coleta de lixo.

Para obter informações sobre os navegadores que suportam o Web Start, consulte Navegadores Suportados.

Para obter mais informações sobre o Web Start, consulte: http://java.sun.com/products/javawebstart e http://java.sun.com/j2se/1.5.0/docs/guide/javaws/index.html. Para obter mais informações sobre os aplicativo de implementação, consulte: http://java.sun.com/j2se/1.5.0/docs/guide/deployment/index.html.

### Executando o Web Start

Você pode chamar o Web Start de três maneiras:

1. Selecione um link em uma página da Web que faça referência a um arquivo .jnlp.
2. Em um prompt de comandos, digite `javaws <URL>`, em que `<URL>` é o local de um arquivo .jnlp.
3. |Se o Java Web Start já foi utilizado para abrir o aplicativo, execute |javaws, no |diretório jre\bin,para ativar o Java Application Cache Viewer.

Depois de fazer download do aplicativo, ele será armazenado no Java Application Cache. Se o aplicativo for acessado novamente, o Java Web Start fará download de uma versão mais recente do aplicativo, se estiver disponível, e utilizará a versão em cache, se não estiver disponível.

Se ocorrer um erro em um arquivo .jnlp (como um nome de tag inválido), o Web Start falhará sem exibir uma mensagem de erro.

## Remessa dos Aplicativos Java

Um aplicativo Java, ao contrário de um applet Java, não pode contar com um navegador da Web para serviços de instalação e tempo de execução. Quando você envia um aplicativo Java, o pacote de software provavelmente consiste nas seguintes partes:

- Sua própria classe, recurso e arquivos de dados
- Um procedimento ou programa de instalação

Para executar o aplicativo, um usuário precisa do Runtime Environment para Windows. O software SDK para Windows contém um Runtime Environment. No entanto, você não pode assumir que os usuários tenham o software SDK para Windows instalado.

A licença do software SDK para Windows não permite que você redistribua qualquer um dos arquivos do SDK com seu aplicativo. Você precisa assegurar-se de que uma versão licenciada do SDK para Windows esteja instalada na máquina de destino.

| | |

# Compartilhamento de Dados de Classe Entre JVMs

|

O IBM Virtual Machine (VM) permite compartilhar classes de auto-inicialização e |aplicativos entre VMs, armazenando-as em um cache na memória compartilhada. O compartilhamento de classes |reduz o consumo geral de memória virtual quando mais de uma VM compartilha |um cache. O compartilhamento de classe também reduz o tempo de inicialização de uma VM depois do cache |ter sido criado. O cache de classe compartilhada é independente de qualquer VM ativo |e persiste além do período de existência da VM que iniciou o cache.

| |

## Visão Geral sobre o Compartilhamento de Classe

|

O IBM SDK permite compartilhar tantas classes quanto possível, atuando |de forma transparente ao usuário.

| |

### Conteúdo do Cache

|

O cache de classe compartilhada contém dados e metadados da classe estática de leitura |que descreve as classes. Qualquer VM pode ler ou atualizar o cache. Os VMs que |estão sendo compartilhados devem estar no mesmo release. Você deve tomar |cuidado se o bytecode do tempo de execução estiver sendo utilizado. (Consulte Modificação do Bytecode de Tempo de Execução).

| |

### Atualização Dinâmica do Cache

|

Como o cache de classe compartilhada persiste além do período de existência de qualquer VM, |o cache é atualizado dinamicamente para refletir quaisquer modificações que possam ter sido |feitas nos JARs ou nas classes, no sistema de arquivos. A atualização dinâmica torna |o cache transparente para o aplicativo que está utilizando-o.

| |

### Ativando o Compartilhamento de Classe

|

Ative o compartilhamento de classes utilizando a opção -Xshareclasses |ao iniciar uma VM, para fazer com que a VM se conecte a um cache existente ou crie |um se ainda não existir. Todas as classes de auto-inicialização e aplicativos carregadas pela VM são compartilhadas por padrão. Os carregadores de classe personalizados são compartilhados automaticamente se |estenderem o carregador de classe do aplicativo; caso contrário, eles deverão usar o Java Helper |API fornecido com a VM para acessar o cache. (Consulte Adaptando Carregadores de Classe Personalizados às Classes de Compartilhamento).

| |

### Segurança do Cache

|

A acesso ao cache de classe compartilhada é limitado pelas permissões |do sistema operacional e da segurança do Java. Por padrão, |Somente um classloader registrado para |compartilhar classes poderá incluir classes no cache de classe |compartilhada. Se um Java SecurityManager estiver instalado, os |ClassLoaders (exceto os de auto-inicialização, de aplicativo e de |extensão) devem possuir permissão para compartilhar classes, incluindo |SharedClassPermissions no arquivo java.policy. (Consulte Utilizando SharedClassPermissions). A |RuntimePermission "createClassLoader" restringe a criação de novos |ClassLoaders e, portanto, também restringe o acesso ao cache.

| |

### Tempo de Vida do Cache

|

Vários caches podem existir em um sistema e são especificados por nome como uma subopção |para o comando -Xshareclasses. Uma VM pode se conectar a apenas um cache |por vez. Especifique o tamanho do cache na inicialização utilizando -Xscmx<n>[k|m|g], porém esse tamanho será corrigido para o período de existência do |cache. Os caches existirão até que sejam explicitamente destruídos utilizando uma subopção |para o comando -Xshareclasses ou até que o sistema seja |reinicializado.

| |

### Utilitários do Cache

|

Todos os utilitários do cache são subopções para o comando -Xshareclasses. Utilize -Xshareclasses:help para ver uma lista |de subopções disponíveis.

| |

## Utilizando as Opções da Linha de Comandos para Compartilhamento de Classe

|

O compartilhamento de classe é ativado e configurado utilizando as opções de linha de comandos -Xshareclasses e -Xscmx.

|

|
- -Xscmx<size>[k|m|g] |
  |
  - Especifica o tamanho do cache. Essa opção é aplicável apenas se um cache |estiver sendo criado e se não houver nenhum cache existente com o mesmo |nome. |O tamanho do cache padrão depende da plataforma. |É possível descobrir o valor que está sendo utilizado, incluindo |-verbose:sizes como argumento da linha de comando. O tamanho mínimo do |cache é 4 kB. O tamanho máximo do cache também depende da plataforma. (Consulte Limites no Tamanho do Cache).
|
- -Xshareclasses:<suboption1>[,<suboption2>...] |
  |
  - Ativa o compartilhamento de classe. Pode obter um número de subopções, alguns dos quais |são utilitários de cache. Os utilitários de cache executam a operação requerida no |cache especificado, sem iniciar a VM. É possível combinar várias subopções, |separadas por vírgula, porém os utilitários de cache são mutuamente exclusivos.
  Você pode usar as seguintes subopções com a opção -Xshareclasses, por exemplo -Xshareclasses:help |
  |
  - help |
    |
    - Lista todas as opções da linha de comandos.
  |
  - name=<name> |
    |
    - Conecta a um cache de um determinado nome, criando o cache se ele ainda não |existir. Use a opção do utilitário listAllCaches |para mostrar quais caches estão atualmente disponíveis. Se não especificar |um nome, o nome padrão "sharedcc_" será combinado com o nome do usuário |atual anexado para criar o nome do cache.
  |
  - verbose |
    |
    - A opção Verbose fornece uma saída detalhada sobre a atividade de E/S do |cache, listando informações sobre as classes que estão sendo armazenadas e |localizadas. A cada carregador de classe é dado um único ID (o |carregador de auto-inicialização é sempre 0) e a saída mostra a hierarquia do carregador de classe |no trabalho, onde os carregadores de classe devem solicitar aos seus pais uma classe para poderem |carregá-la. É normal ver muitos pedidos com falha; esse comportamento é |esperado para a hierarquia do classloader. Observe que a opção padrão |-verbose:class também ativa a saída detalhada do |compartilhamento de classe, se tal compartilhamento estiver ativado.
  |
  - modified=<modified context> |
    |
    - Essa opção será requerida se for instalado um agente de bytecode que possa modificar |o bytecode no tempo de execução. Se você não especificar essa opção e um agente de bytecode |for instalado, nenhuma classe será armazenada ou localizada no cache. A opção <modified context> é um descritor escolhido pelo usuário; por exemplo, |"myModification1". Isso particiona o cache, de forma que apenas os JVMs que utilizem o contexto |myModification1 podem compartilhar as mesmas classes. Por exemplo, se você executar "HelloWorld" |com um contexto de modificação e depois executá-lo novamente com um contexto de modificação |diferente, verá todas as classes armazenadas duas vezes no cache.
  |
  - destroy (opção do utilitário) |
    |
    - Destrói um cache usando o nome especificado na subopção name=<name>. Se o nome não for especificado, |o cache padrão será destruído. Um cache somente pode ser destruído |se todos os VMs que o utilizam foram encerrados e o usuário tiver permissões suficientes.
  |
  - destroyAll (opção do utilitário) |
    |
    - Tenta destruir todos os caches disponíveis para o usuário. Um cache somente pode ser destruído |se todos os VMs que o utilizam foram encerrados e o usuário tiver permissões suficientes.
  |
  - expire=<time in minutes> |(opção do utilitário) |
    |
    - Destrói todos os caches que não foram utilizados durante o tempo especificado.
  |
  - listAllCaches (opção do utilitário) |
    |
    - Lista todos os caches no sistema, descrevendo se estão em uso e quando |foram utilizados pela última vez.
  |
  - printStats (opção do utilitário) |
    |
    - Exibe informações resumidas das estatísticas sobre o cache especificado na subopção name=<name>. Se o nome não for especificado, serão exibidas as estatísticas sobre o cache padrão. As |informações mais úteis exibidas são o quão completo é o cache e quantas classes |ele contém. Observe que as classes "stale" são classes que foram atualizadas |no sistema de arquivos e, portanto, qual cache foi marcado com "stale". As classes Stale |não são limpas do cache. Consulte o Manual de Diagnóstico para obter mais informações.
  |
  - printAllStats (opção do utilitário) |
    |
    - Exibe informações detalhadas sobre o conteúdo do cache especificado |na subopção name=<name>. |Se o nome não for especificado, serão exibidas as estatísticas sobre o cache padrão. Cada classe é listada na ordem cronológica juntamente com uma referência |ao local de onde ela foi carregada. Consulte o Manual de Diagnóstico para obter mais informações.

| |

## Criando, Preenchendo, Monitorando e Excluindo um Cache

|

Para ativar o compartilhamento de classe, inclua -Xshareclasses[:name=<name>] na linha de comandos do aplicativo. A VM se conectará a um cache |existente com um nome específico ou criará um novo cache com esse nome. Se |um novo cache for criado, ele será preenchido com todas as classes de |auto-inicialização e de aplicativos que estão sendo carregadas, até ficar |completamente cheio. Se dois ou mais VMs forem iniciados de forma concorrente, |todos preencherão o cache de forma concorrente.

|

Para verificar se o cache foi criado, execute `java |-Xshareclasses:listAllCaches` . Para ver quantas classes e quantos dados das classes estão sendo compartilhados, execute `java -Xshareclasses:[name=<name>],printStats`. (Esses utilitários podem |ser executados após o término da VM do aplicativo ou em outra janela de comando)

|

Para ver as classes que estão sendo carregadas do cache ou armazenadas nele, inclua `-Xshareclasses:[name=<name>],verbose` na linha de comandos do |aplicativo.

|

Para excluir o cache criado, execute `java -Xshareclasses:[name=<name>],delete`. Você terá que excluir caches somente se eles contiverem muitas classes |stale ou se o cache estiver cheio e você desejar criar um cache maior.

|

Convém ajustar o tamanho do cache para o seu aplicativo específico, uma |vez que não é provável que o padrão seja o tamanho ideal. O melhor meio de |determinar o tamanho ideal do cache é especificar um cache grande (com | -Xscmx), executar o aplicativo e utilizar |printStats para determinar quantos dados de classe foram armazenados. |Inclua um valor pequeno no valor mostrado em printStats para contingência. |Não se esqueça de que, como as classes podem ser carregadas a qualquer |momento durante a existência da VM, é melhor que essa análise seja feita |depois da conclusão do aplicativo. Contudo, um cache cheio não causa um |efeito negativo no desempenho ou capacidade de qualquer VM conectada a |ele; assim é plenamente justificável escolher um tamanho de cache menor do |que o requerido.

|

Se um cache ficar cheio, uma mensagem será exibida na linha de comandos de |todas as VMs que o utilizem, e elas carregarão quaisquer classes |adicionais na própria memória de processo. As classes em um cache cheio |ainda podem ser compartilhadas, contudo ele é de somente leitura e não |pode ser atualizado com novas classes.

| |

## Desempenho e Consumo de Memória

|

O compartilhamento de classe é particularmente útil em sistemas que |utilizam mais de uma VM com código semelhante; os sistemas se beneficiam |do consumo reduzido de memória virtual. Também é útil em sistemas que |freqüentemente inicializam e encerram VMs, que se beneficiam do |aprimoramento no tempo de inicialização.

|

O código extra para criar e preencher um novo cache é mínimo. O custo do |tempo de inicialização de uma única VM é, normalmente, entre 0 e 5%, |dependendo de quantas classes são carregadas. O tempo de inicialização da |VM melhorado com um cache preenchido geralmente está entre 10% e 40%, |dependendo do sistema operacional e do número de classes carregadas. |Várias VMs executando simultaneamente exibirão benefícios de tempo de |inicialização total maiores.

|

Quando você executar seu aplicativo com compartilhamento de classe, poderá utilizar as ferramentas |do sistema operacional para ver a redução no consumo de memória virtual.

| |

## Limitações e Considerações sobre Como Utilizar o Compartilhamento de Classe

| |

### Limites no Tamanho do Cache

|

O tamanho do cache teórico máximo é 2 GB. O cache estará |limitado pelos seguintes fatores:

|

|

|
- Espaço em disco disponível. Um arquivo é criado no disco para armazenar os |dados da classe no diretório "javasharedresources" sob o perfil do |usuário. Esse diretório está normalmente definido como C:\Documents and |Settings\<username>\Application Data\. |Esse arquivo é excluído toda vez que |o Windows é reiniciado.
|
- Espaço de endereço virtual disponível. Como o espaço de endereço virtual |de um processo é compartilhado entre o cache de classes compartilhadas e o |heap Java, aumentar o tamanho máximo do heap Java reduzirá o tamanho do |cache de classes compartilhadas que pode ser criado.

| |

### Modificação do Bytecode de Tempo de Execução

|

Qualquer VM que utilize um agente JVMTI que possa modificar o bytecode não pode compartilhar |classes a não ser que a subopção modified=<modified_context> seja utilizada na |linha de comandos (veja acima). O contexto modificado é um descritor especificado pelo usuário |que descreve o tipo de modificação que está sendo executada. Todos os VMs que utilizam um determinado |contexto modificado devem modificar o bytecode de uma maneira previsível e repetida |para cada classe, de forma que as classes modificadas armazenadas no cache tenham |as modificações esperadas quando forem carregadas por outra VM. O motivo |de qualquer modificação precisar ser previsível é que as classes |carregadas do cache de classes compartilhadas não podem ser novamente |modificadas pelo agente. Observe que o bytecode |modificado e não modificado pode ser armazenado no mesmo cache. Consulte o Manual de Diagnóstico para obter mais detalhes sobre este tópico.

| |

### Limitações do Sistema Operacional

|

Para sistemas operacionais que podem executar os aplicativos de |32 bits e 64 bits, o compartilhamento de classe não é permitido entre VMs de 32 bits e 64 bits. |A subopção listAllCaches listará caches de 32 bits ou 64-bits, |dependendo do modo de endereço da VM que está sendo utilizado.

|

O cache de classes compartilhadas requer espaço em disco para armazenar informações de identificação |sobre os caches existentes no sistema. Essas informações |estão localizadas no diretório do perfil do usuário. Se o diretório de informações de |identificação for excluído, a VM não poderá identificar as classes compartilhadas no sistema |e deverá recriar o cache.

|

As permissões para acessar um |cache de classes compartilhadas são forçadas pelo sistema operacional. Por padrão, se um nome de cache não for |especificado, o nome do usuário será anexado ao nome padrão para que vários |usuários no sistema operacional criem seus próprios caches.

| |

### Utilizando SharedClassPermissions

|

Se um SecurityManager estiver sendo utilizado em conjunto com o |compartilhamento de classe e o aplicativo em execução utilizar seus |próprios classloaders, tais classloaders devem possuir a permissão |SharedClassPermissions antes que possam compartilhar classes. Inclua |SharedClassPermissions no arquivo java.policy utilizando o nome de classe |ClassLoader (caracteres-curinga são permitidos), e "read", "write" ou |"read,write" para determinar o acesso concedido. |Exemplo:

|

    permission com.ibm.oti.shared.SharedClassPermission "com.abc.customclassloaders.*", "read,write";

Se um ClassLoader sem a permissão SharedClassPermission correta tentar |compartilhar classes, a exceção AccessControlException será emitida. Não |é possível alterar ou reduzir as permissões dos classloaders de |auto-inicialização, aplicativo ou extensão.

| |

## Adaptando Carregadores de Classe Personalizados às Classes de Compartilhamento

|

A maioria dos aplicativos Java utilizará os próprios carregadores de classe da VM ou terá |carregadores de classe personalizados que estendam java/net/URLClassLoader. |Aplicativos que utilizem tais classloaders poderão compartilhar |automaticamente classes de auto-inicialização e de aplicativos. |Os carregadores de classe personalizados que não estendam java/net/URLClassLoader irão requerer |modificações para utilizar o compartilhamento de classes. Todos os |classloaders precisarão receber permissões SharedClassPermissions caso um |SecurityManager seja utilizado; consulte |Utilizando SharedClassPermissions. A IBM apresenta várias interfaces Java para diversos tipos de |classloaders personalizados, as quais permitem que os classloaders |localizem e armazenem classes no cache de classes compartilhadas. Essas classes estão no pacote |com.ibm.oti.shared. O Javadoc desse pacote é fornecido com o SDK no |arquivo docs/apidoc.zip. Consulte o Manual de |Diagnóstico para obter mais informações sobre como utilizar essas interfaces.

# Serviço e Suporte para Fornecedores Independentes de Software

Se você estiver qualificado para os serviços do código do Programa relativos ao programa IBM Solutions Developer, entre em contato com esse Programa por meio de seu método normal de acesso ou pela Web em: http://www-1.ibm.com/partnerworld/.

Se você adquiriu um contrato de serviço (isto é, Linha de Suporte aos Sistemas Pessoais da IBM ou serviço equivalente por país), os termos e condições desse contrato de serviço determinam quais serviços, se existirem, você está qualificado a receber com relação ao Programa.

# Acessibilidade

Os Guias do Usuário fornecidos com este SDK e o Runtime Environment foram testados utilizando os leitores de tela. É possível utilizar um leitor de tela como o Home Page Reader ou o leitor de tela JAWS com esses Guias do Usuário.

Para alterar os tamanhos de fonte nos Guias do Usuário, utilize a função fornecida com seu navegador, normalmente encontrada na opção de menu Exibir.

Para usuários que necessitam da navegação via teclado, há uma descrição do pressionamento de teclas úteis dos aplicativos Swing em "Swing Key Bindings", no site http://www-128.ibm.com/developerworks/java/jdk/additional/

## Acessibilidade iKeyman

|Em adição à GUI, a ferramenta iKeyman apresenta a ferramenta de linha de |comandos IKEYCMD com as mesmas funções que a |interface gráfica com o usuário (GUI) do iKeyman. O IKEYCMD permite que você gerencie teclas, |certificados e pedidos de certificados. Você pode chamar o IKEYCMD a partir de scripts shell nativos e de programas que deverão ser utilizados quando |os aplicativos precisarem incluir interfaces personalizadas nas tarefas de gerenciamento de certificados |e chaves. O IKEYCMD pode criar arquivos do banco de dados de chaves para todos |os tipos que o iKeyman suporta atualmente. O IKEYCMD pode |também criar pedidos de certificados, importar certificados assinados CA e gerenciar |certificados auto-assinados.

Para executar um comando IKEYCMD, digite:

    java [-Dikeycmd.properties=<properties file>]com.ibm.gsk.ikeyman.ikeycmd
    <object> <action> [options]

em que:

<object>
  é uma das seguintes opções:
  -keydb
    Ações tomadas no banco de dados de chaves (um arquivo do banco de dados de chaves CMS, um arquivo de chaves WebDB ou uma classe SSLight)
  -cert
    Ações a serem tomadas num certificado dentro de um banco de dados de chaves
  -certreq
    Ações a serem tomadas num pedido de certificado dentro de um banco de dados de chaves
  -version
    Exibe informações sobre versão do IKEYCMD
  -help
    Exibe ajuda para as chamadas do IKEYCMD.
<action>
  |A ação específica a ser tomada no objeto. Para consultar as ações |disponíveis para um objeto, chame IKEYCMD e informe |apenas o objeto como argumento. A ajuda sensível a contexto será exibida |mostrando as ações disponíveis para esse objeto.
-Dikeycmd.properties
  Especifica o nome de um arquivo de propriedades opcional para utilizar com essa invocação Java. Um arquivo de propriedades padrão, ikeycmd.properties, é fornecido como um arquivo de amostra que pode ser alterado e utilizado por qualquer aplicativo Java.

Nota:
As palavras-chave object e action devem estar na seqüência especificada. Contudo, as opções não são posicionais e podem estar em qualquer seqüência, desde que estejam especificadas como um par de opção e operando.

Para obter mais informações, consulte o Guia do Usuário do iKeyman em: http://www.ibm.com/developerworks/java/jdk/security/index.html.

## Keyboard Traversal dos Componentes JComboBox no Swing

Se você percorrer a lista drop-down de um componente JComboBox com as teclas do cursor, o botão ou o campo editável da caixa de combinação não alterará o valor até que um item seja selecionado. Esse é o comportamento ideal para este release e melhora a acessibilidade e a utilidade assegurando que o comportamento do keyboard traversal seja consistente com o comportamento do mouse traversal.

## Acessibilidade do Web Start

O IBM Java Web Start v5.0 contém vários aprimoramentos de acessibilidade e usabilidade a mais que o release anterior, incluindo melhor suporte para leitores de tela e navegação do teclado aprimorada.

Você pode usar apenas a linha de comandos para ativar um aplicativo Java que seja ativado para o Web Start. Para alterar as opções de preferência, você deverá editar um arquivo de configuração, Application Data\IBM\Java\Deployment\deployment.properties no diretório home do usuário. Faça um backup antes de editar esse arquivo. Nem todas as preferências que podem ser definidas no Java Application Cache Viewer estão disponíveis no arquivo de configuração.

# Nota Geral Sobre Segurança

Você pode obter os arquivos de políticas de jurisdição irrestrita JCE em http://www.ibm.com/developerworks/java/jdk/security/index.html. A documentação sobre os pacotes de segurança IBM JCE, JCEFIPS, JSSE2, JSSEFIPS, JGSS, JAAS e criptografia de hardware também está disponível nesse Web site.

# Limitações Conhecidas

Observe essas limitações no IBM 32-bit SDK for Windows, v5.0:

- O IBM 32-bit SDK for Windows, v5.0 suporta os seguintes códigos do idioma:
  - Bengalês (bn_IN)
  - Malaiala (ml_IN)
  - Oriá (or_IN)
  Entretanto, as fontes desses códigos do idioma podem não funcionar nos componentes do AWT.

- O IBM 32-bit SDK for Windows, v5.0 suporta o IPv6. |Contudo, como o suporte atual do IPv6 no Windows não é dual-stack, |o SDK emula o comportamento dual-stack em um sistema ativado por IPv6. Seu aplicativo |Java pode usar até duas vezes o máximo de soquetes por causa da natureza |da emulação. Para desativar essa emulação, desative o suporte do IPv6 no SDK |configurando a propriedade de sistema java.net.preferIPv4Stack para `true`.

- Ao trabalhar com um IME (Input Method Editor), recomenda-se que a composição dos caracteres seja completada e o candidato selecionado antes de utilizar a área de trabalho para qualquer outra operação.

- A criação de pares de chaves DSA de comprimentos incomuns pode demorar um tempo significativo em máquinas mais lentas. Este atraso não deve ser interpretado como uma interrupção, pois o processo se completará se lhe for cedido tempo suficiente. O algoritmo de geração da chave DSA foi otimizado para gerar comprimentos de chave padrão (neste caso, 512, 1024) com mais rapidez que os outros.

- Firewalls pessoais podem causar problemas ao código NIO do Windows, fazendo com que operações particulares falhem. Por exemplo, a chamada do método Selector.open() pode emitir um `java.io.IOException: Unable to establish loopback connection` com uma causa de `java.net.ConnectException: Connection refused: connect`. A exceção é causada pela conexão do sistema operacional em uma porta que esteja sendo bloqueada pelo firewall. A JVM tentará novamente a operação de conexão, solicitando ao sistema operacional para escolher um número de porta diferente. Se, depois de várias tentativas, ele ainda não puder conectar-se, um `ConnectException` será emitido.

  Se você vir essa exceção, poderá definir a propriedade do sistema java.nio.debug=pipe para ver quais números de porta estão sendo bloqueados.

- Quando um usuário digitar texto em uma Área de Texto AWT enquanto estiver utilizando um IME e, em seguida, redimensionar a janela do aplicativo antes de consolidar o texto, ele será consolidado automaticamente.

- No Windows 2000, e XP, o valor padrão do número de arquivos que podem ser abertos simultaneamente é muito baixo e causará muitos problemas de E/S dos aplicativos. Para corrigir essa limitação, edite o arquivo <windows>\system32\CONFIG.NT e defina os seguintes valores:
  - `files=200`
  - `buffers=60`
  em que <windows> é o diretório onde o Windows está instalado.

- No Windows 2000, com uma profundidade de cores de 32 bits, o mecanismo DirectDraw da JVM não redesenha a região sob o ponteiro do mouse. O efeito são quadrados cinza ou preto que aparecem nos menus depois de o mouse ter estado ali. A solução alternativa é desativar o DirectDraw (`-Dsun.java2d.noddraw`), ou alterar a resolução de cores da tela para algum outro valor, como 256 cores.

- Ao instalar a biblioteca nativa PKCS 11 na JVM v1.4.x, você deve colocar a biblioteca no diretório binário JRE com as outras bibliotecas nativas JRE.

- A chamada NIO SocketChannel finishConnect() pode retornar `verdadeiro` (o canal está conectado) ou `falso` (o processo de conexão não está concluído ainda), ou pode emitir uma exceção. No Windows 2000, ao utilizar conexões sem bloqueio, poderá ser retornado `falso` mesmo depois que uma chamada anterior select() java tiver deduzido que um canal está pronto para processamento.

- Não é possível alterar o intervalo de pilhas do encadeamento principal Java (também conhecido como o encadeamento primordial) no tempo de execução. O encadeamento principal possui um tamanho fixo de 256 KB, determinado como o valor ótimo por motivos de desempenho. Você pode usar a opção -Xss para modificar o intervalo de pilhas somente em encadeamentos que não sejam o principal. Por causa desse tamanho fixo do encadeamento principal, recomenda-se não tensioná-lo com atividade recursiva intensa, pois o encadeamento principal é mais propenso ao estouro da pilha que outros encadeamentos.

- Se você estiver digitando caracteres DBCS em um JTextArea, JTextField ou JFileChooser, a alternância de alguns IMEs chineses (especialmente Chinese Internal Code e Zhengma) para o IME Intelligent ABC pode fazer com que seja produzido um dump de núcleo.

- Para usuários tchecos, observem que o painel de seleção de idiomas do Installshield oferece uma entrada traduzida em uma instalação normalmente não traduzida. Essa é uma limitação causada pelo Installshield. A cadeia é capturada do sistema operacional com base na página de códigos. Como os idiomas polonês (para o qual a instalação foi traduzida) e tcheco possuem a página de códigos 1250, o Installshield tenta recuperar uma lista de idiomas do sistema para ambos os idiomas, resultando nessa cadeia na lista de idiomas.

- Se utilizar o chinês tradicional, não canalize a saída do aplicativo Java diretamente para o comando more. Em vez disso, direcione-a para um arquivo temporário e exiba o arquivo separadamente.

- Para usuários catalães, a fonte Lucida Console deve ser utilizada para impedir a má exibição de caracteres maiúsculos acentuados. Esse problema afeta apenas os usuários do Windows 2000.

# Algum Comentário sobre este Guia do Usuário?

Caso tenha algum comentário sobre a utilidade, ou não, deste Guia do Usuário, gostaríamos de saber sua opinião através do correio. Observe que esse meio não foi implementado para responder perguntas técnicas - esse meio é apenas para comentários sobre a documentação. Envie seus comentários:

- Por e-mail: idrcf@hursley.ibm.com.
- Por fax:
  - Do Reino Unido: 01962 842327
  - De outros locais:<código internacional>44 1962 842327
- Por escrito para:
  Centro de Tecnologia IBM Brasil - Centro de Traduções
  Rodovia SP 101 km 09
  CEP 13185-900
  Hortolândia, SP

Letras Miúdas. Ao mandar uma mensagem para a IBM, o Cliente concorda que todas as informações contidas em sua mensagem, incluindo dados sobre feedback, como perguntas, comentários, sugestões ou informações similares, serão classificadas como não-confidenciais; a IBM não possui nenhuma obrigação de qualquer tipo em relação a tais informações e poderá reproduzir, utilizar, divulgar e distribuir as informações a terceiros sem nenhuma limitação. A IBM poderá usar todas as idéias, conceitos, conhecimentos ou técnicas contidas em tais informações para o fim que desejar, incluindo, mas não se limitando a desenvolvimento, fabricação e marketing de produtos incorporando tais informações.

# Avisos

Estas informações foram desenvolvidas para produtos e serviços oferecidos nos Estados Unidos. A IBM pode não oferecer os produtos, serviços ou recursos discutidos neste documento em outros países. Consulte seu representante da IBM local para obter informações sobre os produtos e serviços atualmente disponíveis em sua área. Qualquer referência a produtos, programas ou serviços IBM não significa que apenas produtos, programas ou serviços IBM possam ser utilizados. Qualquer produto, programa ou serviço funcionalmente equivalente, que não infrinja nenhum direito de propriedade intelectual da IBM ou quaisquer outros direitos da IBM, poderá ser utilizado em substituição a este produto, programa ou serviço. Entretanto, a avaliação e verificação da operação de qualquer produto, programa ou serviço não-IBM é de inteira responsabilidade do Cliente.

A IBM pode ter patentes ou solicitações de patentes pendentes relativas a assuntos tratados nesta publicação. O fornecimento desta publicação não garante ao Cliente nenhum direito sobre tais patentes. Pedidos de licença devem ser enviados, por escrito, para:

- Gerência de Relações Comerciais e Industriais da IBM Brasil
  Av. Pasteur, 138-146
  Botafogo
  Rio de Janeiro, RJ
  CEP 22290-240

Para pedidos de licenças com relação a informações sobre DBCS (Conjunto de Caracteres de Byte Duplo), entre em contato com o Departamento de Propriedade Intelectual da IBM em seu país ou envie pedidos, por escrito, para:

- IBM World Trade Asia Corporation Licensing
  2-31 Roppongi 3-chome, Minato-ku
  Tokyo 106-0032, Japan

O parágrafo a seguir não se aplica a nenhum país em que tais disposições não estejam de acordo com a legislação local:

A INTERNATIONAL BUSINESS MACHINES CORPORATION FORNECE ESTA PUBLICAÇÃO "NO ESTADO EM QUE SE ENCONTRA", SEM GARANTIA DE NENHUM TIPO, SEJA EXPRESSA OU IMPLÍCITA, INCLUINDO, MAS NÃO SE LIMITANDO ÀS GARANTIAS IMPLÍCITAS DE MERCADO OU DE ADEQUAÇÃO A UM DETERMINADO PROPÓSITO. Alguns países não permitem a exclusão de garantias expressas ou implícitas em certas transações; portanto, esta disposição pode não se aplicar ao Cliente.

Estas informações podem incluir imprecisões técnicas ou erros tipográficos. Periodicamente, são feitas alterações nas informações aqui contidas; tais alterações serão incorporadas em futuras edições desta publicação. A IBM pode fazer aperfeiçoamentos e/ou alterações nos produtos e/ou programas descritos nesta publicação, a qualquer momento e sem aviso prévio.

Referências nestas informações a Web sites não-IBM são fornecidas apenas por conveniência e não representam de forma alguma um endosso a esses Web sites. Os materiais contidos nesses Web sites não fazem parte dos materiais deste produto IBM e a utilização desses Web sites é de responsabilidade do usuário.

A IBM pode utilizar ou distribuir qualquer informação fornecida, da forma que julgar apropriada, sem que isso incorra em qualquer obrigação para com o Cliente.

Licenciados deste programa que pretendam obter mais informações sobre o mesmo com o objetivo de permitir: (i) a troca de informações entre programas criados independentemente e outros programas (incluindo este) e (ii) a utilização mútua das informações trocadas, devem entrar em contato com:

- Gerência de Relações Comerciais e Industriais da IBM Brasil
  Av. Pasteur, 138-146
  Botafogo
  Rio de Janeiro-RJ
  CEP 22290-240

Tais informações podem estar disponíveis, sujeitas a termos e condições apropriados, incluindo, em alguns casos, o pagamento de uma taxa.

O programa licenciado descrito neste documento e todo o material licenciado disponível são fornecidos pela IBM sob os termos do Contrato com Cliente IBM, Contrato de Licença de Programa Internacional IBM ou qualquer contrato equivalente.

Todos os dados de desempenho aqui descritos foram determinados em um ambiente controlado. Portanto, os resultados obtidos em outros ambientes operacionais podem variar significativamente. Algumas medidas podem ter sido tomadas em sistemas em fase de desenvolvimento e não há garantia de que tais medidas sejam as mesmas nos sistemas normalmente disponíveis. Além disso, algumas medições podem ter sido estimadas através de extrapolação. Os resultados reais podem variar. Os usuários deste documento devem verificar os dados que se aplicam ao seu ambiente específico.

As informações referentes a produtos não-IBM foram obtidas junto a fornecedores desses produtos, anúncios publicados ou outras fontes publicamente disponíveis. A IBM não testou esses produtos e não pode confirmar a precisão de desempenho, compatibilidade nem qualquer outra reivindicação relacionada a produtos não-IBM. Dúvidas sobre os recursos dos produtos não-IBM devem ser encaminhadas aos fornecedores dos respectivos produtos.

## Marcas Registradas

IBM é uma marca registrada da International Business Machines Corporation nos Estados e/ou em outros países.

Java e todas as marcas registradas e logotipos baseados em Java são marcas ou marcas registradas da Sun Microsystems, Inc., nos Estados Unidos e/ou em outros países.

Microsoft, Windows e o logotipo do Windows são marcas registradas da Microsoft Corporation nos Estados Unidos e/ou em outros países.

Outros nomes de empresas, produtos ou serviços podem ser marcas registradas ou marcas de serviço de terceiros.

Este produto também é baseado em parte do trabalho do Projeto FreeType. Para obter mais informações sobre o Freetype, consulte http://www.freetype.org.

Este produto inclui software desenvolvido pela Apache Software Foundation http://www.apache.org/.