Class CIM_PhysicalMemory

Used in features: Hardware Asset
Compatible with the following Intel AMT Releases: 3.0, 3.2, 4.0, 5.0, 5.1, 6.0, 6.1, 6.2, 7.0, 8.0, 8.1, 9.0, 9.5, 10.0, 11.0
CIM_ManagedElement
   extended by CIM_ManagedSystemElement
      extended by CIM_PhysicalElement
         extended by CIM_PhysicalComponent
            extended by CIM_Chip
               extended by CIM_PhysicalMemory


class CIM_PhysicalMemory
extends CIM_Chip

General Information:
PhysicalMemory is a subclass of CIM_Chip, representing low level memory devices - SIMMS, DIMMs, raw memory chips, etc.

Qualifiers:
-------------
Version=2.33.0
ClassConstraint={inv:self.IsSpeedInMhz=true implies self.Speed = 0 and self.MaxMemorySpeed > 0, inv:self.IsSpeedInMhz=false implies self.MaxMemorySpeed=null}
UMLPackagePath=CIM::Physical::Component


Supported Fields Summary
 string PartNumber
The part number assigned by the organization that is responsible for producing or manufacturing the PhysicalElement.
 string SerialNumber
A manufacturer-allocated number used to identify the Physical Element.
 string Manufacturer
The name of the organization responsible for producing the PhysicalElement . . .
 string ElementName

 string CreationClassName Key
CreationClassName indicates the name of the class or the subclass used in the creation of an instance . . .
 string Tag Key
An arbitrary string that uniquely identifies the Physical Element and serves as the key of the Element . . .
 uint16[] OperationalStatus
Indicates the current statuses of the element . . .
 uint16 FormFactor

 uint16 MemoryType
The type of PhysicalMemory . . .
 uint32 Speed
The speed of the PhysicalMemory, in nanoseconds.
 uint64 Capacity
The total capacity of this PhysicalMemory, in bytes.
 string BankLabel
A string identifying the physically labeled bank where the Memory is located - for example, 'Bank 0' or 'Bank A'.
 uint32 ConfiguredMemoryClockSpeed
The configured clock speed (in MHz) of PhysicalMemory.
 boolean IsSpeedInMhz
The IsSpeedInMHz property is used to indicate if the Speed property or the MaxMemorySpeed contains the value of the memory speed . . .
 uint32 MaxMemorySpeed
The maximum speed (in MHz) of PhysicalMemory.

Methods Summary
  Get(Instance)
Gets the representation of the instance
  Pull(EnumerationContext, MaxElements)
Pulls instances of this class, following an Enumerate operation
  Enumerate()
Enumerates the instances of this class
  Release(EnumerationContext)
Releases an enumeration context

Field Detail

PartNumber

public string PartNumber
General Information:
The part number assigned by the organization that is responsible for producing or manufacturing the PhysicalElement.

Qualifiers:
-------------
MaxLen=65
MappingStrings={MIB.IETF|Entity-MIB.entPhysicalModelName}


SerialNumber

public string SerialNumber
General Information:
A manufacturer-allocated number used to identify the Physical Element.

Product Specific Usage:
"Serial Number" string in the SMBIOS Memory Device (type 17) structure.

Qualifiers:
-------------
MaxLen=65
MappingStrings={MIB.IETF|Entity-MIB.entPhysicalSerialNum, MIF.DMTF|FRU|003.7}


Manufacturer

public string Manufacturer
General Information:
The name of the organization responsible for producing the PhysicalElement. This organization might be the entity from whom the Element is purchased, but this is not necessarily true. The latter information is contained in the Vendor property of CIM_Product.

Product Specific Usage:
"Manufacturer" string in the SMBIOS Memory Device (type 17) structure.

Qualifiers:
-------------
MaxLen=65
MappingStrings={MIB.IETF|Entity-MIB.entPhysicalMfgName, MIF.DMTF|FRU|003.4}


ElementName

public string ElementName
General Information:


Product Specific Usage:
'ElementName' is constant. In CIM_Chip instances its value is set to 'Managed System Memory Chip'.

Qualifiers:
-------------
Override=ElementName
MappingStrings={MIB.IETF|Entity-MIB.entPhysicalName}
MaxLen=32


CreationClassName Key

public string CreationClassName
General Information:
CreationClassName indicates the name of the class or the subclass used in the creation of an instance. When used with the other key properties of this class, this property allows all instances of this class and its subclasses to be uniquely identified.

