Class GuestOSMemoryUsage

java.lang.Object
com.ibm.virtualization.management.GuestOSMemoryUsage

public final class GuestOSMemoryUsage extends Object
This provides a snapshot of the Guest (Virtual Machine(VM)/Logical Partition(LPAR)) Memory usage statistics as seen by the Hypervisor Host. The supported Operating System and Hypervisor combinations are:
  1. Linux and Windows on VMWare (IBM Java 8 only).
  2. AIX and Linux on PowerVM.
  3. Linux and z/OS on z/VM.
  4. Guest Operating System memory usage statistics are not available on Linux for PowerKVM.
Since:
1.7.1
  • Constructor Details

    • GuestOSMemoryUsage

      public GuestOSMemoryUsage()
      Creates a new GuestOSMemoryUsage instance.
  • Method Details

    • getMemUsed

      public long getMemUsed()
      The total Memory used by the Guest as reported by the Hypervisor in MB.
      Returns:
      Current used Memory by the Guest in MB or -1 if info not available.
    • getTimestamp

      public long getTimestamp()
      The timestamp when the usage statistics were last sampled in microseconds.
      Returns:
      The last sampling timestamp in microseconds.
    • getMaxMemLimit

      public long getMaxMemLimit()
      The amount of real Memory allowed to be used by the Guest as reported by the Hypervisor in MB.
      Returns:
      Max Memory that can be used by the Guest in MB or -1 if info not available or if no limit has been set.
    • from

      public static GuestOSMemoryUsage from(CompositeData cd)
      Receives a CompositeData representing a GuestOSMemoryUsage object and attempts to return the root GuestOSMemoryUsage instance.
      Parameters:
      cd - A CompositeData that represents a GuestOSMemoryUsage.
      Returns:
      if cd is non- null, returns a new instance of GuestOSMemoryUsage, If cd is null, returns null.
      Throws:
      IllegalArgumentException - if argument cd does not correspond to a GuestOSMemoryUsage with the following attributes:
      • memUsed(java.lang.Long)
      • timestamp(java.lang.Long)
      • maxMemLimit(java.lang.Long)
    • toString

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