home *** CD-ROM | disk | FTP | other *** search
/ PC Pro 2003 March / DPPCPRO0303.ISO / Netfusion / data1.cab / Program_Executable_Files / NetObjects_System / JRE / 1.1 / README < prev   
Encoding:
Text File  |  1998-12-10  |  16.4 KB  |  403 lines
  1.  
  2.           IBM WIN32 Runtime Environment, Java(TM) Edition
  3.           ===============================================
  4.  
  5. The JRE is provided as a self-extracting InstallShield executable
  6. (ibm-jre-n116p-win32-x86.exe) and as a Zip file (ibm-jre-n116p-win32-x86.zip).
  7.  
  8. Previous releases of the JRE executable used pre-existing registry settings and
  9. environment variables to generate the classpath. This release ignores
  10. those settings. The JRE use the location of the executable to
  11. generate the Java home directory and hence the location of the supplied classes.
  12.  
  13. The IBM build number can be obtained by entering:
  14.   jre -d
  15.  
  16.  
  17. -----------------------------------------------------------------------
  18. CONTENTS
  19.  
  20.   Overview of the Java Runtime Environment
  21.     - Introduction
  22.     - The Java Runtime Interpreter
  23.     - Just-In-Time Compiler
  24.     - Euro Currency Symbol Support
  25.     - Required vs. Optional Files
  26.        - Required Files
  27.        - Optional Files
  28.  
  29.   Running the Java Runtime
  30.     - Java Runtime Example
  31.     - Runtime Documentation
  32.  
  33.  
  34. =======================================================================
  35.                  Overview of the Java Runtime Environment
  36. =======================================================================
  37.  
  38. -----------------------------------------------------------------------
  39. Introduction
  40. -----------------------------------------------------------------------
  41.  
  42. This is version 1.1.6 of the Java Runtime Environment, also known as
  43. the Java Runtime, or JRE.  The Java Runtime is the minimum standard
  44. Java Platform for running Java programs.  It contains the Java
  45. Virtual Machine, Java Core Classes and supporting files.
  46.  
  47. The JRE can be invoked from the command line by using the jre tool
  48. (see the following section). On Windows platforms, the jre tool will
  49. ignore the CLASSPATH environment variable. The -cp option is recommended
  50. to specify an application's class path.
  51.  
  52. The JRE includes all of the non-debuggable .dll or .so files plus
  53. the necessary classes from the JDK 1.1.6 to support a runtime-only
  54. program.  The JRE does not include any of the development tools
  55. (such as appletviewer or javac) or classes that would pertain only
  56. to a development system.
  57.  
  58.  
  59. -----------------------------------------------------------------------
  60. The Java Runtime Interpreter
  61. -----------------------------------------------------------------------
  62.  
  63. The jre tool invokes the Java Runtime interpreter for executing Java
  64. applications. The syntax for the jre command is:
  65.  
  66.         jre [ options ] classname <args>
  67.  
  68. The classname argument is the name of the class file to be
  69. executed. Any arguments to be passed to the class must be placed
  70. after the classname on the command line.
  71.  
  72. An alternative version of the tool, jrew, is available for Win32. The
  73. jrew command is identical to jre, except that a console window is not
  74. invoked. The syntax of the jrew command is
  75.  
  76.         jrew [ options ] classname <args>
  77.  
  78. The JRE tool will ignore the CLASSPATH environment variable. The
  79. -cp option is recommended to specify an application's class path.
  80.  
  81. Options for the jre and the jrew commands are as follows:
  82.  
  83.    -classpath path      Specifies the path that jre uses to
  84.                         look up classes. Overrides the default
  85.                         classpath.
  86.  
  87.    -cp path             Prepends the specified path to the default
  88.                         classpath that jre uses to look up classes.
  89.  
  90.    -help                Print a usage message.
  91.  
  92.    -mx x                Sets the maximum size of the memory allocation
  93.                         pool (the garbage collected heap) to x. The
  94.                         default is 16 megabytes of memory. x must be
  95.                         greater than or equal to 1000 bytes.
  96.  
  97.    -ms x                Sets the startup size of the memory allocation
  98.                         pool (the garbage collected heap) to x. The
  99.                         default is 1 megabyte of memory. x must be
  100.                         greater than 1000 bytes.
  101.  
  102.    -noasyncgc           Turns off asynchronous garbage collection. When
  103.                         activated, no garbage collection takes place
  104.                         unless it is explicitly called or the program
  105.                         runs out of memory.
  106.  
  107.    -noclassgc           Turns off garbage collection of Java classes.
  108.                         By default, the Java interpreter reclaims space
  109.                         for unused Java classes during garbage collection.
  110.  
  111.    -nojit               Don't invoke the Just In Time bytecode
  112.                         compiler. The virtual machine directly
  113.                         interprets bytecodes, without converting them
  114.                         to native code.
  115.  
  116.    -ss x                The -ss option sets the maximum stack size that
  117.                         can be used by C code in a thread to x. The
  118.                         default units for x are bytes. The value of x
  119.                         must be greater than or equal to 1000 bytes.
  120.  
  121.    -oss x               The -oss option sets the maximum stack size
  122.                         that can be used by Java code in a thread to x.
  123.                         The default units for x are bytes. The value of
  124.                         x must be greater than or equal to 1000 bytes.
  125.  
  126.    -v, -verbose         Causes jre to print a message to stdout each
  127.                         time a class file is loaded.
  128.  
  129.    -verify              Performs byte-code verification on the class
  130.                         file. Beware, however, that java -verify does
  131.                         not perform a full verification in all
  132.                         situations. Any code path that is not actually
  133.                         executed by the interpreter is not verified.
  134.                         Therefore, java -verify cannot be relied upon to
  135.                         certify class files unless all code paths in
  136.                         the class file are actually run.
  137.  
  138.    -verifyremote        Runs the verifier on all code that is loaded
  139.                         into the system via a classloader. verifyremote
  140.                         is the default for the interpreter.
  141.  
  142.    -noverify            Turns verification off.
  143.  
  144.    -verbosegc           Causes the garbage collector to print out
  145.                         messages whenever it frees memory.
  146.  
  147.    -DpropName=value     Defines a property value. propName is the name
  148.                         of the property whose value you want to change
  149.                         and value is the value to change it to. For
  150.                         example, the command
  151.                         java -Dawt.button.color=green ...
  152.                         sets the value of the property awt.button.color
  153.                         to "green".
  154.  
  155.  
  156. -----------------------------------------------------------------------
  157. Just-In-Time Compiler
  158. -----------------------------------------------------------------------
  159. The JRE includes the IBM JIT (ibmjitc.dll) which is used by default.
  160. To disable the JIT, pass the -nojit option to the jre:
  161.  
  162.   jre -nojit MyClass
  163.  
  164. The JRE also use the java.compiler property to determine JIT usage.
  165. The JRE ignores the JAVA_COMPILER environment variable.
  166.  
  167. Whether or not the JIT will be used can be determined by entering:
  168.   jre -d
  169.  
  170. If a JIT is in use, this will be indicated by
  171.  
  172.   compiler = enabled: ibmjitc
  173.  
  174.  
  175.  
  176. If no JIT is in use, this will be indicated by
  177.  
  178.   compiler = disabled
  179.  
  180.  
  181. -----------------------------------------------------------------------
  182. Euro Currency Symbol Support
  183. -----------------------------------------------------------------------
  184. The JRE includes support for the Euro currency symbol as detailed in
  185. this section.
  186.  
  187. Platform Support
  188. ----------------
  189. In order to take advantage of the support, the Operating System
  190. must also support the Euro. At present Microsoft's support is as follows:
  191.  
  192.  Windows NT 4 - Microsoft has posted a 'Windows NT 4.0 Euro product update'
  193.                 on their web site.  This update includes codepage support,
  194.                 fonts and keyboard drivers. It will also be included in
  195.                 Service Pack 4.
  196.  
  197.  Windows 95 - Microsoft has posted a 'Windows 95 beta 1 Euro product update'
  198.               on their web site.  This update includes fonts and keyboard
  199.               drivers
  200.  
  201.  Windows 98 - has codepage support for the euro, and appropriate fonts and
  202.               keyboard drivers.
  203.  
  204.  The encoded Windows core fonts which contain euro support are Times New Roman,
  205.  Courier New and Arial.
  206.  
  207.  If you need to change your keyboard layout or input locale (see Regional
  208.  Settings or Keyboard on the Control Panel) you should do this before
  209.  installing the appropriate Euro product update. The Microsoft web site
  210.  Euro Currency Symbol FAQ page details the keyboard layouts which support the
  211.  Euro. If your input locale is EN English (United States) please use
  212.  US-International rather than US as the keyboard layout. You can then use the
  213.  key combination right 'ALT' key + 5 to enter a euro character.
  214.  
  215.  
  216.  The Windows code pages which include or will include the euro are:
  217.  
  218.  1250 Central/Eastern European
  219.  1251 Cyrillic
  220.  1252 Western Europe
  221.  1253 Greek
  222.  1254 Turkish
  223.  1255 Hebrew
  224.  1256 Arabic
  225.  1257 Baltic
  226.  1258 Vietnamese
  227.  874 Thai
  228.  
  229. Further information about Operating System Support for the Euro may be added
  230. to the Microsoft web site.
  231.  
  232. Unicode
  233. -------
  234. The Unicode character for the euro is u'20ac'.
  235.  
  236. Codepage Converters
  237. -------------------
  238. The codepage converters for the codepages listed above have been modified to
  239. support the euro symbol. A number of additional codepage converters have been
  240. included to support the euro on IBM codepages, including those for EBCDIC. A
  241. new ISO codepage, ISO8859_15, has also been added.
  242.  
  243. Default codepage
  244. ----------------
  245. The default converter for Western Europe locales has been changed from 8859_1
  246. to Cp1252 as Cp1252 supports the euro and 8859_1 does not.
  247.  
  248. Locales
  249. -------
  250. A number of new 'ResourceBundle's have been created to support the euro. These
  251. are:
  252.  
  253.   LocaleElements_de_AT_EURO
  254.   LocaleElements_de_DE_EURO
  255.   LocaleElements_de_LU
  256.   LocaleElements_de_LU_EURO
  257.   LocaleElements_en_IE_EURO
  258.   LocaleElements_es_ES_EURO
  259.   LocaleElements_fi_FI_EURO
  260.   LocaleElements_fr_BE_EURO
  261.   LocaleElements_fr_FR_EURO
  262.   LocaleElements_fr_LU
  263.   LocaleElements_fr_LU_EURO
  264.   LocaleElements_it_IT_EURO
  265.   LocaleElements_nl_BE_EURO
  266.   LocaleElements_nl_NL_EURO
  267.   LocaleElements_pt_PT_EURO
  268.  
  269. The method java.util.Locale.getDisplayVariant() has been modified to lookup the
  270. localized name of the euro locale (in all cases, "Euro") from the resource data.
  271.  
  272. Collation
  273. ---------
  274. Collation of currency symbols traditionally follows the English collation order
  275. of the symbol name. Thus 'cent' is followed by 'dollar.' According to this scheme,
  276. the euro symbol will sort immediately following the dollar and dong currency
  277. symbols and before the French franc.
  278.  
  279. Java programs
  280. -------------
  281. Existing Java programs will run as before, with the exception of changes
  282. brought about by any new or altered default codeset converters (see below).
  283. Programs can use the following lines to get a locale that uses the euro from
  284. one that does not.
  285.  
  286. if (source.getVariant().indexOf("EURO") >= 0)
  287.   newLocale = source;
  288. else
  289.   newLocale = new Locale(source.getLanguage(), source.getCountry(),
  290.     source.getVariant().length()>0 ? (source.getVariant() + "_EURO") : "EURO");
  291.  
  292.  
  293. -----------------------------------------------------------------------
  294. Required vs. Optional Files
  295. -----------------------------------------------------------------------
  296.  
  297. The files that make up the JRE are divided into two categories:
  298. required and optional.  The files that are marked "optional" here do
  299. not need to be included in redistributions of the JRE with the licensee's
  300. program. Most of the optional files provide localization support for
  301. languages.
  302.  
  303. The term "required" means licensees who distribute the runtime
  304. must include those files with their program, whether or not their
  305. program ever uses those files.  Those files are a required part of
  306. the Java Platform.
  307.  
  308. The JRE includes the bin and lib directories which both must
  309. reside in the same directory.  We call this directory <runtime-dir>.
  310. In the following lists, all paths are relative to the <runtime-dir>
  311. directory (which is originally "jre1.1.6").
  312.  
  313.  
  314. Required Files --------------------------------------------------------
  315.  
  316. The Win32 bin directory contains the executables and native libraries:
  317.  
  318.    bin\jre.exe                   Java runtime executable
  319.    bin\jrew.exe                  Java runtime executable, no console window
  320.    bin\rmiregistry.exe           rmiregistry executable
  321.    bin\javai.dll                 Java runtime native code library
  322.    bin\JdbcOdbc.dll              native code support for sun.jdbc
  323.    bin\jpeg.dll                  native code support for sun.jpeg
  324.    bin\math.dll                  native code support for java.math
  325.    bin\mmedia.dll                native code support for sun.audio
  326.    bin\net.dll                   native code support for java.net
  327.    bin\sysresource.dll           native code support for sun.net.www.protocol
  328.    bin\winawt.dll                native code support for sun.awt
  329.    bin\zip.dll                   native code support for java.util.zip
  330.    bin\msvcrt.dll                native code C runtime library
  331.    bin\ibmjitc.dll               IBM JIT compiler
  332.  
  333. The Win32 lib directory contains the classes and property files:
  334.  
  335.    lib\rt.jar                    Java runtime core classes
  336.    lib\content-types.properties  MIME-type properties
  337.    lib\awt.properties            properties for key events for java.awt
  338.    lib\font.properties           Win32 font properties for java.awt
  339.    lib\serialver.properties      serialization properties
  340.    lib\security\java.security    properties for java.security
  341.  
  342. Optional Files --------------------------------------------------------
  343.  
  344. The following files are optional:
  345.  
  346.    lib\i18n.jar                  I18N character conversion classes from
  347.                                    sun.io
  348.    lib\font.properties.ar        AWT font properties for Arabic locale
  349.    lib\font.properties.iw        AWT font properties for Hebrew locale
  350.    lib\font.properties.ja        AWT font properties for Japanese locale
  351.    lib\font.properties.ko        AWT font properties for Korean locale
  352.    lib\font.properties.ru        AWT font properties for Russian locale
  353.    lib\font.properties.th        AWT font properties for Thai locale
  354.    lib\font.properties.zh_TW     AWT font properties for Traditional
  355.                                    Chinese locale
  356.    lib\font.properties.zh        AWT font properties for Simplified
  357.                                    Chinese locale
  358.  
  359.  
  360. =======================================================================
  361.                 Running the Java Runtime
  362. =======================================================================
  363.  
  364. -----------------------------------------------------------------------
  365. Java Runtime Example
  366. -----------------------------------------------------------------------
  367.  
  368. The following web page has a Hello World example that you can download
  369. demonstrating how to create a simple Java application that runs on,
  370. and is bundled with, the Java Runtime Environment.
  371.  
  372.      http://java.sun.com/products/jdk/1.1/jre/example/
  373.  
  374. This example shows how to make a simple, seamless transition
  375. from developing an application with the JDK, to deploying it with
  376. the more-lightweight JRE.
  377.  
  378.  
  379. -----------------------------------------------------------------------
  380. Runtime Documentation
  381. -----------------------------------------------------------------------
  382.  
  383. Runtime documentation is any documentation that an end-user might
  384. need after they have installed a Java program that runs on the JRE.
  385.  
  386. We supply the following runtime documentation:
  387.  
  388.   - Each property file contains comments that describe what the
  389.     file is useful for and how to modify it.
  390.  
  391.   - awt.properties file - KeyEvent uses it to print out properties of
  392.     key events, usually for debugging purposes.  This might be used
  393.     by a GUI debugger that needs to print out events.
  394.  
  395.  
  396. -----------------------------------------------------------------------
  397. (c) Copyright IBM Corporation, 1998. All rights reserved.
  398. -----------------------------------------------------------------------
  399. Copyright ⌐ 1997, 1998 Sun Microsystems, Inc.
  400. 901 San Antonio Rd., Palo Alto, CA 94303 USA.
  401. All rights reserved.
  402.  
  403.