IBM(R) Runtime Environment para Windows(R), Java (TM) 2 Technology Edition, Versión 1.3.1, versión de 32 bits
- README -


Nota: antes de utilizar esta información y el producto al que da soporte, asegúrese de leer la información general que aparece en Avisos.

Esta edición del README se aplica a IBM Developer Kit para Windows, Java 2 Technology Edition, Versión 1.3.1, versión de 32 bits y a todos los releases y modificaciones subsiguientes, a menos que se indique lo contrario en nuevas ediciones.

(c) Copyright Sun Microsystems, Inc. 1997, 2001, 901 San Antonio Rd., Palo Alto, CA 94303 USA. Reservados todos los derechos.

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

Derechos restringidos para los usuarios del Gobierno de los Estados Unidos - Su uso, duplicación o divulgación están restringidos por el GSA ADP Schedule Contract con IBM Corp.


Este archivo README proporciona información acerca del paquete Runtime Environment que se proporciona con el IBM(R) Developer Kit para Windows(R), Java(TM) 2 Technology Edition, Versión 1.3.1, versión de 32 bits. Utilice este archivo README si tiene previsto distribuir el Runtime Environment con su producto.

El Runtime Environment recibe soporte en los siguientes productos:


Contenido

  • Visión general
  • Archivos incluidos con el Runtime Environment
  • Compilador just-in-time (JIT)
  • Cómo inhabilitar el JIT
  • Cómo habilitar el JIT
  • Cómo determinar si el JIT está habilitado
  • Obtención del número de versión y de fabricación de IBM
  • Invocación de Runtime Environment
  • Requisitos de redistribución
  • Java Runtime Interpreter
  • Propiedades del sistema
  • Ejemplo de ejecución
  • Instalación de la aplicación en un sistema del usuario
  • Cómo especificar una política de recopilación de desechos
  • Tiempo de pausa
  • Reducción del tiempo de pausa
  • Entornos con almacenamientos dinámicos muy llenos
  • Información adicional sobre la recopilación de desechos
  • Cómo ejecutar aplicaciones Java con tecnologías de asistencia nativas
  • Documentación de tiempo de ejecución
  • Avisos
  • Marcas registradas

  • Visión general

    El Runtime Environment contiene la Java Virtual Machine (JVM), clases Java de Sun Microsystems y archivos de soporte. El Runtime Environment no contiene todas las clases que se hallan en el paquete Developer Kit.


    Archivos incluidos con el Runtime Environment

    Runtime Environment incluye todos los archivos .dll más las clases que dan soporte a un programa Java en tiempo de ejecución. Runtime Environment no incluye ninguna de las herramientas de desarrollo, del tipo appletviewer o javac, ni clases que pudieran pertenecer sólo a un sistema de desarrollo.

    Consulte Requisitos de redistribución para obtener información acerca de los archivos que se deben redistribuir con programas Java.


    Compilador just-in-time (JIT)

    El compilador JIT genera código máquina de forma dinámica para las secuencias de códigos de bytes utilizadas con más frecuencia en una aplicación o applet Java durante la ejecución. El compilador JIT (jitc.dll) se habilita por omisión.

    Cómo inhabilitar el JIT

    Es posible inhabilitar el JIT para contribuir a aislar un problema con una aplicación Java, un applet o el mismo compilador.

    Hay dos maneras de inhabilitar el JIT:

    Cómo habilitar el JIT

    Para habilitar el JIT, escriba lo siguiente en un indicador de mandatos:

                 set JAVA_COMPILER=jitc
    

    Cómo determinar si el JIT está habilitado

    Para verificar si el JIT está habilitado o no, escriba lo siguiente en un indicador de mandatos:

                 java -version
    

    Si el JIT se está utilizando, aparece un mensaje similar al siguiente:

        JIT enabled: jitc
    

    En caso contrario, aparecerá el mensaje siguiente:

        JIT disabled
    

    Obtención del número de versión y de nivel de compilación de IBM

    Para obtener el número de versión y de compilación de IBM, escriba lo siguiente en el indicador de mandatos:

                 java -version
    

    Invocación de Runtime Environment

    Para ejecutar una aplicación Java, escriba el texto siguiente en un indicador de mandatos:

              java nombreclase
    

    donde nombreclase es el nombre del archivo de clase Java (la aplicación Java) que desea ejecutar. Para obtener información acerca de los parámetros que puede utilizar al invocar la herramienta java, vea Java Runtime Interpreter.

    Nota: si no ha instalado el Entorno de ejecución (Runtime Environment) como JVM del sistema, primero debe establecer la vía de acceso que incluya los directorios apropiados. Para actualizar la vía de acceso, escriba lo siguiente en un indicador de mandatos:

        set path=dirjava\jre\bin;%path%
    

    donde dirjava es el directorio en el que se ha instalado Runtime Environment. Por omisión, este directorio es C:\Archivos de programa\IBM\Java131.


    Requisitos de redistribución

    Cuando redistribuya el Runtime Environment, es necesario que incluya archivos del siguiente paquete:

    Para obtener información concreta acerca de los archivos que se deben redistribuir, consulte el documento de acuerdo de licencia que acompaña a este producto.

    El término required significa que los poseedores de licencia que distribuyen el tiempo de ejecución deben incluir dichos archivos con su programa, los utilice o no.

    Runtime Environment incluye los directorios \bin y \lib y sus subdirectorios. Estos dos directorios y sus subdirectorios deben residir en el mismo directorio. El directorio bin contiene archivos ejecutables y bibliotecas nativas. El directorio lib contiene los archivos de clase y property.

    Todos los archivos de los directorios bin y lib son necesarios para la redistribución.

    Nota: la biblioteca de tiempo de ejecución del código nativo C, msvcrt.dll, se halla en el directorio de sistema de Windows. Asegúrese de que dicho archivo se halla en el directorio de sistema de Windows. La ubicación de este directorio varía en diferentes sistemas operativos, pero acostumbra a ser:


    Java Runtime Interpreter

    La herramienta java invoca el Java Runtime Interpreter para ejecutar aplicaciones Java. La sintaxis para iniciar la herramienta java es la siguiente:

    Hay disponible una alternativa a la herramienta java, javaw. La herramienta javaw es idéntica a la herramienta java, excepto que ésta no invoca una ventana de consola. La sintaxis para iniciar la herramienta javaw es la siguiente:

        javaw [opciones] nombreclase <args>
    

    Las opciones para la herramienta Java son las siguientes:


    Propiedades de sistema

    La propiedad del sistema ibm.jvm.bootclasspath se puede definir utilizando la opción -D, que se describe en el apartado Java Runtime Interpreter. El valor de esta propiedad se utiliza como vía de acceso de búsqueda adicional, insertándose entre un valor definido por -Xbootclasspath/p: y la vía de acceso bootclass. La vía de acceso de la clase de arranque es la definida por omisión o bien la definida mediante la opción .-Xbootclasspath:.


    Ejemplo de ejecución

    La página Web de Sun contiene un ejemplo "Hello World". El ejemplo muestra cómo crear una aplicación Java sencilla que se ejecuta y se empaqueta en el Java Runtime Environment. El sitio Web de Sun es http://java.sun.com y puede hallar el ejemplo "Hello World" buscando en "Hello World" y "Notes for Developers".

    El ejemplo muestra cómo pasar de forma muy sencilla de desarrollar aplicaciones con un Developer Kit a utilizar las técnicas más novedosas de Runtime Environment.


    Instalación de la aplicación en un sistema de usuario

    En su producto debe proporcionar una manera de:

    Si redistribuye Runtime Environment, deberá asegurarse de que el procedimiento de instalación no altere ninguna instalación existente (a menos que la versión existente de Java Runtime Environment sea una versión antigua).

    El método preferido consiste en tomar los archivos contenidos en el archivo comprimido de Runtime Environment de redistribución, ibm-jre-n131p-win32-x86.zip, e instalarlo en la misma estructura de directorios. Asegúrese de incluir todos los archivos de los directorios bin y lib y sus subdirectorios. Estos directorios se describen en Requisitos de redistribución. El software de Runtime Environment sólo se puede redistribuir si se incluyen todos estos archivos. A efectos prácticos, cuando distribuya su aplicación, ésta tendrá su propia copia del Runtime Environment.

    Si usa este método, no intente imitar los pasos de instalacón realizados por el programa de instalación del Runtime Environment.

    Nota: cuando instala el Runtime Environment, debe anotar la información de programa en el Registro de Windows, como sigue:


    Cómo especificar una política de recopilación de desechos

    Este Developer Kit presenta la opción de tiempo de ejecución JVM -Xgcpolicy para especificar la política de recopilación de desechos.

    -Xgcpolicy acepta dos valores, optthruput (el valor por omisión) y optavgpause. La opción controla el comportamiento del recopilador de desechos, realizando intercambios entre la salida de la aplicación y el sistema en general y los tiempos de pausa provocados por la recopilación de desechos.

    El formato de la opción y sus valores son:

    -Xgcpolicy:optthruput
    y
    -Xgcpolicy:optavgpause

    Tiempo de pausa

    Cuando un intento de una aplicación de crear un objeto no se puede cumplir inmediatamente con el espacio disponible en el almacenamiento dinámico, corresponde al recopilador de desechos identificar los objetos sin referencia (desechos), suprimirlos y reinstaurar el almacenamiento dinámico a un estado en el que las peticiones de asignación inmediatas y posteriores se puedan satisfacer rápidamente. Estos ciclos de recopilación de desechos provocan pausas inesperadas ocasionales en la ejecución del código de la aplicación. A medida que el tamaño y la complejidad de las aplicaciones aumenta y los almacenamientos dinámicos crecen en consecuencia, este tiempo de pausa de recopilación de desechos tiende a aumentar en duración e importancia. El valor por omisión de la recopilación de desechos, optthruput, proporciona una salida muy alta para las aplicaciones, pero al coste de estas pausas ocasionales, que pueden variar de unos pocos milisegundos a varios segundos, en función del tamaño del almacenamiento dinámico y la cantidad de desechos.

    Reducción del tiempo de pausa

    El valor optavgpause reduce substancialmente el tiempo invertido en estas pausas de recopilación de desechos, además de limitar el efecto de incremento del tamaño del almacenamiento dinámico en la duración de la pausa de recopilación de desechos. Esto tiene una importancia especial en configuraciones con almacenamientos dinámicos grandes. (Un almacenamiento dinámico se considera grande cuando es al menos de 1 GB.) Los tiempos de pausa se reducen intercalando actividades de recopilación de desechos con la ejecución normal del programa. Esta intercalación comporta una pequeña reducción de la salida de la aplicación.

    Entornos con almacenamientos dinámicos muy llenos

    Si el almacenamiento dinámico de Java está casi lleno y hay muy pocos desechos que recopilar, es posible que las peticiones de objetos nuevos no se puedan satisfacer rápidamente ya que no hay espacio disponible inmediatamente. Si se trabaja con un almacenamiento dinámico casi lleno, el rendimiento de las aplicaciones puede resentirse sin importar cuál de las opciones anteriores se usa y, si se siguen realizando peticiones de más espacio de almacenamiento dinámico, la aplicación recibe una excepción de Memoria agotada, que provoca la interrupción del JVM si esta excepción no se detecta y gestiona. En estas situaciones, se recomienda incrementar el tamaño del almacenamiento dinámico mediante la opción -Xmx o reducir el número de objetos de aplicación en uso.

    Información adicional sobre la recopilación de desechos

    Para obtener información adicional acerca del ajuste del tamaño del almacenamiento dinámico y las implicaciones de la recopilación de recursos en el rendimiento de las aplicaciones, vea:


    Cómo ejecutar aplicaciones Java con tecnologías de asistencia nativas

    Sun proporciona el Java Access Bridge para facilitar a las tecnologías de asistencia nativas de Windows, como los lectores de pantalla, acceso al soporte Java Accessibility en una aplicación Java. Estas tecnologías de asistencia nativas de Windows deben haberse escrito para realizar llamadas al Java Access Bridge.

    El Java Access Bridge que facilita Sun incluye un programa de instalación, que coloca cinco archivos en los directorios correctos: access-bridge.jar, jaccess.jar, accessibility.properties, JavaAccessBridge.dll y WindowsAccessBridge.dll.

    Si ya ha instalado el IBM Accessibility Bridge (JawBridge), que permite que el Windows 2000 Magnifier funcione con aplicaciones Swing, y desea ejecutar al mismo tiempo el Java Access Bridge, edite la línea del archivo accessibility.properties para que diga:

    assistive_technologies=com.sun.java.accessibility.AccessBridge, JawBridge Comente la línea que empieza por # para desactivar ambas pasarelas.

    El siguiente sitio Web le indica cómo descargar el Java Access Bridge:


    Documentación de tiempo de ejecución

    Cada archivo property contiene comentarios que describen la utilidad del archivo y cómo modificarlo.


    Avisos

    Esta información se ha desarrollado para productos y servicios que se ofrecen en los EE.UU.

    IBM puede que no ofrezca los productos, servicios o características que se discuten en este documento en otros países. 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 de IBM no pretende afirmar ni implica que sólo se pueda utilizar dicho producto, programa o servicio de IBM. En su lugar, puede utilizarse cualquier producto, programa o servicio funcionalmente equivalente que no infrinja ninguno de los derechos de propiedad intelectual de IBM. Sin embargo, es responsabilidad del usuario evaluar y verificar el funcionamiento de cualquier producto, programa o servicio que no sea de IBM.

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

    Para consultas de 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:

    El párrafo siguiente no se aplica al Reino Unido ni a 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ÍA DE NINGUNA CLASE, YA SEA EXPLICITA O IMPLÍCITA, INCLUIDAS, PERO SIN LIMITARSE 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 limitación de responsabilidades, 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 realizarán modificaciones en la información aquí contenida; dichos cambios se incorporarán en nuevas ediciones de la publicación. IBM puede efectuar mejoras y/o cambios en los productos y/o programas descritos en esta información en cualquier momento y sin previo aviso.

    Cualquier referencia hecha en esta información a sitios Web que no son de IBM se proporciona únicamente para su comodidad y no debe considerarse en modo alguno como promoción 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 facilite de la manera que considere apropiada sin incurrir en obligaciones 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:

    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 de 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. Es posible que algunas medidas se hayan tomado en sistemas de nivel de desarrollo y no hay garantías de que estas medidas serán iguales en los sistemas habitualmente disponibles. Asimismo, algunas mediciones pueden haber sido estimadas mediante la extrapolación. Los resultados reales pueden variar. Los usuarios de este documento deben verificar los datos aplicables para su entorno específico.

    La información relativa a productos que no son de IBM se ha obtenido de los proveedores de estos productos, de los anuncios públicos o de otras fuentes disponibles públicamente. IBM no ha probado esos productos y no puede confirmar la precisión del rendimiento, su compatibilidad o cualquier otra afirmación relacionada con productos que no son de IBM. Las preguntas sobre las posibilidades de los productos que no son de IBM deben dirigirse a los proveedores de dichos productos.


    Marcas registradas

    IBM es una marca registrada de International Business Machines Corporation en los Estados Unidos y/o en otros países.

    Java y todas las marcas y logotipos basados en Java son marcas comerciales o marcas registradas de Sun Microsystems, Inc. en los Estados Unidos y/o en otros países. Sun Microsystems, Inc. es la empresa propietaria y tiene licencia exclusiva sobre la tecnología Java.

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

    Otros nombres de empresas, productos o servicios pueden ser marcas registradas o de servicio de otros.