Product Specific Usage:
"CIM_PhysicalMemory"


Qualifiers:
-------------
Key
MaxLen=65


Tag Key

public string Tag
General Information:
An arbitrary string that uniquely identifies the Physical Element and serves as the key of the Element. The Tag property can contain information such as asset tag or serial number data. The key for PhysicalElement is placed very high in the object hierarchy in order to independently identify the hardware or entity, regardless of physical placement in or on Cabinets, Adapters, and so on. For example, a hotswappable or removable component can be taken from its containing (scoping) Package and be temporarily unused. The object still continues to exist and can even be inserted into a different scoping container. Therefore, the key for Physical Element is an arbitrary string and is defined independently of any placement or location-oriented hierarchy.

Product Specific Usage:
"Physical Memory N" where N is replaced with the zero-based ordinal value of the device among all physical memory devices in the SMBIOS table.

Qualifiers:
-------------
Key
MaxLen=65


OperationalStatus

public uint16[] OperationalStatus
General Information:
Indicates the current statuses of the element. Various operational statuses are defined. Many of the enumeration's values are self-explanatory. However, a few are not and are described here in more detail.
"Stressed" indicates that the element is functioning, but needs attention. Examples of "Stressed" states are overload, overheated, and so on.
"Predictive Failure" indicates that an element is functioning nominally but predicting a failure in the near future.
"In Service" describes an element being configured, maintained, cleaned, or otherwise administered.
"No Contact" indicates that the monitoring system has knowledge of this element, but has never been able to establish communications with it.
"Lost Communication" indicates that the ManagedSystem Element is known to exist and has been contacted successfully in the past, but is currently unreachable.
"Stopped" and "Aborted" are similar, although the former implies a clean and orderly stop, while the latter implies an abrupt stop where the state and configuration of the element might need to be updated.
"Dormant" indicates that the element is inactive or quiesced.
"Supporting Entity in Error" indicates that this element might be "OK" but that another element, on which it is dependent, is in error. An example is a network service or endpoint that cannot function due to lower-layer networking problems.
"Completed" indicates that the element has completed its operation. This value should be combined with either OK, Error, or Degraded so that a client can tell if the complete operation Completed with OK (passed), Completed with Error (failed), or Completed with Degraded (the operation finished, but it did not complete OK or did not report an error).
"Power Mode" indicates that the element has additional power model information contained in the Associated PowerManagementService association.
"Relocating" indicates the element is being relocated.
OperationalStatus replaces the Status property on ManagedSystemElement to provide a consistent approach to enumerations, to address implementation needs for an array property, and to provide a migration path from today's environment to the future. This change was not made earlier because it required the deprecated qualifier. Due to the widespread use of the existing Status property in management applications, it is strongly recommended that providers or instrumentation provide both the Status and OperationalStatus properties. Further, the first value of OperationalStatus should contain the primary status for the element. When instrumented, Status (because it is single-valued) should also provide the primary status of the element.

Product Specific Usage:
Must support at least 0 ("Unknown")

Qualifiers:
-------------
ValueMap={0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, .., 0x8000..}
Values={Unknown, Other, OK, Degraded, Stressed, Predictive Failure, Error, Non-Recoverable Error, Starting, Stopping, Stopped, In Service, No Contact, Lost Communication, Aborted, Dormant, Supporting Entity in Error, Completed, Power Mode, Relocating, DMTF Reserved, Vendor Reserved}
ArrayType=Indexed
ModelCorrespondence={CIM_ManagedSystemElement.StatusDescriptions}


FormFactor

public uint16 FormFactor
General Information:


Product Specific Usage:
Value in "Form Factor" field, SMBIOS Memory Device (type 17) structure.

Qualifiers:
-------------
Override=FormFactor
MappingStrings={MIF.DMTF|Memory Device|005.6}


MemoryType

public uint16 MemoryType
General Information:
The type of PhysicalMemory. Synchronous DRAM is also known as SDRAM Cache DRAM is also known as CDRAM CDRAM is also known as Cache DRAM SDRAM is also known as Synchronous DRAM BRAM is also known as Block RAM

Product Specific Usage:
type 23: DDR2-FBDIMM
Values in "Memory Type" and "Type Detail" fields, SMBIOS Memory Device (type 17) structure.

