Class ProcessorUsage

java.lang.Object
com.ibm.lang.management.ProcessorUsage
public class ProcessorUsage extends Object
This represents a snapshot of the Operating System level Processor usage statistics. The statistics could be at an individual Processor level or an aggregate across all Processors. The statistics are available on AIX, Linux and Windows.
  • This information is not available on z/OS.
Since:
1.7.1

  • Constructor Details

    • ProcessorUsage

      public ProcessorUsage()
      Creates a new ProcessorUsage instance.

  • Method Details

    • getUser

      public long getUser()
      The time spent in user mode in microseconds.
      Returns:
      The user times in microseconds or -1 if not available.

    • getSystem

      public long getSystem()
      The time spent in system mode in microseconds.
      Returns:
      The system times in microseconds or -1 if not available.

    • getIdle

      public long getIdle()
      The time spent by the Processor sitting idle in microseconds.
      Returns:
      The idle times in microseconds or -1 if not available.

    • getWait

      public long getWait()
      The time spent by the Processor in Input/Output (IO) wait in microseconds.
      Returns:
      The wait times in microseconds or -1 if not available.

    • getBusy

      public long getBusy()
      The time spent by the Processor executing a non-idle thread in microseconds.
      Returns:
      The busy times in microseconds or -1 if not available.

    • getId

      public int getId()
      A unique identifier assigned to the this Processor. This is -1 if method invoked on the global Processor record.
      Returns:
      An identifier for this Processor or -1 for the global record or if not available.

    • getOnline

      public int getOnline()
      The online/offline status of this Processor. This is -1 if method invoked on the global Processor record or if this info is unavailable.
      • On AIX the online value is not reliable. Once a Processor becomes online, the status of the Processor will always be shown as online from that point onwards, even if it is currently offline. This is a limitation of the OS. Similarly offline on AIX means that the Processor was never online.
      Returns:
      This Processor's online status (0 = offline, 1 = online) or -1 for the global record or if not available.

    • getTimestamp

      public long getTimestamp()
      The timestamp when usage statistics were last sampled in microseconds.
      Returns:
      Timestamp in microseconds.

    • from

      public static ProcessorUsage from(CompositeData cd)
      Receives a CompositeData representing a ProcessorUsage object and attempts to return the root ProcessorUsage instance.
      Parameters:
      cd - A CompositeData that represents a ProcessorUsage
      Returns:
      if cd is non- null, returns a new instance of ProcessorUsage, If cd is null, returns null.
      Throws:
      IllegalArgumentException - if argument cd does not correspond to a ProcessorUsage with the following attributes:
      • user(java.lang.Long)
      • system(java.lang.Long)
      • idle(java.lang.Long)
      • wait(java.lang.Long)
      • busy(java.lang.Long)
      • id(java.lang.Integer)
      • online(java.lang.Integer)
      • timestamp(java.lang.Long)

    • toString

      public String toString()
      Text description of this ProcessorUsage object.
      Overrides:
      toString in class Object
      Returns:
      Text description of this ProcessorUsage object.