- 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 Summary
Constructors Constructor Description ProcessorUsage()Creates a newProcessorUsageinstance.
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Modifier and Type Method Description static ProcessorUsagefrom(CompositeData cd)Receives aCompositeDatarepresenting aProcessorUsageobject and attempts to return the rootProcessorUsageinstance.longgetBusy()The time spent by the Processor executing a non-idle thread in microseconds.intgetId()A unique identifier assigned to the this Processor.longgetIdle()The time spent by the Processor sitting idle in microseconds.intgetOnline()The online/offline status of this Processor.longgetSystem()The time spent in system mode in microseconds.longgetTimestamp()The timestamp when usage statistics were last sampled in microseconds.longgetUser()The time spent in user mode in microseconds.longgetWait()The time spent by the Processor in Input/Output (IO) wait in microseconds.StringtoString()Text description of thisProcessorUsageobject.
-
-
-
Constructor Detail
-
ProcessorUsage
public ProcessorUsage()
Creates a newProcessorUsageinstance.
-
-
Method Detail
-
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 aCompositeDatarepresenting aProcessorUsageobject and attempts to return the rootProcessorUsageinstance.- Parameters:
cd- ACompositeDatathat represents aProcessorUsage- Returns:
- if
cdis non-null, returns a new instance ofProcessorUsage, Ifcdisnull, returnsnull. - Throws:
IllegalArgumentException- if argumentcddoes not correspond to aProcessorUsagewith 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 thisProcessorUsageobject.- Overrides:
toStringin classObject- Returns:
- Text description of this
ProcessorUsageobject.
-
-