### IBM(R) OS/2 WARP(R) DEVELOPER KIT,
JAVA(TM) 2 TECHNOLOGY EDITION, 1.3.1
MANUAL DE INSTALAÇÃO E CONFIGURAÇÃO

(c) Copyright IBM Corporation 1999, 2002. Todos os direitos reservados.

Nota: A citação completa de copyright está incluída na seção Avisos deste documento.

Este guia fornece informações sobre o IBM OS/2 Warp Developer Kit, Java(TM) 2 Technology Edition, Versão 1.3.1 (Developer Kit). Ele traz informações sobre a preparação para instalação dos componentes do Developer Kit e itens a serem observados após a instalação.

O Developer Kit é suportado nos seguinte produtos do OS/2(R):

- OS/2 Warp 4 com FixPak 5 ou superior para países ou regiões de conjunto de caracteres de byte único (SBCS)
  ou FixPak FX00505 para países ou regiões de conjunto de caracteres de byte duplo (DBCS)
- OS/2 Warp Server for e-business
- Convenience Package for OS/2 Warp 4
- Convenience Package for OS/2 Warp Server for e-business
- Convenience Package 2 for OS/2 Warp 4
- Convenience Package 2 for OS/2 Warp Server for e-business
- WorkSpace On-Demand Versão 2.0, com o último FixPak

Nota: Para obter informações sobre os requisitos do FixPak ou do site IBM FixPak na Web, consulte a seção FixPaks.

Para obter o build e o número da versão da IBM do Developer Kit, digite o seguinte em uma linha de comandos:

         java -version

### Conteúdo

- 1.0 ANTES DA INSTALAÇÃO
- 1.1 Requisitos de instalação
- 1.2 Extração dos arquivos para instalação
- 1.3 Considerações sobre a partição do sistema de arquivos
- 1.4 FixPaks
- 1.5 Instalação do Developer Kit como a JVM padrão

- 1.5.1 Informações sobre a variável de ambiente JAVA_HOME

- 1.6 Informações sobre o Netscape Communicator
- 1.7 União de arquivos divididos
- 2.0 INSTALAÇÃO DO DEVELOPER KIT
- 2.1 Método de instalação da GUI

- 2.1.1 Método de ambiente de trabalho
- 2.1.2 Método de prompt de comandos
- 2.1.3 Componentes não selecionáveis durante a instalação
- 2.1.4 Recuperação de uma instalação com falha
- 2.1.5 Nível de FixPak correto mas sem possibilidade de instalação

- 2.2 Método de instalação não-assistida (CID)
  - 2.2.1 Modificação do arquivo de resposta CID
  - 2.2.1.1 Unidades de instalação do componente
  - 2.2.2 Início da instalação não-assistida
  - 2.2.3 Código de retorno de instalação do CID "Bem-sucedida" e instalação com falha
  - 2.2.4 Nível de FixPak correto mas sem possibilidade de instalação
- 2.3 Considerações sobre a instalação do NVDM/2

- 2.3.1 Comando estático no perfil do NVDM/2

- 2.4 Instalação do Developer Kit no WorkSpace On-Demand 2.0

- 2.4.1 Instalação do Developer Kit no Servidor WorkSpace On-Demand 2.0
- 2.4.2 Instalação do Developer Kit no Cliente WorkSpace On-Demand 2.0

- 2.4.2.1 Instalação Não-assistida para um Cliente WorkSpace On-Demand 2.0
- 2.4.2.2 Modificação dos Arquivos CONFIG.SYS para Clientes WorkSpace On-Demand 2.0
- 2.4.2.3 Modificação dos arquivos FIT e concessão de acesso aos Clientes WorkSpace On-Demand 2.0
- 2.4.2.4 Atribuição do diretório USER_HOME para Clientes WorkSpace On-Demand 2.0
- 2.4.2.5 Ativação de fontes para Clientes WorkSpace On-Demand 2.0
- 2.4.2.6 Instalação do plug-in do Netscape Communicator para Clientes WorkSpace On-Demand 2.0
- 2.4.2.7 Instalação de componentes adicionais do Developer Kit no Cliente WorkSpace On-Demand 2.0
- 2.4.2.8 Execução de amostras Java em um Cliente WorkSpace On-Demand 2.0
- 2.4.2.9 Emissão de um trust em um Cliente WorkSpace On-Demand 2.0
- 2.4.2.10 O compilador JIT e um Cliente WorkSpace On-Demand 2.0
- 2.4.2.11 Criação de um aplicativo público para o painel de controle de plug-ins Java para o Cliente WorkSpace On-Demand 2.0

- 2.5 Método de instalação de IPL remoto

- 2.5.1 Criação de arquivos de resposta
- 2.5.2 Modificação do arquivo JAVA131.RSP
- 2.5.3 Atualização dos arquivos do Feature Install
- 2.5.4 Início da instalação de IPL remoto
- 2.5.5 Execução de amostras Java em um cliente de IPL remoto

- 2.5.5.1 Emissão de um trust em um cliente IPL remoto

- 3.0 APÓS A INSTALAÇÃO
- 3.1 Fontes adicionais de informações
- 3.2 Instalação de componentes adicionais
- 3.3 Considerações sobre AWT TextField e TextArea
- 3.4 Modificação do arquivo de propriedades de fonte não é suportada
- 3.5 Problemas com horário nos applets Java
- 3.6 Utilização do Suporte à Memória Alta do OS/2 para aumentar o tamanho do heap do Java

- 3.6.1 Ativação do HMS do OS/2
- 3.6.2 Ativação do Tamanho do Heap do Java para utilizar o HMS do OS/2
- 3.6.3 Limitações ao utilizar o HMS do OS/2

- 3.7 Classe BigDecimal aperfeiçoada
- 3.8 Os plug-ins Java
  - 3.8.1 Instalação do plug-in Java após a instalação do Netscape Communicator
  - 3.8.2 Instalação do plug-in Java após a instalação do IBM Web Browser for OS/2
  - 3.8.3 O painel de controle do plug-in Java
- 3.9 Desativação do compilador JIT
- 3.10 Alterações em nomes de arquivos
- 3.11 Configuração do visualizador de applets
- 3.12 Especificação das opções do Java e das propriedades do sistema
- 3.13 RMI Sobre IIOP

- 3.13.1 O compilador IDL para Java

- 3.13.1.1 Restrições do compilador IDL para Java
- 3.13.1.2 Problemas conhecidos do compilador IDL para Java

- 3.13.2 Informações adicionais
- 3.13.3 Termos RMI-IIOP

- 3.14 O JAAS (Java authentication and authorization service)

- 3.14.1 Diferença entre as versões do JAAS da IBM e da Sun
- 3.14.2 Instalação básica

- 3.15 Informações sobre a programação da JNI
- 3.16 Considerações de desempenho
- 4.0 PACOTES DE FONTES ADICIONAIS
- 4.1 Instalação de pacotes de fontes adicionais

- 4.1.1 Método de instalação CID
- 4.1.2 Método de paleta de fontes

- 5.0 INFORMAÇÕES SOBRE O CONJUNTO DE CARACTERES DE BYTE DUPLO (DBCS)
- 5.1 Texto do painel de instalação ausente ou muito longo em países ou regiões DBCS
- 5.2 Fontes TrueType devem ser instaladas em sistemas chineses
- 5.3 Correções temporárias do programa e FixPaks para sistemas DBCS
- 5.4 Controle da exibição de caracteres numéricos árabes
- 5.5 Definições do ambiente japonês na versão japonesa do OS/2 Warp 4
- 5.6 Fontes requeridas na versão japonesa do OS/2 Warp
- 5.7 Melhora na qualidade da fonte no OS/2 Warp Server for e-business
- 6.0 REMOÇÃO DA INSTALAÇÃO DO DEVELOPER KIT
- 6.1 Método de ambiente de trabalho
- 6.2 Método de prompt de comandos do OS/2
- 6.3 Remoção da Instalação do Developer Kit a partir do WorkSpace On-Demand 2.0
- 6.4 Execução de uma remoção de instalação não-assistida
- 6.5 Remoção do Developer Kit como a JVM padrão
- 7.0 LIMITAÇÕES CONHECIDAS
- 8.0 AVISOS
- 9.0 MARCAS

## 1.0 ANTES DA INSTALAÇÃO

O Developer Kit consiste em dois pacotes: um Runtime Environment e um Toolkit. O Runtime Environment inclui componente como JAAS (Java Authetication and Authorization Service), RMI-IIOP Runtime e o compilador JIT (Just-in-Time). O Toolkit contém componentes como o Toolkit, o ICAT (Interactive Code Analysis Tool) Debugger e Samples.

Nota: Não é possível instalar o Toolkit, a não ser que o Runtime Environment também esteja sendo instalado.

Se você fez download de arquivos divididos, consulte a seção União de arquivos divididos para obter informações sobre como unir arquivos divididos em um arquivo instalável.

Antes de instalar o Developer Kit, faça uma cópia do arquivo CONFIG.SYS atual. Isso assegura o retorno ao ambiente original se ocorrerem problemas durante a instalação.

As referências neste manual são as seguintes:

- OS/2 Warp 4 refere-se ao sistema operacional do cliente OS/2 Warp 4 e ao cliente WorkSpace On-Demand (2.0 ou 3.0).
- OS/2 Warp Server refere-se aos sistemas operacionais OS/2 Warp Server for e-business e o servidor WorkSpace On-Demand (2.0 ou 3.0).
- Java 1.1.x refere-se a Java 1.1.1 para OS/2, Java 1.1.4 para OS/2 Warp, IBM OS/2 Warp Developer Kit, Java(TM) Edition, 1.1.6, IBM OS/2 Warp Developer Kit, Java Edition, 1.1.7 e IBM OS/2 Warp Developer Kit, Java Edition, 1.1.8
- Objetos específicos deste produto são referidos como objetos Java 1.3.1.
- Netscape Communicator, a não ser que especificado diretamente, refere-se ao Netscape Communicator 4.04 e posterior.

### 1.1 Requisitos de Instalação

Requisitos de Espaço em Disco:

A seguir, uma lista dos componentes e tamanhos de arquivos do Developer Kit após a instalação. Verifique se há espaço em disco suficiente disponível antes da instalação.

Componente | Tamanho
--- | ---
Runtime Environment | 25,0 MB
Toolkit | 35,0 MB
Samples | 5,0 MB
ICAT Debugger para OS/2 Java | 13,0 MB
Tamanho Total Instalado | 65,0 MB
Lista dos componentes e tamanhos de arquivos do Developer Kit após a instalação.

Requisitos de Hardware:

- Geralmente, um mínimo de 32 MB de memória RAM (memória de acesso aleatório) fornece os melhores resultados ao executar os aplicativos do Developer Kit.
- Recomenda-se um mínimo de 48 MB de RAM para applets executados em um navegador que utiliza o Plug-in Java.
- A IBM recomenda a utilização de um processador Intel(R) Pentium(R) (ou compatível) ou posterior para todos os sistemas OS/2.
- A especificação do Developer Kit requer o modo de 256 cores (ou mais). O Developer Kit não suporta os aplicativos e applets Java que utilizam o AWT (Abstract Window Toolkit) no modo de 16 cores.

Requisitos de Software:

- Feature Install 1.2.3 ou posterior. Você pode fazer download da versão mais recente do Feature Install no IBM Software Choice Catalog of Features. Antes de fazer download, verifique os requisitos de instalação do Feature Install.
- Netscape Communicator 4.0.4. ou posterior.
- TCP/IP Versão 4.3. para OS/2 ou posterior. Você pode fazer download deste produto no IBM Software Choice Catalog of Features.

### 1.2 Extração dos Arquivos para Instalação

Para extrair um arquivo ZIP de auto-extração, conclua as seguintes etapas:

1. Crie um subdiretório (caso ainda não tenha um) para armazenar o arquivo ZIP de auto-extração em sua unidade de disco.
2. Execute o arquivo digitando o nome do arquivo e especificando a opção "-o", em um prompt de comandos, a partir do diretório em que você fez o download do arquivo.

   Por exemplo, para o Developer Kit, digite o seguinte:

       javaintk.exe -o

   Para o Runtime Environment, digite o seguinte:

       javainrt.exe -o

Se você fez download de arquivos divididos e precisa uni-los em um arquivo instalável, consulte a seção União de arquivos divididos. As informações sobre como instalar o Developer Kit estão localizadas na seção Instalação do Developer Kit.

### 1.3 Considerações sobre a Partição do Sistema de Arquivos

As considerações a seguir se aplicam à instalação do Developer Kit:

- Se você instalar o Toolkit, o Runtime Environment será automaticamente selecionado e instalado na mesma unidade do Toolkit.
- O Toolkit e o Samples devem ser instalados em uma unidade HPFS (High Performance File System) ou JFS (Journaled File System).
- Os componentes Runtime Environment e ICAT Debugger podem ser instalados em uma partição FAT (File Allocation Table, Tabela de Alocação de Arquivos).
- Se estiver instalando o Toolkit, o Runtime Environment poderá ser instalado em uma partição FAT, HPFS ou JFS. Para obter melhor desempenho, instale-os em uma partição HPFS ou JFS, que suporte nomes de arquivos longos.

Se você tiver apenas um disco rígido com uma única partição FAT, existem as seguintes opções:

- Deixe o sistema como está e instale apenas o componente Runtime e, opcionalmente, o ICAT Debugger.
- Formate a partição FAT para HPFS ou JFS e instale novamente todos os softwares.
- Adquira um programa de particionamento de disco, como o PartitionMagic. Com espaço suficiente, um programa de particionamento de disco reduz o tamanho da partição atual (unidade C) e cria uma nova partição (unidade lógica D), que pode ser formatada para HPFS.

Nota: Neste documento, o termo "partição" refere-se a qualquer unidade física ou lógica.

### 1.4 FixPaks

As seguintes considerações se aplicam:

Nível de FixPak do Sistema Requerido para OS/2 Warp 4
SBCS | DBCS
FixPak 5 ou posterior | FixPak FX00505
Considerações sobre nível do FixPak.

Para utilizar o euro em aplicativos e applets Java
OS/2 Warp 4 | FixPak 6 ou posterior
Níveis de FixPak para utilização com o euro.

Nota: A exibição e conversão de código do euro são suportadas nas páginas de códigos que contêm o euro.

Se desejar inserir o euro, a versão SBCS (conjunto de caracteres de byte único) do OS/2 será requerida. O teclado Internacional dos Estados Unidos, UX103, suporta entrada do euro, mas um teclado padrão americano não. Em todos os casos, se não tiver um teclado que suporte a entrada do euro, será possível exibi-lo, mas não inseri-lo.

