The PerfUtil Java API

The PerfUtil Java API provides a rich set of functionality, all available to Java applications. The API is provided in named package jperf. The jperf package is distributed as JPerf.jar in the tools' bin directory.

In order to (re)compile/run your application you must do the following:

• Import either the entire package or the required classes:
  • import jperf.*;
  • import jperf.PerfCounter.*;
• Add the jperf package jar filename to the CLASSPATH, for example:
  SET CLASSPATH=D:\ibmperf\bin\JPerf.jar;%CLASSPATH%
• All "constants" (i.e., static data members) are part of the JPerf class. Take a look at JPerfBase.java in the tools' src directory.
• (Re)compile the application.
• Run the application. Just remember that JPerf.jar must be included in the CLASSPATH.

PerfUtil JPerf package classes

• JPerf class
  Generic class which provides most of the native methods as well as all constants (i.e., static final data members) used by all the classes in the jperf package.
  
  
• SysUtil class
  This class provides information about supported/active functionality, about the system, and about the operating system.
  
  
• CpuInfo class
  This class provides information about the processors.
  
  
• CpuUtil class
  This class provides access to the CPU Utilization measurement (AI) facility.
  
  
• Cpi class
  This class provides access to the CPI measurement facility.
  
  
• PerThreadTime class
  This class provides access to the Per-Thread Time (PTT) facility.
  
  
• Trace class
  This class provides full control of the Software Trace (SWTRACE) facility and the Instruction Trace (ITrace) facility.
  
  
• PerfCounter class
  This class provides access to the raw hardware performance counters and to tools-managed performance counter events.
  
  
• Msr class
  This class provides low-level access to the system's Machine Specific Registers (MSR).
  
  
• RtDriver class
  This class provides some level of control of JProf, running on the local machine or running on a remote machine.