### KIT DEL DESARROLLADOR DE IBM(R) OS/2 WARP(R),
JAVA(TM) 2 TECHNOLOGY EDITION, 1.3.1
GUÍA DE INSTALACIÓN Y CONFIGURACIÓN

(c) Copyright IBM Corporation 1999, 2002. Reservados todos los derechos.

Nota: La información completa de copyright se incluye en la sección Avisos de este documento.

Esta guía proporciona información acerca del IBM OS/2 Warp Developer Kit, Java(TM) 2 Technology Edition, Versión 1.3.1 (Kit del desarrollador). Esta guía ofrece información sobre cómo preparar e instalar los componentes del Kit del desarrollador así como aspectos a tener en cuenta después de la instalación.

El Kit del desarrollador tiene soporte en los productos de OS/2(R) siguientes:

- OS/2 Warp 4 con FixPak 5 o posterior para los países o regiones con juego de caracteres de un solo byte (SBCS)
  o FixPak FX00505 para los países o regiones con juego de caracteres de doble byte (DBCS)
- OS/2 Warp Server para e-business
- Convenience Package para OS/2 Warp 4
- Convenience Package para OS/2 Warp Server para e-business
- Convenience Package 2 para OS/2 Warp 4
- Convenience Package para OS/2 Warp Server para e-business
- WorkSpace On-Demand Versión 2.0, con el FixPak más reciente

Nota: Para obtener información acerca de los requisitos de los FixPak o el sitio web de los FixPak de IBM, consulte la sección FixPaks.

Para obtener el número de versión y de nivel de compilación de IBM del Kit del desarrollador, escriba lo siguiente en la línea de mandatos:

             java -version

### Contenido

- 1.0 ANTES DE EFECTUAR LA INSTALACIÓN
- 1.1 Requisitos de la instalación
- 1.2 Extracción de los archivos para la instalación
- 1.3 Consideraciones sobre las particiones del sistema de archivos
- 1.4 FixPaks
- 1.5 Instalación del Kit del desarrollador como JVM por omisión

- 1.5.1 Información de la variable de entorno JAVA_HOME

- 1.6 Información acerca de Netscape Communicator
- 1.7 Unión de archivos partidos
- 2.0 INSTALACIÓN DEL KIT DEL DESARROLLADOR
- 2.1 Método de instalación de la GUI

- 2.1.1 Método de escritorio
- 2.1.2 Método de línea de mandatos
- 2.1.3 Componentes que no puede seleccionar durante la instalación
- 2.1.4 Recuperación de una instalación anómala
- 2.1.5 Nivel correcto de FixPak, pero no se puede instalar

- 2.2 Método de instalación desatendida (CID)
  - 2.2.1 Modificación del archivo de respuestas CID
  - 2.2.1.1 Unidades de instalación de componentes
  - 2.2.2 Inicio de la instalación desatendida
  - 2.2.3 Código de retorno "Successful" de instalación CID e instalación anómala
  - 2.2.4 Nivel correcto de FixPak, pero no se puede instalar
- 2.3 Consideraciones acerca de la instalación de NVDM/2

- 2.3.1 Mandato estático en el perfil NVDM/2

- 2.4 Instalación del Kit del desarrollador en WorkSpace On-Demand 2.0

- 2.4.1 Instalación del Kit del desarrollador en un servidor WorkSpace On-Demand 2.0
- 2.4.2 Instalación del Kit del desarrollador en un cliente WorkSpace On-Demand 2.0

- 2.4.2.1 Instalación desatendida en un cliente WorkSpace On-Demand 2.0
- 2.4.2.2 Modificación de los archivos CONFIG.SYS para los clientes WorkSpace On-Demand 2.0
- 2.4.2.3 Modificación de los archivos FIT y concesión de acceso a clientes WorkSpace On-Demand 2.0
- 2.4.2.4 Asignación del directorio USER_HOME para clientes WorkSpace On-Demand 2.0
- 2.4.2.5 Habilitación de fonts para clientes WorkSpace On-Demand 2.0
- 2.4.2.6 Instalación del plug-in de Netscape Communicator para clientes WorkSpace On-Demand 2.0
- 2.4.2.7 Instalación de componentes adicionales del Kit del desarrollador en el cliente WorkSpace On-Demand 2.0
- 2.4.2.8 Ejecución de ejemplos de Java desde un cliente WorkSpace On-Demand 2.0
- 2.4.2.9 Emisión de un Trust en clientes WorkSpace On-Demand 2.0
- 2.4.2.10 El compilador JIT y un cliente WorkSpace On-Demand 2.0
- 2.4.2.11 Creación de una aplicación pública del Panel de control del plug-in de Java para el cliente WorkSpace On-Demand 2.0

- 2.5 Método de instalación de la IPL remota

- 2.5.1 Creación de archivos de respuestas
- 2.5.2 Modificación del archivo JAVA131.RSP
- 2.5.3 Actualización de archivos para Feature Install
- 2.5.4 Inicio de la instalación de IPL remota
- 2.5.5 Ejecución de ejemplos de Java desde un cliente de IPL remota

- 2.5.5.1 Emisión de un trust en un cliente de IPL remota

- 3.0 DESPUÉS DE LA INSTALACIÓN
- 3.1 Fuentes de información adicionales
- 3.2 Instalación de componentes adicionales
- 3.3 Consideraciones acerca de los controles TextField y TextArea de AWT
- 3.4 No se da soporte a la modificación del archivo de propiedades de font
- 3.5 Problemas de hora en applets de Java
- 3.6 Utilización del soporte de área alta de memoria para aumentar el tamaño de pila de Java

- 3.6.1 Habilitación de OS/2 HMS
- 3.6.2 Habilitación del tamaño de pila de Java para utilizar OS/2 HMS
- 3.6.3 Limitaciones al utilizar OS/2 HMS

- 3.7 Clase BigDecimal ampliada
- 3.8 Los plug-in de Java
  - 3.8.1 Instalación del plug-in de Java después de instalar Netscape Communicator
  - 3.8.2 Instalación del plug-in de Java después de instalar IBM Web Browser para OS/2
  - 3.8.3 El panel de control del plug-in de Java
- 3.9 Desactivación del compilador JIT
- 3.10 Cambios en los nombres de archivo
- 3.11 Configuración del visor de applets
- 3.12 Especificación de opciones de Java y propiedades del sistema
- 3.13 RMI a través de IIOP

- 3.13.1 El compilador IDL-to-Java

- 3.13.1.1 Restricciones del compilador IDL-to-Java
- 3.13.1.2 Problemas conocidos del compilador IDL-to-Java

- 3.13.2 Información adicional
- 3.13.3 Términos de RMI-IIOP

- 3.14 JAAS (Servicio de autenticación y autorización de Java)

- 3.14.1 Diferencia entre la versión de JAAS de IBM y Sun
- 3.14.2 Instalación básica

- 3.15 Información sobre programación JNI
- 3.16 Consideraciones acerca del rendimiento
- 4.0 PAQUETES DE FONTS ADICIONALES
- 4.1 Instalación de paquetes de fonts adicionales

- 4.1.1 Método de instalación CID
- 4.1.2 Método de la paleta de fonts

- 5.0 INFORMACIÓN ACERCA DEL JUEGO DE CARACTERES DE DOBLE BYTE (DBCS)
- 5.1 Omisión de texto en el panel de texto, o es demasiado largo en países o regiones con juego de caracteres de doble byte (DBCS)
- 5.2 En los sistemas chinos se deben instalar los fonts TrueType
- 5.3 Arreglos temporales del programa y FixPaks para sistemas DBCS
- 5.4 Control de la visualización de caracteres numéricos de árabe
- 5.5 Valores del entorno japonés en la versión japonesa de OS/2 Warp 4
- 5.6 Fonts necesarios en la versión japonesa de OS/2 Warp
- 5.7 Mejora de la calidad de los fonts en OS/2 Warp Server para e-business
- 6.0 DESINSTALACIÓN DEL KIT DEL DESARROLLADOR
- 6.1 Método de escritorio
- 6.2 Método de línea de mandatos de OS/2
- 6.3 Desinstalación del Kit del desarrollador desde WorkSpace On-Demand 2.0
- 6.4 Cómo realizar una desinstalación desatendida
- 6.5 Eliminación del Kit del desarrollador como JVM por omisión
- 7.0 LIMITACIONES CONOCIDAS
- 8.0 AVISOS
- 9.0 MARCAS REGISTRADAS

## 1.0 ANTES DE EFECTUAR LA INSTALACIÓN

El Kit del desarrollador consta de dos paquetes: un Entorno de ejecución y un Kit de utilidades. El entorno de ejecución incluye componentes tales como JAAS (Servicio de autenticación y autorización de Java), la ejecución de RMI-IIOP y el compilador JIT (Just-in-Time). El Kit de utilidades contiene componentes tales como un kit de utilidades, el Depurador ICAT (Interactive Code Analysis Tool) y Ejemplos.

Nota: No puede instalar el kit de utilidades a menos que también instale el entorno de ejecución.

Si ha bajado archivos partidos, consulte la sección Unión de archivos partidos para obtener información sobre cómo unir archivos partidos y obtener un archivo instalable.

Antes de instalar el Kit del desarrollador, haga una copia del archivo CONFIG.SYS actual. Esto garantiza que pueda regresar al entorno original si se producen problemas durante la instalación.

Las referencias incluidas en esta guía son las siguientes:

- OS/2 Warp 4 hace referencia al sistema operativo de cliente OS/2 Warp 4 y al cliente WorkSpace On-Demand (2.0 ó 3.0).
- OS/2 Warp Server hace referencia a los sistemas operativos OS/2 Warp Server para e-business y al servidor WorkSpace On-Demand (2.0 ó 3.0).
- Java 1.1.x hace referencia a Java 1.1.1 para OS/2, Java 1.1.4 para OS/2 Warp, Kit del desarrollador de OS/2 Warp de IBM, Java(TM) Edition, 1.1.6, Kit del desarrollador de OS/2 Warp, Java Edition, 1.1.7 y Kit del desarrollador IBM OS/2 Warp, Java Edition, 1.1.8
- Los objetos específicos de este producto se denominan objetos de Java 1.3.1.
- Netscape Communicator, a menos que se especifique directamente, hace referencia a Netscape Communicator 4.04 y posteriores.

### 1.1 Requisitos de la instalación

Requisitos de espacio en disco:

En la lista siguiente se muestran los componentes del Kit del desarrollador y los tamaños de los archivos después de la instalación. Asegúrese de que dispone de suficiente espacio en disco antes de comenzar la instalación.

Componente | Tamaño
--- | ---
Entorno de ejecución | 25,0 MB
Kit de utilidades | 35,0 MB
Ejemplos | 5,0 MB
Depurador ICAT para Java OS/2 | 13,0 MB
Total instalado Tamaño | 65,0 MB
Lista de los componentes del Kit del desarrollador y los tamaños de los archivos después de la instalación.

Requisitos de hardware:

- Un mínimo de 32 MB de RAM (memoria de acceso aleatorio) suele proporcionar los mejores resultados al ejecutar aplicaciones del Kit del desarrollador.
- Se recomienda un mínimo de 48 MB de RAM para las applets que se ejecuten en un navegador que utilice el plug-in de Java.
- IBM recomienda utilizar un procesador Intel(R) Pentium(R) (o equivalente) o posterior para todos los sistemas OS/2.
- La especificación del Kit del desarrollador requiere la modalidad de 256 colores (o superior). El Kit del desarrollador no da soporte a aplicaciones y applets de Java que utilicen AWT (Abstract Window Toolkit) en modalidad de 16 colores.

Requisitos de software:

- Feature Install 1.2.3 o posterior. Puede bajar la versión de Feature Install más reciente del Catálogo de opciones de software de características de IBM. Antes de bajar Feature Install, compruebe los requisitos de instalación para Feature Install.
- Netscape Communicator 4.0.4. o posterior.
- TCP/IP versión 4.3. para OS/2 o posterior. Puede bajar este producto del sitio Catálogo de opciones de software de características de IBM.

### 1.2 Extracción de los archivos para la instalación

Para descomprimir un archivo ZIP autoextraíble, siga los siguientes pasos:

1. Cree un subdirectorio (si todavía no lo ha hecho) para almacenar el archivo ZIP autoextraíble en su disco duro.
2. Ejecute el archivo escribiendo el nombre del archivo y especificando el conmutador "-o" en una línea de mandatos dentro del directorio en el que descargó el archivo.

   Por ejemplo, para el Kit del desarrollador, escriba lo siguiente:

       javaintk.exe -o

   Para el entorno de ejecución, escriba lo siguiente:

       javainrt.exe -o

Si ha bajado archivos partidos y debe unirlos en un solo archivo instalable, consulte la sección Unión de archivos partidos. Puede encontrar información acerca de la instalación del Kit del desarrollador en la sección Instalación del Kit del desarrollador.

### 1.3 Consideraciones sobre las particiones del sistema de archivos

Al instalar el Kit del desarrollador, se aplican las consideraciones siguientes:

- Si instala el kit de utilidades, el entorno de ejecución se selecciona e instala automáticamente en la misma unidad que el Kit de utilidades.
- El kit de utilidades y los ejemplos deben instalarse en una unidad HPFS (sistema de archivos de alto rendimiento) o JFS sistema de archivos de diario).
- Los componentes Entorno de ejecución y Depurador ICAT pueden instalarse en una partición FAT (Tabla de asignación de archivos).
- Si no instala el Kit de utilidades, el Entorno de ejecución puede instalarse en una partición FAT, HPFS o JFS. Para obtener un mejor rendimiento, instálelos en una partición HPFS o JFS, que soportan nombres de archivo largos.

Si únicamente tiene un disco duro con una única partición FAT, dispone de las siguientes opciones:

- Dejar el sistema tal cual e instalar únicamente el componente Ejecución y, opcionalmente, el componente Depurador ICA.
- Formatear la partición FAT como HPFS o JFS y volver a instalar todo el software.
- Adquirir un programa de partición de disco como, por ejemplo, PartitionMagic. Con el espacio suficiente, un programa de partición de disco reduce el tamaño de la partición actual (unidad C) y crea una nueva partición (unidad lógica D), la cual se puede formatear para HPFS.

Nota: En este documento, el término "partición" hace referencia a cualquier unidad física o lógica.

### 1.4 FixPaks

Se aplican las consideraciones siguientes:

Nivel de FixPak de sistema necesario para OS/2 Warp 4
SBCS | DBCS
FixPak 5 o posterior | FixPak FX00505
Consideraciones de nivel de FixPak.

Para utilizar el símbolo del euro en las aplicaciones y applets de Java
OS/2 Warp 4 | FixPak 6 o posterior
Niveles de FixPak para la utilización del euro.

Nota: La visualización y la conversión de código del euro están soportadas en las páginas de códigos que contienen el euro.

