IBM User Guide for Java V7 on Windows > Troubleshooting and support > Using diagnostic tools

Using the Reliability, Availability, and Serviceability Interface

The JVM Reliability, Availability, and Serviceability Interface (JVMRI) allows an agent to access reliability, availability, and serviceability (RAS) functions by using a structure of pointers to functions.

The JVMRI interface will be deprecated in the near future and replaced by JVMTI extensions.

You can use the JVMRI interface to:

• Determine the trace capability that is present
• Set and intercept trace data
• Produce various dumps
• Inject errors

To use the JVMRI you must be able to build a native library, add the code for JVMRI callbacks (see the subtopics), and interface the code to the JVM through the JNI. This section provides the callback code but does not provide the other programming information.

• Preparing to use JVMRI
  Trace and dump functions in the JVMRI require the JVM trace and dump libraries to be loaded. These libraries will be loaded by default, but JVMRI will fail with a warning message if you specify -Xtrace:none or -Xdump:none.
• JVMRI functions
  At startup, the JVM initializes JVMRI. You access the JVMRI functions with the JNI GetEnv() routine to obtain an interface pointer.
• API calls provided by JVMRI
  The JVMRI functions are defined in a header file jvmri.h, which is supplied in the sdk/include directory. Note that all calls must be made using a valid JNIEnv pointer as the first parameter.
• RasInfo structure
  
• RasInfo request types
  
• Intercepting trace data
  To receive trace information from the JVM, you can register a trace listener using JVMRI. In addition, you must specify the option -Xtrace:external=<option> to route trace information to an external trace listener.
• Formatting
  You can use J9TraceFormat.dat to format JVM-generated tracepoints that are captured by the agent. J9TraceFormat.dat is shipped with the SDK.

Parent: Using diagnostic tools

Error 404 - Not Found

The document you are looking for may have been removed or re-named. Please contact the web site owner for further assistance.