Qualifiers:
-------------
ValueMap={0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37..32567, 32568..65535}
Values={Unknown, Other, DRAM, Synchronous DRAM, Cache DRAM, EDO, EDRAM, VRAM, SRAM, RAM, ROM, Flash, EEPROM, FEPROM, EPROM, CDRAM, 3DRAM, SDRAM, SGRAM, RDRAM, DDR, DDR-2, BRAM, FB-DIMM, DDR3, FBD2, DDR4, LPDDR, LPDDR2, LPDDR3, LPDDR4, Logical non-volatile device, HBM (High Bandwidth Memory), HBM2 (High Bandwidth Memory Generation 2), DDR5, LPDDR5, HBM3 (High Bandwidth Memory Generation 3), DMTF Reserved, Vendor Reserved}
MappingStrings={MIF.DMTF|Memory Device|005.9}


Speed

public uint32 Speed
General Information:
The speed of the PhysicalMemory, in nanoseconds.

Product Specific Usage:
Value in "Speed" field, SMBIOS Memory Device (type 17) structure.
When the memory speed is greater than 1000MKZ this parameter will equal 0.

Qualifiers:
-------------
Units=NanoSeconds
MappingStrings={MIF.DMTF|Memory Device|005.24}
ModelCorrespondence={CIM_PhysicalMemory.MaxMemorySpeed, CIM_PhysicalMemory.IsSpeedInMHz}


Capacity

public uint64 Capacity
General Information:
The total capacity of this PhysicalMemory, in bytes.

Product Specific Usage:
The Capacity parameter is calculated using the SMBIOS 2.7.1 Memory Device table (Type 17).
Starting in Intel AMT 8.0 and SMBIOS 2.7.1, this table includes the Extended Size field which was created to accommodate device memories larger than 32,767 MB (32 GB - 1 MB). This new field is not supported in SOAP. The maximum memory size which can be reported by SOAP is 7FFFh.
Therefore, a device’s actual memory may be larger than the 32,767 MB (32 GB - 1 MB) reported by SOAP.

Qualifiers:
-------------
Units=Bytes
MappingStrings={MIF.DMTF|Memory Device|005.5}


BankLabel

public string BankLabel
General Information:
A string identifying the physically labeled bank where the Memory is located - for example, 'Bank 0' or 'Bank A'.

Product Specific Usage:
Value in "Bank Locator" field, in the SMBIOS Memory Device (type 17) table
If not present or invalid SMBIOS value, default value is 'CIM_PhysicalMemory Bank Label'.

Qualifiers:
-------------
MaxLen=64
MappingStrings={MIF.DMTF|Memory Device|005.4}


ConfiguredMemoryClockSpeed

public uint32 ConfiguredMemoryClockSpeed
General Information:
The configured clock speed (in MHz) of PhysicalMemory.

Qualifiers:
-------------
Units=MegaHertz


IsSpeedInMhz

public boolean IsSpeedInMhz
General Information:
The IsSpeedInMHz property is used to indicate if the Speed property or the MaxMemorySpeed contains the value of the memory speed. A value of TRUE shall indicate that the speed is represented by the MaxMemorySpeed property. A value of FALSE shall indicate that the speed is represented by the Speed property.

Qualifiers:
-------------
ModelCorrespondence={CIM_PhysicalMemory.Speed, CIM_PhysicalMemory.MaxMemorySpeed}


MaxMemorySpeed

public uint32 MaxMemorySpeed
General Information:
The maximum speed (in MHz) of PhysicalMemory.

Qualifiers:
-------------
Units=MegaHertz
ModelCorrespondence={CIM_PhysicalMemory.Speed, CIM_PhysicalMemory.IsSpeedInMHz}


Method Detail

Get

public  Get([OUT]CIM_PhysicalMemory Instance)
Permission Information:
Permitted realms: ADMIN_SECURITY_HARDWARE_ASSET_REALM

General Information:
Gets the representation of the instance

Pull

public  Pull([IN]String EnumerationContext, [IN]String MaxElements)
Permission Information:
All users permitted to use method, only instances to whom the user has permissions will be returned

General Information:
Pulls instances of this class, following an Enumerate operation

Enumerate

public  Enumerate()
Permission Information:
All users permitted to use method

General Information:
Enumerates the instances of this class

Release

public  Release([IN]String EnumerationContext)
Permission Information:
All users permitted to use method

General Information:
Releases an enumeration context

Copyright © 2006-2022, Intel Corporation. All rights reserved.