Si desea utilizar el símbolo del euro, necesita la versión del juego de caracteres de un solo byte (SBCS) de OS/2. El teclado americano internacional, UX103, da soporte a la entrada del euro, pero el teclado inglés estándar no. En cualquier caso, si no tiene un teclado que dé soporte a la entrada del símbolo del euro, puede visualizarlo, pero no puede entrarlo.

Para obtener información sobre cómo bajar un determinado FixPak, visite el sitio web de FixPaks de IBM:
http://ps.software.ibm.com/pbin-usa-ps/getobj.pl?/pdocs-usa/otherservices.html

### 1.5 Instalación del Kit del desarrollador como JVM por omisión

La instalación del Kit del desarrollador como JVM (Máquina virtual de Java) le permite ejecutar el Kit del desarrollador desde una línea de mandatos por omisión. Puede hacer que el Kit del desarrollador sea la JVM por omisión de forma permanente o temporal. Consulte las siguientes secciones para obtener más información.

#### Convertir de modo permanente el Kit del desarrollador en la JVM por omisión

Para hacer que el Kit del desarrollador sea de modo permanente la JVM por omisión, puede:

- Seleccionarlo durante la instalación de la GUI.
- Realizar el cambio manualmente, si ya ha instalado el Kit del desarrollador (Versión 1.3), modificando la sentencia PATH del archivo CONFIG.SYS.

Para modificar la sentencia PATH, añada x:\JAVA131\JRE\BIN; a la sentencia PATH del archivo CONFIG.SYS.

Si decide mantener una versión anterior de Java como JVM por omisión, no seleccione el recuadro de selección durante la instalación de la GUI, o bien, si el Kit del desarrollador ya está instalado, no añada el directorio x:\JAVA131\JRE\BIN; a la sentencia PATH del archivo CONFIG.SYS. Si ya tiene instalada una versión 1.1.x de Java como la JVM por omisión, ésta seguirá siendo la JVM por omisión.

Nota: Puede mejorar el rendimiento eliminando las referencias a releases anteriores de Java del archivo CONFIG.SYS. Sin embargo, se conoce la existencia de aplicaciones que darán error si instala el Kit del desarrollador (versión 1.3.x) como su JVM por omisión.

#### Utilización temporal del Kit del desarrollador para una sesión de Java

Si el Kit del desarrollador no está instalado como la JVM por omisión, pero si desea utilizarlo en una sesión de Java, modifique la sentencia PATH. Por ejemplo,

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

donde x es la unidad en la que se ha instalado el Kit del desarrollador.

Puede mejorar el rendimiento si modifica las sentencias BEGINLIBPATH y CLASSPATH del siguiente modo:

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

         SET CLASSPATH=

Nota: La CLASSPATH está establecida en un valor null (nulo) debido a que la JVM del Kit del desarrollador no suele necesitar la CLASSPATH para localizar archivos de clases del sistema; CLASSPATH se utiliza para los archivos de clases de aplicaciones.

#### Utilización temporal de la JVM de Java 1.1.x para una sesión de Java

Si el Kit del desarrollador 1.3.x está instalado como una JVM por omisión, pero si desea utilizar una JVM de Java 1.1.x en una sesión de Java, modifique la sentencia PATH. Por ejemplo,

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

donde x es la unidad en la que se ha instalado el Kit del desarrollador 1.1.x.

Si elimina todas las referencias a JAVA11 del archivo CONFIG.SYS, tiene que modificar las sentencias PATH, BEGINLIBPATH y CLASSPATH del siguiente modo:

        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: La CLASSPATH está establecida en los archivos de la biblioteca Java 1.1.x. El valor de CLASSPATH correspondiente a cada sistema diferirá.

Para poder ejecutar el Kit del desarrollador y el plug-in de Java, debe modificar la sentencia PATH tal como se ha mostrado anteriormente.

#### 1.5.1 Información de la variable de entorno JAVA_HOME

Si ya ha instalado el Kit del desarrollador (versión 1.3) como JVM por omisión (Máquina virtual de Java) y:

- ha añadido manualmente una variable de entorno JAVA_HOME al archivo CONFIG.SYS para un nivel anterior del Kit del desarrollador
- tiene los archivos de mandatos que establecen la variable de entorno JAVA_HOME

Debe llevar a cabo lo siguiente:

- Quitar o actualizar la variable de entorno JAVA_HOME del archivo CONFIG.SYS.
- Modificar los archivos de mandatos quitando o modificando las sentencias que definen la variable de entorno JAVA_HOME.

### 1.6 Información acerca de Netscape Communicator

La lista siguiente contiene información acerca de la utilización del Kit del desarrollador y Netscape Communicator Versión 4.04 y superiores:

- #### Ejecución de Netscape Communicator mientras se instala el Kit del desarrollador

  El Kit del desarrollador no se podrá instalar si está ejecutando Netscape Communicator mientras ejecuta el mandato INSTALL. Debe cerrar Netscape Communicator y luego ejecutar el mandato INSTALL.

- #### Netscape Communicator Versión 4.04 y el compilador JIT

  Para ejecutar applets utilizando Netscape Communicator Versión 4.04, debe tener activado el compilador JIT (Just-in-Time). Sin embargo, si desea utilizar Netscape Communicator Versión 4.04 y tener desactivado el JIT, necesitará el último nivel de actualización de Netscape Communicator Versión 4.04. Para obtener información acerca del último nivel de actualización, visite el sitio web siguiente:

  http://ps.software.ibm.com

- #### Selección fantasma durante la instalación y Netscape Communicator Versión 4.61

  Si tiene Netscape Communicator Versión 4.61 y no ha bajado la actualización más reciente, es posible que aparezcan recuadros de selección "fantasma" durante la instalación. Aunque estos recuadros de selección "fantasma" no afectan a la instalación del Kit del desarrollador, es posible que quiera bajar la actualización más reciente desde el sitio web siguiente:
  http://ps.software.ibm.com

- Si instala el Kit del desarrollador de Java 1.3 y, a continuación, elimina las entradas JAVA11 del archivo CONFIG.SYS, o bien, elimina la versión 1.1.x del Kit del desarrollador del sistema, no puede ejecutar applets cuyas páginas HTML tengan el código <APPLET>, si se inician desde un navegador Netscape 4.x. Para ejecutar estas applets desde un navegador Netscape 4.x, debe instalar el plug-in de Java del Kit del desarrollador 1.3 y convertir el archivo HTML de applets para utilizar el plug-in de Java. Las applets iniciadas desde IBM Web Browser para OS/2 funcionan sin que sea necesario llevar a cabo ningún cambio, incluso si no se ha instalado Java 1.1.x JVM en el sistema.

### 1.7 Unión de archivos partidos

Puede unir los archivos partidos utilizando el programa de utilidad de fusión o bien manualmente desde una línea de mandatos. Las subsecciones siguientes ofrecen información sobre cómo unir los archivos partidos y crear un archivo instalable.

Antes de empezar, asegúrese de:

- Que ha bajado todos los archivos partidos de un determinado componente y que ha utilizado el nombre de archivo correcto. Si no ha bajado todas las partes de un paquete o ha cambiado los nombres de archivo de las partes al bajarlas, el programa de utilidad de fusión (Merge Utility) muestra un mensaje de error y el paquete no se vuelve a crear.
- Que ha especificado todos los nombres de archivo y de colocarlos en el orden correcto. Si ha cambiado los nombres de archivo al bajarlos, especifique los nombres de archivo que ha utilizado.
- Que el nombre del archivo en el que combina los archivos sea el nombre de archivo completo del paquete original. (Por ejemplo, el nombre de archivo completo del Entorno de ejecución es javainrt.exe.) De esta forma, el programa de utilidad de instalación reconocerá el archivo.

#### Unión de archivos partidos utilizando el programa de utilidad de fusión

Antes de empezar el proceso de unión de los archivos partidos, debe bajar el programa de utilidad de unión al mismo directorio que los archivos partidos que ha bajado. (El nombre de archivo es joiner.exe.) El programa de utilidad de unión contiene el programa de utilidad de fusión (Merge Utility), que permite unir los archivos partidos y crear un archivo instalable. El programa de utilidad de unión puede bajarse de la misma página que los componentes del Kit del desarrollador en el Catálogo de opciones de software.

Escriba `joiner` en una línea de mandatos dentro del directorio donde ha bajado el programa de utilidad de unión. Este mandato extrae el programa de utilidad de fusión (merge.exe) y los archivos de datos necesarios. El programa de utilidad de fusión se utiliza para unir los archivos partidos.

Escriba `merge` en una línea de mandatos dentro del directorio en el que ha bajado el programa de utilidad de unión. De este modo se volverán a crear los paquetes que se habían dividido en varios archivos. Para instalar el archivo, consulte la sección Instalación del Kit del desarrollador.

#### Unión manual de los archivos partidos desde una línea de mandatos

1. Asegúrese de que todos los archivos partidos del componente que desea instalar se han bajado al mismo directorio.
2. En una línea de mandatos (dentro del directorio donde ha bajado los archivos partidos), escriba los nombres de los archivos partidos y el nombre del archivo completo. Por ejemplo, si quiere unir los archivos partidos del Entorno de ejecución, escriba lo siguiente:

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

De este modo se volverán a crear los paquetes que se habían dividido en varios archivos. Para instalar el archivo, consulte la sección Instalación del Kit del desarrollador.

## 2.0 INSTALACIÓN DEL KIT DEL DESARROLLADOR

En las siguientes secciones se proporcionan instrucciones e información sobre la instalación del Kit del desarrollador. Antes de instalar el Kit del desarrollador o los componentes asociados al mismo, lea la sección Antes de efectuar la instalación para obtener información sobre la extracción de los archivos y los requisitos de instalación.

### 2.1 Método de instalación de la GUI

Puede instalar el Kit del desarrollador mediante el método de escritorio o el método de línea de mandatos. Consulte las siguientes secciones para ver las instrucciones.

#### 2.1.1 Método de escritorio

Nota: Si Netscape Communicator se está ejecutando mientras se instala el Kit del desarrollador, la instalación no se realizará correctamente. Debe concluir Netscape Communicator y después iniciar el proceso de instalación.

Para realizar la instalación utilizando el objeto INSTALL.EXE, siga los pasos siguientes:

1. Abra la carpeta Sistema OS/2.
2. Abra el objeto Unidades.
3. Abra la unidad de la que se han extraído los archivos del Kit del desarrollador.
4. Abra la carpeta de la que se han extraído los archivos del Kit del desarrollador.
5. Efectúe una doble pulsación sobre el objeto INSTALL.EXE para iniciar el programa de instalación.

El mandato INSTALL.EXE muestra una Interfaz gráfica de usuario (GUI) con botones que especifican los idiomas en los que puede instalar el programa. Pulse el idioma que prefiere y el programa de instalación le indicará los pasos a seguir.

Se crea una carpeta Kit del desarrollador para OS/2 en la carpeta Programas en OS/2 Warp 4 y en el escritorio para todas las plataformas soportadas.

Una vez finalizada la instalación, si desea borrar el directorio de donde se han extraído los archivos del Kit del desarrollador, seleccione el objeto DELINST.CMD de la carpeta Kit del desarrollador. Los archivos y subdirectorios del Kit del desarrollador se eliminarán del directorio de donde se han extraído. Los archivos y subdirectorios que no se hayan extraído del Kit del desarrollador no se borran. También puede eliminar manualmente los archivos bajados.

#### 2.1.2 Método de línea de mandatos

Nota: Si Netscape Communicator se está ejecutando mientras se instala el Kit del desarrollador, la instalación no se realizará correctamente. Debe concluir Netscape Communicator y después iniciar el proceso de instalación.

Para iniciar la instalación, asegúrese de que se encuentra en el directorio de donde se han extraído los archivos del Kit del desarrollador. En la línea de mandatos de OS/2, escriba:

         INSTALL

El mandato install muestra una GUI con botones que especifican los idiomas en los que puede instalar el programa. Pulse el idioma que desee y el programa de instalación le indicará los pasos a seguir.

Se crea una carpeta Kit del desarrollador para OS/2 en la carpeta Programas en OS/2 Warp 4 y en el escritorio para todas las plataformas soportadas.

Una vez finalizada la instalación, si desea borrar el directorio de donde se han extraído los archivos del Kit del desarrollador, seleccione el objeto DELINST.CMD de la carpeta Kit del desarrollador. Los archivos y subdirectorios del Kit del desarrollador se eliminarán del directorio de donde se han extraído. Los archivos y subdirectorios que no se hayan extraído del Kit del desarrollador no se borran. También puede eliminar manualmente los archivos bajados.

#### 2.1.3 Componentes que no puede seleccionar durante la instalación

Si utiliza la GUI para instalar el Kit del desarrollador y no puede seleccionar componentes, es posible que no haya bajado y extraído el archivo ZIP que contiene el componente que desea. Vuelva a la página Catálogo de opciones de software de características y baje el archivo ZIP autoextraíble que necesite.

Todos los componentes del Kit del desarrollador requieren que baje e instale el componente Entorno de ejecución (o que haya instalado previamente el componente Entorno de ejecución) y que reinicie el sistema.

#### 2.1.4 Recuperación de una instalación anómala

Si se producen anomalías durante la instalación del Kit del desarrollador, compruebe y suprima los objetos que queden de la instalación. Si no suprime estos objetos de la instalación, las futuras instalaciones podrían ser anómalas, y aparecería un mensaje indicando que uno o más componentes no se han instalado porque el objeto es de sólo lectura u otro proceso lo está utilizando.

Para una instalación CID (Configuración, Instalación y Distribución), el icono del objeto de instalación es un recuadro de color azul con un lazo rojo que aparece en el escritorio. Para una instalación atendida, el objeto se encuentra en la carpeta x:\os2\install\ (donde x es la unidad de arranque). Para suprimir el objeto, pulse el mismo con el botón derecho del ratón y, a continuación, pulse Suprimir en el menú.

De forma alternativa, vaya al directorio que contiene el objeto y suprima todo el árbol de directorios. El directorio se denomina "Objeto object" o "Java 1.3 para OS/2" dependiendo de cuándo se hayan producido las anomalías en la instalación.

Después de suprimir el objeto de instalación, concluya y rearranque el sistema.

#### ¿No se puede eliminar el objeto de instalación?

Si, después de seguir las instrucciones indicadas anteriormente, el objeto de instalación no se ha eliminado, haga lo siguiente:

1. Vaya a una línea de mandatos de OS/2.
2. Vaya a la unidad de arranque y, a continuación, vaya al directorio os2\install.
3. Elimine el directorio de Java 1.3.1 para OS/2 y todos los subdirectorios.
4. Reinicie el sistema.

#### 2.1.5 Nivel correcto de FixPak, pero no se puede instalar