Para obter informações sobre como fazer download de um determinado FixPak, visite o site do IBM FixPak na Web, no endereço:
http://ps.software.ibm.com/pbin-usa-ps/getobj.pl?/pdocs-usa/otherservices.html

### 1.5 Instalação do Developer Kit como a JVM Padrão

A instalação do Developer Kit como a Java Virtual Machine (JVM) padrão permite executar o Developer Kit a partir de um prompt de comandos. Você pode tornar o Developer Kit sua JVM padrão de modo permanente ou temporário. Veja mais informações nas próximas seções.

#### Preparação do Developer Kit como sua JVM Padrão Permanente

Para tornar o Developer Kit sua JVM padrão de forma permanente, é possível:

- Selecioná-lo durante a instalação da Interface Gráfica Com o Usuário.
- Fazer a alteração manualmente, se o Developer Kit (Versão 1.3) já estiver instalado, modificando a instrução PATH no arquivo CONFIG.SYS.

Para modificar a instrução PATH, inclua x:\JAVA131\JRE\BIN; na instrução PATH do arquivo CONFIG.SYS.

Se decidir manter uma versão anterior de Java como a JVM padrão, não selecione a caixa de entrada durante a instalação da GUI ou, se o Developer Kit já estiver instalado, não inclua o diretório x:\JAVA131\JRE\BIN; na instrução PATH no arquivo CONFIG.SYS. Se você já tiver uma versão 1.1.x do Java instalada como a JVM padrão, ela permanecerá como a JVM padrão.

Nota: É possível melhorar o desempenho removendo as referências a releases anteriores de Java no arquivo CONFIG.SYS. No entanto, há aplicativos conhecidos que falharão se o Developer Kit (versão 1.3.x) for instalado como a JVM padrão.

#### Utilização Temporária do Developer Kit para uma sessão Java

Se o Developer Kit não estiver instalado como a JVM padrão, e você desejar utilizá-lo em uma sessão Java, modifique a instrução PATH. Por exemplo,

         SET PATH=x:\JAVA131\JRE\BIN;%PATH%

em que x é a unidade em que o Developer Kit está instalado.

Para melhorar o desempenho, modifique as instruções BEGINLIBPATH e CLASSPATH, conforme mostrado abaixo:

         SET BEGINLIBPATH=x:\JAVA131\JRE\BIN;x:\JAVA131\JRE\DLL;%beginlibpath%
         SET CLASSPATH=

Nota: A instrução CLASSPATH está definida com valor nulo porque a JVM do Developer Kit geralmente não requer que a instrução CLASSPATH procure arquivos de classe do sistema; a instrução CLASSPATH é utilizada para arquivos de classe de aplicativo.

#### Utilização temporária da JVM Java 1.1.x para uma sessão Java

Se o Developer Kit 1.3.x estiver instalado como a JVM padrão, e você desejar utilizar uma JVM Java 1.1.x em uma sessão Java, modifique a instrução PATH. Por exemplo,

        SET PATH=x:\JAVA11\BIN;%PATH%

em que x é a unidade em que o Developer Kit 1.1.x está instalado.

Se as referências ao JAVA11 foram removidas do arquivo CONFIG.SYS, modifique as instruções PATH, BEGINLIBPATH, e CLASSPATH, conforme mostrado abaixo:

        SET PATH=x:\JAVA11\BIN;%PATH%
        SET BEGINLIBPATH=x:\JAVA11\BIN;x:\JAVA11\DLL;%beginlibpath%
        SET CLASSPATH=x:\JAVA11\LIB\CLASSES.ZIP;x:\JAVA11\SWING\SWINGALL.JAR;\;

Nota: A variável CLASSPATH está definida para os arquivos de biblioteca do Java 1.1.x. A definição da variável CLASSPATH para sistemas individuais será diferente.

Para fazer com que o Developer Kit e o Java Plug-in sejam executados, modifique a instrução PATH conforme mostrado acima.

#### 1.5.1 Informações sobre a Variável de Ambiente JAVA_HOME

Se você instalou o Developer Kit (versão 1.3) como sua JVM (Java Virtual Machine) padrão e possui:

- Uma variável de ambiente JAVA_HOME manualmente incluída em seu arquivo CONFIG.SYS para um nível anterior do Developer Kit
- Arquivos de comandos que definem a variável de ambiente JAVA_HOME

Você deve fazer o seguinte:

- Remover ou atualizar a variável de ambiente JAVA_HOME em seu arquivo CONFIG.SYS .
- Modificar os arquivos de comandos removendo ou modificando as instruções que definem a variável de ambiente JAVA_HOME.

### 1.6 Informações sobre o Netscape Communicator

A lista apresentada a seguir contém informações sobre a utilização do Developer Kit e do Netscape Communicator Versão 4.04 e posteriores:

- #### Execução do Netscape Communicator Durante a Instalação do Developer Kit

  Não será possível instalar o Developer Kit se o Netscape Communicator estiver sendo executado durante a execução do comando INSTALL. Feche o Netscape Communicator e depois execute o comando INSTALL.

- #### Netscape Communicator Versão 4.04 e o compilador JIT

  Para executar applets utilizando o Netscape Communicator Versão 4.04, será necessário estar com o compilador JIT (Just-in-Time) ativado. Entretanto, se desejar que o JIT fique desativado e ainda assim utilizar o Netscape Communicator Versão 4.04, você precisará do último nível de atualização do Netscape Communicator Versão 4.04. Para obter informações sobre o nível de atualização mais recente, visite o seguinte site da Web:

  http://ps.software.ibm.com

- #### Caixas de entrada de instalação "fantasma" e o Netscape Communicator Versão 4.61

  Se você tem o Netscape Communicator Versão 4.61 e ainda não fez o download da última atualização, poderá observar caixas de entrada "fantasma" durante a instalação. Embora essas caixas de entrada "fantasma" não afetem a instalação do Developer Kit, você pode optar por fazer o download da atualização mais recente no seguinte site da Web:
  http://ps.software.ibm.com

- Se você instalar o Java 1.3 Developer Kit e remover as entradas JAVA11 do arquivo CONFIG.SYS ou remover a versão 1.1.x do Developer Kit do sistema, não será possível executar applets cujas páginas HTML possuam a marcação <APPLET>, se elas forem lançadas a partir de um navegador Netscape 4.x. Para executar esses applets a partir de um navegador Netscape 4.x, será necessário instalar o Plug-in Java do Developer Kit 1.3 e converter o arquivo HTML do applet para utilizar o Plug-in Java. Os applets lançados a partir do IBM Web Browser for OS/2 funcionarão sem a necessidade de alterações, mesmo se a JVM Java 1.1.x não estiver instalada no sistema.

### 1.7 União de Arquivos Divididos

Os arquivos divididos podem ser unidos com o Merge Utility ou manualmente a partir de um prompt de comandos. As subseções a seguir fornecem informações sobre como unir os arquivos divididos em um arquivo instalável.

Antes de começar, certifique-se de:

- Fazer download de todos os arquivos divididos de um determinado componente e utilizar o nome de arquivo correto. Se você não fez download de todas as partes de um pacote ou se alterou os nomes de arquivos das partes durante o download, o Merge Utility exibirá uma mensagem de erro e o pacote não será recriado.
- Especificar todos os nomes de arquivos e colocá-los na ordem correta. Se os nomes de arquivos foram alterados durante o download, especifique os nomes de arquivos utilizados.
- Que o nome do arquivo no qual os arquivos foram combinados seja o nome de arquivo completo do pacote original. (Por exemplo, o nome de arquivo completo do Runtime Environment é javainrt.exe.) Isso assegura que o utilitário de instalação reconhecerá o arquivo.

#### União de arquivos divididos com o Merge Utility

Antes de começar o processo de união dos arquivos divididos, faça download do programa Joiner Utility para o mesmo diretório em que você fez download dos arquivos divididos. (O nome do arquivo é joiner.exe.) O programa Joiner Utility contém o Merge Utility, que permite unir os arquivos divididos em um arquivo instalável. Você pode fazer download do Joiner Utility a partir da mesma página dos componentes do Developer Kit, no link Software Choice Catalog of Features.

Digite `joiner` em um prompt de comandos a partir do diretório em que fez download do Joiner Utility. Este comando extrai o Merge Utility (merge.exe) e seus arquivos de dados requeridos. O Merge Utility é utilizado para unir os arquivos divididos.

Digite `merge` em um prompt de comandos no diretório em que você fez download do Joiner Utility. Isto cria novamente qualquer pacote que esteja dividido em vários arquivos: Para instalar o arquivo, consulte Instalação do Developer Kit.

#### União de arquivos divididos manualmente a partir de um prompt de comandos

1. Certifique-se de fazer download de todos os arquivos divididos do componente que deseja instalar no mesmo diretório.
2. Em um prompt de comandos (no diretório em que fez download dos arquivos divididos), digite os nomes dos arquivos divididos e o nome do arquivo completo. Por exemplo, para unir os arquivos divididos do Runtime Environment, digite este comando:

         copy /b javainrt.ex1 + javainrt.ex2 + javainrt.ex3 + javainrt.ex4 javainrt.exe

Isto cria novamente qualquer pacote que esteja dividido em vários arquivos: Para instalar o arquivo, consulte Instalação do Developer Kit.

## 2.0 INSTALAÇÃO DO DEVELOPER KIT

As próximas seções fornecem instruções e informações sobre a instalação do Developer Kit. Antes de instalar o Developer Kit ou os componentes a ele associados, leia Antes de instalar para obter informações sobre como extrair os arquivos e os requisitos de instalação.

### 2.1 Método de Instalação da Interface Gráfica Com o Usuário

O Developer Kit pode ser instalado com o método de ambiente de trabalho ou o método de prompt de comandos. Consulte as seções a seguir para obter instruções.

#### 2.1.1 Método de Ambiente de Trabalho

Nota: Se o Netscape Communicator estiver sendo executado durante a instalação do Developer Kit, a instalação falhará. Você deve primeiro encerrar o Netscape Communicator e, então, começar o processo de instalação.

Para instalar com o objeto INSTALL.EXE, siga estas etapas:

1. Abra a pasta Sistema OS/2.
2. Abra o objeto Unidades.
3. Abra a unidade em que os arquivos do Developer Kit foram extraídos.
4. Abra a pasta da qual os arquivos do Developer Kit foram extraídos.
5. Dê um clique duplo no objeto INSTALL.EXE para iniciar o programa de instalação.

O comando INSTALL.EXE ativa uma interface gráfica com o usuário (GUI) com botões que especificam os idiomas nos quais o programa pode ser instalado. Clique no idioma preferido e o programa de instalação o conduzirá pelas etapas de instalação.

Uma pasta Developer Kit para OS/2 será criada na pasta Programas no OS/2 Warp 4 e no Ambiente de trabalho para todas as outras plataformas suportadas.

Após a conclusão da instalação, se desejar apagar o diretório no qual os arquivos do Developer Kit foram extraídos, selecione o objeto DELINST.CMD na pasta Developer Kit. Isso remove os arquivos e subdiretórios do Developer Kit do diretório no qual foram extraídos. Os arquivos e subdiretórios não extraídos do Developer Kit não são apagados. Também é possível excluir manualmente os arquivos que você fez download.

#### 2.1.2 Método de Prompt de Comandos

Nota: Se o Netscape Communicator estiver sendo executado durante a instalação do Developer Kit, a instalação falhará. Você deve primeiro encerrar o Netscape Communicator e, então, começar o processo de instalação.

Para iniciar a instalação, certifique-se de estar no diretório do qual os arquivos do Developer Kit foram extraídos. No prompt de comandos do OS/2, digite:

         INSTALL

O comando install ativa uma GUI com botões que especificam os idiomas nos quais o programa pode ser instalado. Clique no idioma preferido e o programa de instalação o conduzirá pelas etapas de instalação.

Uma pasta Developer Kit para OS/2 será criada na pasta Programas no OS/2 Warp 4 e no Ambiente de trabalho para todas as outras plataformas suportadas.

Após a conclusão da instalação, se desejar apagar o diretório no qual os arquivos do Developer Kit foram extraídos, selecione o objeto DELINST.CMD na pasta Developer Kit. Isso remove os arquivos e subdiretórios do Developer Kit do diretório no qual foram extraídos. Os arquivos e subdiretórios não extraídos do Developer Kit não são apagados. Também é possível excluir manualmente os arquivos que você fez download.

#### 2.1.3 Componentes Não Selecionáveis Durante a Instalação

Se estiver utilizando a interface gráfica com o usuário para instalar o Developer Kit e os componentes não estiverem selecionáveis, talvez você não tenha feito download e extraído o arquivo ZIP que contém o componente necessário. Volte para a página Software Choice Catalog of Features e faça download do arquivo ZIP de extração automática necessário.

Todos os componentes do Developer Kit requerem que você faça o download e instale o componente Runtime Environment (ou o tenha instalado anteriormente) e reinicie o sistema.

#### 2.1.4 Recuperação de uma Instalação Falha

Se a instalação do Developer Kit falhar, verifique e apague os objetos de instalação restantes. Se você não excluir esses objetos de instalação, instalações futuras poderão falhar com uma mensagem afirmando que um ou mais componentes não foram instalados porque o objeto é somente leitura ou está em uso por outro processo.

Para uma instalação CID (Configuração, Instalação e Distribuição), o ícone do objeto de instalação é uma caixa azul com uma fita vermelha, localizado no ambiente de trabalho. Para uma instalação assistida, o objeto está na pasta x:\os2\install\ (em que x é a unidade de inicialização). Para excluir o objeto, clique nele com o botão direito do mouse e clique em Excluir, no menu.

Alternativamente, vá para o diretório que contém o objeto e exclua a árvore de diretórios completa. O diretório chama-se "Install object" ou "Java 1.3 for OS/2" dependendo do momento em que a instalação falhou.

Depois de excluir o objeto de instalação, encerre e reinicialize o sistema.

#### Não É Possível Remover o Objeto de Instalação?

Se, depois de seguir as instruções relacionadas anteriormente, o objeto de instalação não tiver sido removido, faça o seguinte:

1. Vá para um prompt de comandos do OS/2.
2. Mude para a unidade de inicialização e vá para o diretório os2\install.
3. Remova o diretório Java 1.3.1 for OS/2 e todos os subdiretórios.
4. Reinicialize o sistema.

#### 2.1.5 Nível de FixPak correto mas sem possibilidade de instalação

Se tiver certeza de que seu sistema está de acordo com os níveis de FixPak requeridos, mas não conseguir instalar devido à verificação automatizada do FixPak, é possível desativá-la. Para isso, utilize um dos seguintes métodos:

