Reproduction of these materials in any manner whatsoever without the written permission of Dell Inc.
is strictly forbidden.
Trademarks used in this text: Dell, the DELL logo, OpenManage are trademarks of Dell Inc.; Microsoft
and Windows NT are either trademarks or registered trademarks of Microsoft Corporation in the United
States and/or other countries; Intel, Pen ti u m, Xeon, Itanium, i860, i960, and Celeron are registered
trademarks and MMX, i386, i486, SpeedStep, and Core are trademarks of Intel Corporation in the United
States and/or other countries; AMD, AMD Athlon, AMD Duron, AMD-K5, AMD-K6, Opteron, and Tur ion
are trademarks and AMD-K6 -2 and AMD-K6 -III are registered trademarks of Advanced Micro Devices,
Inc in the United States and/or other countries; Crusoe and Efficeon are trademarks of Transmeta
Corporation in the United States and/or other countries.
Other trademarks and trade names may be used in this document to refer to either the entities claiming
the marks and names or their products. Dell Inc. disclaims any proprietary interest in trademarks and
trade names other than its own.
This reference guide documents the Dell™ OpenManage™ Server Administrator
Common Information Model (CIM) provider contained in the Management
Object File (MOF) dccim32.mof.
CIM provides a conceptual model for describing manageable objects in a
systems management environment. CIM is a modeling tool rather than a
programming language. CIM provides the structure for organizing objects
into a model of a managed environment. For modeling a managed
environment, CIM makes available a set of abstract and concrete classes of
objects. These classes model the basic characteristics of systems, networks,
and applications, as well as groupings of management-related data.
For more information about CIM, see the Distributed Management Task
Force (DMTF) website at www.dmtf.org and the Microsoftwww.microsoft.com.
Server Administrator
Server Administrator 1.0 or later provides a suite of systems management
information for keeping track of your networked systems. In addition to
providing systems management agents that are independent of the management
console, Server Administrator supports these systems management standards:
CIM and Simple Network Management Protocol (SNMP).
In addition to supporting systems management industry standards, Server
Administrator provides additional systems management information about
the specific components of your Dell™ system.
®
website at
What’s New in this Release
The following changes have been made for this release:
•Added two new properties — ChassisSystemProperties and
ChassisSystemRevision to the
•Added a new value to the MemoryType property of the
CIM_PhysicalMemory
DELL_Chassis
class.
class.
Introduction9
•Added a new property — SystemSlotType to the
•Added new values for the UpgradeMethod and Family properties of the
CIM_Processor
•Added a new property — RemoteAccessType to the
DELL_RemoteServiceAccessPortGroup
•Added the new class
the base class CIM_LogicalDevice.
class.
DELL_ManagedSystemServicesDevice to
CIM_Slot
class.
class.
Documenting CIM Classes and Their Properties
The Dell CIM provider extends support to Dell-specific software and
hardware components. The Dell MOF defines the classes for the Dell CIM
provider. All of the supported classes and properties in the MOF are
documented in this guide.
The following subsections define some of the basic building blocks of
CIM classes that are used in describing the dccim32 provider name.
These subsections also explain how the elements used in describing
these classes are organized. This section does not document the entire
CIM schema, but only those classes and properties supported by the
dccim32 provider. The list of properties for each supported class varies greatly.
Base Classes
The classes listed in the Server Administrator CIM provider class hierarchy
do not have a parent property. These base classes do not derive from
another class. The base classes are:
•CIM_ManagedSystemElement
•CIM_Dependency
•DELL_Esm Log
•DELL_PostLog
•DELL_CMApplication
•DELL_CMDevice
•DELL_CMDeviceApplications
10Introduction
•DELL_CMInventory
•DELL_CMOS
•DELL_CMProductInfo
The CIM_ManagedSystemElement class is the base class for the system
element hierarchy from which all other CIM classes are derived. As a result,
CIM_ManagedSystemElement has no parent. Examples of managed system
elements include software components such as files, devices such as hard
drives and controllers, and physical subcomponents of devices such as chip
sets and cards. For the CIM_ManagedSystemElement properties, see
Caption, CreationClassName, Description, Name, and Status in Table 1-1
The Dell-defined classes are not defined in the official schema by the DMTF,
the industry group that defines the standards for CIM, and hence do not have
parent classes. CIM_Dependency does not have a parent class because it is a
relationship or association between two managed system elements.
Parent Classes
Most classes in the dccim32 provider document both a Class Name and a
Parent Class property. The parent class is the class from which any given class
inherits its core properties. For example, the CIM_Controller class has the
CIM_LogicalDevice class as its parent, and has various types of controllers
(CIM_ParallelController, CIM_SerialController) as its children.
Classes That Describe Relationships
Classes that derive from CIM_Dependency have CIM_Dependency as their
parent class, but they are documented in terms of antecedent and dependent
elements in a relationship rather than in terms of common properties.
Consider the following relationship between two
CIM_ManagedSystemElements:
AntecedentCIM_PackageCurrentSensor
DependentCIM_PhysicalPackage
The CIM_PackageCurrentSensor monitors an entire physical package, such
as all the components contained in a given system chassis. The
CIM_PhysicalPackage is dependent on the CIM_PackageCurrentSensor for
this monitoring function.
Introduction11
Dell-Defined Classes
Server Administrator has extended some CIM classes and has created new
classes to assist in managing systems and their components. In the diagrams
that appear in the documentation for each class, those classes created and
populated by Dell are designated by the gold (lighter gray) triangle icon.
Common Properties of Classes
Many classes have properties such as Caption, Description, and
CreationClassName. Table 1-1 defines properties that have the same
meaning in every class that has this property and are defined more than once
in this guide.
Table 1-1. Common Properties of Classes
PropertyDescriptionData Type
CaptionDescribes the object using a short textual
description (one-line string).
CreationClassNameIndicates 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.
CSCreationClassNameIndicates the computer system’s creation
class name.
CSNameIndicates the computer system’s name.string
CurrentReadingIndicates the actual current value indicated
by the sensor in amperes.
DescriptionProvides a textual description of the object.string
LowerThresholdNonCritical If current reading is between lower threshold
noncritical and upper threshold noncritical,
the current state is normal. See Figure 3-2.
LowerThresholdCriticalIf the current reading is between upper
threshold critical and upper threshold fatal,
the current state is critical. See Figure 3-2.
string
string
string
sint32
sint32
sint32
12Introduction
Table 1-1. Common Properties of Classes (continued)
PropertyDescriptionData Type
IsLinearIndicates that the sensor is linear over its
dynamic range.
ManufacturerProvides the name of the organization
responsible for producing the
CIM_PhysicalElement or
CIM_SoftwareElement. This may be the
entity from whom the element is purchased,
but not necessarily. Purchase information is
contained in the Vendor property of
CIM_Product.
NameDefines the label by which the object is
known. When subclassed, the Name property
can be overridden to be a Key property.
StatusProvides a string indicating the status of the
component. Status values include:
Operational Status Values:
OK indicates that the object is
functioning normally.
Degraded means that the item is
functioning, but not optimally.
Stressed indicates that the element is
functioning, but needs attention. Examples
of Stressed states are overloaded, overheated,
and so on.
Boolean
string
string
string
Nonoperational Status Values:
Non-recover means that a nonrecoverable
error has occurred.
Error means that an element has
encountered an operational condition that is
severe as compared to its normal mode of
operation.
Introduction13
Table 1-1. Common Properties of Classes (continued)
PropertyDescriptionData Type
SystemCreationClassName Indicates the system’s creation class name.string
UnitModifierProvides the unit multiplier for the values
returned by this sensor. All the values
returned by this sensor are represented in
units of 10 raised to the power of the unit
modifier. If the unit modifier is –6, then the
units of the values returned are microvolts.
The units apply to all numeric properties of
the sensor, unless explicitly overridden by the
units’ qualifier.
UpperThresholdCriticalIf the current reading is between upper
threshold critical and upper threshold fatal,
the current status is critical. See Figure 3-2.
UpperThresholdNonCritical If the current reading is between lower
threshold noncritical and lower threshold
critical, the current status is noncritical.
SeeFigure3-2.
VersionVersion should be in the form
<major>.<minor>.<revision>
or <major>.<minor><letter><revision>;
for example, 1.2.3 or 1.2a3.
sint32
sint32
sint32
string
Other Documents You May Need
Besides this Dell OpenManage Server Administrator CIM Reference Guide,
you can find the following guides either on the Dell Support website at
support.dell.com or on the Dell Systems Management Tools and Documentation
DVD:
•
Dell OpenManage Server Administrator Online Help
help that you can access while running Server Administrator. Help screens
provide step-by-step instructions on how to perform systems management
tasks using Server Administrator.
•
Dell OpenManage Server Administrator User’s Guide
features, installation, and uninstallation of Server Administrator.
14Introduction
is context-sensitive
documents the
•
Dell OpenManage Installation and Security User’s Guide
complete information on installation procedures and step-by-step
instructions for installing, upgrading, and uninstalling Server
Administrator for each operating system.
•
Dell OpenManage Server Administrator Command Line Interface User’s
Guide
explains how to perform tasks using the text-based command line
interface.
Dell OpenManage Server Administrator Messages Reference Guide
•
messages that you can receive on your systems management console or on
your operating system’s event viewer. This guide explains the text, severity,
and cause of each message that the Server Administrator issues.
•
Dell OpenManage Server Administrator SNMP Reference Guide
the SNMP management information base (MIB). The SNMP MIB defines
variables that cover the capabilities of Server Administrator systems
management agents.
provides
lists the
documents
Typographical Conventions
The following example shows how most of the classes in the Dell CIM provider
are documented. Table 1-2 shows a partial class description for the DELL_DMA
class. (For a full class description, see Table 3-42)
Class Name appears in
the class in the MOF.
Parent Class appears in
from which the present class is derived.
Property denotes the name of the attribute that is being defined for this class.
Description includes text that defines the property.
Data Type stipulates the format that the values of this property must take.
Common data types include Boolean, string, and various types of integer.
Boolean indicates that the property must be expressed as one of two
alternatives.
Courier typeface and provides the string that names
Courier typeface and provides the name of the class
Introduction15
Table 1-2. CIM_DMA Properties
Class Name:CIM_DMA
Parent Class: CIM_SystemResource
PropertyDescriptionData Type
DMAChannel A part of the object’s key value, the DMA channel
uint32
number.
AvailabilityAvailability of the DMA. Availability values are
uint16
defined as follows:
1 - Other
2 - Unknown
3 - Available
4 - In Use/Not Available
5 - In Use and Available/Shareable
16Introduction
CIM_PhysicalElement
CIM_PhysicalElement is a CIM-defined class. The CIM_PhysicalElement
class contains the subclasses shown in Figure 2-1.
Figure 2-1. CIM_PhysicalElement Class Structure
CIM_ManagedSystemElement
CIM_PhysicalElement
CIM_PhysicalPackage
CIM_PhysicalFrame
CIM_Chassis
DELL_Chassis
CIM_PhysicalComponent
CIM_Chip
CIM_PhysicalMemory
CIM_PhysicalConnector
CIM_Slot
CIM_PhysicalElement
CIM_ManagedSystemElement
CIM_PhysicalElement
Subclasses of the CIM_PhysicalElement class listed in Table 2-1 define any
component of a system that has a distinct physical identity. Physical elements
are tangible managed system elements (usually actual hardware items) that
have a physical manifestation of some sort. By contrast, processes, files, and
logical devices are not classified as physical elements. A managed system
element is not necessarily a discrete component. A single card (which is a type
of physical element) can host more than one logical device. One card, for
example, could implement both a modem and a local area network (LAN)
adapter. In this case, the card would be represented by a single physical
element associated with multiple logical devices.
CIM_PhysicalElement17
Table 2-1. CIM_PhysicalElement Properties
Class Name:CIM_PhysicalElement
Parent Class: CIM_ManagedSystemElement
PropertyDescriptionData
Ty pe
CreationClass
Name
Manufacturer See Table 1-1.
ModelThe name by which the physical element is
SerialNumber A manufacturer-allocated number used to identify
TagUniquely identifies the physical element and serves
See Table 1-1.
string
generally known.
string
the physical element.
string
as the element’s key. The Ta g property can contain
information such as asset tag or serial number data.
The key for physical element is placed very high in
the object hierarchy in order to identify the
hardware/entity independently, regardless of
physical placement in or on cabinets, adapters, and
so on. For example, a hot-swappable or removable
component can be taken from its containing
(scoping) package and temporarily unused. The
object still continues to exist and may even be
inserted into a different scoping container.
Therefore, the key for physical element is an
arbitrary string that is defined independently of
any placement or location-oriented hierarchy.
18CIM_PhysicalElement
CIM_PhysicalPackage
CIM_ManagedSystemElement
CIM_PhysicalElement
CIM_PhysicalPackage
The CIM_PhysicalPackage class listed in Table 2-2 represents physical
elements that contain or host other components. Examples are a rack
enclosure or an adapter card with multiple functions.
Table 2-2. CIM_PhysicalPackage Properties
Class Name: CIM_PhysicalPackage
Parent Class: CIM_PhysicalElement
PropertyDescriptionData
Ty pe
RemovableA CIM_PhysicalPackage is removable if it is
designed to be taken in and out of the
physical container in which it is normally
found without impairing the function of the
overall package.
ReplaceableA CIM_PhysicalPackage is replaceable if it is
possible to substitute a physically different
element for the original element, as in a field
replaceable unit (FRU). For example, some
computer systems allow the microprocessor to
be upgraded to one of a higher clock rating. In
this case, the microprocessor is said to be
replaceable.
Boolean
Boolean
CIM_PhysicalElement19
CIM_PhysicalFrame
CIM_ManagedSystemElement
CIM_PhysicalElement
CIM_PhysicalPackage
CIM_PhysicalFrame
The CIM_PhysicalFrame class described in Table 2-3 contains other frame
enclosures such as racks and chassis. Properties like VisibleAlarm or
AudibleAlarm, and data related to security breaches are also members of
this class.
Table 2-3. CIM_Physical Frame Properties
Class Name:CIM_PhysicalFrame
Parent Class: CIM_PhysicalPackage
PropertyDescriptionData Type
LockPresentIndicates whether the frame is protected with a
lock.
AudibleAlarmIndicates whether the frame is equipped with an
audible alarm.
VisibleAlarmIndicates that the equipment includes a
indicating that a physical breach of the frame is in
progress. Values for the SecurityBreach property
are:
1 - Other
2 - Unknown
3 - No breach
4 - Breach attempted
5 - Breach successful
IsLockedIndicates that the frame is currently locked.Boolean
Boolean
Boolean
Boolean
uint16
20CIM_PhysicalElement
CIM_Chassis
CIM_ManagedSystemElement
CIM_PhysicalElement
CIM_PhysicalPackage
CIM_PhysicalFrame
CIM_Chassis
The CIM_Chassis class described in Table 2-4 represents the physical
elements that enclose physical elements such as power supplies, fans,
and processors.
Table 2-4. CIM_Chassis Parent Properties
Class Name:CIM_Chassis
Parent Class: CIM_PhysicalFrame
PropertyDescriptionData Type
ChassisTypesValues for the ChassisTypes property are:
1 - Other
2 - Unknown
3 - Mini-tower
4 - Tower
5 - Space-saving
6 - Main system chassis
7 - Expansion chassis
8 - Subchassis
9 - Space-saving
10 - Main system chassis
11 - Expansion chassis
12 - Subchassis
13 - Bus expansion chassis
14 - Peripheral chassis
15 - Storage chassis
16 - Rack-mount chassis
uint16
CIM_PhysicalElement21
DELL_Chassis
CIM_ManagedSystemElement
CIM_PhysicalElement
CIM_PhysicalPackage
CIM_PhysicalFrame
CIM_Chassis
DELL_Chassis
The DELL_Chassis class explained in Table 2-5 defines the identifying and
status properties of the chassis. DELL_Chassis inherits from CIM-defined
classes, but is populated by Dell™ properties.
Table 2-5. DELL_Chassis Properties
Class Name:DELL_Chassis
Parent Class: CIM_Chassis
PropertyDescriptionData Type
AssetTagIndicates the container AssetTag string. This
asset tag string is writable by the system
administrator.
SystemClassRefers to the system type that is installed and
running the instrumentation. Values for the
SystemClass property are:
1 - Other
2 - Unknown
3 - Workstation
4 - Server
5 - Desktop
6 - Portable
7 - Net PC
SystemIDIndicates the system identifier code.uint16
string
uint16
22CIM_PhysicalElement
Table 2-5. DELL_Chassis Properties (continued)
Class Name:DELL_Chassis
Parent Class: CIM_Chassis
PropertyDescriptionData Type
LogFormatDefines whether the event log data is unicode
uint16
formatted or binary (raw). Values for the event
LogFormat property are:
1 - Formatted (event log only)
2 - Unformatted
3 - Events_and_POST_Formatted (both the event
log and the power-on self-test (POST) log are
unicode for matted)
FanStatusIndicates the global status of fan sensors.string
TempStatusIndicates the global status of temperature
string
sensors.
VoltStatusIndicates the global status of voltage sensors.string
AmpStatusIndicates the global status of current sensors.string
PsStatusIndicates the global status of power supplies.string
MemStatusIndicates the global status of memory devices. string
ProcStatusIndicates the global status of processor devices. string
FanRedStatusIndicates the global status of the cooling unit. string
PsRedStatusIndicates the global status of the power unit.string
ChassisSystemProperties Indicates chassis characteristics, such as energy
uint16
smart etc.
ChassisSystemRevisionIndicates the chassis revision.uint16
CIM_PhysicalElement23
CIM_PhysicalComponent
CIM_ManagedSystemElement
CIM_PhysicalElement
CIM_PhysicalComponent
The CIM_PhysicalComponent class listed in Table 2-6 represents any lowlevel or basic component within a package. A component object either cannot
or does not need to be broken down into its constituent parts. For example,
an application specific integrated circuit (ASIC) cannot be broken down into
smaller discrete parts.
Table 2-6. CIM_PhysicalComponent Properties
Class Name:CIM_PhysicalComponent
Parent Class: CIM_PhysicalElement
CIM_Chip
CIM_ManagedSystemElement
CIM_PhysicalElement
CIM_PhysicalComponent
CIM_Chip
The CIM_Chip class listed in Table 2-7 represents any type of integrated
circuit hardware, including ASICs, processors, memory chips, and so on.
24CIM_PhysicalElement
Table 2-7. CIM_Chip Properties
Class Name:CIM_Chip
Parent Class: CIM_PhysicalComponent
PropertyDescriptionData Type
FormFa ct or
0 - Unknown
1 - Other
2 - SIP
3 - DIP
4 - ZIP
5 - SOJ
6 - Proprietary
7 - SIMM
8 - DIMM
9 - TSOP
10 - PGA
11 - RIMM
12 - SODIMM
13 - SRIMM
14 - SMD
15 - SSMP
16 - QFP
17 - TQFP
18 - SOIC
19 - LCC
20 - PLCC
21 - BGA
22 - FPBGA
23 - LGA
24 - FB-DIMM
uint16
CIM_PhysicalElement25
CIM_PhysicalMemory
CIM_ManagedSystemElement
CIM_PhysicalElement
CIM_PhysicalComponent
CIM_Chip
CIM_PhysicalMemory
The CIM_PhysicalMemory class described in Table 2-8 is a subclass of
CIM_Chip, representing low-level memory devices, such as SIMMS, DIMMs,
and so on.
Table 2-8. CIM_PhysicalMemory Properties
Class Name:CIM_PhysicalMemory
Parent Class: CIM_Chip
PropertyDescriptionData Type
FormFactorSee Table 2-7.uint16
MemoryTypeIndicates the type of physical memory. Values for
TotalWidthIndicates the total width, in bits, of the physical
11 - Flash
12 - EEPROM
13 - FEPROM
14 - EPROM
15 - CDRAM
16 - 3DRAM
17 - SDRAM
18 - SGRAM
19 - RDRAM
20 - DDR
21 - DDR2
22 - DDR2 FB-DIMM
24 - DDR3
uint16
memory, including check or error correction bits.
If there are no error correction bits, the value in
this property should match that specified for the
DataWidth property.
DataWidthIndicates the data width, in bits, of the physical
uint16
memory. A data width of 0 and a total width of 8
would indicate that the memory is solely used to
provide error correction bits.
SpeedIndicates the speed of the physical memory, in
uint32
nanoseconds.
SpeedAsStringIndicates the accurate speed of the physical
string
memory, in string format (with units).
CapacityIndicates the total capacity of this physical
BankLabelA string identifying the physically labeled bank
where the memory is located, for example, "Bank 0"
or "Bank A."
PositionInRowSpecifies the position of the physical memory in a
“row.” For example, if it takes two 8-bit memory
devices to form a 16-bit row, then a value of 2
means that this memory is the second device.
0 is an invalid value for this property.
InterleavePosition Indicates the position of this physical memory in
an interleave. 0 indicates noninterleaved.
1 indicates the first position, 2 the second
position, and so on. For example, in a 2:1
interleave, a value of 1 indicates that the memory is
in the “even” position.
string
uint32
uint32
CIM_PhysicalConnector
CIM_ManagedSystemElement
CIM_PhysicalElement
CIM_PhysicalConnector
The CIM_PhysicalConnector class explained in Table 2-9 includes physical
elements such as plugs, jacks, or buses that connect physical elements. Any
object that can be used to connect and transmit signals or power between two
or more physical elements is a member of this class. For example, slots
and D-shell connectors are types of physical connectors. See Table 2-10 for a
list of valid connector type values.
28CIM_PhysicalElement
Table 2-9. CIM_PhysicalConnector Properties
Class Name:CIM_PhysicalConnector
Parent Class: CIM_PhysicalElement
PropertyDescriptionData Type
ConnectorPinout A free-form string describing the pin
string
configuration and signal usage of a physical
connector.
ConnectorTypeAn array of integers defining the type of
uint16
physical connector. An array is specified to allow
the description of “combinations” of connector
information. For example, one array entry could
specify RS-232, another DB-25, and a third
entry could define the connector as male. See
Table 2-10 for the values of the ConnectorType
property.
Table 2-10. Connector Type Values
0 - Unknown30 - unused60 - Micro-DIN90 - On Board IDE