Si está seguro de que su sistema cumple los niveles de FixPak necesarios, pero no puede instalar debido a la comprobación automatizada de FixPak, puede inhabilitar la comprobación automatizada de FixPak. Para hacerlo, utilice uno de los siguientes métodos:

Método Uno:

1. Edite el archivo CONFIG.SYS y añada la sentencia JAVANOFPK=YES.
2. Reinicie el sistema y vuelva a realizar el proceso de instalación del Kit del desarrollador.

Método Dos:

1. Desde el directorio donde ha ejecutado los archivos autoextraíbles, vaya al directorio del idioma que desee.
2. Edite el archivo CHECK.CMD. Busque la sentencia:

            disablecheck="NO"

   Cambie "NO" por "YES". (Esta sentencia se encuentra en la línea 12 o cerca de la línea 12).
3. Vuelva al directorio donde ha ejecutado los archivos autoextraíbles y ejecute de nuevo los archivos.

### 2.2 Método de instalación desatendida (CID)

Las instalaciones desatendidas o CID (Configuración, Instalación y Distribución) del Kit del desarrollador las maneja una interfaz de línea de mandatos para Feature Install (CLIFI) y pueden tardar entre 15 y 20 minutos, o quizás más. Después de que finalice el programa de instalación se debe rearrancar el sistema para completar la instalación.

CLIFI necesita dos archivos de respuestas: el archivo de respuestas del Kit del desarrollador (JAVA131.RSP) y un archivo de respuestas personalizado en el que los usuarios pueden modificar las selecciones por omisión. El archivo CID.RSP se incluye en el paquete de instalación como ejemplo de archivo de respuestas personalizado; este archivo y el archivo CID.CMD deben modificarse si se desea realizar instalaciones desatendidas.

Nota: Se necesita Feature Install versión 1.2.3 o posterior para las instalaciones desatendidas (CID). Además, si Netscape Communicator se está ejecutando mientras se instala el Kit del desarrollador, la instalación no se realizará correctamente. Debe concluir Netscape Communicator y después iniciar el proceso de instalación.

#### 2.2.1 Modificación del archivo de respuestas CID

El archivo CID.RSP contiene variables que le permiten seleccionar los componentes que se deben instalar y la unidad y directorio de destino. Por omisión, el archivo CID.RSP instalará todos los componentes del Kit del desarrollador. Puede modificar este archivo de respuestas para seleccionar los componentes que desea instalar. Asegúrese de bajar y extraer todos los archivos que necesite antes de iniciar la instalación. Además, si instala el Kit de utilidades, instale también el componente Entorno de ejecución aunque ya esté instalado.

En la tabla siguiente se indican los componentes que se pueden seleccionar y los nombres de las variables:

Componente | Variable
Entorno de ejecución | JV13Runtime
Kit de utilidades | JV13Toolkit
Ejemplos | JV13Samples
Depurador ICAT para Java OS/2 | JV13Debugger
Lista de los componentes instalables y nombres de variable.

En el archivo CID.RSP, establezca "selection=1" para cada componente que desee instalar y establezca "selection=0" para cada componente que no desee instalar. Por ejemplo, para:

- Instalar los componentes Entorno de ejecución y Depurador ICAT de OS/2
- Configurar el plug-in de Java para Netscape 4.x
- Configurar el plug-in de Java para IBM Web Browser para OS/2
- Instalar el Kit del desarrollador como JVM por omisión
- No instale el componente Kit de utilidades ni Ejemplos

Establezca las variables siguientes tal como se muestra:

         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:

Esto es un ejemplo. Vea en el archivo CID.RSP los componentes específicos y sus variables asociadas. x es la unidad donde se instala el componente.

Hay una variable JV13xxConfig.Selection asociada con cada variable JV13xx.Selection. La variable JV13xxConfig.Selection debe tener el mismo valor que la variable JV13xx.Selection. Por ejemplo, si establece JV13Toolkit.Selection=0, también debe establecer JV13ToolkitConfig.Selection=0 (donde xx es el nombre del componente).

En el ejemplo anterior, hay varias variables que deben establecerse para que el Kit del desarrollador se instale correctamente. Las variables y sus definiciones son:

JV13.LicenseAgree | Contrato de licencia Los valores de esta variable son DISAGREE y AGREE. Establezca esta variable en AGREE para indicar que ha leído el contrato de licencia y que está de acuerdo con los términos del mismo. Si no cambia la variable a AGREE, el Kit del desarrollador no se instalará.
JV13DefaultJVM.Selection | JVM Establezca esta variable en el valor "1" si desea instalar el Kit del desarrollador como la JVM por omisión.
JV13MZFiles | Plug-in para IBM Web Browser para OS/2 Establezca esta variable en el valor "1" si desea configurar el plug-in para IBM Web Browser para OS/2.
JV13NSFiles | Plug-in de Netscape Establezca esta variable en el valor "1" si desea configurar el plug-in de Netscape.

Para suprimir las ventanas de confirmación durante la instalación, establezca la siguiente variable como se indica a continuación:

        java13.continue=UNATTENDED

##### 2.2.1.1 Unidades de instalación de componentes

El Kit de utilidades se instala en el directorio \JAVA131 en la unidad destino. Si instala el Kit de utilidades, el componente Entorno de ejecución se instala automáticamente en la misma unidad que el Kit de utilidades. El componente Entorno de ejecución es un requisito previo para los componentes Kit de utilidades, Ejemplos y Depurador.

La unidad de destino de los componentes Ejemplos e ICAT se especifica estableciendo la unidad en los valores deseados. Si el Kit del desarrollador existe en la unidad de destino, el programa de instalación lo reemplaza.

#### 2.2.2 Inicio de la instalación desatendida

El archivo CID.CMD contiene un mandato CLIFI de ejemplo para una desatendida (CID). El proceso de instalación se ha modificado a fin de incluir una instalación multilingüe; por lo tanto, debe especificar la variable de su idioma en el archivo CID.RSP. Las variables de idioma son las siguientes:

Idioma | Variable de idioma
Inglés | en
Francés | fr
Alemán | de
Italiano | it
Japonés | jp
Portugués, versión de Brasil | br
Chino simplificado | cn
Español | es
Chino tradicional | tw
Idioma y la variable de idioma asociada con el mismo.

El mandato CLIFI también se puede entrar como un mandato de una sola línea en un indicador de mandatos de OS/2, tal como se muestra a continuación:

         clifi /a:c /r2:cid.rsp /r:xx\JAVA131.rsp /b:c: /s:d:\tmp\xx

         /l1:ciderr.log /l2:cidhist.log

Utilice la siguiente lista de variables como referencia cuando establezca las variables en los archivos mencionados anteriormente.

donde:

/r2 | representa la unidad, vía de acceso y el nombre del archivo de respuestas del usuario
/r | Especifica la ubicación completa del archivo de respuestas de Feature Install.
xx | Especifica la variable de idioma preferido.
/b | Especifica la unidad de arranque.
/s | Especifica la ubicación completa de los archivos extraídos del Kit del desarrollador.
/l1 y /l2 | Especifican las ubicaciones completas de los archivos de anotaciones cronológicas opcionales. Consulte estos archivos, además del archivo \os2\install\wpinstal.log en la unidad de arranque, si se producen problemas durante la instalación.

Para suprimir las ventanas de confirmación durante la instalación, establezca la siguiente variable como se indica a continuación:

        java13.continue=UNATTENDED

#### 2.2.3 Código de retorno "Successful" de instalación CID e instalación anómala

Si ha recibido un código de retorno "successful" de CID después de instalar el Kit del desarrollador, pero la instalación no se ha realizado correctamente, la causa podría ser:

- No ha modificado el archivo de respuestas para que aparezca "AGREE" después de la variable Java13LicenseAgree.
- El sistema no tiene el nivel correcto de FixPak.

Se recomienda que los administradores de CID lleven a cabo una comprobación de FixPak para garantizar que existe el nivel correcto de FixPak. (Consulte la sección FixPaks para obtener más información.) Puede utilizar el archivo check.cmd que se encuentra en el directorio x:\Java131 como ejemplo para escribir un script que compruebe los niveles de los FixPaks. (x:\ es la unidad donde está instalado el Kit del desarrollador.)

#### 2.2.4 Nivel correcto de FixPak, pero no se puede instalar

Si está seguro de que su sistema cumple los niveles de FixPak, pero no puede instalar debido a la comprobación automatizada de FixPak, puede inhabilitar la comprobación automatizada de FixPak. Para hacerlo, utilice uno de los siguientes métodos:

Método Uno:

1. Edite el archivo CONFIG.SYS y añada la sentencia JAVANOFPK=YES.
2. Reinicie el sistema y vuelva a realizar el proceso de instalación del Kit del desarrollador.

Método Dos:

1. Desde el directorio en el que ha ejecutado los archivos autoextraíbles, vaya al directorio del idioma que desee.
2. Edite el archivo CHECK.CMD. Busque la sentencia:

            disablecheck="NO"

   Cambie "NO" por "YES". (Esta sentencia se encuentra en la línea 12 o cerca de la línea 12).
3. Vuelva a ejecutar el proceso CID.

### 2.3 Consideraciones acerca de la instalación de NVDM/2

Una instalación CID de NVDM/2 (NetView(R) Distribution Manager/2) requiere la creación de un perfil y, a continuación, la creación y catalogación de un archivo de cambios. El perfil de NVDM/2 sólo le permite especificar un archivo de respuestas; sin embargo, la instalación desatendida del Kit del desarrollador necesita dos archivos de respuestas. Además, el uso de variables y argumentos en NVDM/2 es distinto del que se utiliza en Feature Install, que se utiliza para instalar el Kit del desarrollador.

Nota: Si Netscape Communicator se está ejecutando mientras se instala el Kit del desarrollador, la instalación no se realizará correctamente. Debe concluir Netscape Communicator y después iniciar el proceso de instalación.

En la siguiente sección se describen dos métodos que puede utilizar para instalar el Kit del desarrollador mediante NVDM/2.

#### 2.3.1 Mandato estático en el perfil de NVDM/2

En el perfil de NVDM/2, especifique todas las opciones CLIFI en la variable PARMS. Los parámetros deben estar en una sola línea y encerrados entre comillas dobles:

    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 requiere que modifique el perfil cada vez que se modifiquen los nombres del directorio de origen o de los archivos de anotaciones cronológicas. Como alternativa, puede sustituir estos valores por valores de variables específicas de la estación de trabajo, tal como se muestra a continuación:

         Program=c:\os2\install\clifi.exe

         Parms="/a:c /r2:$(ResponseFile) /r:$(SourceDir)\xx\JAVA131.rsp

         /b:c: /s:$(DirOrigen\xx) /l1:$(ArcAnot1) /l2:$(ArchAnot2)"

         ArchRespuestas=$(NombEstaciónTrab).rsp

         DirOrigen=d:\tmp

         ArchAnot1=$(NombEstaciónTrab).log

         ArchAnot2=$(NombEstaciónTrab).lg2

Este segundo método requiere un archivo de respuestas diferente para cada estación de trabajo y requiere que NombEstaciónTrab se defina correctamente.

Utilice la siguiente lista de variables como referencia cuando establezca las variables en los archivos mencionados anteriormente.

donde:

d: | Especifica el directorio temporal.
/r | Especifica la ubicación completa del archivo de respuestas de Feature Install.
xx | Especifica la variable de idioma preferido.
/b | Especifica la unidad de arranque.
/s | Especifica la ubicación completa de los archivos extraídos del Kit del desarrollador.
/l1 y /l2 | Especifican las ubicaciones completas de los archivos de anotaciones cronológicas opcionales. Consulte estos archivos, además del archivo \os2\install\wpinstal.log en la unidad de arranque, si se producen problemas durante la instalación.

### 2.4 Instalación del Kit del desarrollador en WorkSpace On-Demand 2.0

Nota: Si Netscape Communicator se está ejecutando mientras se instala el Kit del desarrollador, la instalación no se realizará correctamente. Debe concluir Netscape Communicator y después iniciar el proceso de instalación.

El producto WorkSpace On-Demand 2.0 incluye Java 1.1.6 para OS/2 Warp. Puede instalar el Kit del desarrollador (versión 1.3) en clientes y servidores WorkSpace On-Demand. El Kit del desarrollador coexiste con Java 1.1.x para OS/2 Warp. Consulte las siguientes secciones para instalar el Kit del desarrollador en servidores y clientes WorkSpace On-Demand y obtener información sobre cómo instalar el Kit del desarrollador como la JVM por omisión.

#### 2.4.1 Instalación del Kit del desarrollador en un servidor WorkSpace On-Demand 2.0

Para instalar el Kit del desarrollador en un servidor WorkSpace On-Demand, utilice la GUI. Consulte la sección Método de instalación de la GUI de esta guía para ver las instrucciones.

#### 2.4.2 Instalación del Kit del desarrollador en un cliente WorkSpace On-Demand 2.0

Para instalar el Kit del desarrollador en un cliente WorkSpace On-Demand, utilice una instalación desatendida (CID). Puede utilizar las instrucciones de la sección Método de instalación desatendida (CID) y utilizar los archivos CID.CMD y WSOD2.RSP que se incluyen en el paquete de instalación del Kit del desarrollador. Los pasos para la instalación se completan en un servidor WorkSpace On-Demand 2.0.

Nota: Si desea instalar el Kit del desarrollador como la JVM por omisión en los clientes WorkSpace On-Demand, deberá colocar las referencias a los archivos y directorios de `z:\JAVA131` antes que las referencias a `z:\JAVA11` que aparecen en el archivo CONFIG.SYS.

##### 2.4.2.1 Instalación desatendida en un cliente WorkSpace On-Demand 2.0

Siga estos pasos:

1. En el archivo CID.CMD, cambie `/r2:cid.rsp` por `/r2:wsod2.rsp` (donde `/r2` es la unidad, vía de acceso y nombre del archivo de respuesta de usuario).
2. Tal como se describe en la sección Inicio de la instalación desatendida de esta guía:
   - Sustituya `/s:d:\tmp\xx` del archivo CID.CMD por la unidad y el directorio donde ha desempaquetado el paquete de instalación (donde `xx` es la variable del idioma preferido).
   - Asegúrese de que `/b:z` del archivo CID.CMD señala a la unidad de arranque del cliente.
3. Verifique si las selecciones en los archivos WSOD2.RSP son las apropiadas para lo que desea instalar. El valor por omisión es seleccionar Entorno de ejecución; todos los demás componentes estarán deseleccionados. Asegúrese de bajar y extraer todos los archivos que necesite. Además, después de leer el contrato de licencia y de aceptar los términos del mismo, la variable de selección Java13.LicenseAgree debe establecerse en AGREE en el archivo WSOD2.RSP. Si no cambia esta variable a AGREE, el componente Entorno de ejecución no se instalará.
4. Ejecute el archivo actualizado CID.CMD escribiendo el nombre del archivo en una línea de mandatos.