Método Um:

1. Edite o arquivo CONFIG.SYS, adicionando a instrução JAVANOFPK=YES.
2. Reinicialize o sistema e conclua o processo de instalação do Developer Kit novamente.

Método Dois:

1. No diretório em que executou os arquivos de extração automática, vá para o diretório do idioma desejado.
2. Edite o arquivo CHECK.CMD. Procure a instrução:

            disablecheck="NO"

   Altere "NO" para "YES". (Esta instrução está localizada na linha 12 ou aproximadamente.)
3. Volte para o diretório em que executou os arquivos de extração automática e execute-os novamente.

### 2.2 Método de instalação não-assistida (CID)

Instalações não-assistidas ou CID (configuração, instalação e distribuição) do Developer Kit são tratadas por uma interface de linha de comandos para instalação de recursos (CLIFI) e pode levar de 15 a 20 minutos ou mais. Após a conclusão do programa de instalação, o sistema deve ser reinicializado para concluir a instalação.

O CLIFI requer dois arquivos de resposta: o do Developer Kit (JAVA131.RSP) e um personalizado no qual os usuários possam substituir as seleções padrão. O arquivo CID.RSP está incluído no pacote de instalação como um exemplo do arquivo de respostas personalizado; este e o arquivo CID.CMD precisam ser modificados para instalações não-assistidas.

Nota: É necessário o Feature Install versão 1.2.3 ou posterior para instalações não-assistidas (CID). Além disso, se o Netscape Communicator estiver sendo executado durante a instalação do Developer Kit, a instalação falhará. Você deve primeiro encerrar o Netscape Communicator e, então, começar o processo de instalação.

#### 2.2.1 Modificação do Arquivo de Respostas CID

Onde apropriado, o arquivo CID.RSP contém variáveis que permitem a seleção dos componentes a serem instalados e a unidade de disco de destino e diretório. Por padrão, o arquivo CID.RSP é definido para instalar todos os componentes do Developer Kit. Este arquivo de respostas pode ser modificado para selecionar os componentes que você deseja instalar. Certifique-se de fazer download e extrair todos os arquivos necessários antes de iniciar a instalação. Além disso, se você instalar o Toolkit, instale também o Runtime Environment mesmo se já estiver instalado.

A tabela a seguir lista os componentes selecionáveis e os nomes das variáveis:

Componente | Variável
Runtime environment | JV13Runtime
Toolkit | JV13Toolkit
Samples | JV13Samples
OS/2 ICAT Debugger para Java | JV13 Debugger
Lista dos componentes selecionáveis e nomes de variáveis:

No arquivo CID.RSP, defina "selection=1" para cada componente que deseja instalar e "selection=0" para cada componente que não deseja instalar. Por exemplo, para:

- Instalar o componente Runtime Environment e o componente OS/2 ICAT Debugger
- Configurar o Java Plug-in para Netscape 4.x
- Configurar o Plug-in Java para o IBM Web Browser for OS/2
- Instalar o Developer Kit como a JVM padrão
- Não instalar o componente Toolkit ou o componente Samples

Defina as seguintes variáveis como mostrado:

         Java13.Continue=UNATTENDED
         Java13.LicenseAgree=AGREE
         JV13Runtime.Selection=1
         JV13RuntimeConfig.Selection=1
         JV13RuntimeUrls.Selection=1
         JV13NSFiles.Selection=1
         JV13MZFiles.Selection=1
         Java13.RUNDRV=x:
         JV13DefaultJVM.Selection=1
         JV13Samples.Selection=0
         JV13SamplesConfig.Selection=0
         JV13Samplesurls.Selection=0
         JV13Samples.SMPDRV=x:
         JV13Toolkit.Selection=0
         JV13ToolkitConfig.Selection=0
         JV13Debugger.Selection=1
         JV13Debuggerurls.Selection=1
         JV13Debugger.DBGDRV=x:

Este é um exemplo. Consulte o arquivo CID.RSP para obter os componentes específicos e as variáveis associadas. x é a unidade em que o componente está instalado.

Há uma variável JV13xxConfig.Selection associada a cada variável JV13xx.Selection. A variável JV13xxConfig.Selection deve ser definida com o mesmo valor da variável JV13xx.Selection. Por exemplo, se você definir JV13Toolkit.Selection=0, também deverá definir JV13ToolkitConfig.Selection=0 (em que xx é o nome do componente).

No exemplo anterior, existem diversas variáveis que devem ser definidas para que o Developer Kit seja instalado adequadamente. As variáveis e suas definições são:

O JV13.LicenseAgree | Contrato de Licença Os valores dessa variável são DISAGREE e AGREE. Defina esta variável como AGREE para significar que você leu o contrato de licença e concorda com os termos. Se você não alterar a variável para AGREE, o Developer Kit não será instalado.
JV13DefaultJVM.Selection | JVM Defina esta variável com o valor "1" se desejar instalar o Developer Kit como a JVM padrão.
JV13MZFiles | Plug-in para o IBM Web Browser for OS/2 Defina esta variável com o valor "1" se desejar configurar o Plug-in para o IBM Web Browser for OS/2.
JV13NSFiles | Netscape Plug-in Defina esta variável com o valor "1" se desejar configurar o Netscape Plug-in.

Para eliminar as janelas de confirmação durante a instalação, defina a seguinte variável, conforme mostrado:

        java13.continue=UNATTENDED

##### 2.2.1.1 Unidades de Instalação do Componente

O Toolkit é instalado no diretório \JAVA131 na unidade de destino. Se você instalar o Toolkit, o Runtime Environment será automaticamente instalado na mesma unidade do Toolkit. O Runtime Environment é um pré-requisito para os componentes Toolkit, Samples e Debugger.

A unidade de disco de destino dos componentes Samples e ICAT é especificada definindo-a com os valores desejados. Se o Developer Kit estiver presente na unidade de disco de destino, o programa de instalação o substituirá.

#### 2.2.2 Início da Instalação Não-assistida

O arquivo CID.CMD contém um comando CLIFI de amostra para uma instalação CID. O processo de instalação foi modificado para incluir uma instalação multilíngüe; portanto, você deve especificar a variável do idioma nos arquivos CID.RSP. As variáveis de idiomas são as seguintes:

Idioma | Variável de Idioma
Inglês | en
Francês | fr
Alemão | de
Italiano | it
Japonês | jp
Português, versão do Brasil | br
Chinês Simplificado | cn
Espanhol | es
Chinês Tradicional | tw
Idioma e variável de idioma associados a ela.

O comando CLIFI também pode ser digitado como um comando de uma única linha, em um prompt de comandos do OS/2, conforme mostrado a seguir:

         clifi /a:c /r2:cid.rsp /r:xx\JAVA131.rsp /b:c: /s:d:\tmp\xx
         /l1:ciderr.log /l2:cidhist.log

Utilize a seguinte lista de variáveis como referência ao definir as variáveis nos arquivos mencionados acima.

em que:

/r2 | representa a unidade, o caminho e o nome do arquivo de respostas do usuário
/r | Especifica a localização completa do arquivo de resposta Feature Install.
xx | Especifica a variável de idioma de sua preferência.
/b | Especifica a unidade de reinicialização.
/s | Especifica a localização completa dos arquivos extraídos do Developer Kit.
/l1 e /l2 | Especifica as localizações completas dos arquivos de log opcionais. Consulte estes arquivos, além do arquivo \os2\install\wpinstal.log na unidade de inicialização, se ocorrerem problemas durante a instalação.

Para eliminar as janelas de confirmação durante a instalação, defina a seguinte variável, conforme mostrado:

        java13.continue=UNATTENDED

#### 2.2.3 Código de retorno de instalação do CID "Bem-sucedida" e instalação com falha

Se tiver recebido um código de retorno de CID "bem-sucedida" após a instalação do Developer Kit, mas a instalação falhou, pode ser que:

- Você não modificou o arquivo de respostas para "AGREE" depois da variável Java13LicenseAgree.
- O nível correto do FixPak não está presente no sistema.

Recomenda-se que os administradores do CID realizem uma verificação de FixPak para assegurar que o nível correto de FixPak esteja disponível. (Consulte a seção FixPaks para obter mais informações.) É possível utilizar o arquivo check.cmd localizado no diretório x:\Java131 como um exemplo para gravar um script que verifique os níveis de FixPak. (x:\ é a unidade em que o Developer Kit está instalado.)

#### 2.2.4 Nível de FixPak Correto Mas sem Possibilidade de Instalação

Se tiver certeza de que seu sistema está de acordo com os níveis de FixPak requeridos, mas não conseguir instalar devido à verificação automatizada do FixPak, é possível desativá-la. Para isso, utilize um dos seguintes métodos:

Método Um:

1. Edite o arquivo CONFIG.SYS, adicionando a instrução JAVANOFPK=YES.
2. Reinicialize o sistema e conclua o processo de instalação do Developer Kit novamente.

Método Dois:

1. No diretório em que executou os arquivos de extração automática, vá para o diretório do idioma desejado.
2. Edite o arquivo CHECK.CMD. Procure a instrução:

            disablecheck="NO"

   Altere "NO" para "YES". (Esta instrução está localizada na linha 12 ou aproximadamente.)
3. Execute o processo CID novamente.

### 2.3 Considerações sobre a instalação do NVDM/2

Uma instalação CID do NVDM/2 (NetView(R) Distribution Manager/2) requer a criação de um perfil e, a seguir, a construção e catalogação de um arquivo de alterações. O perfil NVDM/2 permite que você especifique apenas um arquivo de respostas; entretanto, a instalação não-assistida do Developer Kit requer dois arquivos de respostas. Além disso, o tratamento das variáveis e argumentos no NVDM/2 é diferente do utilizado no Feature Install, que é utilizado para instalar o Developer Kit.

Nota: Se o Netscape Communicator estiver sendo executado durante a instalação do Developer Kit, a instalação falhará. Você deve primeiro encerrar o Netscape Communicator e, então, começar o processo de instalação.

Na seção a seguir, há dois métodos que podem ser utilizados para instalar o Developer Kit através do NVDM/2.

#### 2.3.1 Comando Estático no Perfil NVDM/2

No perfil NVDM/2, especifique todas as opções CLIFI na variável PARMS. Os parâmetros devem ficar em uma única linha e colocados entre aspas duplas:

         Program=c:\os2\install\clifi.exe
         Parms="/a:c /r2:cid.rsp /r:\xx\JAVA131.rsp /b:c: /s:d:\tmp\xx
         /l1:ciderr.log /l2:cidhist.log"

Este método requer que você modifique o perfil sempre que os nomes do diretório de origem ou do arquivo de log forem alterados. Alternativamente, esses valores podem ser substituídos por valores de variáveis específicas da estação de trabalho, conforme mostrado abaixo:

         Program=c:\os2\install\clifi.exe
         Parms="/a:c /r2:$(ResponseFile) /r:$(SourceDir)\xx\JAVA131.rsp
         /b:c: /s:$(SourceDir\xx) /l1:$(LogFile1) /l2:$(LogFile2)"
         ResponseFile=$(WorkstatName).rsp
         SourceDir=d:\tmp
         LogFile1=$(WorkstatName).log
         LogFile2=$(WorkstatName).lg2

Esse segundo método requer um arquivo de resposta separado para cada estação de trabalho e requer que WorkstatName seja definido apropriadamente.

Utilize a seguinte lista de variáveis como referência ao definir as variáveis nos arquivos mencionados acima.

em que:

d: | Especifica o diretório temp.
/r | Especifica a localização completa do arquivo de resposta Feature Install.
xx | Especifica a variável de idioma de sua preferência.
/b | Especifica a unidade de reinicialização.
/s | Especifica a localização completa dos arquivos extraídos do Developer Kit.
/l1 e /l2 | Especifica as localizações completas dos arquivos de log opcionais. Consulte estes arquivos, além do arquivo \os2\install\wpinstal.log na unidade de inicialização, se ocorrerem problemas durante a instalação.

### 2.4 Instalação do Developer Kit no WorkSpace On-Demand 2.0

Nota: Se o Netscape Communicator estiver sendo executado durante a instalação do Developer Kit, a instalação falhará. Você deve primeiro encerrar o Netscape Communicator e, então, começar o processo de instalação.

O produto WorkSpace On-Demand 2.0 inclui o Java 1.1.6 para OS/2 Warp. É possível instalar o Developer Kit (versão 1.3) nos Servidores e Clientes WorkSpace On-Demand. O Developer Kit coexiste com o Java 1.1.x para OS/2 Warp. Consulte as seguintes seções para instalar o Developer Kit nos Servidores e Clientes WorkSpace On-Demand e obter informações sobre a instalação do Developer Kit como a JVM padrão.

#### 2.4.1 Instalação do Developer Kit em um Servidor WorkSpace On-Demand 2.0

Para instalar o Developer Kit em um Servidor WorkSpace On-Demand, utilize a GUI. Consulte a seção Método de Instalação da interface gráfica com o usuário deste guia para obter instruções.

#### 2.4.2 Instalação do Developer Kit em um Cliente WorkSpace On-Demand 2.0

Para instalar o Developer Kit em um Cliente WorkSpace On-Demand, utilize uma instalação não-assistida (CID). Você pode utilizar as instruções da seção Método de Instalação Não-assistida (CID) e utilizar os arquivos CID.CMD e WSOD2.RSP que estão incluídos no pacote de instalação do Developer Kit. As etapas de instalação são concluídas em um Servidor WorkSpace On-Demand 2.0.

Nota: Se desejar instalar o Developer Kit como sua JVM padrão nos Clientes WorkSpace On-Demand, as referências aos diretórios `z:\JAVA131` e aos arquivos precisam ser colocadas antes das referências `z:\JAVA11` no arquivo CONFIG.SYS.

##### 2.4.2.1 Instalação Não-assistida para um Cliente WorkSpace On-Demand 2.0

Complete as seguintes etapas:

1. No arquivo CID.CMD, altere `/r2:cid.rsp` para `/r2:wsod2.rsp` (em que `/r2` é a unidade, o caminho e o nome do arquivo de resposta do usuário).
2. Conforme descrito na seção Início da instalação não-assistida deste guia:
   - Substitua `/s:d:\tmp\xx` no arquivo CID.CMD pela unidade e diretório no qual o pacote de instalação foi descompactado (em que `xx` é a variável do idioma escolhido).
   - Certifique-se de que `/b:z` no arquivo CID.CMD indique a unidade de inicialização do cliente.
