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 64 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 64 bits. Utilice este archivo README si tiene previsto distribuir el Runtime Environment con su producto.
Este Runtime Environment recibe soporte en los siguientes productos:
El Runtime Environment contiene la Java Virtual Machine (JVM), clases Java y archivos de soporte. El Runtime Environment no contiene todas las clases que se hallan en el paquete Developer Kit.
Runtime Environment incluye archivos .dll más las clases que dan soporte a un programa Java de Sun Microsystems 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.
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.
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:
set JAVA_COMPILER=NONE
También puede establecer permanentemente JAVA_COMPILER en la configuración de Entorno de las Propiedades del sistema. Seleccione Panel de control y Sistema; a continuación, en la pestaña Avanzada, seleccione Variables de entorno).
java -Djava.compiler=NONE myapp
Para habilitar el JIT, escriba lo siguiente en un indicador de mandatos:
set JAVA_COMPILER=jitc
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
Cuando se ejecutan varios JVM, puede que el JIT necesite una gran cantidad de memoria al compilar métodos grandes o métodos que tienen varias expresiones aritméticas complejas. Puede que necesite incrementar de manera significativa la memoria virtual del sistema.
Para obtener el número de versión y de compilación de IBM, escriba lo siguiente en el indicador de mandatos:
java -version
Para ejecutar una aplicación Java, escriba el texto siguiente en un indicador de mandatos:
java classname
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 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
La herramienta java invoca el Java Runtime Interpreter para ejecutar aplicaciones Java. La sintaxis para iniciar la herramienta java es la siguiente:
java [-opciones] nombreclase <args>
El argumento nombreclase
es el nombre del archivo de clase que
se debe ejecutar. Los argumentos que tengan que acompañar a la clase se deben colocar tras el
nombreclase
en la línea de mandatos.
java -jar [-opciones] archivojar <args>
El argumento archivojar
es el nombre del archivo jar que se debe ejecutar. Los
argumentos que tengan que acompañar al archivo jar se deben colocar después de
archivojar
en la línea de mandatos.
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:
Las opciones -X no son estándar y están sujetas a cambios sin previo aviso.
La siguiente 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. La página Web se halla en:
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.
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-win64-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. 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 instalació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:
Java2 Runtime Environment/1.3.1/JavaHome | directorio raíz de java\jre |
Java2 Runtime Environment/1.3.1/RuntimeLib | directorio y archivo de java\jre\bin\classic\jvm.dll |
Java2 Runtime Environment/1.3.1/Microversion | 0 |
IBM Developer Kit para Windows, Java 2 Technology Edition, Versión 1.3.1, versión de 64 bits presenta la opción JVM de tiempo de ejecución -Xgcpolicy para especificar una 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:optthruputy
-Xgcpolicy:optavgpause
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.
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.
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.
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:
Cada archivo property contiene comentarios que describen la utilidad del archivo y cómo modificarlo.
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.
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.