Para completar la instalación desatendida, consulte las secciones siguientes.

##### 2.4.2.2 Modificación de los archivos CONFIG.SYS para los clientes WorkSpace On-Demand 2.0

Para habilitar el componente Entorno de ejecución del Kit del desarrollador, un administrador de WorkSpace On-Demand debe realizar las siguientes adiciones a los archivos CONFIG.SYS de los clientes WorkSpace On-Demand:

Añada lo siguiente:

`z:\JAVA131\jre\dll` | a la sentencia LIBPATH
`z:\JAVA131\jre\bin;` | a la sentencia SET PATH

Puede encontrar y editar el archivo CONFIG.SYS para los clientes WorkSpace On-Demand basándose en las dos opciones siguientes:

- En el servidor de un usuario específico, el archivo CONFIG.SYS se ubica en la siguiente unidad y directorio:

         [unidadrpl]:\ibmlan\rpl\machines\[nombre_cliente]\config.sys

- Para modificar el CONFIG.SYS por omisión de cada máquina creada utilizando la clase de máquina individual, el archivo CONFIG.SYS se ubica en la siguiente unidad y directorio:

         [unidadrpl]:\ibmlan\rpl\machines\BB20.xx\[clase_máquina]\config.sys

donde:

[unidadrpl] | Especifica la unidad donde está instalado el directorio RPL.
[nombre_cliente] | Especifica el nombre del cliente WorkSpace On-Demand.
xx | Especifica el código del país o la región.
[clase_máquina] | Especifica el nombre de la máquina.

##### 2.4.2.3 Modificación de los archivos FIT y concesión de acceso a clientes WorkSpace On-Demand 2.0

Para habilitar el componente Entorno de ejecución, un administrador de WorkSpace On-Demand debe realizar la siguiente adición a los archivos FIT (File Index Table) de los clientes WorkSpace On-Demand:

Añada lo siguiente:

         z:\JAVA131      BB20.xx\JAVA131

Puede encontrar y editar los archivos FIT para los clientes WorkSpace On-Demand basándose en las dos opciones siguientes:

- En el servidor de un usuario específico, el archivo [nombre_cliente].FIT se ubica en la unidad y el directorio siguientes:

         [unidadrpl]:\ibmlan\rpl\fits\[nombre_cliente].FIT

- Para modificar la FIT por omisión, el archivo DFBB20xx.FIT se ubica en la unidad y el directorio siguientes:

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

Un administrador de WorkSpace On-Demand también debe otorgar acceso de lectura y ejecución al directorio JAVA131 de los clientes WorkSpace On-Demand.

Ejecute los siguientes mandatos del Servidor de la LAN:

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

      NET ACCESS [unidadrpl]\ibmlan\rpl\bb20.xx\JAVA131 /APPLY

donde:

[unidadrpl] | Especifica la unidad donde está instalado el directorio RPL.
[nombre_cliente] | Especifica el nombre del cliente WorkSpace On-Demand.
xx | Especifica el código del país o la región.

##### 2.4.2.4 Asignación del directorio USER_HOME para clientes WorkSpace On-Demand 2.0

El directorio z:\JAVA13\JRE (directorio USER_HOME) debe tener acceso de lectura y grabación puesto que es donde se crean los archivos de propiedades del plug-in y de certificados de seguridad y donde se accede a los mismos. Por ejemplo, para especificar `z:\JAVA13_RW` como el directorio USER_HOME y otorgar acceso de lectura y grabación, añada lo siguiente al archivo FIT (se debe especificar en una sola línea):

         z:\JAVA13_RW      \\nombre_servidor\WRKFILES\nombre_cliente\JAVA_RW

Sustituya nombre_servidor y nombre_cliente por los nombres del servidor y el cliente WorkSpace On-Demand. z es la unidad donde ha instalado el Entorno de ejecución. También se puede entrar en el archivo FIT por omisión.

Además, un administrador de WorkSpace On-Demand debe añadir lo siguiente a los archivos OS2.INI para los clientes WorkSpace On-Demand. Las adiciones deben terminar con un valor nulo (NULL).

Añada lo siguiente:

         Application = Java131

         Key = USER_HOME

         Value = z:\JAVA13_RW

Consulte el Manual de WorkSpace On-Demand 2.0 para obtener información sobre cómo utilizar un editor INI o el mandato NET APPPARM para añadir entradas de archivos INI para los clientes WorkSpace On-Demand. Puede encontrar el archivo OS2.INI para los clientes WorkSpace On-Demand de una de las dos formas siguientes:

- Desde el servidor correspondiente a un determinado usuario:

           [unidadrpl]:\ibmlan\rpluser\[nombre_cliente]\os2\os2.ini

- Para modificar el OS2.INI por omisión de cada máquina creada utilizando la clase de máquina individual, el archivo OS2.INI se ubica en la siguiente unidad y directorio:

           [unidadrpl]:\ibmlan\rpl\machines\BB20.xx\[clase_máquina]\os2\os2.ini

donde:

z | Especifica la unidad donde está instalado el Entorno de ejecución correspondiente al cliente.
[unidadrpl] | Especifica la unidad donde está instalado el directorio RPL.
[nombre_cliente] | Especifica el nombre del cliente WorkSpace On-Demand.
xx | Especifica el código del país o la región.
[clase_máquina] | Especifica el nombre de la clase de máquina que utiliza un cliente WorkSpace On-Demand.

##### 2.4.2.5 Habilitación de fonts para clientes WorkSpace On-Demand 2.0

Para habilitar fonts del Entorno de ejecución, un administrador de WorkSpace On-Demand debe realizar las siguientes adiciones a los archivos OS2.INI de los clientes WorkSpace On-Demand. Todas las adiciones deben terminar con un valor nulo (NULL). z especifica la unidad donde está instalado el Entorno de ejecución del cliente.

Añada lo siguiente:

       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 el Manual de WorkSpace On-Demand 2.0 para obtener información sobre cómo utilizar un editor INI o el mandato NET APPPARM para añadir entradas de archivos INI para los clientes WorkSpace On-Demand. Puede encontrar el archivo OS2.INI para los clientes WorkSpace On-Demand basándose en las dos opciones siguientes:

- En el servidor de un usuario específico, el archivo OS2.INI se ubica en la unidad y el directorio siguientes:

         [unidadrpl]:\ibmlan\rpluser\[nombre_cliente]\os2\os2.ini

- Para modificar el OS2.INI por omisión de cada máquina creada utilizando la clase de máquina individual, el archivo OS2.INI se ubica en la siguiente unidad y directorio:

         [unidadrpl]:\ibmlan\rpl\machines\BB20.xx\[clase_máquina]\os2\os2.ini

donde:

[unidadrpl] | Especifica la unidad donde está instalado el directorio RPL.
[nombre_cliente] | Especifica el nombre del cliente WorkSpace On-Demand.
xx | Especifica el código del país o la región.
[clase_máquina] | Especifica el nombre de la clase de máquina que utiliza un cliente WorkSpace On-Demand.

##### 2.4.2.6 Instalación del plug-in de Netscape para clientes WorkSpace On-Demand 2.0

Para instalar el plug-in de Java para el navegador Netscape 4.x, un administrador de WorkSpace On-Demand debe copiar el archivo npjava.dll en el directorio del plug-in de Netscape 4.x de los clientes WorkSpace On-Demand. Para copiar el archivo, escriba el mandato siguiente:

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

Para instalar el plug-in de Java para IBM Web Browser para OS/2, copie el archivo npoji6.dll en el directorio del plug-in del navegador web de los clientes WorkSpace On-Demand. Para copiar el archivo, escriba el mandato siguiente:

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

donde:

d:\JavaTemp | Especifica la ubicación completa de los archivos descomprimidos del Entorno de ejecución.
[unidadrpl] | Especifica la unidad donde está instalado el directorio RPL.
xx | Especifica el código del país o la región.

Además, un administrador de WorkSpace On-Demand debe realizar la siguiente adición a los archivos OS2.INI para los clientes WorkSpace On-Demand. Todas las adiciones deben terminar con un valor nulo (NULL).

Añada lo siguiente:

         Application = Java Plug-in

         Key = JAVA_HOME

         Value = z:\JAVA131\jre

donde z especifica la unidad en la que se ha instalado el entorno de ejecución para el cliente.

Consulte el Manual de WorkSpace On-Demand 2.0 para obtener información sobre cómo utilizar un editor INI o el mandato NET APPPARM para añadir entradas de archivos INI para los clientes WorkSpace On-Demand. Puede encontrar el archivo OS2.INI para los clientes WorkSpace On-Demand de una de las dos formas siguientes:

- En el servidor de un usuario específico, el archivo OS2.INI se ubica en la unidad y el directorio siguientes:

         [unidadrpl]:\ibmlan\rpluser\[nombre_cliente]\os2\os2.ini

- Para modificar el OS2.INI por omisión de cada máquina creada utilizando la clase de máquina individual, el archivo OS2.INI se ubica en la siguiente unidad y directorio:

         [unidadrpl]:\ibmlan\rpl\machines\BB20.xx\[clase_máquina]\os2\os2.ini

donde:

[unidadrpl] | Especifica la unidad donde está instalado el directorio RPL.
[nombre_cliente] | Especifica el nombre del cliente WorkSpace On-Demand.
xx | Especifica el código del país o la región.
[clase_máquina] | Especifica el nombre de la clase de máquina que utiliza un cliente WorkSpace On-Demand.

##### 2.4.2.7 Instalación de componentes adicionales del Kit del desarrollador en el cliente WorkSpace On-Demand 2.0

Si desea instalar componentes que no sean el Entorno de ejecución para el cliente WorkSpace On-Demand, puede seleccionar estos componentes en el archivo WSOD2.RSP.

Si instala el Kit de utilidades, un administrador de WorkSpace On-Demand debe realizar las siguientes adiciones a los archivos CONFIG.SYS de los clientes:
Añada lo siguiente:

`x:\java131\bin;` | a la sentencia SET PATH
`z:\JAVA131\lib;` | a la sentencia SET LIB
`z:\JAVA131\include;` | a la sentencia SET INCLUDE

donde z:\JAVA131 es la unidad y el directorio donde está instalado el Kit de utilidades del cliente.

##### 2.4.2.8 Ejecución de ejemplos de Java desde un cliente WorkSpace On-Demand 2.0

El administrador del servidor WorkSpace On-Demand debe añadir las líneas siguientes al archivo RPL\FITS\nombre_cliente.FIT para permitir que el cliente WorkSpace On-Demand pueda ejecutar los ejemplos proporcionados en el componente Ejemplos:

         z:\JAVA131\WEBLOGS \\nombre_servidor\WRKFILES\nombre_cliente\JAVA131\WEBLOGS

         z:\JAVA131\HOTJAVA \\nombre_servidor\WRKFILES\nombre_cliente\JAVA131\HOTJAVA

Sustituya nombre_servidor y nombre_cliente por los nombres del servidor de IPL remota y el cliente de IPL remota. z es la unidad donde ha instalado el Kit del desarrollador. También se puede entrar en el archivo FIT por omisión.

Los clientes de IPL remota pueden compilar el código de ejemplo si los ejemplos están en un directorio sobre el que el cliente de IPL remota tiene acceso de grabación.

##### 2.4.2.9 Emisión de un trust en clientes WorkSpace On-Demand 2.0

Si emite un trust (dando acceso) para conectarse a un servidor web, el archivo IDENTITYDB.OBJ tiene que ser de lectura y grabación. Añada lo siguiente al archivo FIT para realizar la conexión:

         z:\JAVA131\WEBLOGS        \\nombre_servidor\WRKFILES\nombre_cliente\JAVA131\WEBLOGS

         z:\JAVA131\HOTJAVA        \\nombre_servidor\WRKFILES\nombre_cliente\JAVA131\HOTJAVA

         z:\JAVA131\IDENTITYDB.OBJ \\nombre_servidor\WRKFILES\nombre_cliente\JAVA131\IDENTITYDB.OBJ

##### 2.4.2.10 El compilador JIT y un cliente WorkSpace On-Demand 2.0

En un sistema cliente WorkSpace On-Demand, se añade el siguiente mandato al archivo CONFIG.SYS si se ha instalado la versión 1.1.6 del Kit del desarrollador durante la instalación del servidor WorkSpace On-Demand Server:

        set java_compiler=xxx

Este mandato desactiva el compilador JIT (Just-in-Time).

Para activar el compilador JIT, elimine el mandato indicado anteriormente del archivo CONFIG.SYS. Puede encontrar y editar el archivo basándose en las dos opciones siguientes:

- En el servidor de un usuario específico, el archivo CONFIG.SYS se ubica en la unidad y directorio siguientes:

         [unidadrpl]:\ibmlan\rpl\machines\[clase_máquina]\config.sys

- Para modificar el CONFIG.SYS por omisión de cada máquina creada utilizando la clase de máquina individual, el archivo CONFIG.SYS se ubica en la unidad y directorio siguientes:

         [unidadrpl]:\ibmlan\rpl\machines\BB20.xx\[clase_máquina]\config.sys

Utilice la siguiente lista de variables como referencia cuando establezca las variables en los archivos mencionados anteriormente:

donde:

[unidadrpl] | Especifica la Lista de parámetros de solicitud.
xx | Especifica el código del país o la región.
[clase_máquina] | Especifica el nombre de la clase de máquina que utiliza un cliente WorkSpace On-Demand.

##### 2.4.2.11 Creación de una aplicación pública del Panel de control del plug-in de Java para el cliente WorkSpace On-Demand 2.0

Para crear una aplicación pública del Panel de control del plug-in de Java que se ejecuta en un cliente WorkSpace On-Demand 2.0, debe proporcionar acceso a los archivos de Netscape. Los controles de acceso se especifican en el archivo APPPOST.FIT de Netscape.

El ejemplo siguiente muestra cómo crear una aplicación pública para ejecutar el Panel de control del plug-in de Java:

         net app jctrlpnl /remark:"Panel de control del plug-in de Java "

           /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 es el directorio en el que está instalada la imagen de Java Developer Kit (Kit del desarrollador de Java) y z:\netscape es el directorio en el que está instalada la imagen de Netscape.

### 2.5 Método de instalación de la IPL remota

Para llevar a cabo una instalación de IPL remota, es necesario crear dos archivos de respuestas y configurar los directorios y archivos adecuados en el servidor de IPL remota.

Siga estos pasos para cada cliente a instalar:

