IBM SDK, Java Technology Edition, Version 6: Linux User Guide Preface
Total Page:16
File Type:pdf, Size:1020Kb
IBM SDK, Java Technology Edition Version 6 Linux User Guide IBM IBM SDK, Java Technology Edition Version 6 Linux User Guide IBM Note Before you use this information and the product it supports, read the information in “Notices” on page 143. Copyright information This edition of the user guide applies to the IBM SDK, Java Technology Edition, Version 6, for all supported Linux architectures, and to all subsequent releases, modifications, and service refreshes, until otherwise indicated in new editions. The platforms this guide applies to are: v IBM 32-bit SDK for Linux on Intel architecture, Java Technology Edition, Version 6 v IBM 32-bit Runtime Environment for Linux on Intel architecture, Java Technology Edition, Version 6 v IBM 64-bit SDK for Linux on AMD64/EM64T architecture, Java Technology Edition, Version 6 v IBM 64-bit Runtime Environment for Linux on AMD64/EM64T architecture, Java Technology Edition, Version 6 v IBM 64-bit SDK for Linux on Intel Itanium architecture, Java Technology Edition, Version 6 v IBM 32-bit Runtime Environment for Linux on Intel Itanium architecture, Java Technology Edition, Version 6 v IBM 32-bit SDK for Linux on System i® and System p architecture, Java Technology Edition, Version 6 v IBM 32-bit Runtime Environment for Linux on System i and System p architecture, Java Technology Edition, Version 6 v IBM 64-bit SDK for Linux on System i and System p architecture, Java Technology Edition, Version 6 v IBM 64-bit Runtime Environment for Linux on System i and System p architecture, Java Technology Edition, Version 6 v IBM 31-bit SDK for Linux on System z architecture, Java Technology Edition, Version 6 v IBM 31-bit Runtime Environment for Linux on System z architecture, Java Technology Edition, Version 6 v IBM 64-bit SDK for Linux on System z architecture, Java Technology Edition, Version 6 v IBM 64-bit Runtime Environment for Linux on System z architecture, Java Technology Edition, Version 6 Note: The SDK and Runtime Environment for some platforms are available only as part of an IBM product or service. Portions © Copyright 1997, 2016, Oracle and/or its affiliates. © Copyright IBM Corporation 2003, 2016. US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp. Contents Preface ............... v Chapter 5. Developing Java applications ............ 31 Chapter 1. Overview ......... 1 Using XML .............. 31 Version compatibility ........... 1 Migrating to the XL-TXE-J ........ 33 Migrating from earlier IBM SDK or JREs ..... 2 | Securing Java API for XML processing (JAXP) Supported environments .......... 3 | against malformed input ......... 35 XML reference information ........ 35 Chapter 2. Contents of the SDK and Debugging Java applications......... 40 Runtime Environment ......... 5 Java Debugger (JDB) .......... 40 Selective debugging .......... 41 Contents of the Runtime Environment ...... 5 Determining whether your application is running on Contents of the SDK ............ 6 a 32-bit or 64-bit JVM ........... 42 | Determining which JVM version your application is Chapter 3. Installing and configuring the | running on .............. 42 SDK and Runtime Environment .... 9 How the JVM processes signals........ 43 Upgrading the SDK ............ 9 Signals used by the JVM ......... 43 Installing on Red Hat Enterprise Linux (RHEL) 4 .. 9 Linking a native code driver to the Installing on Red Hat Enterprise Linux (RHEL) 5 .. 9 signal-chaining library .......... 45 Running Java with SELinux on RHEL 5 .... 10 Writing JNI applications .......... 46 Installing from an InstallAnywhere package ... 10 Supported compilers .......... 46 Completing an attended installation ..... 11 JNI runtime linking........... 47 Completing an unattended installation .... 12 Support for thread-level recovery of blocked Interrupted installation ......... 14 connectors ............... 48 Known issues and limitations ....... 14 Configuring large page memory allocation .... 48 Configuring the SDK and Runtime Environment .. 15 CORBA support ............. 50 Setting the path ............ 15 System properties for tracing the ORB .... 51 Setting the class path .......... 15 System properties for tuning the ORB .... 52 Updating your SDK or JRE for Daylight Saving Java security permissions for the ORB .... 52 Time changes ............. 16 ORB implementation classes ........ 53 Uninstalling the SDK and Runtime Environment .. 17 RMI over IIOP ............. 53 Implementing the Connection Handler Pool for RMI 53 Chapter 4. Running Java applications 19 Enhanced BigDecimal ........... 53 The java and javaw commands ........ 19 Support for XToolkit ........... 54 Obtaining version information ....... 19 Support for the Java Attach API ....... 54 Specifying Java options and system properties.. 20 Standard options ........... 21 Chapter 6. Plug-in, Applet Viewer and Globalization of the java command ..... 22 Web Start ............. 57 Working with the LD_LIBRARY_PATH environment (Linux IA 32-bit and PPC32 only) Using the Java variable................ 23 plug-in ................ 57 The Just-In-Time (JIT) compiler ........ 23 Supported browsers .......... 57 Disabling the JIT ........... 23 Installing the Java plug-in ........ 57 Enabling the JIT ............ 24 Common Document Object Model (DOM) Determining whether the JIT is enabled .... 24 support............... 58 Specifying a garbage collection policy ..... 25 Using DBCS parameters ......... 58 Garbage collection options ........ 25 Working with applets ........... 58 More effective heap usage using compressed Running and debugging applets with the Applet references .............. 26 Viewer ............... 58 Pause time ............. 26 (Linux IA 32-bit, PPC32, and PPC64 only) Using Pause time reduction .......... 27 Web Start ............... 59 Environments with very full heaps ..... 27 Running Web Start ........... 60 Euro symbol support ........... 28 (Linux IA 32-bit only) WebStart Secure Static Fallback font configuration files ....... 28 Versioning .............. 60 Using Indian and Thai input methods ..... 28 Distributing Java applications ........ 61 System resource limits and the ulimit command .. 29 © Copyright IBM Corp. 2003, 2016 iii Chapter 7. Class data sharing between The Java Communications API documentation... 78 JVMs ............... 63 Overview of class data sharing ........ 63 Chapter 9. Service and support for Class data sharing command-line options .... 65 independent software vendors .... 79 Creating, populating, monitoring, and deleting a cache ................ 69 Chapter 10. Accessibility ....... 81 Performance and memory consumption ..... 70 Keyboard traversal of JComboBox components in Considerations and limitations of using class data Swing ................ 81 sharing ................ 71 Web Start accessibility (Linux IA 32-bit, PPC32, and Cache size limits............ 71 PPC64 only) .............. 81 JVMTI RetransformClasses() is unsupported .. 71 Runtime bytecode modification....... 71 Appendix. Appendixes ........ 83 Operating system limitations ....... 72 Using SharedClassPermission ....... 72 Command-line options .......... 83 Adapting custom class loaders to share classes .. 72 Specifying command-line options ...... 83 General command-line options ....... 84 Chapter 8. Java Communications API System property command-line options .... 85 JVM command-line options ........ 96 (JavaComm) ............ 75 JVM -XX command-line options ...... 111 Installing Java Communications API from a JIT and AOT command-line options ..... 112 compressed file ............. 75 Garbage Collector command-line options ... 116 Location of the Java Communications API files .. 76 Default settings for the JVM ........ 126 Configuring the Java Communications API .... 76 Known issues and limitations ........ 128 Changing the access mode of serial and parallel Support for virtualization software ...... 141 ports ............... 76 Specifying devices in the javax.comm.properties Notices .............. 143 file ................ 76 Trademarks .............. 145 Enabling serial ports on IBM ThinkPads ..... 77 Terms and conditions for product documentation 145 Printing limitation with the Java Communications IBM Online Privacy Statement........ 146 API ................. 77 Uninstalling the compressed Tape Archive (TAR) package ............... 77 iv IBM SDK, Java Technology Edition, Version 6: Linux User Guide Preface This guide provides general information about the IBM® SDK, Java™ Technology Edition, Version 6, for all supported Linux architectures. The guide gives specific information about any differences in the IBM implementation compared with the Oracle implementation. Read this information in conjunction with the documentation on the Oracle Web site: http://www.oracle.com/technetwork/java/index.html. Late breaking information about this release that is not available in the guide can be found here: http://www.ibm.com/support/docview.wss?uid=swg21587401. The Diagnostics Guide provides more detailed information about the IBM Virtual Machine for Java. The terms Runtime Environment and Java Virtual Machine are used interchangeably throughout this guide. This guide is part of a release and is applicable only to that particular release. Make sure that you have the guide appropriate to the release you are using. For Service Refresh 9 and earlier The guide is available in the code package. Technical changes made for a version of the user guide are indicated by blue chevrons. For Service Refresh 10 and later The guide is available