3. Verifique se as seleções nos arquivos WSOD2.RSP são apropriadas para o que deseja instalar. Por padrão, Runtime Environment é selecionado; os outros componentes são desmarcados. Certifique-se de fazer download e extrair todos os arquivos necessários. Além disso, após ler o acordo de licença e concordar com os termos, a variável de seleção Java13.LicenseAgree deverá ser definida como AGREE no arquivo WSOD2.RSP. Se essa variável não for alterada para AGREE, o Runtime Environment não será instalado.
4. Execute o arquivo CID.CMD atualizado digitando o nome do arquivo em um prompt de comandos.

Para concluir a instalação não-assistida, consulte as seguintes seções:

##### 2.4.2.2 Modificação dos arquivos CONFIG.SYS para Clientes WorkSpace On-Demand 2.0

Para ativar o componente Runtime Environment do Developer Kit, um administrador do WorkSpace On-Demand deve fazer as seguintes inclusões nos arquivos CONFIG.SYS dos Clientes WorkSpace On-Demand:

Inclua o seguinte:

`z:\JAVA131\jre\dll` | à instrução LIBPATH
`z:\JAVA131\jre\bin;` | à instrução SET PATH

Você pode procurar e editar o arquivo CONFIG.SYS dos clientes WorkSpace On-Demand com base nas duas opções a seguir:

- No servidor de um usuário específico, o arquivo CONFIG.SYS está localizado na seguinte unidade e diretório:

         [rpldrive]:\ibmlan\rpl\machines\[client name]\config.sys

- Para modificar o CONFIG.SYS padrão de cada máquina criada com a classe de máquina individual, o arquivo CONFIG.SYS está localizado na seguinte unidade e diretório:

         [rpldrive]:\ibmlan\rpl\machines\BB20.xx\[machine class]\config.sys

em que:

[rpldrive] | Especifica a unidade em que o diretório RPL está instalado.
[client_name] | Especifica o nome do Cliente WorkSpace On-Demand.
xx | Especifica o código do país ou da região.
[machine_class] | Especifica o nome da máquina.

##### 2.4.2.3 Modificação dos arquivos FIT e concessão de acesso aos Clientes WorkSpace On-Demand 2.0

Para ativar o Runtime Environment, um administrador do WorkSpace On-Demand deve fazer a seguinte inclusão nos arquivos FIT (File Index Table) nos Clientes WorkSpace On-Demand:

Inclua o seguinte:

         z:\JAVA131      BB20.xx\JAVA131

Você pode procurar e editar os arquivos FIT dos clientes WorkSpace On-Demand com base nas duas opções a seguir:

- No servidor de um usuário específico, o arquivo [client_name].FIT está localizado na seguinte unidade e diretório:

         [rpldrive]:\ibmlan\rpl\fits\[client_name].FIT

- Para modificar o FIT padrão, o arquivo DFBB20xx.FIT está localizado na seguinte unidade e diretório:

         [rpldrive]:\ibmlan\rpl\fits\DFBB20xx.FIT

Um administrador do WorkSpace On-Demand também deve conceder acesso de leitura e execução ao diretório JAVA131 para Clientes WorkSpace On-Demand.

Execute os seguintes comandos do LAN Server:

      NET ACCESS [rpldrive]\ibmlan\rpl\bb20.xx\JAVA131 /ADD RPLGROUP:RX
      NET ACCESS [rpldrive]\ibmlan\rpl\bb20.xx\JAVA131 /APPLY

em que:

[rpldrive] | Especifica a unidade em que o diretório RPL está instalado.
[client_name] | Especifica o nome do Cliente WorkSpace On-Demand.
xx | Especifica o código do país ou da região.

##### 2.4.2.4 Atribuição do diretório USER_HOME para Clientes WorkSpace On-Demand 2.0

O diretório USER_HOME do Developer Kit deve ter acesso de leitura e gravação, pois é neste local onde os certificados de segurança e os arquivos de propriedades do plug-in são criados e acessados. Por exemplo, para especificar `z:\JAVA13_RW` como o diretório USER_HOME e atribuir a ele acesso de leitura e gravação, inclua o seguinte no arquivo FIT (isto deve ser digitado como uma linha contínua):

         z:\JAVA13_RW      \\server_name\WRKFILES\client_name\JAVA_RW

Substitua os nomes do Servidor e do Cliente WorkSpace On-Demand por server_name e client_name. z representa a unidade em que o Runtime Environment foi instalado. Esta informação também pode ser digitada no arquivo FIT padrão.

Um administrador do WorkSpace On-Demand também deve fazer a seguinte inclusão nos arquivos OS2.INI dos Clientes WorkSpace On-Demand. A adição deve terminar com NULL.

Inclua o seguinte:

         Application = Java131
         Key = USER_HOME
         Value = z:\JAVA13_RW

Para obter informações sobre como utilizar um INI Editor ou o Comando NET APPPARM para incluir entradas do arquivo INI para Clientes WorkSpace On-Demand, consulte a publicação WorkSpace On-Demand Handbook 2.0. O arquivo OS2.INI para clientes WorkSpace On-Demand pode ser localizado de uma destas duas maneiras:

- No servidor, para um usuário específico:

           [rpldrive]:\ibmlan\rpluser\[client name]\os2\os2.ini

- O arquivo OS2.INI padrão de cada máquina criada com a classe de máquina individual está localizado na seguinte unidade e diretório:

           [rpldrive]:\ibmlan\rpl\machines\BB20.xx\[machine class]\os2\os2.ini

em que:

z | Especifica a unidade em que o Runtime Environment está instalado para o cliente.
[rpldrive] | Especifica a unidade em que o diretório RPL está instalado.
[client_name] | Especifica o nome do Cliente WorkSpace On-Demand.
xx | Especifica o código do país ou da região.
[machine class] | Especifica o nome da classe da máquina utilizada por um Cliente WorkSpace On-Demand.

##### 2.4.2.5 Ativação de Fontes para Clientes WorkSpace On-Demand 2.0

Para ativar as fontes do Runtime Environment, um administrador do WorkSpace On-Demand deve fazer as seguintes inclusões nos arquivos OS2.INI dos Clientes WorkSpace On-Demand. Todas as inclusões devem terminar com NULL. z especifica a unidade em que o Runtime Environment está instalado para o cliente.

Inclua o seguinte:

      Application = PM_Fonts
      Key = courtbi_.ttf
      Value = z:\JAVA131\jre\lib\fonts\COURTBI_.TTF
      Application = PM_Fonts
      Key = courtb_.ttf
      Value = z:\JAVA131\jre\lib\fonts\COURTB_.TTF
      Application = PM_Fonts
      Key = courti_.ttf
      Value = z:\JAVA131\jre\lib\fonts\COURTI_.TTF
      Application = PM_Fonts
      Key = court_.ttf
      Value = z:\JAVA131\jre\lib\fonts\COURT_.TTF
      Application = PM_Fonts
      Key = lucb.ttf
      Value = z:\JAVA131\jre\lib\fonts\LUCB.TTF
      Application = PM_Fonts
      Key = lucbb.ttf
      Value = z:\JAVA131\jre\lib\fonts\LUCBB.TTF
      Application = PM_Fonts
      Key = lucbbi.ttf
      Value = z:\JAVA131\jre\lib\fonts\LUCBBI.TTF
      Application = PM_Fonts
      Key = lucbi.ttf
      Value = z:\JAVA131\jre\lib\fonts\LUCBI.TTF
      Application = PM_Fonts
      Key = lucs.ttf
      Value = z:\JAVA131\jre\lib\fonts\LUCS.TTF
      Application = PM_Fonts
      Key = lucsb.ttf
      Value = z:\JAVA131\jre\lib\fonts\LUCSB.TTF
      Application = PM_Fonts
      Key = lucsbi.ttf
      Value = z:\JAVA131\jre\lib\fonts\LUCSBI.TTF
      Application = PM_Fonts
      Key = lucsi.ttf
      Value = z:\JAVA131\jre\lib\fonts\LUCSI.TTF
      Application = PM_Fonts
      Key = luct.ttf
      Value = z:\JAVA131\jre\lib\fonts\LUCT.TTF
      Application = PM_Fonts
      Key = luctb.ttf
      Value = z:\JAVA131\jre\lib\fonts\LUCTB.TTF
      Application = PM_Fonts
      Key = luctbi.ttf
      Value = z:\JAVA131\jre\lib\fonts\LUCTBI.TTF
      Application = PM_Fonts
      Key = lucti.ttf
      Value = z:\JAVA131\jre\lib\fonts\LUCTI.TTF
      Application = PM_Fonts
      Key = thonbi_.ttf
      Value = z:\JAVA131\jre\lib\fonts\THONBI_.TTF
      Application = PM_Fonts
      Key = thonburi.ttf
      Value = z:\JAVA131\jre\lib\fonts\THONBURI.TTF
      Application = PM_Fonts
      Key = thonb_.ttf
      Value = z:\JAVA131\jre\lib\fonts\THONB_.TTF
      Application = PM_Fonts
      Key = thoni_.ttf
      Value = z:\JAVA131\jre\lib\fonts\Thoni_.TTF

Consulte o WorkSpace On-Demand Handbook 2.0 para obter informações sobre como utilizar um INI Editor ou o NET APPPARM Command para incluir as entradas do arquivo INI no Clientes WorkSpace On-Demand. Você pode procurar o arquivo OS2.INI dos clientes WorkSpace On-Demand com base nas duas opções a seguir:

- No servidor de um usuário específico, o arquivo OS2.INI está localizado na seguinte unidade e diretório:

         [rpldrive]:\ibmlan\rpluser\[client name]\os2\os2.ini

- Para modificar o OS2.INI padrão de cada máquina criada com a classe de máquina individual, o arquivo OS2.INI está localizado na seguinte unidade e diretório:

         [rpldrive]:\ibmlan\rpl\machines\BB20.xx\[machine class]\os2\os2.ini

em que:

[rpldrive] | Especifica a unidade em que o diretório RPL está instalado.
[client name] | Especifica o nome do Cliente WorkSpace On-Demand.
xx | Especifica o código do país ou da região.
[machine class] | Especifica o nome da classe da máquina utilizada por um Cliente WorkSpace On-Demand.

##### 2.4.2.6 Instalação do Plug-in do Netscape para Clientes WorkSpace On-Demand 2.0

Para instalar o Plug-in Java do navegador Netscape 4.x, um administrador do WorkSpace On-Demand deverá copiar o arquivo npjava.dll para o diretório do Plug-in do Netscape 4.x dos Clientes WorkSpace On-Demand. Digite o seguinte comando para copiar o arquivo:

         copy d:\JavaTemp\package\npjava.dll  [rpldrive]:\ibmlan\rpl\bb20.xx\NETSCAPE\PROGRAM\PLUGINS\*.*

Para instalar o Plug-in Java do IBM web-browser for OS/2, copie o arquivo npoji6.dll para o diretório do Plug-in do Web-browser dos Clientes WorkSpace On-Demand. Digite o seguinte comando para copiar o arquivo:

         copy d:\JavaTemp\package\npoji6.dll  [rpldrive]:\ibmlan\rpl\bb20.xx\os2\os2web\PLUGINS\*.*

em que:

d:\JavaTemp | Especifica a localização completa dos arquivos extraídos do Runtime Environment.
[rpldrive] | Especifica a unidade em que o diretório RPL está instalado.
xx | Especifica o código do país ou da região.

Além disso, um administrador do WorkSpace On-Demand deve fazer a seguinte inclusão nos arquivos OS2.INI dos Clientes WorkSpace On-Demand. Todas as inclusões devem terminar com NULL.

Inclua o seguinte:

         Application = Java Plug-in
         Key = JAVA_HOME
         Value = z:\JAVA131\jre

em que z especifica a unidade onde o Runtime Environment está instalado no cliente.

Consulte o WorkSpace On-Demand Handbook 2.0 para obter informações sobre como utilizar um Editor INI ou o comando NET APPPARM para incluir as entradas do arquivo INI nos Clientes WorkSpace On-Demand. O arquivo OS2.INI para clientes WorkSpace On-Demand pode ser localizado de uma destas duas maneiras:

- No servidor de um usuário específico, o arquivo OS2.INI está localizado na seguinte unidade e diretório:

         [rpldrive]:\ibmlan\rpluser\[client name]\os2\os2.ini

- Para modificar o OS2.INI padrão de cada máquina criada com a classe de máquina individual, o arquivo OS2.INI está localizado na seguinte unidade e diretório:

         [rpldrive]:\ibmlan\rpl\machines\BB20.xx\[machine class]\os2\os2.ini

em que:

[rpldrive] | Especifica a unidade em que o diretório RPL está instalado.
[client name] | Especifica o nome do Cliente WorkSpace On-Demand.
xx | Especifica o código do país ou da região.
[machine class] | Especifica o nome da classe da máquina utilizada por um Cliente WorkSpace On-Demand.

##### 2.4.2.7 Instalação de componentes adicionais do Developer Kit no Cliente WorkSpace On-Demand 2.0

Se desejar instalar componentes que não sejam o Runtime Environment no Cliente WorkSpace On-Demand, é possível selecionar esses componentes no arquivo WSOD2.RSP.

Se você instalar o Toolkit, um administrador do WorkSpace On-Demand deverá fazer as seguintes inclusões nos arquivos CONFIG.SYS dos clientes.
Inclua o seguinte:

`x:\java131\bin;` | à instrução SET PATH
`z:\JAVA131\lib;` | à instrução SET LIB
`z:\JAVA131\include;` | à instrução SET INCLUDE

em que z:\JAVA131 é a unidade e o diretório onde o Toolkit está instalado no cliente.

##### 2.4.2.8 Execução de amostras Java em um Cliente WorkSpace On-Demand 2.0

O administrador do servidor WorkSpace On-Demand deve incluir as seguintes linhas no arquivo RPL\FITS\client_name.FIT para fornecer ao Cliente WorkSpace On-Demand a capacidade de executar as amostras fornecidas no componente Samples:

         z:\JAVA131\WEBLOGS \\server_name\WRKFILES\client_name\JAVA131\WEBLOGS
         z:\JAVA131\HOTJAVA \\server_name\WRKFILES\client_name\JAVA131\HOTJAVA

Substitua os nomes do servidor de IPL remoto e do cliente de IPL remoto por server_name e client_name. z representa a unidade em que o Developer Kit foi instalado. Esta informação também pode ser digitada no arquivo FIT padrão.

Os clientes de IPL remoto poderão compilar o código de amostra se as amostras forem colocadas em um diretório para o qual o cliente de IPL remoto tenha acesso de gravação.

##### 2.4.2.9 Emissão de um trust em Clientes WorkSpace On-Demand 2.0