1. Coloque los archivos de instalación del Kit del desarrollador extraídos en el servidor de IPL remota.
2. Ejecute el mandato GENFIRPL. (Consulte la sección Creación de los archivos de respuestas para obtener más información.)
3. Ejecute el mandato CLIFI para un cliente de IPL remota. (Consulte la sección Inicio de la instalación de IPL remota para obtener más información.)
4. Modifique el archivo FIT del cliente (Consulte las secciones Actualización de archivos para Feature Install y Ejecución de Ejemplos de Java desde un cliente de IPL remota.)

#### 2.5.1 Creación de archivos de respuestas

Después de colocar los archivos de instalación del Kit del desarrollador extraídos en el servidor de IPL remota, se utiliza el mandato GENFIRPL para generar dos archivos de respuestas: FILES.RSP para el servidor de IPL Remota y JAVA131.RSP para el cliente de IPL remota. A continuación, se incluye un mandato GENFIRPL de ejemplo. El mandato se tiene que entrar en una sola línea.

         genfirpl /m:c:\javacode\xx  /r:c:\ibmlan\rpl

         /u:c:\ibmlan\rpluser  /f:c:\javacode\xx\JAVA131.rsp

         /c:nombre_cliente  /b:x:

El cliente de IPL remota no debe estar en ejecución cuando se emita el mandato GENFIRPL. Debe ejecutarse un mandato GENFIRPL para cada cliente de IPL remota, especificando el nombre de cliente adecuado y la unidad de arranque.

Utilice la siguiente lista de variables como referencia cuando establezca las variables en los archivos mencionados más arriba:

donde:

/m | Especifica el directorio que contiene los archivos de instalación del Kit del desarrollador extraídos en el servidor de IPL remota.
xx | Especifica la variable de idioma preferido.
/r | Especifica el directorio RPL.
/u | Especifica el directorio RPLUSER.
/f | Especifica el nombre completo del archivo de respuestas del cliente de IPL remota.
/c | Especifica el nombre del cliente de IPL remota.
/b | Especifica la unidad de arranque del cliente de IPL remota.
/nf | Suprime la transferencia de archivos de Java. Utilice este distintivo cuando instale clientes de IPL remota, después del primero, para evitar que los archivos del Kit del desarrollador se instalen otra vez para cada cliente nuevo.

#### 2.5.2 Modificación del archivo JAVA131.RSP

El archivo JAVA131.RSP contiene variables que le permiten seleccionar los componentes que se deben instalar así como la unidad y el directorio. Por omisión, el archivo JAVA131.RSP está establecido para instalar todos los componentes del Kit del desarrollador. Puede modificar este archivo de respuestas para seleccionar los componentes que desea instalar. Asegúrese de bajar y extraer todos los archivos que necesite antes de iniciar la instalación.

Tiene que utilizar un editor de textos que pueda manejar líneas mayores de 255 bytes, como TEDIT, para evitar el truncamiento de las líneas largas de este archivo. Debido a que es un archivo muy grande, las modificaciones pueden llevarle mucho tiempo y generar errores. Haga una copia de seguridad del archivo JAVA131.RSP antes de modificarlo para evitar la pérdida de datos.

#### 2.5.3 Actualización de archivos para Feature Install

El archivo nombre_cliente.FIT de cada cliente de IPL remota debe modificarse para incluir lo siguiente, que se tiene que entrar en una única línea:

         z:\os2\install\install.inv
    \\nombre_servidor\WRKFILES\nombre_cliente

         \os2\install\install.inv

Sustituya nombre_servidor y nombre_cliente por los nombres del servidor de IPL remota y el cliente de IPL remota. z es la unidad donde ha instalado el Kit del desarrollador.

#### 2.5.4 Inicio de la instalación de la IPL inicial remota

Las instalaciones de carga de programa inicial remota (RIPL) las maneja CLIFI (el programa de instalación de Feature Install) y pueden tardar de 15 a 20 minutos o más. Después de iniciar la sesión como administrador en el servidor de IPL remota, ejecute el mandato CLIFI utilizando el archivo de respuestas creado para el servidor de IPL remota, FILES.RSP:

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

Es necesario reiniciar el servidor de IPL remota después de ejecutar CLIFI si no se ha suprimido la transferencia de archivos.

Ejecute el mandato CLIFI en cada cliente de IPL remota después de ejecutar el mandato GENFIRPL para dicho cliente.

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

Utilice la siguiente lista de variables como referencia cuando establezca las variables en los archivos indicados anteriormente:

donde:

/r | Especifica el nombre completo del archivo de respuestas del cliente de IPL remota, tal como se especifica en el mandato GENFICMD.
xx | Especifica la variable de idioma preferido.

#### 2.5.5 Ejecución de Ejemplos de Java desde un cliente de IPL remota

El administrador del servidor de IPL remota debe añadir las líneas siguientes al archivo RPL\FITS\nombre_cliente.FIT para que el cliente de IPL remota pueda ejecutar los ejemplos proporcionados en el componente Ejemplos:

         z:\JAVA131\WEBLOGS \\nombre_servidor\WRKFILES\nombre_cliente\JAVA131\WEBLOGS

         z:\JAVA131\HOTJAVA \\nombre_servidor\WRKFILES\nombre_cliente\JAVA131\HOTJAVA

Sustituya nombre_servidor y nombre_cliente por los nombres del servidor de IPL remota y el cliente de IPL remota. z es la unidad donde ha instalado el Kit del desarrollador.

Los clientes de IPL remota pueden compilar el código de ejemplo si los ejemplos están en un directorio sobre el que el cliente de IPL remota tiene acceso de grabación.

##### 2.5.5.1 Emisión de un trust en un cliente de IPL remota

Si emite una confirmación (trust) para conectarse a un servidor web, el archivo IDENTITYDB.OBJ debe tener el permiso de lectura y grabación. Añada lo siguiente al archivo FIT para realizar la conexión:

         z:\JAVA131\WEBLOGS \\nombre_servidor\WRKFILES\nombre_cliente\JAVA131\WEBLOGS

         z:\JAVA131\HOTJAVA \\nombre_servidor\WRKFILES\nombre_cliente\JAVA131\HOTJAVA

         z:\JAVA131\IDENTITYDB.OBJ  \\servidor\WRKF\cliente\JAVA131\IDENTITYDB.OBJ

Sustituya nombre_servidor y nombre_cliente por los nombres del servidor de IPL remota y el cliente de IPL remota, respectivamente. z es la unidad donde ha instalado el Kit del desarrollador.

Esto también se puede entrar en el archivo FIT por omisión como parte de la instalación del Kit del desarrollador para WorkSpace On-Demand cuando se ejecuta el mandato WSOD.CMD.

## 3.0 DESPUÉS DE LA INSTALACIÓN

Las siguientes secciones contienen información adicional que puede necesitar después de instalar el Kit del desarrollador.

### 3.1 Fuentes de información adicionales

Los objetos de la siguiente lista se visualizan en la carpeta Kit del desarrollador de OS/2 sólo si utiliza OS/2 Warp Server 4. Si está ejecutando OS/2 Warp Server para e-business, puede acceder a los documentos de las ubicaciones siguientes:

- Centro de IBM para tecnología de Java:
  http://www.ibm.com/java/jdk/index.html
- Documentación de Java:
  http://www.javasoft.com/doc.html
- Depurador ICAT para Java OS/2:
  `x:\JAVA131\ICATJAVA\help\icatjvo.htm`
