[Fwd: RE: Problems in RFC3060 et al]

From: "John Strassner" <>

oops, forgot to give you note 1:

Note 1: From the CIM 2.6 COre MOF:

//

==================================================================

//
System
//

==================================================================

[Abstract, Description (

"A CIM_System is a LogicalElement that aggregates an "

"enumerable set of Managed System Elements. The aggregation "

"operates as a functional whole. Within any particular "

"subclass of System, there is a well-defined list of "

"Managed System Element classes whose instances must be "

"aggregated.") ]
class CIM_System : CIM_LogicalElement {

[Key, MaxLen (256), Description (

"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.") ]

string CreationClassName;

[Key, MaxLen (256), Override ("Name"), Description (

"The inherited Name serves as key of a System instance in "

"an enterprise environment.") ]

string Name;

[MaxLen (64), Description (

"The System object and its derivatives are Top Level Objects "

"of CIM. They provide the scope for numerous components. "

"Having unique System keys is required. A heuristic can be "

"defined in individual System subclasses to attempt to always "

"generate the same System Name Key. The NameFormat property "

"identifies how the System name was generated, using "

"the subclass' heuristic.") ]

string NameFormat;

[MaxLen (64), Description (

"The name of the primary system owner."),

MappingStrings {"MIF.DMTF|General Information|001.4"} ]

string PrimaryOwnerName;

[MaxLen (256), Description (

"A string that provides information on how the primary system "

"owner can be reached (e.g. phone number, email address, "

"...)."),

MappingStrings {"MIF.DMTF|General Information|001.3"} ]

string PrimaryOwnerContact;

[Description (

"An array (bag) of strings that specify the roles this System "

"plays in the IT-environment. Subclasses of System may "

"override this property to define explicit Roles values. "

"Alternately, a Working Group may describe the heuristics, "

"conventions and guidelines for specifying Roles. For "

"example, for an instance of a networking system, the Roles "

"property might contain the string, 'Switch' or 'Bridge'.") ]

string Roles[];
};

//

===================================================================

//
ComputerSystem
//

===================================================================