Se você estiver emitindo um comando trust (conceder acesso) para conexão a um servidor Web, o arquivo IDENTITYDB.OBJ deverá ter acesso de leitura e gravação. Adicione o seguinte ao arquivo FIT para fazer a conexão:

         z:\JAVA131\WEBLOGS        \\server_name\WRKFILES\client_name\JAVA131\WEBLOGS
         z:\JAVA131\HOTJAVA        \\server_name\WRKFILES\client_name\JAVA131\HOTJAVA
         z:\JAVA131\IDENTITYDB.OBJ \\server_name\WRKFILES\client_name\JAVA131\IDENTITYDB.OBJ

##### 2.4.2.10 O Compilador JIT e um Cliente Workspace On-Demand 2.0

Em um sistema Cliente WorkSpace On-Demand, o seguinte comando é incluído no arquivo CONFIG.SYS se a versão 1.1.6 do Developer Kit estava instalada durante a instalação do Servidor WorkSpace On-Demand:

        set java_compiler=xxx

Esse comando desativa o compilador JIT (Just-in-Time).

Para ativar o compilador JIT, remova o comando relacionado anteriormente do arquivo CONFIG.SYS. Você pode procurar e editar o arquivo com base nas duas opções a seguir:

- No servidor de um usuário específico, o arquivo CONFIG.SYS está localizado na seguinte unidade e diretório:

         [rpldrive]:\ibmlan\rpl\machines\[machine class]\config.sys

- Para modificar o CONFIG.SYS padrão de cada máquina criada com a classe de máquina individual, o arquivo CONFIG.SYS está localizado na seguinte unidade e diretório:

         [rpldrive]:\ibmlan\rpl\machines\BB20.xx\[machine class]\config.sys

Utilize a seguinte lista de variáveis como referência ao definir as variáveis nos arquivos mencionados acima.

em que:

[rpldrive] | Especifica a Lista de Parâmetros de Pedido.
xx | Especifica o código do país ou da região.
[machine class] | Especifica o nome da classe da máquina utilizada por um Cliente WorkSpace On-Demand.

##### 2.4.2.11 Criação de um Aplicativo Público para o Painel de Controle de Plug-ins Java para o Cliente WorkSpace On-Demand 2.0

Para criar um aplicativo público no Painel de Controle do Plug-in Java que seja executado em um Cliente WorkSpace On-Demand 2.0, é necessário fornecer acesso aos arquivos do Netscape. Os controles de acesso são especificados no arquivo APPPOST.FIT do Netscape.

Os exemplos a seguir mostram como criar um aplicativo público para executar o Painel de Controle de Plug-ins Java:

         net app jctrlpnl /remark:"Java Plug-in Control Panel"
           /appdir:z:\java131\jre\bin
           /command:"jctrlpnl.cmd"
           /type:wsod /interface:pm /add
        net appparm jctrlpnl NCC_POSTFITS=z:\netscape\program\apppost.fit
           /add /placement:b

z:\java131 é o local onde a imagem do Java Developer Kit está instalada e z:\netscape é o local onde a imagem do Netscape está instalada.

### 2.5 Método de instalação de IPL remoto

Uma instalação de IPL remoto requer a criação de dois arquivos de respostas e a configuração de diretórios e arquivos apropriados no servidor IPL remoto.

Siga estas etapas para cada cliente a ser instalado:

1. Coloque os arquivos de instalação extraídos do Developer Kit no servidor IPL remoto.
2. Execute o comando GENFIRPL. (Consulte a seção Criação de Arquivos de Respostas para obter informações.)
3. Execute o comando CLIFI para um cliente IPL remoto. (Consulte a seção Início da Instalação de IPL Remoto para obter informações.)
4. Modifique o arquivo FIT cliente (Consulte as seções Atualização de Arquivos para Feature Install e Execução do Java Samples em um Cliente de IPL Remoto.)

#### 2.5.1 Criação de arquivos de resposta

Depois de colocar os arquivos de instalação extraídos do Developer Kit no servidor IPL remoto, o comando GENFIRPL é utilizado para gerar dois arquivos de resposta: FILES.RSP para o servidor IPL remoto e JAVA131.RSP para o cliente IPL remoto. O seguinte é um comando GENFIRPL de amostra. O comando deve ser digitado em uma única linha.

         genfirpl /m:c:\javacode\xx  /r:c:\ibmlan\rpl
         /u:c:\ibmlan\rpluser  /f:c:\javacode\xx\JAVA131.rsp
         /c:client_name  /b:x:

O cliente IPL remoto não deverá estar em execução quando o comando GENFIRPL for emitido. Deve-se executar um comando GENFIRPL para cada cliente IPL remoto, especificando-se o nome de cliente e a unidade de inicialização apropriados.

Utilize a seguinte lista de variáveis como referência ao definir as variáveis no arquivo(s) mencionado(s) acima:

em que:

/m | Especifica o diretório que contém os arquivos de instalação do Developer Kit no servidor de IPL remoto.
xx | Especifica a variável de idioma de sua preferência.
/r | Especifica o diretório RPL.
/u | Especifica o diretório RPLUSER.
/f | Especifica o nome completo do arquivo de resposta para o cliente IPL remoto.
/c | Especifica o nome do cliente de IPL remoto.
/b | Especifica a unidade de reinicialização do cliente de IPL remoto.
/nf | Elimina a transferência de arquivos Java. Utilize este sinalizador ao instalar clientes IPL remotos adicionais, após o primeiro, para evitar que os arquivos do Developer Kit sejam instalados novamente para cada novo cliente.

#### 2.5.2 Modificação do arquivo JAVA131.RSP

O arquivo JAVA131.RSP contém variáveis que permitem a seleção dos componentes a serem instalados, além da unidade e do diretório. Por padrão, o arquivo JAVA131.RSP é definido para instalar todos os componentes do Developer Kit. Este arquivo de respostas pode ser modificado para selecionar os componentes que você deseja instalar. Certifique-se de fazer download e extrair todos os arquivos necessários antes de iniciar a instalação.

É necessário utilizar um editor de texto que trate linhas superiores a 255 bytes, como o TEDIT, para evitar o truncamento de linhas longas neste arquivo. Como este é um arquivo muito grande, as modificações podem consumir muito tempo e ficarem propensas a erros. Faça um backup do arquivo JAVA131.RSP antes de modificá-lo para evitar perda de dados.

#### 2.5.3 Atualização dos arquivos do Feature Install

O arquivo client_name.FIT de cada cliente IPL remoto deve ser modificado para incluir o seguinte comando, que deve ser digitado em uma única linha:

         z:\os2\install\install.inv
    \\server_name\WRKFILES\client_name
         \os2\install\install.inv

Substitua o nome do servidor de IPL remoto e do cliente de IPL remoto por server_name e client_name. z representa a unidade em que o Developer Kit foi instalado.

#### 2.5.4 Início da instalação de IPL remoto

As instalações RIPL (Remote initial program load) são tratadas pelo CLIFI (o programa de instalação do Feature Install) e podem levar de 15 a 20 minutos ou mais. Depois de efetuar logon no servidor IPL remoto como administrador, execute o comando CLIFI utilizando o arquivo de resposta criado para o servidor IPL remoto, FILES.RSP:

         clifi /a:i  /r:c:\javacode\files.rsp

Será necessário reinicializar o servidor IPL remoto depois de executar o CLIFI se a transferência de arquivos não tiver sido eliminada.

Execute o comando CLIFI em cada cliente IPL remoto depois de executar o comando GENFIRPL desse cliente.

         clifi /a:i  /r:z:\xx\JAVA131.rsp

Utilize a seguinte lista de variáveis como referência ao definir as variáveis nos arquivos mencionados anteriormente.

em que:

/r | Especifica o nome completo do arquivo de resposta do cliente de IPL remoto, conforme especificado no comando GENFICMD.
xx | Especifica a variável de idioma de sua preferência.

#### 2.5.5 Execução do Java Samples em um Cliente de IPL Remoto

O administrador do servidor IPL remoto deve adicionar as seguintes linhas ao arquivo RPL\FITS\client_name.FIT para fornecer ao cliente IPL remoto a capacidade de executar as amostras fornecidas no componente Samples:

         z:\JAVA131\WEBLOGS \\server_name\WRKFILES\client_name\JAVA131\WEBLOGS
         z:\JAVA131\HOTJAVA \\server_name\WRKFILES\client_name\JAVA131\HOTJAVA

Substitua os nomes do servidor de IPL remoto e do cliente de IPL remoto por server_name e client_name. z representa a unidade em que o Developer Kit foi instalado.

Os clientes de IPL remoto poderão compilar o código de amostra se as amostras forem colocadas em um diretório para o qual o cliente de IPL remoto tenha acesso de gravação.

##### 2.5.5.1 Emissão de um trust em um cliente IPL remoto

Se você estiver emitindo um comando trust para conexão a um servidor Web, o arquivo IDENTITYDB.OBJ deverá ter permissão de leitura e gravação. Adicione o seguinte ao arquivo FIT para fazer a conexão:

         z:\JAVA131\WEBLOGS \\server_name\WRKFILES\client_name\JAVA131\WEBLOGS
         z:\JAVA131\HOTJAVA \\server_name\WRKFILES\client_name\JAVA131\HOTJAVA
         z:\JAVA131\IDENTITYDB.OBJ  \\server\WRKF\client\JAVA131\IDENTITYDB.OBJ

Substitua os nomes do servidor de IPL remoto e do cliente de IPL remoto por server_name e client_name. z representa a unidade em que o Developer Kit foi instalado.

Isto também pode ser digitado no arquivo padrão FIT como parte da instalação do Developer Kit para WorkSpace On-Demand durante a execução do comando WSOD.CMD.

## 3.0 APÓS A INSTALAÇÃO

As seções a seguir fornecem informações adicionais que poderão ser necessárias depois da instalação do Developer Kit.

### 3.1 Fontes adicionais de informações

Os objetos da lista a seguir são exibidos na pasta Developer Kit OS/2 apenas se você estiver executando o OS/2 Warp Server 4. Se estiver executando o OS/2 Warp Server for e-business, é possível acessar os documentos associados nas seguintes localizações:

- Centro IBM para Tecnologia Java:
  http://www.ibm.com/java/jdk/index.html
- Documentação Java:
  http://www.javasoft.com/doc.html
- ICAT Debugger para OS/2 Java:
  `x:\JAVA131\ICATJAVA\help\icatjvo.htm`
