RMI Implementation Logging in J2SETM 1.4

Documentation Contents

As of J2SE^TM 1.4, Sun's RMI implementation uses the new Logging APIs to provide implementation logging output. The logging configuration file and programmatic API (java.util.logging) can be used to configure RMI implementation logging.

The java.rmi.server.logCalls system property and the implementation-specific sun.rmi.* logging properties that were recognized by previous J2SE versions still function to set the default levels for the RMI implementation Logger objects and to cause their output to be directed to System.err as with earlier versions.

The table below shows the names of the Logger objects used by the RMI implementation and how they correspond to the logging properties supported by previous versions.

Note that the RMI implementation supports a new logging category: client-side call logging, analagous to the server-side call logging activated by the java.rmi.server.logCalls property. Client-side call logging is output to the Logger named sun.rmi.client.call.

System Property Name	Logger Name	Information Logged
java.rmi.server.logCalls	sun.rmi.server.call	server-side remote calls and exceptions
sun.rmi.server.logLevel	sun.rmi.server.ref	server-side remote reference activity
sun.rmi.client.logCalls (new in J2SE 1.4)	sun.rmi.client.call	client-side remote calls and exceptions
sun.rmi.client.logLevel	sun.rmi.client.ref	client-side remote reference activity
sun.rmi.dgc.logLevel	sun.rmi.dgc	distributed garbage collection activity
sun.rmi.loader.logLevel	sun.rmi.loader	activity of default RMIClassLoader provider
sun.rmi.transport.logLevel	sun.rmi.transport.misc	transport-layer activity
sun.rmi.transport.tcp.logLevel	sun.rmi.transport.tcp	TCP binding and connection activity
sun.rmi.transport.proxy.logLevel	sun.rmi.transport.proxy	HTTP tunnelling activity

For both the sun.rmi.client.call and the sun.rmi.server.call Loggers, exceptions thrown from remote calls are logged at the level Level.FINE, and each remote call is logged at the level Level.FINER. Setting the java.rmi.server.logCalls or sun.rmi.client.logCalls system properties to the value "true" causes the corresponding Logger to be set to the level Level.FINER.

For the sun.rmi.* logging properties that have names ending in ".logLevel", a value of "BRIEF" causes the corresponding Logger to be set to the level Level.FINE, and a value of "VERBOSE" causes the corresponding Logger to be set to the level Level.FINER. Use of the logging configuration file is now preferred over the use of these sun.rmi.* system properties for logging.

Copyright © 2003 Sun Microsystems, Inc. All Rights Reserved.  Please send comments to: rmi-comments@java.sun.com