- README del Kit del desarrollador
  `x:\JAVA131\`

x es la unidad donde se ha instalado el Kit del desarrollador.

Si ha instalado los componentes del Kit de utilidades o del Depurador ICAT para Java OS/2 en directorios distintos al del componente Entorno de ejecución, especifique el directorio apropiado para estos dos objetos. Los enlaces a la documentación del Entorno de ejecución y al Depurador ICAT para Java OS/2 no funcionan si los componentes están en directorios distintos o no están instalados.

### 3.2 Instalación de componentes adicionales

Tras la instalación inicial del Kit del desarrollador, puede instalar componentes adicionales volviendo a ejecutar el procedimiento de instalación. Para ello, puede volver a bajar los archivos del sitio web del Catálogo de opciones de software, puede guardar todos los archivos extraídos en el sistema, o bien, puede guardar los archivos ZIP originales y volver a extraer los archivos cuando los necesite.

### 3.3 Consideraciones acerca de los controles TextField y TextArea de AWT

Los controles TextField and TextArea de AWT (Abstract Window Toolkit) no dan soporte a caracteres que no estén en la página de códigos actual. Los usuarios que ejecuten sistemas en inglés de EE.UU. pueden cambiar a la página de códigos 850 (la página de códigos multilingüe, que da soporte a los idiomas de Europa occidental) para ver caracteres específicos de idiomas adicionales en estos controles.

### 3.4 No se da soporte a la modificación de archivos de propiedades de font

No se da soporte a la modificación de los archivos de propiedades de fonts que se suministran con el Kit del desarrollador.

### 3.5 Problemas de hora en applets de Java

Si tiene problemas con la hora en las applets de Java, es posible que deba establecer o cambiar la variable del huso horario (TZ). Para establecer la variable TZ, siga uno de los siguientes pasos:

- Vaya a la página General del cuaderno Configuración de TCP/IP. Utilizando la ayuda en línea que se proporciona, establezca el campo del huso horario.
- Edite el archivo CONFIG.SYS y añada o modifique la sentencia SET TZ=.

### 3.6 Utilización del soporte de área alta de memoria de OS/2 para aumentar el tamaño de pila de Java

En un entorno estándar de OS/2, el espacio máximo de direcciones virtuales disponible para una aplicación es de 512 MB y la memoria disponible para el tamaño de pila de Java está limitado a 256 MB, aproximadamente. Esta restricción puede modificarse utilizando el Soporte de área alta de memoria de OS/2 (OS/2 HMS). HMS de OS/2 aumenta el espacio máximo de direcciones virtuales disponible para una aplicación a 3 GB.

Las siguientes plataformas ofrecen soporte para OS/2 HMS:

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

#### 3.6.1 Habilitación de OS/2 HMS

El área alta de la memoria disponible se controla mediante el valor de VIRTUALADDRESSLIMIT en el archivo CONFIG.SYS. El valor se especifica en MB en el archivo CONFIG.SYS. Por ejemplo:

            VIRTUALADDRESSLIMIT=2048

El valor más pequeño admisible es 512 MB. Este valor proporciona compatibilidad con las versiones anteriores de OS/2 que permitían el acceso a 512 MB. Los valores que superan los 512 MB pueden reducir el número de procesos que pueden ejecutarse simultáneamente en un sistema.

#### 3.6.2 Habilitación del tamaño de pila para utilizar OS/2 HMS

Para indicar a la Máquina Virtual Java (JVM) que debería intentar colocar su pila en OS/2 HMS, establezca la siguiente variable de entorno:

        SET JAVA_HIGH_MEMORY=1

Si HMS de OS/2 no está disponible, esta opción se ignora y la pila se asigna desde el espacio de direcciones estándar.

#### 3.6.3 Limitaciones al utilizar OS/2 HMS

Si se coloca la pila de Java en OS/2 HMS, los objetos que se asignan desde la misma no resultan accesibles para el código de 16 bits. Esto sólo es un problema si una aplicación Java tiene DLL de método nativo que se hayan compilado con un compilador de 16 bits o llama a otras DLL que contengan código de 16 bits.

### 3.7 Clase BigDecimal ampliada

Este release incluye la clase BigDecimal (com.ibm.math.BigDecimal). Se facilita (con su MathContext de clase de soporte) como alternativa a la clase java.math.BigDecimal. Si está utilizando la clase java.math.BigDecimal en un programa de Java y desea acceder a la clase nueva, debe cambiar la sentencia de importación en el código de origen, tal y como se muestra a continuación.

Cambie:

         import java.math.*;

Por:

         import com.ibm.math*;

No ha de cambiar ningún otro código.

### 3.8 Los plug-in de Java

En las secciones siguientes se proporciona información acerca de la instalación y la utilización de los plug-in de Java para Netscape 4.x e IBM Web Browser para OS/2.

#### 3.8.1 Instalación del plug-in de Java después de instalar Netscape Communicator

Si ha instalado Netscape Communicator después del Kit del desarrollador y desea habilitar el plug-in de Java, realice los pasos siguientes:

1. Busque el archivo plugin.exe, que se encuentra en el directorio \JAVA131\ns\ del componente Entorno de ejecución. Copie el archivo plugin.exe en un directorio temporal.
2. Ejecute el archivo plugin.exe, desde el directorio en el que ha copiado el archivo plugin.exe, escribiendo el nombre de archivo en una línea de mandatos. Cuando se ejecuta el archivo se extraen los siguientes archivos:
   - instplug.cmd: Mandato CLIFI que se utiliza para ejecutar la instalación del plug-in de Java.
   - npjava.dll: dll del plug-in de Java.
   - nscheck2.exe: Salida de usuario para localizar Netscape.
   - nsfiles.rsp: Archivo de respuestas de Feature Install (FI). No edite este archivo.
   - nsuser.rsp: Archivo de respuestas del usuario parcial de ejemplo.
   - package.ctl: Un archivo de empaquetamiento que necesita FI.
3. Vuelva al directorio \JAVA131\ns\.
4. Edite el archivo instplug.cmd para apuntar a la unidad de arranque y vías de acceso correctas.
5. Edite el archivo nsuser.rsp para habilitar el plug-in de Java. Se habilita la versión más reciente de Netscape Communicator. (Si desea habilitar una versión específica de Netscape, establezca el valor JAVANSFILES.NSDRV que se encuentra en el archivo nsuser.rsp en la unidad y directorio completos.)
6. Ejecute el archivo instplug.cmd.
7. Reinicie el sistema.

Utilice la siguiente lista de variables como referencia cuando establezca las variables en los archivos indicados anteriormente.

donde:

xx | Especifica la variable de idioma preferido.
/r | Especifica la ubicación completa del archivo de respuestas de Feature Install.
/r2 | Especifica la unidad, vía de acceso y el nombre del archivo de respuestas del usuario.
/b | Especifica la unidad de arranque.
/s | Especifica la ubicación completa de los archivos extraídos del Kit del desarrollador.
/l1 y /l2 | Especifican las ubicaciones completas de los archivos de anotaciones cronológicas opcionales. Consulte estos archivos, además del archivo \os2\install\wpinstal.log en la unidad de arranque, si se producen problemas durante la instalación.

#### 3.8.2 Instalación del plug-in de Java después de instalar IBM Web Browser para OS/2

Si ha instalado IBM Web Browser para OS/2 después del Kit del desarrollador y desea habilitar el plug-in de Java para este navegador, siga los pasos que se indican a continuación:

1. Busque el archivo mzplugin.exe, que se encuentra en el directorio \JAVA131\ns\ del componente Entorno de ejecución. Copie el archivo mzplugin.exe en un directorio temporal.
2. Ejecute el archivo mzplugin.exe, desde el directorio en el que ha copiado el archivo mzplugin.exe, escribiendo el nombre de archivo en una línea de mandatos. Cuando se ejecuta el archivo se extraen los siguientes archivos:

- insmzplg.cmd: Mandato CLIFI que se utiliza para ejecutar la instalación del plug-in de Java
- npoji6.dll: dll del plug-in de Java
- mzcheck2.exe: Salida de usuario para localizar Netscape
- mzfiles.rsp: Archivo de respuestas de Feature Install (FI). No edite este archivo.
- mzuser.rsp: Archivo de respuestas del usuario parcial de ejemplo
- package.ctl: Un archivo de empaquetamiento que necesita FI.

3. Vuelva al directorio \JAVA131\ns\.
4. Edite el archivo insmzplg.cmd para que señale a la unidad de arranque y las vías de acceso correctas.
5. Edite el archivo mzuser.rsp para habilitar el plug-in de Java. Se habilita la versión más actualizada de IBM Web Browser para OS/2. (Si desea habilitar una versión específica de IBM Web Browser para OS/2, establezca el valor JAVAMZFILES.NSDRV, que se encuentra en el archivo mzuser.rsp, en la unidad y el directorio completos).
6. Ejecute el archivo insmzplg.cmd.
7. Reinicie el sistema.

Utilice la lista de variables siguiente como referencia cuando establezca los variables en los archivos indicados anteriormente.
donde:

xx | Especifica la variable de idioma preferido.
/r | Especifica la ubicación completa del archivo de respuestas de Feature Install.
/r2 | Especifica la unidad, vía de acceso y el nombre del archivo de respuestas del usuario.
/b | Especifica la unidad de arranque.
/s | Especifica la ubicación completa de los archivos extraídos del Kit del desarrollador.
/l1 y /l2 | Especifica las ubicaciones completas de los archivos de anotaciones opcionales. Si se produce algún problema durante la instalación, consulte estos archivos, además del archivo \os2\install\wpinstal.log de la unidad de arranque.

#### 3.8.3 El Panel de control del plug-in de Java

Tras la instalación del plug-in de Java, puede controlar el comportamiento del plug-in de Java en ejecución. Por ejemplo, cuando ejecute el plug-in de Java, puede controlar si se iniciará o no la consola de Java cuando el plug-in de Java se inicie.

El Panel de control es una aplicación Java lanzada por el archivo de mandatos ubicado en el archivo [x:\JAVA131]\jre\bin\jctrlpnl.cmd. Hay un icono para este archivo de mandatos, situado en el directorio [x:\JAVA131], donde x es la unidad en la que ha instalado el Kit del desarrollador. Por omisión, JAVA131 es el nombre del directorio.

### 3.9 Desactivación del compilador JIT

Con el Kit del desarrollador se proporciona un compilador Just-in-Time (JIT). El compilador JIT genera código máquina para las secuencias de códigos de bytes utilizadas con más frecuencia en una aplicación o applet Java durante la ejecución. Por omisión, el compilador JIT está habilitado. Puede inhabilitar el JIT para ayudar a determinar un problema en una aplicación Java, en una applet o en el propio compilador pasando el mandato siguiente al intérprete de ejecución de Java:

    SET JAVA_COMPILER=none

### 3.10 Cambios en los nombres de archivo

Hay algunos nombres cortos de archivo que se basan en el convenio de denominación de archivos 8.3 obligatorios para OS/2 que difieren de los nombres largos de archivo que requieren plataformas como, por ejemplo, Microsoft(R) Windows(R) o Linux. A continuación se muestran los nombres de archivo conocidos que difieren:

Nombre largo de archivo | Nombre corto de archivo de 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
Nombres cortos y largos de archivo conocidos que se diferencian basados en el convenio de denominación de archivos 8.3.

### 3.11 Configuración del visor de applets

Para configurar el visor de applets para que se conecte a través de una pasarela proxy a Internet:

1. Pulse Propiedades de applet.
2. Pulse Propiedades.
3. Escriba su servidor y puerto proxy en los campos correspondientes
Por ejemplo:

         Http proxy server: myproxy.mycompany.com

         Http proxy port:   80

Si su navegador web ya está configurado para conectarse a Internet, utilice los valores definidos en dicha configuración. Por ejemplo, con WebExplorer(R), utilice los valores de la pasarela proxy de la página Configurar servidores, omitiendo los caracteres 'http://' iniciales y el carácter '/' final.
Si no sabe cuál es su pasarela proxy, pregunte al administrador del sistema si está autorizado a utilizar los servicios proxy.
4. Pulse Aplicar para guardar los cambios.
5. Cierre el visor de applets.

### 3.12 Especificación de opciones de Java y propiedades del sistema

Puede especificar opciones de Java y propiedades del sistema creando una variable de entorno llamada IBM_JAVA_OPTIONS y estableciéndola en los valores que necesite. Todas las opciones de Java o propiedades del sistema especificadas deben ir precedidas por un espacio excepto la primera opción. Por ejemplo, podría establecer IBM_JAVA_OPTIONS del modo siguiente:

    IBM_JAVA_OPTIONS=-Dmysysprop1=tcpip -Dmysysprop2=wait

Si especifica las mismas opciones o propiedades desde la línea de mandatos (o desde un programa JNI), éstas tendrán preferencia sobre las opciones y propiedades especificadas con la variable de entorno IBM_JAVA_OPTIONS. La única excepción a esta regla es cuando se especifica -Xt, -Xtm o -Xdebug. Todas ellas implican que no deben utilizarse un JIT.

Tenga en cuenta que:

- IBM_JAVA_OPTIONS no tendrá ningún efecto cuando se ejecuta con JNI_VERSION_1_1.
- Las opciones de Java deben especificarse en su formato actual; por ejemplo, -verbose:gc en lugar de -verbosegc.

La propiedad de sistema ibm.jvm.bootclasspath permite definir una vía de acceso de búsqueda adicional. El valor de esta propiedad se inserta entre un valor definido por -Xbootclasspath/p: y la vía de acceso de bootclass. La vía de acceso de bootpath es la definida por omisión o bien la definida mediante la opción -Xbootclasspath:. Si desea más información sobre estas opciones, consulte la sección 3.1 Fuentes de información adicionales

### 3.13 RMI a través de IIOP

RMI (Remote Method Invocation) de Java proporciona un mecanismo simple de realizar programación distribuida de Java. RMI a través de IIOP (RMI-IIOP) amplía la RMI Java básica para establecer la comunicación mediante el protocolo Inter-ORB de Internet estándar (protocolo IIOP) de CORBA (Common Object Request Broker Arquitecture). Esto permite una interacción directa con cualquier otro ORB (Object Request Broker) de CORBA tanto si se ha implementado en Java u otro lenguaje de programación.

El Kit del desarrollador incluye el soporte para las aplicaciones desarrolladas para utilizar RMI a través de IIOP (RMI-IIOP). Este soporte forma parte de la instalación estándar del Entorno de ejecución y no requiere ninguna instalación o configuración especial.

#### 3.13.1 El compilador IDL-to-Java

Con este release se incluye un compilador IDL-to-Java. Esta herramienta convierte el IDL (Interface Definition Language) de CORBA en Java. Consulte la Guía del usuario del compilador IDL-to-Java para obtener más información. Esta documentación se puede encontrar en el directorio siguiente:

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

[x:\JAVA131] es la unidad y el directorio donde se ha instalado el Kit del desarrollador. Por omisión, JAVA131 es el nombre del directorio.

El compilador IDL-to-Java ofrece soporte a la especificación de CORBA 2.3. Ello incluye la construcción "valuetype" y su correlación de IDL a Java. Se pueden encontrar detalles acerca de este soporte en los siguientes sitios FTP:

- ftp://ftp.omg.org/
  Desde esta página principal, pulse pub --> docs --> formal --> 99-07-53.pdf
  (Correlación IDL-to-Java)
- ftp://ftp.omg.org/
  Desde esta página principal, pulse pub --> docs --> formal --> 98-12-01.pdf
  (Componente principal de CORBA 2.3)

El compilador IDL-to-Java se suministra para que pueda experimentar con el IDL generado mediante el mandato "rmic -idl". Este IDL generado y el compilador IDL-to-Java no son necesarios cuando se utiliza RMI-IIOP en el caso de Java a Java. El IDL generado se utiliza para que RMI-IIOP interactúe con otros lenguajes como, por ejemplo, C++. Para la interacción con C++, se debe utilizar un compilador IDL-to-C++ que admita la especificación CORBA 2.3 para compilar el IDL generado.

##### 3.13.1.1 Restricciones del compilador IDL-to-Java

Se aplican las siguientes consideraciones cuando se utiliza el compilador IDL-to-Java:

- Es posible que los identificadores liberados del ámbito global no se escriban igual que los tipos primitivos de IDL, Object o ValueBase. Esto se debe a que la tabla de símbolos está precargada con estos identificadores; si se volvieran a definir se escribiría encima de sus definiciones originales.
- No hay stubs locales ni semántica de copia cuando se pasan valores localmente.
- El tipo de IDL fijo no está soportado.
- Los stubs generados no admiten la serialización. Debido a la correlación IDL y Java, la especificación de 1998-08-22 de la sección 25.3.1.3 falla al especificar lo que es necesario.
- Las constantes de tipo octet no pueden declararse.

##### 3.13.1.2 Problemas conocidos del compilador IDL-to-Java

A continuación se indican los problemas conocidos del compilador IDL-to-Java:

- El compilador puede completar el proceso de compilación sin error pero no generar salida. Si ocurre esto, especifique la opción -emitAll para forzar que se generen todas las clases. Cuando utilice la opción -emitAll, se recomienda utilizar también la opción -pkgPrefix para añadir un prefijo a cualquier nombre de clase que empiece por 'java' para evitar que se produzcan conflictos de nomenclatura con las clases de la JVM.
- El compilador no reconoce el tipo ignorado de CORBA::Principal.
- La declaración de una constante y un método o atributo que tengan el mismo nombre en el mismo ámbito no produce ningún error. El IDL siguiente puede causar un error:

               interface t {

                 const long foo = 1;

                 attribute long foo;

               };

- El siguiente IDL produce un error para "S es un tipo no declarado" en la interfaz B. Pero no debería hacerlo.

               interface A { struct S { short s; }; };

               interface B:A { typedef S new_S;

                           exception ex {S f1;}; // Error for "S" here

               };

- Si una unión define otra unión en su cláusula por omisión, la clase de Java resultante recibe errores de compilación. El método alternativo consiste en definir la unión anidada fuera de la unión que la contiene.

#### 3.13.2 Información adicional

Para obtener información acerca de IBM y RMI-IIOP, consulte el siguiente sitio web de IBM:
http://www.ibm.com/java/jdk/rmi-iiop/index.html

Otra documentación disponible:

- El README del Kit del desarrollador que se encuentra en el directorio donde se ha instalado el Kit del desarrollador.
- La Guía del programador de RMI-IIOP es una introducción a la escritura de programas RMI-IIOP y se encuentra en el siguiente sitio web o directorio y archivo:

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

- La Guía del usuario del compilador IDL-to-Java describe cómo se utiliza la herramienta que genera código Java desde IDL y se encuentra en el siguiente sitio web o directorio y archivo:
  - http://www.ibm.com/java/jdk/rmi-iiop/docs/win130/toJavaPortableUG.htm
  - [x:\JAVA131]\DOCS\RMI-IIOP\toJavaPortableUG.htm
- El directorio de ejemplos contiene lo siguiente:
  - Un ejemplo de Hello World que es intercambiable entre los protocolos JRMP e IIOP. ([x:/JAVA131]/rmi-iiop/samples/Hello)
  - Un ejemplo de Hello World que interactúa con un programa IDL estándar. ([x:/JAVA131]/rmi-iiop/samples/idl)

  [x:\JAVA131] es la unidad donde se ha instalado el Kit del desarrollador. Por omisión, JAVA131 es el nombre del directorio.

- El documento Java Language to IDL Mapping (Correlación de lenguaje Java a IDL) es una especificación técnica detallada de RMI-IIOP y puede encontrarse en el siguiente sitio FTP:
  ftp://ftp.omg.org/
  Desde esta página principal, pulse pub --> docs --> formal --> 99-07-59.pdf
- La información de la API (interfaz de programas de aplicación) de Java de Sun Microsystems se puede obtener en el sitio web siguiente: http://java.sun.com/products/?frontpage-main

#### 3.13.3 Términos de 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 (Servicio de autenticación y autorización de Java)

La plataforma Java 2 proporciona una forma de exigir controles de acceso basados en dónde procede el código y en quién lo ha firmado. Estos controles de acceso son necesarios debido a la naturaleza distribuida de la plataforma Java donde, por ejemplo, una applet remota puede bajarse a través de una red pública y, después, ejecutarse localmente.

Sin embargo, la plataforma Java 2 no proporciona una forma de exigir controles de acceso similares basados en quién ejecuta el código. Para proporcionar este tipo de control de acceso, la arquitectura de seguridad de Java 2 requiere lo siguiente:

- Soporte adicional para la autenticación (determinación de quién está realmente ejecutando el código)
- Ampliaciones de los componentes de autorización existentes para exigir nuevos controles de acceso basados en quién se ha autenticado

La infraestructura del JAAS (Servicio de autenticación y autorización de Java) proporciona estas mejoras.

Para una descripción general del JAAS, consulte el siguiente sitio web:

http://java.sun.com

Desde esta página principal, pulse Products & APIs y desplácese hacia abajo hasta la sección Optional Packages. Los documentos de este sitio web contienen enlaces a muchas otras fuentes de información basadas en web.

#### 3.14.1 Diferencia entre la versión de JAAS de IBM y Sun

La versión de IBM de JAAS para OS/2 difiere de la versión de Sun de JAAS para Windows en que los paquetes com.sun.* se han movido a los paquetes com.ibm.*.

#### 3.14.2 Instalación básica

A continuación se ofrece información sobre la ubicación de los archivos JAAS:

- Los archivos jaas.jar y jaas_lm.jar se encuentran en el subdirectorio jre\lib\ext del directorio donde se ha instalado el Entorno de ejecución
.
- JAAS incluye un LoginModule (módulo de inicio de sesión) simple que refleja la información actual de inicio de sesión del sistema operativo para los programas de Java. Para proporcionar dicha capacidad, los archivos siguientes se instalan en los subdirectorios mostrados, en el directorio donde está instalado el Entorno de ejecución:

             JAVA131\jre\bin:

                       jaas.dll

                       jaas_g.dll

- El directorio de documentación JAVA131\docs\jaas contiene la documentación de la API de JAAS y un archivo module.html. En el directorio de documentación de JAAS, busque el archivo JaasDocs.jar (contiene la documentación de la API de JAAS) y descomprímalo (jar -xvf JaasDocs.jar) en una partición HPFS o JFS. Busque el archivo index.html. Mediante un navegador, utilice el archivo index.html para acceder al resto de la documentación de la API.

Nota: El componente Entorno de ejecución está instalado en el directorio x:\JAVA131. (Donde x es la unidad en la que ha instalado instalado el Kit del desarrollador. Por omisión, JAVA131 es el nombre del directorio).

### 3.15 Información sobre programación JNI

Puede acceder a los objetos Java desde un programa C utilizando JNI (interfaz nativa Java), que se presentó con Java 1.1.1. La utilización de JNI proporciona una interfaz más estable que NMI (Native Method Interface).

Las aplicaciones JNI deben interactuar a menudo con los tipos de Java "long", "float" y "double" por uno o más de los motivos siguientes:

- Para recibir las variables como parámetros de método nativos.
- Para examinar o modificar las variables instance o class directamente.
- Para devolver la variable como el valor de retorno de método nativo.
- Para pasar las variables como datos de parámetro al invocar otros métodos Java desde un método nativo.

### Tipos nativos de JNI

JNI proporciona tipos nativos que puede utilizar en la aplicación JNI para cada uno de los tipos de Java. Estos tipos se muestran en la tabla siguiente:

Tipos nativos de JNI
Tipo de Java | Tipo nativo de JNI | Tamaño en bytes
--- | --- | ---
long | jlong | 8
double | jdouble | 8
float | jfloat | 4
Tipos nativos de JNI

Nota: No necesita utilizar estos tipos si la aplicación no manipula los tipos de Java "long", "float" o "double".

Utilice los tipos nativos de JNI cuando defina una implementación de método nativa, de modo que el compilador empareje la signatura de método nativa con la signatura del archivo de cabecera generado tras utilizar el programa de utilidad javah.

### Funciones y macros del auxiliar

Los tipos nativos de JNI "jlong", "jdouble" y "jfloat" son incompatibles con los tipos C y C++ "long", "double" y "float" respectivos. Si intenta fusionar uno en el otro, provocará un error de compilación o un comportamiento inesperado mientras esté en ejecución. No intente convertir uno en el otro ya que los tipos nativos de JNI son tipos privados del Kit del desarrollador.

El archivo de cabecera de la JNI (jni.h) incluye un segundo archivo de cabecera, incluido en el Kit del desarrollador, llamado int64_md.h. Este archivo define las funciones y macros del auxiliar que puede utilizar para trabajar con tipos nativos.

Las funciones y macros de int64_md.h (con relación a "jlong") suelen incluir los caracteres ll al principio o al final del nombre. Las funciones relacionadas con "jdouble" o "jfloat" suelen incluir "dbl", "double", "flt" o float en el nombre. También hay definidas algunas constantes "jlong", "jdouble" y "jfloat".

A continuación ofrecemos ejemplos de macro:

- La macro ll_add() añade dos "jlong" y devuelve un "jlong".
- La macro int2ll() convierte un "int" en un "jlong".
- La función ll2str() convierte un "jlong" en una representación de cadena de caracteres ASCII del valor de 64 bits.
- La función flt2dbl() convierte un "jfloat" y devuelve un "jdouble".
- La macro dbl2nat() convierte un "jdouble" en un "double" de OS/2 nativo
.
- La macro dbl_sqrt() extrae la raíz cuadrada de un "jdouble" y devuelve un "jdouble".
- Las funciones dbl2str() y flt2str() convierten sus argumentos en una representación de cadena de caracteres ASCII.

### 3.16 Consideraciones acerca del rendimiento

Es posible que los usuarios observen que algunas aplicaciones tardan más tiempo en cargarse o iniciarse en el Kit del desarrollador de OS/2 Warp Development Kit, Java 2 Technology Edition, versión 1.3.1 en comparación con la versión 1.3.0. En estos casos, puede resultar útil usar el parámetro de línea de mandatos JAVA.EXE, -Xquickstart.

Por omisión, el compilador JIT (Just-In-Time) de OS/2 Java 1.3.1 realiza optimizaciones que pueden incrementar el tiempo que tarda en cargarse una aplicación. La ventaja intencional de estas optimizaciones adicionales es mejorar el rendimiento de ejecución de la aplicación. La ventaja del rendimiento de ejecución y la degradación del tiempo de carga varían de una aplicación a otra. Algunas aplicaciones experimentan muy pocos o ningún cambio con respecto a Java 1.3.0. El parámetro -Xquickstart especifica la utilización de un conjunto simplificado de optimizaciones que puede mejorar los tiempos de arranque. Las diferencias del rendimiento entre utilizar -Xquickstart y no utilizarlo varían según las aplicaciones.

## 4.0 PAQUETES DE FONTS ADICIONALES

Si ha bajado uno o más paquetes de fonts en forma de archivo, vaya a las secciones Instalación de fonts adicionales para ver las instrucciones de instalación. Si ha bajado archivos partidos, siga los pasos que se indican a continuación para unir los archivos partidos y obtener un único archivo instalable. Después, continúe con las secciones de instalación.

1. Asegúrese de que todos los archivos partidos del font deseado se encuentran en el mismo directorio.
2. En una línea de mandatos y desde el directorio en el que ha bajado los archivos partidos, utilice el mandato copy para unir los archivos. Debe incluir los nombres de los archivos partidos y el nombre completo del archivo para el font. Por ejemplo, si ha bajado tres archivos partidos, escriba lo siguiente:

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

donde:

ExamFont.txx | es el nombre del archivo partido que ha bajado. (xx es el número del archivo partido que ha bajado.) Asegúrese de que especifica los archivos partidos en el orden correcto.
ExamFont.ttf | es el nombre completo del font.

### 4.1 Instalación de fonts adicionales

Consulte las siguientes secciones para obtener información sobre cómo utilizar el método de instalación CID o el método de Paleta de fonts.

#### 4.1.1 Método de instalación CID

Para instalar un font adicional utilizando la instalación CID, siga los pasos que se indican a continuación:

1. Busque el archivo wtfont.exe, situado en el directorio x:\JAVA131\fonti del Kit del desarrollador. x es la unidad donde se ha instalado el Kit del desarrollador.
2. Ejecute el archivo wtfont.exe escribiendo el nombre del archivo en una línea de mandatos. Cuando se ejecuta el archivo se extraen los siguientes archivos:

- wtfnt.cmd: Un archivo de mandatos que ejecuta CLIFI.
- wtfonts.rsp: El archivo de respuestas de Feature Install (FI). No edite este archivo.
- wtfntusr.rsp: Un archivo de respuestas del usuario. Edite este archivo para seleccionar los fonts que desea instalar.
- PACKAGE.CTL: Un archivo de empaquetamiento que necesita Feature Install.

3. Copie el archivo PACKAGE.CTL en el directorio donde ha bajado los paquetes de font adicionales.
4. Edite el archivo wtfnt.cmd para apuntar a la unidad de arranque y vías de acceso correctas. Vea a continuación una lista de parámetros.
5. Edite el archivo wtfntusr.rsp para seleccionar los fonts que desea instalar.
6. Ejecute el archivo wtfnt.cmd
7. Reinicie el sistema.

Nota: Si CLIFI le solicita que "inserte el soporte", deberá definir el parámetro /s: correctamente en el archivo wtfnt.cmd o colocar el archivo PACKAGE.CTL en el mismo directorio que los paquetes de fonts que desee instalar.

Utilice la siguiente lista de variables como referencia cuando establezca las variables en los archivos mencionados anteriormente.

donde:

/s: | Especifica el origen de los paquetes de fonts y del archivo PACKAGE.CTL.
/b: | Especifica la unidad de arranque.
/r2: | Especifica la unidad, vía de acceso y el nombre del archivo de respuestas del usuario.
/r: | Especifica el archivo de Feature Install (wtfntusr.rsp).
/l1 y /l2 | Especifican las ubicaciones completas de los archivos de anotaciones cronológicas opcionales. Consulte estos archivos, además del archivo \os2\install\wpinstal.log en la unidad de arranque, si se producen problemas durante la instalación.

#### 4.1.2 Método de la paleta de fonts

Para instalar un font adicional utilizando la Paleta de fonts, siga los pasos que se indican a continuación:

1. Abra la carpeta Sistema OS/2.
2. Pulse la carpeta System Setup.
3. Pulse Paleta de fonts.
4. Pulse el botón Editar font.
5. Pulse el botón Añadir.
6. Escriba la unidad y el directorio donde ha bajado los archivos de fonts.
7. Seleccione el font que desea instalar y pulse Añadir.

## 5.0 INFORMACIÓN ACERCA DEL JUEGO DE CARACTERES DE DOBLE BYTE (DBCS)

Las secciones siguientes describen las consideraciones conocidas sobre el juego de caracteres de doble byte (DBCS).

### 5.1 Omisión de texto en el panel de texto, o es demasiado largo en países o regiones con juego de caracteres de doble byte (DBCS)

Cuando instale el Kit del desarrollador en versiones DBCS de OS/2, es posible que los caracteres DBCS no se visualicen en los paneles de instalación o las líneas puedan exceder el margen derecho de la ventana de la pantalla, incluso cuando la ventana esté maximizada.

Para solucionar estos problemas, salga del programa de instalación, abra el objeto Netscape Navigator o Netscape Communicator para OS/2 y pulse el elemento de menú Opciones. Abra el cuaderno Preferencias generales y seleccione la pestaña Fonts. Elija la codificación adecuada para el país o la región y, a continuación, establezca los fonts proporcionales y fijos en MINCHO. Pulse Bien para guardar los cambios. Cuando vuelva a iniciar la instalación del Kit del desarrollador, el texto se debería visualizar correctamente.

### 5.2 En los sistemas chinos se deben instalar los fonts TrueType

En sistemas en idioma chino simplificado o tradicional, asegúrese de que están instalados todos los fonts TrueType OS/2 disponibles. Para instalar estos fonts, haga lo siguiente:

1. En una línea de mandatos de OS/2, donde C: es la unidad de arranque, inicie el programa de instalación selectiva escribiendo:

            C:\OS2\INSTALL\INSTALL

   Aparecerá un panel denominado "Configuración del sistema".
2. Continúe con el panel Configuración e instalación de OS/2, pulsando sobre el botón Siguiente (para OS/2 Warp 4.0) o el botón Bien (para OS/2 Warp Server para e-business).
3. En el panel Configuración e instalación de OS/2, pulse sobre el recuadro de selección Fonts TrueType.
4. Pulse el botón Más que aparece a la derecha de este recuadro de selección.
5. Asegúrese de que estén seleccionados todos los recuadros de selección de fonts. Pulse Bien.
6. Inserte el CD-ROM del sistema operativo (OS/2 Warp Server 4.0 u OS/2 Warp Server para e-business) en la unidad de CD.
7. Pulse Bien en el panel Directorio origen.

Deberían instalarse los fonts adecuados. Rearranque el sistema cuando termine la instalación de fonts.

### 5.3 Arreglos temporales del programa y FixPaks para sistemas DBCS

Algunos usuarios de DBCS pueden encontrar los siguientes comportamientos relacionados con la operación del Método de entrada asiático. Muchos de estos elementos están dirigidos a los releases más recientes del sistema operativo. Sin embargo, si no puede actualizar al último release, póngase en contacto con el Servicio técnico de IBM local para que le informen sobre la disponibilidad de los PTF (arreglo temporal del programa) o FixPak aplicables.

La siguiente tabla describe los comportamientos relacionados con la operación Método de entrada asiático y el sistema DBCS afectado.

Descripción | Sistema DBCS afectado
--- | ---
Cuando el foco se mueve a otra trama, ocurre un Trap en IME. | Chino tradicional
Cuando el foco se mueve a otra trama en una ventana de búsqueda que se está visualizando, la operación de conversión no funciona correctamente. | Chino tradicional
Cuando el foco se mueve a otra trama en una ventana de búsqueda que se está visualizando, la ventana de búsqueda no desaparece. | Japonés
El método de entrada correcto no se muestra en el indicador de modo de entrada. | Japonés, chino simplificado, chino tradicional
Una cadena de caracteres de conversión del cliente activo no desaparece al pulsar la tecla ESC. | Chino tradicional
Cuando el usuario conmuta a IME de JAVA nativo, una clave de conversión no funciona correctamente. | Japonés, chino simplificado, chino tradicional
Se produce una anomalía en el sistema cuando se abren demasiadas tramas IM. | Chino tradicional
No se puede continuar la entrada si se vuelve a la modalidad de entrada de inglés sin seleccionar ningún carácter DBCS desde la ventana de búsqueda. | Chino simplificado, chino tradicional
Una cadena de caracteres de conversión del cliente activo no desaparece al pulsar la tecla Control+Espacio. | Chino simplificado
Al pulsar al tecla Retroceso cuando se visualiza la ventana de búsqueda se produce una condición de excepción en IME. | Chino simplificado
Descripciones de los comportamientos relacionados con la operación Método de entrada asiático y el sistema DBCS afectado.

### 5.4 Control de la visualización de caracteres numéricos de árabe

Los usuarios de algunos países o regiones pueden ver inesperadamente caracteres de numeración árabe. Algunas versiones de OS/2 específicas de país o región correlacionan los caracteres comprendidos entre x'00B0' y x'00B9' con los números arábigos comprendidos entre el cero (0) y el nueve (9). Para ver los caracteres que desee, cambie los atributos bidireccionales del archivo CONFIG.SYS o bien utilice la página Idioma del cuaderno Propiedades (cuaderno Valores de OS/2 Warp Server para e-business) del objeto para obtener el efecto deseado.

### 5.5 Valores del entorno japonés en la versión japonesa de OS/2 Warp 4

Utilice los siguientes valores del entorno en japonés para la versión japonesa de OS/2 Warp 4:

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

### 5.6 Fonts necesarios en la versión japonesa de OS/2 Warp

Para ejecutar el Kit del desarrollador, necesita los siguientes fonts en el sistema:

Nombre | Estilo
GOTHIC | Normal
GOTHIC | HeiseiKakuGothic-W5-H-90-TT
MINCHO | HeiseiMincho-W3-H-90-TT
Fonts necesarios en la versión japonesa de OS/2 Warp.

Puede comprobarlos en la Paleta de fonts, que está en la carpeta Configuración del sistema de la carpeta Sistema OS/2.

- El font GOTHIC Normal se incluye en el font GOTHIC del sistema japonés.
- GOTHIC HeiseiKakuGothic-W5-H-90-TT es el font IBM HeiseiKakuGothic TrueType que viene con New JIS.
- MINCHO HeiseiMincho-W3-H-90-TT es el font IBM HeiseiMincho TrueType que viene con New JIS.

Estos fonts se pueden instalar a través del objeto de programa Instalación selectiva, que está en la carpeta Instalar/eliminar de la carpeta Configuración del sistema en los sistemas OS/2 Warp 4 y OS/2 Warp Server para e-business.

### 5.7 Mejora de la calidad de los fonts en OS/2 Warp Server para e-business

En OS/2 Warp Server para e-business, se puede mejorar la calidad de un font de cuerpo pequeño habilitando una asociación entre un font de contorno y un font de mapa de bits. Para habilitar esta asociación, haga lo siguiente:

1. Abra la carpeta Sistema OS/2.
2. Abra la carpeta Configuración del sistema.
3. Abra el objeto Sistema.
4. Abra la página Asociar con font de mapa de bits.
5. Seleccione el botón Habilitar.
6. Efectúe una doble pulsación en el icono del menú de sistema para cerrar el objeto Sistema.

Si desea más información acerca de la asociación con el font de mapa de bits, pulse el botón Ayuda que se encuentra en la página Asociar con font de mapa de bits.

## 6.0 DESINSTALACIÓN DEL KIT DEL DESARROLLADOR

En las siguientes secciones se proporciona información sobre la desinstalación del Kit del desarrollador.

Si ha instalado varias veces los componentes del Kit del desarrollador sin desinstalarlos, las referencias a JAVA131 seguirán existiendo en el archivo CONFIG.SYS. Si desea eliminar dichas referencias, suprímalas del archivo CONFIG.SYS.

Nota: Si Netscape Communicator se está ejecutando mientras se desinstala el Kit del desarrollador, la desinstalación no se realizará correctamente. Debe concluir Netscape Communicator y después iniciar el proceso de desinstalación.

### 6.1 Método de escritorio

Para desinstalar utilizando el objeto Eliminar el Kit del desarrollador, siga los pasos siguientes:

1. Abra la carpeta Sistema OS/2.
2. Abra la carpeta Configuración del sistema.
3. Abra la carpeta Desinstalar características. Si está desinstalando en un sistema OS/2 Warp 4, abra la carpeta Instalar/eliminar y luego la carpeta Desinstalar características.
4. Efectúe una doble pulsación sobre el objeto Eliminar el Kit del desarrollador para OS/2 para iniciar el programa de desinstalación.

Si ha extraído archivos de fonts adicionales o archivos de plug-in de Java como, por ejemplo, plugin.exe o mzplugin.exe, y desea eliminarlos del sistema, vaya a la unidad y directorio donde los ha instalado y suprímalos.

### 6.2 Método de línea de mandatos de OS/2

Para iniciar la desinstalación, asegúrese de que se encuentra en la unidad raíz donde está instalado el Entorno de ejecución. En una línea de mandatos de OS/2, entre:

         JAVA131/UNINSTAL/UNINSTAL

El programa de desinstalación le guía por el proceso de desinstalación. Sólo se eliminan los archivos y directorios creados por el proceso de instalación. Por ejemplo, el directorio HOTJAVA creado al ejecutar el Visor de applets no se elimina durante la desinstalación.

Si ha extraído archivos de fonts adicionales o archivos de plug-in de Java como, por ejemplo, plugin.exe o mzplugin.exe, y desea eliminarlos del sistema, vaya a la unidad y directorio donde los ha instalado y suprímalos.

### 6.3 Desinstalación del Kit del desarrollador desde WorkSpace On-Demand 2.0

El soporte de desinstalación del Kit del desarrollador requiere acceso a un objeto de inventario (Java 1.3) en el directorio de características instaladas (\os2\install\installed features). Si instala el Kit del Desarrollador tanto para el cliente WorkSpace On-Demand 2.0 como para el servidor WorkSpace On-Demand 2.0, el objeto de inventario Java 1.3 resulta dañado o se sustituye. Por tanto, no utilice el programa de desinstalación para eliminar los componentes del Kit del desarrollador del espacio del cliente.

En su lugar, suprima la estructura de directorios [unidadrpl]\ibmlan\rpl\bb20.xx\JAVA131 y todas las referencias que se hacen a este directorio que se añadieron a los directorios de la imagen del cliente WorkSpace On-Demand. (Como por ejemplo, los archivos CONFIG.SYS, OS2.INI y FIT.)

Para eliminar el Kit del desarrollador del servidor, suprima la estructura de directorios \JAVA131. Puede suprimirla desde la carpeta Unidades de la carpeta Sistema OS/2.

### 6.4 Cómo realizar una instalación desatendida

Para desinstalar el Kit del desarrollador, entre el siguiente mandato en una sola línea en la línea de mandatos de OS/2:

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

### 6.5 Eliminación del Kit del desarrollador como JVM por omisión

Para eliminar o sustituir el Kit del desarrollador como la JVM (Máquina Virtual Java) por omisión, elimine la sentencia x:\JAVA131\JRE\BIN; de la sentencia PATH del archivo CONFIG.SYS. Para que los cambios surtan efecto, reinicie el sistema.

## 7.0 LIMITACIONES CONOCIDAS

- Si instala el Kit del desarrollador como la JVM por omisión, se sabe que hay aplicaciones que tendrán anomalías. Estas aplicaciones son:
  - LVMGUI: La interfaz gráfica de usuario para el Gestor de volúmenes lógicos
  - Algunos componentes de TCP/IP

- El Kit del desarrollador no puede grabar ni leer un archivo que tenga dos gigabytes o más.

- Si baja e instala las extensiones de seguridad JCE (Java Cryptography Extensions), elimine el archivo jar de JCA (Java Cryptography Archictecture) (jre/lib/ext/ibmjca.jar) durante el proceso de instalación. Puesto que las funciones de JCA son un subconjunto de JCE, es posible que el Kit del desarrollador no funcione correctamente con ambos instalados.

- El puente JDBC-ODBC (Conectividad de base de datos Java-conectividad de base de datos abierta) no está soportado.

- El plug-in de Java no da soporte a la impresión en este release del Kit del desarrollador.

- Algunas aplicaciones podrían tener un código para buscar los ejecutables del Kit del desarrollador en el JAVA131\bin. En realidad, estos ejecutables se encuentran en el directorio x:\JAVA131\jre\bin\. Si detecta una aplicación semejante, escriba lo siguiente en una línea de mandatos para copiar los ejecutables al directorio JAVA131\bin:

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

  donde x es la unidad en la que se ha instalado el Kit del desarrollador. Por omisión, JAVA131 es el nombre del directorio.

  Si aplica un nivel de servicio al Kit del desarrollador, repita el paso descrito anteriormente tras aplicar el nivel de servicio.

- Cuando utilice el plug-in de Java de IBM, espere a que las applets terminen de cargarse para evitar que el navegador se cuelgue. Por ejemplo, si pulsa el botón de retroceso y, a continuación, el botón de avance mientras la applet se está cargando, es posible que las páginas HTML no se puedan cargar.

- Aunque el plug-in de Java de IBM ofrece soporte para el mismo nivel de funcionalidad LiveConnect que el de la versión actual de Sun del plug-in de Java (1.3.0_01), se han identificado algunas anomalías de LiveConnect con ambos plug-in. Cuando informe sobre anomalías relacionadas con LiveConnect, indique si se producen en la versión del plug-in de Sun o en la de IBM.

- El tamaño máximo de la antememoria del disco HPFS es de dos megabytes. Este tamaño máximo puede limitar el rendimiento del Kit del desarrollador. En varios entornos, el rendimiento del sistema y el tiempo de carga de aplicaciones se puede mejorar utilizando una antememoria de mayor tamaño. Los sistemas de archivos OS/2 que pueden constituir una alternativa por dar soporte a un tamaño mayor de antememoria son los siguientes:

  - JFS incluido en OS/2 Warp Server para e-business de IBM
  - HPFS 386 incluido en OS/2 Warp Server Advanced de IBM
- Si experimenta problemas en una máquina Pentium(R) MMX o inferior, puede solucionarlos estableciendo la variable de entorno JAVA_COMPILER=NONE.

## 8.0 AVISOS

(c) Copyright International Business Machines Corporation 1999, 2002. Reservados todos los derechos.

Derechos restringidos de los usuarios del gobierno de los EE.UU. - El uso, duplicación o divulgación está restringido por el GSA ADP Schedule Contract con IBM Corp.

Consulte a su representante local de IBM para obtener información acerca de los productos y servicios actualmente disponibles en su zona. Cualquier referencia a un producto, programa o servicio IBM no pretende afirmar o implicar que sólo se pueda utilizar dicho producto, programa o servicio IBM. En su lugar puede utilizarse cualquier producto, programa o servicio funcionalmente equivalente que no vulnere los derechos de propiedad intelectual de IBM. Sin embargo, corresponde al usuario la responsabilidad de evaluar y verificar la operación de cualquier producto, programa o servicio que no sea IBM.

IBM puede tener aplicaciones patentadas o pendientes de patente que cubran el tema tratado en este documento. El suministro de este documento no le otorga ninguna licencia sobre estas patentes. Puede enviar consultas sobre licencias por escrito a la dirección siguiente:

IBM Director of Licensing
IBM Corporation
North Castle Drive
Armonk, NY 10504-1758
EE.UU.

Para consultas sobre licencias relacionadas con la información de doble byte (DBCS), póngase en contacto con el Departamento de la propiedad intelectual de IBM de su país o envíe las consultas por escrito a la dirección siguiente:

IBM World Trade Asia Corporation Licensing
2-31 Roppongi 3-chome, Minato-ku
Tokio 106-0032, Japón

El párrafo siguiente no se aplica en el Reino Unido o cualquier otro país en el que tales disposiciones sean incoherentes con la legislación nacional:

INTERNATIONAL BUSINESS MACHINES CORPORATION PROPORCIONA ESTA PUBLICACIÓN "TAL CUAL" SIN GARANTÍAS DE NINGÚN TIPO, NI EXPLÍCITAS NI IMPLÍCITAS, INCLUYENDO PERO NO LIMITÁNDOSE A ELLAS, LAS GARANTÍAS IMPLÍCITAS DE NO VULNERACIÓN, COMERCIALIZACIÓN O IDONEIDAD PARA UN PROPÓSITO DETERMINADO.

Algunos estados no contemplan la exclusión de garantías, ni implícitas ni explícitas, en determinadas transacciones, por lo que cabe la posibilidad de que esta declaración no sea aplicable en su caso.

Esta información puede contener imprecisiones técnicas o errores tipográficos. Periódicamente se efectúan cambios en la información incluida en este documento; estos cambios se incorporarán en nuevas ediciones de la información. IBM puede efectuar en cualquier momento mejoras y/o cambios en los productos y/o programas que se describen en esta publicación sin previo aviso.

Las referencias hechas en esta publicación a sitios web que no son de IBM se proporcionan únicamente por cortesía y de ningún modo deben interpretarse como un respaldo público de dichos sitios web. Los materiales de estos sitios web no forman parte de los materiales de IBM para este producto y el uso que se haga de estos sitios web es de la entera responsabilidad del usuario.

IBM puede utilizar o distribuir la información que se le proporcione en la forma que considere más adecuada, sin incurrir por ello en ninguna obligación con el remitente.

Los poseedores de la licencia de este programa que deseen obtener información acerca del mismo con el propósito de permitir (i) el intercambio de información entre programas creados independientemente y otros programas (incluido éste) y (ii) la utilización mutua de la información intercambiada, deben ponerse en contacto con la dirección siguiente:

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

Esta información estará disponible, sujeta a los términos que correspondan, lo que en algunos casos incluirá el pago de una cuota.

IBM proporciona el programa con licencia descrito en este documento y todo el material con licencia disponible para el mismo bajo los términos del Acuerdo de cliente IBM, el Acuerdo internacional de licencia de programas IBM o cualquier acuerdo equivalente entre las dos partes.

Cualquier información acerca del rendimiento que contenga el presente documento se ha determinado en un entorno controlado. Por lo tanto, los resultados obtenidos en otros entornos operativos pueden variar significativamente. Algunas de las mediciones se han realizado en sistemas a nivel de desarrollo, por lo que no se garantiza que dichas mediciones sean las mismas en los sistemas disponibles habituales. Además, es posible que algunas de las medidas se hayan estimado por medio de extrapolaciones. Los resultados reales pueden variar. Los usuarios de este documento deben comprobar los datos correspondientes a su entorno en concreto.

La información relativa a productos que no son de IBM se ha obtenido de los proveedores de esos productos, de los anuncios publicados por los mismos o de otras fuentes a disposición del público. IBM no ha probado estos productos y no puede confirmar con precisión el rendimiento, la compatibilidad o cualquier otra reclamación relacionada con productos que no son IBM. Las consultas acerca de las posibilidades de productos que no son IBM deben dirigirse a los proveedores de estos productos.

Todas las declaraciones relacionadas con futuras decisiones o intenciones de IBM están sujetas a cambios o retirada sin previo aviso, y sólo representan metas y objetivos.

LICENCIA DE COPYRIGHT:

Esta información contiene programas de aplicación de ejemplo en lenguaje fuente, que ilustra técnicas de programación en varias plataformas operativas. Puede copiar, modificar y distribuir estos programas de ejemplo, en cualquier formato sin efectuar ningún pago a IBM, sólo a efectos de desarrollo, utilización, márketing o distribución de programas de aplicación que se ajusten a la interfaz de programas de aplicación de la plataforma operativa para la que se hayan escrito los programas.

Estos ejemplos no se han comprobado bajo todas las condiciones. IBM, por tanto, no puede garantizar, ni siquiera implícitamente, que estos programas sean fiables, comercializables o funcionales. Puede copiar, modificar y distribuir estos programas de ejemplo, en cualquier formato sin efectuar ningún pago a IBM, sólo a efectos de desarrollo, utilización, márketing o distribución de programas de aplicación que se ajusten a las interfaces de programas de aplicación de IBM.

Esta edición corresponde a la versión 1.3.1 del Kit del desarrollador IBM OS/2 Warp, Java(TM) 2 Technology Edition y a todos los releases y modificaciones posteriores hasta que se indique lo contrario en nuevas ediciones.

Este software se basa en parte del trabajo del Free Type Project. Para obtener más información sobre el Free Type Project, consulte la dirección: http://www.freetype.org

## 9.0 MARCAS REGISTRADAS

Los términos siguientes son marcas registradas de International Business Machines Corporation en los Estados Unidos y/o en otros países:

IBM
OS/2
OS/2 Warp
NetView
WebExplorer

Java y todos los logotipos y las marcas registradas basados en Java son marcas registradas o marcas comerciales registradas de Sun Microsystems, Inc. en los Estados Unidos y/o en otros países.

Microsoft y Windows NT son marcas registradas de Microsoft Corporation en los Estados Unidos y/o en otros países.

Intel y Pentium son marcas registradas de Intel Corporation en los Estados Unidos y en otros países.

Los demás nombres de compañías, productos y servicios pueden ser marcas registradas o de servicio de otras empresas.

[FIN DE LA GUÍA DE INSTALACIÓN Y CONFIGURACIÓN]