- LEIA ME do Developer Kit
  `x:\JAVA131\`

x é a unidade em que o Developer Kit foi instalado.

Se você instalou os componentes Toolkit ou ICAT Debugger para OS/2 Java em diretórios diferentes do componente Runtime Environment, especifique os diretórios apropriados destes dois objetos. Os links para a documentação do Runtime Environment e para o ICAT Debugger para OS/2 Java não funcionarão se os componentes estiverem em diretórios diferentes ou não estiverem instalados.

### 3.2 Instalação de componentes adicionais

Após a instalação inicial do Developer Kit, é possível instalar componentes adicionais reexecutando o procedimento de instalação. Isso requer que seja feito download dos arquivos a partir do site Software Choice na Web novamente, que todos os arquivos extraídos sejam mantidos em seu sistema ou que os arquivos ZIP originais sejam mantidos e os arquivos sejam extraídos novamente quando necessários.

### 3.3 Considerações sobre AWT TextField e TextArea

Os controles TextField e TextArea do AWT (Abstract Window Toolkit) não suportam caracteres fora da página de códigos atual. Usuários que executem em sistemas em inglês dos Estados Unidos podem alternar para a página de códigos 850 (a página de códigos multilíngüe, que suporta idiomas europeus ocidentais) para ver caracteres de idiomas adicionais nesses controles.

### 3.4 Modificação do arquivo de propriedades de fonte não é suportada

A modificação de arquivos de propriedades fonte fornecida com o Developer Kit não é suportada.

### 3.5 Problemas com horário nos applets Java

Se tiver problemas com horário nos applets Java, poderá ser necessário definir ou alterar a variável de fuso horário (TZ). Para definir a variável TZ, execute um dos seguintes procedimentos:

- Vá para a página Geral no bloco de notas Configuração do TCP/IP. Defina o campo fuso horário, utilizando o auxílio on-line fornecido.
- Edite o arquivo CONFIG.SYS e adicione ou altere a instrução SET TZ=.

### 3.6 Utilização do Suporte à Memória Alta do OS/2 para aumentar o tamanho do heap do Java

Em um ambiente OS/2 padrão, o espaço de endereçamento virtual máximo disponível para um aplicativo é de 512 MB, e a memória disponível para o tamanho do heap do Java é limitada a 256 MB, aproximadamente. Esta restrição pode ser modificada utilizando o Suporte à Memória Alta do OS/2 (HMS do OS/2). O HMS do OS/2 aumenta o espaço de endereçamento virtual máximo disponível para um aplicativo para 3 GB.

As seguintes plataformas suportam o HMS do OS/2:

- Servidores WorkSpace On-Demand
- OS/2 Warp Server for e-business

#### 3.6.1 Ativação do HMS do OS/2

A Memória Alta disponível é controlada pela definição VIRTUALADDRESSLIMIT no arquivo CONFIG.SYS. O valor é especificado em MB no arquivo CONFIG.SYS. Por exemplo:

            VIRTUALADDRESSLIMIT=2048

O menor valor permitido é 512 MB. Isso fornece compatibilidade com versões anteriores do OS/2 que permitiam acesso a 512 MB. Valores superiores a 512 MB podem reduzir o número de processos que podem ser executados simultaneamente em um sistema.

#### 3.6.2 Ativação do Tamanho do Heap do Java para utilizar o HMS do OS/2

Para indicar à JVM (Java Virtual Machine) que ela deve tentar colocar sua pilha no HMS do OS/2, defina a seguinte variável de ambiente:

        SET JAVA_HIGH_MEMORY=1

Se o HMS do OS/2 não estiver disponível, esta opção será ignorada e a pilha será alocada a partir do espaço de endereçamento padrão.

#### 3.6.3 Limitações ao utilizar o HMS do OS/2

Se o heap do Java for colocada no HMS do OS/2, os objetos alocados a partir dela não ficarão acessíveis ao código de 16 bits. Isso será um problema apenas se um aplicativo Java possuir DLLs de método nativo que sejam compiladas com um compilador de 16 bits ou que chamem outras DLLs que contenham código de 16 bits.

### 3.7 Classe BigDecimal Aperfeiçoada

Este release inclui a classe BigDecimal (com.ibm.math.BigDecimal). Ela é fornecida (com sua classe de suporte MathContext) como uma alternativa para a classe java.math.BigDecimal. Se estiver utilizando a classe java.math.BigDecimal em um programa Java e desejar acessar a nova classe, deverá alterar a instrução de importação no código fonte, conforme mostrado abaixo.

Altere:

         import java.math.*;

Para:

         import com.ibm.math*;

Nenhum outro código precisa de alteração.

### 3.8 O Java Plug-ins

As seções a seguir fornecem informações sobre a instalação e a utilização de Plug-ins Java do Netscape 4.x e do IBM Web Browser for OS/2.

#### 3.8.1 Instalação do Plug-in Java após a instalação do Netscape Communicator

Se você instalou o Netscape Communicator depois do Developer Kit e deseja ativar o Java Plug-in, conclua as seguintes etapas:

1. Localize o arquivo plugin.exe encontrado no diretório \JAVA131\ns\ do Runtime Environment. Copie o arquivo plugin.exe para um diretório temporário.
2. Execute o arquivo plugin.exe, a partir do diretório onde você o copiou, digitando o nome do arquivo em um prompt de comandos. A execução do arquivo extrai os seguintes arquivos:
   - instplug.cmd: Comando CLIFI utilizado para executar a instalação do Java Plug-in
   - npjava.dll: Dll do Java Plug-in
   - nscheck2.exe: Saída de usuário utilizada para localizar o Netscape
   - nsfiles.rsp: Arquivo de respostas do Feature Install (FI). Não edite este arquivo.
   - nsuser.rsp: Arquivo de respostas de amostra parcial do usuário
   - package.ctl: Arquivo de pacotes requerido pelo FI.
3. Retorne ao diretório \JAVA131\ns\
4. Edite o arquivo instplug.cmd para indicar os caminhos e unidade de inicialização corretos.
5. Edite o arquivo nsuser.rsp para ativar o Java Plug-in. A versão mais recente do Netscape Communicator é ativada. (Se você quiser ativar uma versão específica do Netscape, defina o valor JAVANSFILES.NSDRV localizado no arquivo nsuser.rsp para a unidade e diretório completamente qualificados.)
6. Execute o arquivo instplug.cmd.
7. Reinicialize o sistema.

Utilize a seguinte lista de variáveis como referência ao definir as variáveis nos arquivos mencionados anteriormente.

em que:

xx | Especifica a variável de idioma de sua preferência.
/r | Especifica a localização completa do arquivo de resposta Feature Install.
/r2 | Especifica a unidade, o caminho e o nome do arquivo de resposta do usuário.
/b | Especifica a unidade de reinicialização.
/s | Especifica a localização completa dos arquivos extraídos do Developer Kit.
/l1 e /l2 | Especifica as localizações completas dos arquivos de log opcionais. Consulte estes arquivos, além do arquivo \os2\install\wpinstal.log na unidade de inicialização, se ocorrerem problemas durante a instalação.

#### 3.8.2 Instalação do Plug-in Java após a instalação do IBM Web Browser for OS/2

Se você instalou o IBM Web Browser for OS/2 após o Developer Kit e deseja ativar o Plug-in Java para este navegador, conclua as seguintes etapas:

1. Localize o arquivo mzplugin.exe encontrado no diretório \JAVA131\ns\ do Runtime Environment. Copie o arquivo mzplugin.exe para um diretório temporário.
2. Execute o arquivo mzplugin.exe, a partir do diretório onde você o copiou, digitando o nome do arquivo em um prompt de comandos. A execução do arquivo extrai os seguintes arquivos:

- insmzplg.cmd: Comando CLIFI utilizado para executar a instalação do Java Plug-in
- npoji6.dll: Dll do Java Plug-in
- mzcheck2.exe: Saída do usuário utilizada para localizar o Netscape
- mzfiles.rsp: Arquivo de resposta FI (Feature Install). Não edite este arquivo.
- mzuser.rsp: Arquivo de resposta do usuário parcial de exemplo
- package.ctl: Arquivo de pacotes requerido pelo FI.

3. Retorne ao diretório \JAVA131\ns\
4. Edite o arquivo insmzplg.cmd para apontar para caminhos e unidade de inicialização.
5. Edite o arquivo mzuser.rsp para ativar o Java Plug-in. A versão mais recente do IBM Web Browser for OS/2 está ativada. (Se desejar ativar uma versão específica do IBM Web Browser for OS/2, defina o valor JAVAMZFILES.NSDRV localizado no arquivo mzuser.rsp para a unidade e o diretório completos).
6. Execute o arquivo insmzplg.cmd.
7. Reinicialize o sistema.

Utilize a seguinte lista de variáveis como referência ao definir as variáveis nos arquivos mencionados anteriormente.
em que:

xx | Especifica a variável de idioma de sua preferência.
/r | Especifica a localização completa do arquivo de resposta Feature Install.
/r2 | Especifica a unidade, o caminho e o nome do arquivo de resposta do usuário.
/b | Especifica a unidade de reinicialização.
/s | Especifica a localização completa dos arquivos extraídos do Developer Kit.
/l1 e /l2 | Especifica as localizações completas dos arquivos de log opcionais. Consulte estes arquivos, além do arquivo \os2\install\wpinstal.log na unidade de inicialização, se ocorrerem problemas durante a instalação.

#### 3.8.3 O Painel de Controle do Java Plug-in

Após a instalação do Java Plug-in, você pode controlar o comportamento do Java Plug-in em tempo de execução. Por exemplo, ao executar o Java Plug-in, você pode controlar se, na inicialização do Java Plug-in, deseja que Java Console se torne visível.

O Painel de Controle é um aplicativo Java lançado pelo arquivo de comandos localizado no arquivo [x:\JAVA131]\jre\bin\jctrlpnl.cmd. Um ícone para este arquivo de comandos está localizado no diretório [x:\JAVA131], em que x é a unidade onde o Developer Kit está instalado. Por padrão, JAVA131 é o nome do diretório.

### 3.9 Desativação do compilador JIT

Um compilador JIT (Just-in-Time) é fornecido com o Developer Kit. O compilador JIT gera um código de máquina para seqüências de códigos de bytes utilizadas freqüentemente em um aplicativo ou applet Java durante a execução. O JIT é ativado por padrão. Você pode desativar o JIT para ajudar no isolamento de um problema com um aplicativo Java, um applet ou o próprio compilador passando o seguinte comando para o interpretador de tempo de execução Java:

    SET JAVA_COMPILER=none

### 3.10 Alterações em nomes de arquivos

Há alguns nomes de arquivos curtos com base na convenção de nomes de arquivos 8.3 requerida pelo OS/2 que diferem dos nomes de arquivos longos requeridos por plataformas como o Microsoft(R) Windows(R) ou o Linux. Abaixo, encontram-se os nomes de arquivos conhecidos que são diferentes:

Nome de Arquivo Longo | Nome de Arquivo Curto do OS/2
cmm.dll | orb.dll
fontmanager.dll | font.dll
ioser12.dll | iosr12.dll
java-rmi.exe | jrmi.exe
| policytool.exe | policy.exe

keytool.exe | keytol.exe
appletviewer.exe | applet.exe
tnameserv.exe | tnames.exe
rmiregistry.exe | rmireg.exe
.keystore | keystore.prp
Nomes de arquivos curtos e longos conhecidos que se diferem, com base na convenção de nomenclatura de arquivos 8.3.

### 3.11 Configuração do visualizador de applets

Para configurar o visualizador de applets para conexão por meio de um gateway proxy à Internet:

1. Clique em Propriedades do applet.
2. Clique em Propriedades.
3. Digite o servidor e porta proxies nos campos correspondentes
Por exemplo:

         Http proxy server: myproxy.mycompany.com
         Http proxy port:   80

Se o navegador da Web já estiver configurado para conectar-se à Internet, utilize os valores configurados nessa configuração. Por exemplo, com o WebExplorer(R), utilize os valores do Gateway Proxy na página Configurar Servidores, omitindo o 'http://' inicial e o '/' final.
Se não souber seu Gateway Proxy, pergunte ao administrador do sistema se você tem autorização para utilizar os serviços proxy.
4. Clique em Aplicar para armazenar as alterações.
5. Feche o visualizador de applets.

### 3.12 Especificação das opções do Java e das propriedades do sistema

É possível especificar opções e propriedades de sistema Java criando uma variável de ambiente chamada IBM_JAVA_OPTIONS e definindo-a com os valores necessários. Toda opção ou propriedade de sistema Java especificada deve ser precedida de um espaço, exceto a primeira opção. Por exemplo, você pode definir IBM_JAVA_OPTIONS como a seguir:

    IBM_JAVA_OPTIONS=-Dmysysprop1=tcpip -Dmysysprop2=wait

Se você especificar as mesmas opções ou propriedades a partir da linha de comandos (ou de um programa JNI), elas terão precedência sobre as opções e propriedades especificadas pela variável de ambiente IBM_JAVA_OPTIONS. A única exceção a essa regra é ao especificar -Xt, -Xtm ou -Xdebug. Todas essas opções implicam que nenhum JIT deve ser usado.

Esteja ciente de que:

- IBM_JAVA_OPTIONS não terá efeito algum ao ser executada com JNI_VERSION_1_1.
- As opções Java devem ser especificadas em seu formato atual, por exemplo, -verbose:gc em vez de -verbosegc.

A propriedade do sistema ibm.jvm.bootclasspath permite que um caminho de pesquisa adicional seja definido. O valor desta propriedade é inserido entre qualquer valor definido por -Xbootclasspath/p: e pelo caminho de bootclass. O caminho da classe bootclass é o padrão, ou o caminho definido através da opção -Xbootclasspath:. Para obter mais informações a respeito dessas opções, consulte 3.1 Fontes adicionais de informações

### 3.13 RMI Sobre IIOP

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

O Developer Kit inclui suporte para aplicativos desenvolvidos para utilizar RMI sobre IIOP (RMI-IIOP). Este suporte faz parte da instalação padrão do Runtime Environment e não requer instalação ou configuração especial.

#### 3.13.1 Compilador IDL para Java

Um compilador IDL para Java é incluído com este release. Esta ferramenta converte IDL (Linguagem de Definição de Interface) CORBA em Java. Consulte o IDL-to-Java Compiler User's Guide para obter mais informações. Esta documentação pode ser encontrada no seguinte diretório:

         [x:\JAVA131]\DOCS\RMI-IIOP\toJavaPortableUG.htm

[x:\JAVA131] é a unidade e o diretório onde o Developer Kit está instalado. Por padrão, JAVA131 é o nome do diretório.

O compilador IDL para Java suporta a especificação CORBA 2.3. Isso inclui a construção "valuetype" e seu mapeamento de IDL para Java. Detalhes deste suporte podem ser encontrados nos seguintes sites FTP:

- ftp://ftp.omg.org/
  Nessa página principal, clique em pub --> docs --> formal --> 99-07-53.pdf
  (mapeamento IDL para Java)
- ftp://ftp.omg.org/
  Nessa página principal, clique em pub --> docs --> formal --> 98-12-01.pdf
  (Núcleo do CORBA 2.3)

O compilador IDL para Java é fornecido para que possa ser experimentado com a IDL gerada pelo comando "rmic -idl". Esta IDL gerada e o compilador IDL para Java não são requeridos ao utilizar RMI-IIOP no caso Java para Java. A IDL gerada é utilizada para permitir que o RMI-IIOP interopere com outras linguagens, como C++. Para interoperar com a linguagem C++, deve-se utilizar um compilador IDL para C++ que suporte a especificação CORBA 2.3 para compilar a IDL gerada.

##### 3.13.1.1 Restrições do compilador IDL para Java

Veja as considerações a seguir, aplicadas ao utilizar o compilador IDL para Java:

- Os identificadores de escape no escopo global podem não ter a mesma grafia dos tipos de IDL, Objetos ou ValueBase primitivos. Isso ocorre porque a tabela de símbolos é pré-carregada com esses identificadores; permitir a redefinição sobreporia suas definições originais.
- Não há stubs locais e semântica de cópia ao passar valores localmente.
- O tipo de IDL fixa não é suportado.
- Os stubs gerados não suportam serialização. Devido à especificação de mapeamento IDL e Java 1998-08-22 seção 25.3.1.3 falhar em especificar o que é necessário.
- Constantes do tipo octeto não podem ser declaradas.

##### 3.13.1.2 Problemas conhecidos do compilador IDL para Java

A seguir, problemas conhecidos do compilador IDL para Java:

- O compilador pode concluir o processo de compilação sem erros, mas falhará ao gerar saída. Se isso ocorrer, especifique a opção -emitAll para forçar que todas as classes sejam geradas. Ao utilizar a opção -emitAll, recomenda-se que a opção -pkgPrefix também seja utilizada para incluir um prefixo em quaisquer nomes de classe que comecem com 'java' para evitar conflitos de nomes com classes na JVM.
- O compilador não reconhece o tipo CORBA::Principal desaprovado.
- A declaração de uma constante e de método ou atributo que tenha o mesmo nome no mesmo escopo não provoca erro. A seguinte IDL pode causar um erro:

               interface t {
                 const long foo = 1;
                 attribute long foo;
               };

- A seguinte IDL resulta no erro "S é um tipo não-declarado" na interface B. Não deveria.

               interface A { struct S { short s; }; };
               interface B:A { typedef S new_S;
                           exception ex {S f1;}; // Erro de "S" aqui
               };

- Se uma união definir outra união em sua cláusula padrão, a classe Java resultante obterá erros de compilação. A solução é definir a união aninhada fora da união que a contém.

#### 3.13.2 Informações adicionais

Para obter informações sobre IBM e RMI-IIOP, consulte o seguinte site IBM na Web:
http://www.ibm.com/java/jdk/rmi-iiop/index.html

Outra documentação disponível:

- O LEIA ME do Developer Kit está localizado no diretório em que o Developer Kit foi instalado.
- O RMI-IIOP Programmer's Guide é uma introdução à gravação de programas RMI-IIOP e pode ser encontrado no seguinte site da Web ou diretório e arquivo:

- http://www.ibm.com/java/jdk/rmi-iiop/docs/win130/rmi_iiop_pg.html
- [x:\JAVA131]\DOCS\RMI-IIOP\rmi_iiop_pg.html

- O IDL-to-Java Compiler User's Guide descreve como utilizar a ferramenta que gera código Java a partir de IDL e pode ser encontrado no seguinte site da Web ou diretório e arquivo:
  - http://www.ibm.com/java/jdk/rmi-iiop/docs/win130/toJavaPortableUG.htm
  - [x:\JAVA131]\DOCS\RMI-IIOP\toJavaPortableUG.htm
- O diretório de amostras contém:
  - Um exemplo de Hello World intercambiável entre os protocolos JRMP e IIOP. ([x:/JAVA131]/rmi-iiop/samples/Hello)
  - Um exemplo de Hello World que interopera com um programa IDL padrão. ([x:/JAVA131]/rmi-iiop/samples/idl)

  [x:\JAVA131] é a unidade e o diretório onde o Developer Kit está instalado. Por padrão, JAVA131 é o nome do diretório.

- O documento Java Language to IDL Mapping é uma especificação técnica detalhada de RMI-IIOP e pode ser encontrado no seguinte site do FTP:
  ftp://ftp.omg.org/
  Nessa página principal, clique em pub --> docs --> formal --> 99-07-59.pdf
- As informações sobre a interface de programação de aplicativos (API) Java da Sun Microsystems podem ser encontradas no seguinte site da Web: http://java.sun.com/products/?frontpage-main

#### 3.13.3 Termos RMI-IIOP

API | Application Programming Interface
CORBA | Common Object Request Broker Architecture
IDL | Interface Definition Language
IIOP | Internet Inter-ORB Protocol
| ORB | Object Request Broker

RMI | Remote Method Invocation

### 3.14 JAAS (Java Authentication and Authorization Service)

A plataforma Java 2 fornece um meio de forçar controles de acesso com base no local de onde o código veio e quem o assinou. Esses controles de acesso são necessários por causa da natureza distribuída da plataforma Java onde, por exemplo, pode-se fazer download de um applet remoto através de uma rede pública e executá-lo localmente.

Entretanto, a plataforma Java 2 não fornece uma maneira de forçar controles de acesso semelhantes com base em quem executa o código. Para fornecer este tipo de controle de acesso, a arquitetura de segurança Java 2 requer o seguinte:

- Suporte adicional para autenticação (determinando quem realmente está executando o código)
- Extensões para os componentes de autorização existentes para forçar novos controles de acesso com base em quem foi autenticado

O JAAS (Java Authentication and Authorization Service) fornece esses aperfeiçoamentos.

Para obter uma visão geral da estrutura JAAS, consulte o seguinte site na Web:

http://java.sun.com

A partir desta página principal, clique em Products & APIs e role para baixo, até a seção Optional Packages. Os documentos neste site na Web contêm links para várias outras fontes de informações baseadas na Web.

#### 3.14.1 Diferença entre as versões do JAAS da IBM e da Sun

A versão IBM do JAAS para OS/2 é diferente da versão Sun do JAAS para Windows; os pacotes com.sun.* mudaram para pacotes com.ibm.*.

#### 3.14.2 Instalação básica

As informações a seguir referem-se à localização dos arquivos JAAS:

- Os arquivos jaas.jar e jaas_lm.jar estão no subdiretório jre\lib\ext do diretório no qual o Runtime Environment foi instalado
.
- O JAAS inclui um LoginModule simples que reflete as informações do sistema operacional atual para programas Java. Para fornecer essa capacidade, os seguintes arquivos são instalados nos subdiretórios mostrados, no diretório no qual o Runtime Environment está instalado:

             JAVA131\jre\bin:
                       jaas.dll
                       jaas_g.dll

- O diretório de documentação JAVA131\docs\jaas contém a documentação da API do JAAS e um arquivo module.html. No diretório de documentação do JAAS, localize o arquivo JaasDocs.jar (contém a documentação de JAAS API) e descompacte-o (jar -xvf JaasDocs.jar) na partição HPFS ou JFS. Localize o arquivo index.html. Através de um navegador, utilize o arquivo index.html para acessar o restante da documentação da API.

Nota: O Runtime Environment está instalado no diretório x:\JAVA131. (em que x é a unidade onde o Developer Kit está instalado. Por padrão, JAVA131 é o nome do diretório).

### 3.15 Informações sobre a programação da JNI

Os objetos Java podem ser acessados a partir de um programa C, utilizando-se a Java Native Interface (JNI), que era nova no Java 1.1.1. Utilizar o JNI fornece uma interface mais estável do que o Native Method Interface (NMI) anterior.

Os aplicativos da JNI geralmente precisam interagir com os tipos Java long, float e double, devido a um ou mais dos seguintes motivos:

- Para receber as variáveis como parâmetros de método nativo.
- Para inspecionar a instância ou as variáveis de classe diretamente.
- Para retornar a variável como o valor de retorno do método nativo.
- Para passar as variáveis como dados de parâmetro ao invocar outros métodos Java de um método nativo.

### Tipos JNI nativos

Para cada um dos tipos Java, a JNI fornece tipos nativos que podem ser utilizados em seu aplicativo JNI. Esses tipos são mostrados na tabela a seguir:

Tipos JNI Nativos
Tipo Java | Tipos JNI Nativos | Tamanho em Bytes
--- | --- | ---
long | jlong | 8
double | jdouble | 8
float | jfloat | 4
Tipos JNI Nativos

Nota: Não há necessidade de utilizar esses tipos se o aplicativo não manipular os tipos Java long, double e float.

Utilize os tipos JNI nativo ao definir uma implementação de método nativo, a fim de que o compilador corresponda a assinatura do método nativo à do cabeçalho gerado através do uso do utilitário javah.

### Funções e macros do Helper

Os tipos JNI nativos jlong, jdouble e jfloat são incompatíveis com os tipos C e C++ respectivos long, double e float. Se você tentar converter um em outro, obterá um erro de compilação ou um comportamento inesperado no tempo de execução. Não tente converter um em outro uma vez que os formatos dos tipos JNI nativo são específicos do Developer Kit.

O arquivo de cabeçalho do JNI (jni.h) inclui outro arquivo de cabeçalho que é fornecido com o Developer Kit denominado int64_md.h. Esse arquivo define as funções e as macros do Helper que podem ser utilizadas para trabalhar com os tipos nativos.

As funções e as macros em int64_md.h (relacionadas a jlong) geralmente incluem ll no início ou no fim do nome. As funções relacionadas a jdouble ou jfloat geralmente incluem dbl, double, flt, ou float no nome. Há também algumas constantes jlong, jdouble e jfloat definidas.

A seguir, alguns exemplos de macros:

- Macro ll_add() adiciona dois jlongs e retorna um jlong.
- Macro int2ll() converte um int em um jlong.
- Função ll2str() converte um jlong em uma representação de cadeia ASCII do valor de 64 bits.
- Função flt2dbl() converte um jfloat e retorna um jdouble.
- Macro dbl2nat() converte um jdouble em um double nativo do OS/2
.
- Macro dbl_sqrt() toma a raiz quadrada de um jdouble e retorna um jdouble.
- Funções dbl2str() e flt2str() converte seus argumentos em uma representação de cadeia ASCII.

### 3.16 Considerações de desempenho

Os usuários podem perceber que alguns aplicativos levam mais tempo para carregar e iniciar no OS/2 Warp Development Kit, Java 2 Technology Edition, versão 1.3.1 se comparados à versão 1.3.0. Nesses casos, seria útil utilizar o parâmetro da linha de comandos -Xquickstart do JAVA.EXE.

O compilador Just-In-Time do Java 1.3.1 do OS/2 executa otimizações adicionais por padrão, que podem aumentar a quantidade de tempo que um aplicativo demora para ser carregado. O benefício pretendido com essas otimizações adicionais é melhorar o desempenho do aplicativo em tempo de execução. A quantidade do benefício de desempenho em tempo de execução e a quantidade de degradação de tempo de carregamento variam para cada aplicativo. Alguns aplicativos apresentarão pouca ou nenhuma alteração se comparados à versão 1.3.0 do Java. O parâmetro -Xquickstart especifica a utilização de um conjunto de otimizações mais simples, que pode melhorar os tempos de inicialização. As diferenças de desempenho entre utilizar -Xquickstart, e a sua não utilização, variam para cada aplicativo.

## 4.0 PACOTE(S) DE FONTES ADICIONAL(IS)

Se tiver feito download de um ou mais pacotes de fontes como um arquivo, pule para as seções Instalação de fontes adicionais para obter instruções sobre a instalação. Se você fez download de arquivos divididos, siga estas etapas para unir os arquivos divididos em um arquivo instalável. Em seguida, continue com as seções de instalação.

1. Assegure que todos os arquivos divididos para a fonte desejada estejam no mesmo diretório.
2. Em um prompt de comandos e a partir do diretório no qual fez download dos arquivos divididos, utilize o comando copy para unir os mesmos. Você deve incluir os nomes dos arquivos divididos e o nome do arquivo da fonte completa. Por exemplo, se você fez download de três arquivos divididos, digite o seguinte:

         Copy /b ExamFont.txx + ExamFont.txx + ExamFont.txx ExamFont.ttf

em que:

ExamFont.txx | é o nome do arquivo dividido do qual você fez download. (xx é o número do arquivo dividido do qual você fez download.) Certifique-se de especificar os arquivos divididos na ordem correta.
ExamFont.ttf | é o nome completo da fonte.

### 4.1 Instalação de fontes adicionais

Consulte as seções a seguir para obter informações sobre a instalação utilizando o método de instalação CID ou o método Paleta de Fontes.

#### 4.1.1 Método de instalação CID

Para instalar uma fonte adicional utilizando uma instalação CID, siga estas etapas:

1. Localize o arquivo wtfont.exe localizado no diretório x:\JAVA131\fonti do Developer Kit. x é a unidade em que o Developer Kit foi instalado.
2. Execute o arquivo wtfont.exe digitando o nome do arquivo em um prompt de comandos. A execução do arquivo extrai os seguintes arquivos:

- wtfnt.cmd: Um arquivo de comandos que executa CLIFI.
- wtfonts.rsp: O arquivo de respostas do FI (Feature Install). Não edite este arquivo.
- wtfntusr.rsp: Um arquivo de respostas do usuário. Edite este arquivo para selecionar as fontes que deseja instalar.
- PACKAGE.CTL: Um arquivo de pacotes requerido pelo Feature Install.

3. Copie o arquivo PACKAGE.CTL para o diretório em que fez download dos pacotes de fontes adicionais.
4. Edite o arquivo wtfnt.cmd para indicar os caminhos e unidade de inicialização corretos. Consulte abaixo para obter uma lista de parâmetros.
5. Edite o arquivo wtfntusr.rsp para selecionar as fontes que deseja instalar.
6. Execute o arquivo wtfnt.cmd
7. Reinicialize o sistema.

Nota: Se o CLIFI solicitar para "inserir a mídia", será necessário definir o parâmetro /s: corretamente no arquivo wtfnt.cmd ou colocar o arquivo PACKAGE.CTL no mesmo diretório dos pacotes de fontes que você deseja instalar.

Utilize a seguinte lista de variáveis como referência ao definir as variáveis nos arquivos mencionados acima.

em que:

/s: | Especifica a origem dos pacotes de fonte e o arquivo PACKAGE.CTL.
/b: | Especifica a unidade de reinicialização.
/r2: | Especifica a unidade, o caminho e o nome do arquivo de resposta do usuário.
/r: | Especifica o arquivo Feature Install (wtfntusr.rsp).
/l1 e /l2 | Especifica as localizações completas dos arquivos de log opcionais. Consulte estes arquivos, além do arquivo \os2\install\wpinstal.log na unidade de inicialização, se ocorrerem problemas durante a instalação.

#### 4.1.2 Método de paleta de fontes

Para instalar uma fonte adicional utilizando a Paleta de Fontes, siga estas etapas:

1. Abra a pasta Sistema OS/2.
2. Clique na pasta Configuração do sistema.
3. Clique em Paleta de fontes.
4. Clique no botão Editar fonte.
5. Clique no botão Incluir.
6. Digite a unidade e diretório em que fez download dos arquivos fonte.
7. Selecione a fonte que deseja instalar e clique em Incluir.

## 5.0 INFORMAÇÕES DO CONJUNTO DE CARACTERES DE BYTE DUPLO

As seções a seguir descrevem as considerações conhecidas sobre o DBCS (conjunto de caracteres de byte duplo).

### 5.1 Texto do painel de instalação ausente ou muito longo em países ou regiões DBCS

Ao instalar o Developer Kit em versões DBCS do OS/2, os caracteres DBCS poderão não ser exibidos nos painéis de instalação ou as linhas poderão exceder a borda direita da janela de exibição, mesmo quando a janela estiver maximizada.

Para corrigir esses problemas, saia do programa de instalação, abra o objeto Netscape Navigator ou o Netscape Communicator para OS/2, e clique no item de menu Opções. Abra o bloco de notas Preferências Gerais e selecione a guia Fontes. Escolha a codificação adequada para o seu país ou região e, em seguida, defina as fontes proporcionais e fixas para MINCHO. Clique em OK para salvar as alterações. Quando iniciar a instalação do Developer Kit novamente, o texto deverá ser exibido corretamente.

### 5.2 Fontes TrueType devem ser instaladas em sistemas chineses

Em sistemas chineses simplificados ou tradicionais, assegure que todas as fontes TrueType disponíveis do OS/2 estejam instaladas. Para instalar essas fontes, faça o seguinte:

1. Em um prompt de comandos do OS/2, em que C: é a unidade de inicialização, inicie o programa Instalação Seletiva digitando:

            C:\OS2\INSTALL\INSTALL

   Um painel intitulado "Configuração do Sistema" é exibido.
2. Continue no painel Configuração e Instalação do OS/2 clicando no botão Próximo (para OS/2 Warp 4.0) ou no botão OK (para OS/2 Warp Server for e-business).
3. No painel Configuração e Instalação do OS/2, selecione a caixa de opções Fontes TrueType.
4. Clique no botão Mais à direita desta caixa de opções.
5. Assegure que todas as caixas de opções de fontes estejam selecionadas. Clique em OK.
6. Insira o CD-ROM do sistema operacional (OS/2 Warp Server 4.0 ou OS/2 Warp Server for e-business) na unidade de CD.
7. Clique em OK no painel Diretório de Origem.

As fontes apropriadas devem ser instaladas. Reinicialize o sistema quando a instalação da fonte estiver concluída.

### 5.3 Correções temporárias do programa e FixPaks para sistemas DBCS

Alguns usuários de DBCS podem encontrar os seguintes comportamentos relacionados a uma operação de Método de Entrada Asiático. Muitos desses itens são tratados nos releases mais recentes do sistema operacional. No entanto, se você não puder fazer upgrade para um release posterior, entre em contato com o representante de serviços IBM local para saber sobre a disponibilidade de quaisquer correções temporárias do programa (PTFs) ou FixPaks aplicáveis.

A tabela a seguir descreve os comportamentos relacionados à operação do Método de Entrada Asiático e o sistema DBCS afetado.

Descrição | Sistema DBCS Afetado
--- | ---
Quando o foco é movido para outro quadro, ocorre Trap em IME. | Chinês Tradicional
Quando o foco é movido para outro quadro na exibição da janela de consulta, a operação de conversão não funciona corretamente. | Chinês Tradicional
Quando o foco é movido para outro quadro na exibição da janela de consulta, a janela de consulta não desaparece. | Japonês
O modo de entrada correto não é exibido no indicador de modo de entrada. | Japonês, chinês simplificado e chinês tradicional
Uma cadeia de conversão no cliente ativo não desaparece pressionando a tecla ESC. | Chinês Tradicional
Quando o usuário vai para o JAVA native IME, uma tecla de conversão não funciona corretamente. | Japonês, chinês simplificado e chinês tradicional
O sistema fica travado ao abrir muitos quadros IM. | Chinês Tradicional
Não é possível continuar a entrada se alternar de volta para o modo de entrada em inglês sem selecionar algum caractere DBCS na janela de procura. | Chinês simplificado e chinês tradicional
Uma cadeia de conversão no cliente ativo não desaparece ao pressionar as teclas Ctrl+Space. | Chinês Simplificado
Pressionar a tecla Backspace ao exibir a janela de procura faz com que um trap ocorra no IME. | Chinês Simplificado
Descrição dos comportamentos relacionados à operação do Método de Entrada Asiático e o sistema DBCS afetado.

### 5.4 Controle da exibição de caracteres numéricos árabes

Os usuários de alguns países ou regiões podem ver, inesperadamente, caracteres numéricos árabes aparecerem. Algumas versões do OS/2 específicas do país ou da região mapeiam os caracteres x'00B0' a x'00B9' para os caracteres numéricos árabes de zero (0) a nove (9). Para exibir os caracteres desejados, altere os Atributos Bidirecionais no arquivo CONFIG.SYS ou utilize a página Idioma no bloco de notas Propriedades (bloco de notas Definições no sistema OS/2 Warp Server for e-business) do objeto para obter o efeito desejado.

### 5.5 Definições do ambiente japonês na versão japonesa do OS/2 Warp 4

Utilize as seguintes definições do ambiente japonês para a versão japonesa do OS/2 Warp 4:

Página de códigos: | 932
Código ShiftJIS: | Novo JIS

### 5.6 Fontes exigidas na versão japonesa do OS/2 Warp

Para executar o Developer Kit, as seguintes fontes são requeridas no sistema:

Nome | Estilo
GOTHIC | Normal
GOTHIC | HeiseiKakuGothic-W5-H-90-TT
MINCHO | HeiseiMincho-W3-H-90-TT
Fontes exigidas na versão em japonês do OS/2 Warp

É possível verificá-las na Paleta de Fontes, que está na pasta Configuração do Sistema na pasta Sistema OS/2.

- A fonte GOTHIC Normal está incluída na fonte japonesa do sistema GOTHIC.
- GOTHIC HeiseiKakuGothic-W5-H-90-TT é uma fonte IBM HeiseiKakuGothic TrueType com ordem Novo JIS.
- MINCHO HeiseiMincho-W3-H-90-TT é uma fonte IBM HeiseiMincho TrueType com ordem Novo JIS.

Estas fontes podem ser instaladas através do objeto de programa Instalação Seletiva, que está localizado na pasta Instalar/Remover na pasta Configuração do sistema nos sistemas OS/2 Warp 4 e OS/2 Warp Servers for e-business.

### 5.7 Melhora na qualidade da fonte no OS/2 Warp Server for e-business

No OS/2 Warp Server for e-business, é possível melhorar a qualidade de uma fonte do tamanho de um ponto pequeno ativando uma associação entre uma fonte dimensionável e uma fonte de bitmap. Para ativar a associação, faça o seguinte:

1. Abra a pasta Sistema OS/2.
2. Abra a pasta Configuração do Sistema.
3. Abra o objeto Sistema.
4. Abra a página Associar à Fonte Bitmap.
5. Marque o botão Ativar.
6. Dê um clique duplo no ícone do menu de sistema para fechar o objeto Sistema.

Se desejar obter mais informações sobre associação de fontes bitmap, clique no botão de auxílio localizado na página Associar à Fonte Bitmap.

## 6.0 REMOÇÃO DA INSTALAÇÃO DO DEVELOPER KIT

As seguintes seções fornecem informações sobre a remoção da instalação do Developer Kit.

Se tiver instalado componentes do Developer Kit várias vezes sem remover a instalação, as referências a JAVA131 continuarão a existir no arquivo CONFIG.SYS. Se desejar que elas sejam removidas, exclua-as do arquivo CONFIG.SYS.

Nota: Se o Netscape Communicator estiver sendo executando durante a remoção da instalação do Developer Kit, ela poderá falhar. Você deve encerrar o Netscape Communicator e, então, começar o processo de remoção de instalação.

### 6.1 Método de Ambiente de Trabalho

Para remover a instalação utilizando o objeto Remover o Developer Kit, siga estas etapas:

1. Abra a pasta Sistema OS/2.
2. Abra a pasta Configuração do Sistema.
3. Abra a pasta Remover a Instalação de Recursos. Se estiver removendo a instalação do OS/2 Warp 4, abra a pasta Instalar/Remover e a pasta Remover a Instalação de Recursos.
4. Dê um clique duplo no objeto Remover o Developer Kit para OS/2 para iniciar o programa de remoção de instalação.

Se você extraiu qualquer arquivo de fonte adicional ou os arquivos Java Plug-in, como o plugin.exe ou mzplugin.exe, e deseja removê-los de seu sistema, vá para a unidade e diretório em que os instalou e os exclua.

### 6.2 Método de prompt de comandos do OS/2

Para iniciar a remoção da instalação, certifique-se de estar na unidade raiz em que o Runtime Environment está instalado. No prompt de comandos do OS/2, digite:

         JAVA131/UNINSTAL/UNINSTAL

O programa de remoção da instalação o conduz através do processo de remoção. Apenas os arquivos e diretórios criados pelo processo de instalação são removidos. Por exemplo, o diretório HOTJAVA criado através da execução do Visualizador de Applets não é removido durante a remoção da instalação.

Se você extraiu qualquer arquivo de fonte adicional ou os arquivos Java Plug-in, como o plugin.exe ou mzplugin.exe, e deseja removê-los de seu sistema, vá para a unidade e diretório em que os instalou e os exclua.

### 6.3 Remoção da Instalação do Developer Kit a partir do WorkSpace On-Demand 2.0

Suporte para remoção do Developer Kit requer acesso a um objeto de inventário (Java 1.3) no diretório Recursos Instalados (\os2\install\installed features). Se você instalar o Developer Kit para o Cliente WorkSpace On-Demand 2.0 e para o Servidor WorkSpace On-Demand 2.0, o objeto de inventário Java 1.3 será danificado ou substituído. Portanto, não utilize o programa de remoção da instalação para remover os componentes do Developer Kit do espaço cliente.

Em vez disso, exclua a estrutura de diretório [rpldrive]\ibmlan\rpl\bb20.xx\JAVA131 e todas as referências feitas a ele que foram incluídas nos diretórios de imagem do Cliente WorkSpace On-Demand. (Como os arquivos CONFIG.SYS, OS2.INI e FIT.)

Para remover o Developer Kit do servidor, exclua a estrutura de diretórios \JAVA131. Você pode excluir a estrutura de diretórios da pasta Unidades na pasta Sistema OS/2.

### 6.4 Execução de uma remoção de instalação não-assistida

Para remover o Developer Kit, digite o seguinte comando de apenas uma linha em um prompt de comandos do OS/2:

         clifi /a:u /f:"<WP_INSTALLED>" /o:INV_JAVA13 /set:Selection=ALL

### 6.5 Remoção do Developer Kit como a JVM padrão

Para remover ou substituir o Developer Kit como a JVM (máquina virtual java) padrão, remova a instrução x:\JAVA131\JRE\BIN; da instrução PATH do arquivo CONFIG.SYS. Para efetivar a alteração, reinicialize o sistema.

## 7.0 LIMITAÇÕES CONHECIDAS

- Se o Developer Kit for instalado como a JVM padrão, alguns aplicativos conhecidos falharão. São eles:
  - LVMGUI: A interface gráfica com o usuário do Logical Volume Manager
  - Certos componentes do TCP/IP

- O Developer Kit não pode ser gravado ou lido a partir de um arquivo que tenha dois gigabytes ou mais.

- Se fizer download e instalar as extensões de segurança JCE (Java Cryptography Extensions), remova o arquivo jar (jre/lib/ext/ibmjca.jar) do JCA (Java Cryptography Archictecture) durante o processo de instalação. Como a funcionalidade JCA é um subconjunto do JCE, o Developer Kit pode não funcionar corretamente se ambos estiverem instalados.

- A ponte JDBC-ODBC (Java Database Connectivity-Open Database Connectivity) não é suportada.

- O Java Plug-in não suporta impressão neste release do Developer Kit.

- O código de alguns aplicativos pode ser alterado para procurarem os executáveis do Developer Kit no diretório JAVA131\bin. Na realidade, estes executáveis estão localizados no diretório x:\JAVA131\jre\bin\. Se encontrar um aplicativo desse tipo, digite o seguinte em um prompt de comandos para copiar os executáveis para o diretório JAVA131\bin:

           copy x:\JAVA131\jre\bin\*.exe to x:\JAVA131\bin

  em que x é a unidade em que o Developer Kit está instalado. Por padrão, JAVA131 é o nome do diretório.

  Se você aplicar um nível de serviço ao Developer Kit, repita a etapa acima após aplicar o nível de serviço.

- Ao utilizar o IBM Java Plug-in, deixe que os applets terminem de carregar para evitar que o navegador fique bloqueado. Por exemplo, se você clicar no botão Voltar e, em seguida, no botão Avançar, enquanto um applet está sendo carregado, as páginas HTML poderão não terminar de carregar.

- Apesar do IBM Java Plug-in suportar o mesmo nível de funcionalidade LiveConnect, conforme encontrado na versão Sun atual do Plug-in Java (1.3.0_01), foram identificadas algumas falhas do Live Connect em ambos os plug-ins. Ao comunicar falhas relacionadas ao LiveConnect, informe se elas ocorreram na versão da Sun ou da IBM do plug-in.

- O tamanho máximo da cache de disco HPFS é dois megabytes. Esse tamanho máximo pode limitar o desempenho do Developer Kit. Em muitos ambientes, o desempenho do sistema e o tempo de carregamento do aplicativo podem ser otimizados com a utilização de uma cache maior. Estes sistemas de arquivos do OS/2 são alternativas potenciais que suportam um tamanho de cache maior:

  - JFS, incluído no sistema IBM OS/2 Warp Server for e-business
  - HPFS 386, incluído no sistema IBM OS/2 Warp Server Advanced
- Se você perceber problemas de reexibição em uma máquina Pentium(R) MMX ou inferior, é possível solucionar este problema definindo a variável de ambiente JAVA_COMPILER=NONE.

## 8.0 AVISOS

(c) Copyright International Business Machines Corporation 1999, 2002. 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 Corp.

Consulte um representante IBM local para obter informações sobre produtos e serviços disponíveis atualmente em sua área. Qualquer referência a um produto, programa ou serviço 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, 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 usuário.

A IBM pode ter patentes ou solicitações de patentes pendentes relativas a assuntos tratados neste documento. O fornecimento deste documento não lhe garante direito algum sobre tais patentes. Pedidos de licença devem ser enviados, por escrito, para:

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

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, EXPRESSA OU IMPLÍCITA, INCLUINDO, MAS NÃO SE LIMITANDO ÀS GARANTIAS IMPLÍCITAS DE MERCADO OU ADEQUAÇÃO A UM DETERMINADO PROPÓSITO.

Alguns países não permitem a exclusão de garantias explícitas ou implícitas em certas transações; portanto, esta disposição pode não se aplicar a você.

Estas informações podem conter 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, sem aviso prévio.

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

A IBM pode utilizar ou distribuir as informações fornecidas da forma que julgar apropriada sem incorrer em obrigações para com você.

Licenciados deste programa que desejam obter informações sobre este assunto 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:

JTCMAIL@uk.ibm.com
[Hursley Java Technology Center (JTC)]

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 medições podem ter sido efetuadas em sistemas em fase de desenvolvimento e não há garantia de que tais medições sejam as mesmas em sistemas disponíveis para o mercado. 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 relativas a produtos não-IBM foram obtidas junto aos fornecedores dos respectivos produtos, de seus anúncios publicados ou de outras fontes disponíveis publicamente. 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.

Todas as declarações referentes a futuras instruções ou intenções da IBM estão sujeitas a alterações ou remoção sem aviso prévio e representam apenas metas e objetivos.

LICENÇA DE COPYRIGHT:

Estas informações contêm exemplos de programas aplicativos no idioma de origem, ilustrando as técnicas de programação em diversas plataformas operacionais. Você pode copiar, modificar e distribuir estes exemplos de programas sem a necessidade de pagamento a IBM, com objetivos de desenvolvimento, utilização, marketing ou distribuição de programas aplicativos, em conformidade com a interface de programação do aplicativo para a plataforma operacional para a qual os programas de exemplo são criados.

Estes exemplos não foram testados completamente em todas as condições. Portanto, a IBM não pode garantir ou implicar a confiabilidade, manutenção ou função destes programas. Você pode copiar, modificar e distribuir estes exemplos de programas de qualquer maneira sem pagamento à IBM, com objetivos de desenvolvimento, utilização, marketing ou distribuição de programas aplicativos em conformidade com interfaces de programação de aplicativos da IBM.

Esta edição se aplica à versão 1.3.1 do IBM OS/2 Warp Developer Kit, Java(TM) 2 Technology Edition e a todos os releases e modificações subseqüentes, até que seja indicado de forma diferente em novas edições.

Este produto é baseado, em parte, no trabalho do Free Type Project. Para obter mais informações sobre o Free Type Project, consulte o endereço: http://www.freetype.org

## 9.0 MARCAS

Os termos a seguir são marcas da International Business Machines Corporation nos Estados Unidos e/ou em outros países:

IBM
OS/2
OS/2 Warp
NetView
WebExplorer

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

Microsoft e Windows NT são marcas da Microsoft Corporation nos Estados Unidos e/ou em outros países e/ou regiões.

Intel e Pentium são marcas registradas da Intel Corporation nos Estados Unidos e em outros países.

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

[FIM DO MANUAL DE INSTALAÇÃO E CONFIGURAÇÃO]