[Abstract, Description (

"A class derived from System that is a special collection of "

"ManagedSystemElements. This collection provides "

"compute capabilities and serves as aggregation point to "

"associate one or more of the following elements: FileSystem, "

"OperatingSystem, Processor and Memory (Volatile and/or "

"NonVolatile Storage).") ]
class CIM_ComputerSystem : CIM_System {

[Override ("NameFormat"), Description (

"The ComputerSystem object and its derivatives are Top Level "

"Objects of CIM. They provide the scope for numerous "

"components. Having unique System keys is required. "

"A heuristic is defined to create the ComputerSystem Name "

"to attempt to always generate the same Name, independent of "

"discovery protocol. This prevents inventory and management "

"problems where the same asset or entity is discovered "

"multiple times, but can not be resolved to a single object. "

"Use of the heuristic is optional, but recommended.\n\n"

"The NameFormat property identifies how the ComputerSystem "

"Name is generated, using a heuristic. The heuristic is "

"outlined, in detail, in the CIM V2 System Model spec. "

"It assumes that the documented rules are traversed in order, "

"to determine and assign a Name. The NameFormat Values "

"list defines the precedence order for assigning the Computer"

"System Name. Several rules do map to the same Value.\n\n"

"Note that the ComputerSystem Name calculated using the "

"heuristic is the System's key value. Other names can be "

"assigned and used for the ComputerSystem, that better suit "

"a business, using Aliases."),

ValueMap {"Other", "IP", "Dial", "HID", "NWA", "HWA", "X25",

"ISDN", "IPX", "DCC", "ICD", "E.164", "SNA", "OID/OSI"} ]

string NameFormat;

[MaxLen (256), ArrayType ("Indexed"), Description (

"OtherIdentifyingInfo captures additional data, beyond "

"System Name information, that could be used to identify "

"a ComputerSystem. One example would be to hold the "

"Fibre Channel World-Wide Name (WWN) of a node. Note that "

"if only the Fibre Channel name is available and is "

"unique (able to be used as the System key), then this "

"property would be NULL and the WWN would become the "

"System key, its data placed in the Name property."),

ModelCorrespondence {

"CIM_ComputerSystem.IdentifyingDescriptions"} ]

string OtherIdentifyingInfo[];

[ArrayType ("Indexed"), Description (

"An array of free-form strings providing explanations "

"and details behind the entries in the OtherIdentifying"

"Info array. Note, each entry of this array is related "

"to the entry in OtherIdentifyingInfo that is located at "

"the same index."),

ModelCorrespondence {

"CIM_ComputerSystem.OtherIdentifyingInfo"} ]

string IdentifyingDescriptions[];

[Description (

"Enumeration indicating whether the ComputerSystem is "

"a special-purpose System (ie, dedicated to a particular "

"use), versus being 'general purpose'. For example, one "

"could specify that the System is dedicated to \"Print\" "

"(value=11) or acts as a \"Hub\" (value=8)."),

Values {"Not Dedicated", "Unknown", "Other", "Storage",

"Router", "Switch", "Layer 3 Switch",

"Central Office Switch", "Hub", "Access Server",

"Firewall", "Print", "I/O", "Web Caching", "Management"} ]

uint16 Dedicated[];

[Description (

"If enabled (value = 4), the UnitaryComputerSystem can be "

"reset via hardware (e.g. the power and reset buttons). If "

"disabled (value = 3), hardware reset is not allowed. In "

"addition to Enabled and Disabled, other Values for the "

"property are also defined - \"Not Implemented\" (5), "

"\"Other\" (1) and \"Unknown\" (2)."),

ValueMap {"1", "2", "3", "4", "5"},

Values {"Other", "Unknown", "Disabled",

"Enabled", "Not Implemented"},

MappingStrings {"MIF.DMTF|System Hardware Security|001.4"} ]

uint16 ResetCapability;

[Description(

"Indicates the specific power-related capabilities of a "

"ComputerSystem and its associated running OperatingSystem. "

"The values, 0=\"Unknown\", 1=\"Not Supported\", and "

"2=\"Disabled\" are self-explanatory. "

"The value, 3=\"Enabled\" indicates that the power management "

"features are currently enabled but the exact feature set "

"is unknown or the information is unavailable. "

"\"Power Saving Modes Entered Automatically\" (4) describes "

"that a system can change its power state based on usage or "

"other criteria. \"Power State Settable\" (5) indicates that "

"the SetPowerState method is supported. \"Power Cycling "

"Supported\" (6) indicates that the SetPowerState method "

"can be invoked with the PowerState input variable set to 5 ("

"\"Power Cycle\"). \"Timed Power On Supported\" (7) indicates "

"that the SetPowerState method can be invoked with the Power"

"State input variable set to 5 (\"Power Cycle\") and the Time "

"parameter set to a specific date and time, or interval, "

"for power-on."),

Values {"Unknown", "Not Supported", "Disabled",

"Enabled", "Power Saving Modes Entered Automatically",

"Power State Settable", "Power Cycling Supported",

"Timed Power On Supported"},

MappingStrings {"MIF.DMTF|System Power Controls|001.2"} ]

uint16 PowerManagementCapabilities[];

[Description(

"SetPowerState defines the desired power state of a "

"ComputerSystem and its running OperatingSystem, and when "

"the system should be put into that state. The PowerState "

"parameter is specified as one of the following integer "

"values: 1=\"Full Power\", 2=\"Power Save - Low Power Mode\", "

"3=\"Power Save - Standby\", 4=\"Power Save - Other\", "

"5=\"Power Cycle\", 6=\"Power Off\", 7=\"Hibernate\" and "

"8=\"Soft Off\". The Time parameter (for all state changes "

"but 5, \"Power Cycle\") indicates when the power state "

"should be set, either as a regular date-time value or as "

"an interval value (where the interval begins when the "

"method invocation is received). When the PowerState "

"parameter is equal to 5, \"Power Cycle\", the Time "

"parameter indicates when the system should power on "

"again. Power off is immediate. SetPowerState should "

"return 0 if successful, 1 if the specified State and "

"Time request is not supported, and some other value if "

"any other error occurred. In a subclass, the "

"set of possible return codes could be specified, using a "

"ValueMap qualifier on the method. The strings to which the "

"ValueMap contents are 'translated' may also be specified in "

"the subclass as a Values array qualifier.") ]

uint32 SetPowerState(

[IN, ValueMap {"1", "2", "3", "4", "5", "6", "7", "8"},

Values {"Full Power", "Power Save - Low Power Mode",

"Power Save - Standby", "Power Save - Other",

"Power Cycle", "Power Off", "Hibernate", "Soft Off"}]

uint32 PowerState,

[IN] datetime Time);

[Description(

"SetPowerStateWithBootFlags defines the desired power state of a "

"ComputerSystem and its running OperatingSystem, and when "

"the system should be put into that state. The PowerState "

"parameter is specified as one of the following integer "

"values: 1=\"Full Power\", 2=\"Power Save - Low Power Mode\", "

"3=\"Power Save - Standby\", 4=\"Power Save - Other\", "

"5=\"Power Cycle\", 6=\"Power Off\", 7=\"Hibernate\", "

"8=\"Soft Off\" and 9=\"Reset\" "

"The Time parameter (for all state changes "

"but 5, \"Power Cycle\") indicates when the power state "

"should be set, either as a regular date-time value or as "

"an interval value (where the interval begins when the "

"method invocation is received). When the PowerState "

"parameter is equal to 5, \"Power Cycle\", the Time "

"parameter indicates when the system should power on "

"again. Power off is immediate. "

"BootOptions parameter provides the options to be used "

"when the system comes back up. These options are not "

"used when the PowerState parameter is \"Power Off\", or "

"\"Soft Off\". This method could also be used to make the "

"bootOptions effective without changing the powerState. "

"For example, the system could be already in \"Full Power\" "

"state, but waiting at a boot loader state to receive a "

"command for BootOptions. The BootOptions can be specified "

"using this method. SetPowerStateWithBootFlags should "

"return 0 if successful, 1 if the specified State and "

"Time request is not supported, and some other value if "

"any other error occurred. In a subclass, the "

"set of possible return codes could be specified, using a "

"ValueMap qualifier on the method. The strings to which the "

"ValueMap contents are 'translated' may also be specified in "

"the subclass as a Values array qualifier.") ]

uint32 SetPowerStateWithOptions(

[IN, ValueMap {"1", "2", "3", "4", "5", "6", "7", "8", "9"},

Values {"Full Power", "Power Save - Low Power Mode",

"Power Save - Standby", "Power Save - Other",

"Power Cycle", "Power Off", "Hibernate", "Soft Off",
"Reset"} ]

uint16 PowerState,

[IN] datetime Time,

[IN] CIM_Settings REF Options);
};

---
end