(file) Return to CIM_Core26.mof CVS log (file) (dir) Up to [Pegasus] / pegasus / Schemas / CIM26Prelim

   1 karl  1.1.2.1 // ===================================================================
   2               // Title:       Core MOF specification 2.6
   3               // Filename:    CIM_Core26.mof
   4               // Version:     2.6
   5               // Release:     0
   6               // Date:        06/12/2001
   7               // ===================================================================
   8               // Copyright "2001" Distributed Management Task Force, Inc. (DMTF).
   9               // All rights reserved.  
  10               // DMTF is a not-for-profit association of industry members dedicated 
  11               // to promoting enterprise and systems management and interoperability. 
  12               // DMTF specifications and documents may be reproduced for uses
  13               // consistent with this purpose by members and non-members, 
  14               // provided that correct attribution is given. 
  15               // As DMTF specifications may be revised from time to time, 
  16               // the particular version and release cited should always be noted.
  17               // ===================================================================
  18               // Description: The object classes below are listed in an order that
  19               //              avoids forward references. Required objects, defined 
  20               //              by other working groups, are omitted.
  21               // ==================================================================
  22 karl  1.1.2.1 // Author:      DMTF System and Devices Working Group
  23               // ==================================================================
  24               //      06/16/1998 - V2.0 Errata
  25               //      - CR224, CIM_ missed in 3 class names
  26               //                CIM_ProductPhysicalElements, CIM_FRUPhysicalElements
  27               //                and CIM_FRUIncludesProduct
  28               //      - CR231, Format for specifying Propagated keys uses
  29               //                period, not colon
  30               //      09/29/1998 - Version 2.1 
  31               //      - CR238, Add CompatibleProduct association
  32               //      - CR239, Add ProductProductDependency association
  33               //      - CR240, Add statistics-related objects
  34               //          CIM_StatisticalInformation, CIM_Statistics and
  35               //          CIM_RelatedStatistics
  36               //      - CR241, Remove "general" from the description of the
  37               //          compute capabilities of ComputerSystem
  38               //      - CR242a, Add to the enumeration for MSE.Status
  39               //      - CR249, Add LastErrorCode, ErrorDescription and
  40               //          ErrorCleared properties to LogicalDevice
  41               //      - CR250, Add CreationClassName (key) to PhysicalElement
  42               //      - CR252, Add OtherIdentifyingInfo and PoweredOn properties
  43 karl  1.1.2.1 //          to PhysicalElement
  44               //      - CR270, Correct the descriptions for Product and FRU
  45               //      - CR272, Remove repetition of the Values array from the
  46               //          descriptions of several properties
  47               //      - CR276b, Add to the enumeration for LogicalDevice.
  48               //          Availability 
  49               //      - CR282, Add PartNumber property to PhysicalElement
  50               //      06/08/1999 - Version 2.2
  51               //      - CR291a, Write qualifier "False" by default
  52               //      - CR295a, Clarify Descriptions for CIM_Product and its
  53               //          property, IdentifyingNumber 
  54               //      - CR300a, Enhance Description for CIM_SettingContext
  55               //      - CR304, Create the NullValue qualifier
  56               //      - CR305, Add DisableOverride flavor to In, Out, Override
  57               //      - CR306, Add DisableOverride flavor to Aggregation 
  58               //          (Already present in V2.1, Spec change only)
  59               //      - CR307b, Allow ArrayType, MaxLen, Units, ValueMap, Values,
  60               //          Syntax and SyntaxType qualifiers to pertain to methods
  61               //          and method parameters 
  62               //      - CR308a, Add LogicalIdentity association
  63               //      - CR309, Remove Min(1) from ManagedSystemElement 
  64 karl  1.1.2.1 //                 reference of ElementSetting
  65               //      - CR315, Create ProvidesServiceToElement association
  66               //      - CR317, Create DefaultSetting association
  67               //      - CR320, Add UnknownValues and UnsupportedValues qualifiers
  68               //      - CR321, Create ConfigurationComponent association
  69               //      - CR322b and 323a, Add 4 methods to 'apply' CIM_Settings
  70               //      - CR324a, Add CollectionOfMSE object and its associations
  71               //      - CR352b, New statuses in ManagedSystemElement.Status
  72               //                 (NonRecover and Stressed added)
  73               //      - CR353b, Add EnableDevice method to LogicalDevice
  74               //      - CR355a, Use Values-ValueMap qualifiers for the PowerState  
  75               //           parameter of LogicaDevice.SetPowerState / Update
  76               //           the method descriptions indicating that Values-
  77               //           ValueMap qualifiers can be defined for return codes
  78               //          - CR356a, Put keys on the references of Dependency,
  79               //           Component, and all of the non-subclassed Setting, 
  80               //                 Configuration, Product and Collection associations 
  81               //      - CR359, Clarify PhysicalElement.Manufacturer and 
  82               //           Product.Vendor
  83               //      - CR361a, Add Terminal and DisplayName qualifiers
  84               //      - CR362a, Add 3 properties to ComputerSystem (Dedicated,
  85 karl  1.1.2.1 //           OtherIdentifyingInfo and IdentifyingDescriptions) /
  86               //           Update the Description for System.Roles
  87               //      - CR376, Add OtherIdentifyingInfo and 
  88               //             IdentifyingDescriptions properties to LogicalDevice
  89               //      - CR387, Add PowerOnHours and TotalPowerOnHours properties
  90               //           to LogicalDevice / Update the Availability enum
  91               //      - CR389, Add MinValue and MaxValue qualifiers
  92               //      - CR390a, Create subclasses of StatisticalInformation
  93               //           to formalize naming
  94               //      - CR391b, 400a and 401b, Add Counter, Gauge, BitMap, 
  95               //                 BitValue and Static qualifiers / Update MinValue 
  96               //                 and MaxValue to apply to methods and parameters
  97               //      - CR396d, Add NonlocalType and SourceType qualifiers
  98               //      - CR404a, Add ServiceComponent association
  99               //      - CR405, Add Counter qualifier to PowerOnHours and
 100               //                 and TotalPowerOnHours properties of LogicalDevice
 101               //      - CR411, Add Provider qualifier
 102               //      - CR413, Fix propagation of keys from 390a
 103               //        07/06/1999 - Version 2.2.1
 104               //      - CR423, Locale should be specified as en_US
 105               //      - CR425, Update the DMI MappingStrings using the June
 106 karl  1.1.2.1 //          release of the master.mif
 107               //  Date  02/18/2000 - Version 2.3
 108               //      - CR433, New properties and enums from Master.MIF 
 109               //              and new ModelCorrespondences
 110               //      - CR444, Add the RestartService property to the 
 111               //              CIM_ServiceServiceDependency association in the 
 112               //              core mof to support diagnostics. 
 113               //      - CR445e Modify the LogicalDevice for Fault Tolerance: 
 114               //              Update the Availability property, add an AdditionalAvailability 
 115               //              property, change the description for the StatusInfo property
 116               //              add new methods, and add a MaxQuiesceTime property
 117               //      - CR446c add Octetstring Qualifier 
 118               //      - CR448b Add ManagedElement, Collection  and MemberOfCollection Classes, 
 119               //              update ManagedSystemElement and Dependency classes accordingly
 120               //      - CR456 Add "Management" to the end of the Values array for 
 121               //              CIM_ComputerSystem.Dedicated
 122               //      - CR458c Add a new association, CIM_Synchronized  
 123               //      - CR461 Subclass from CIM_ManagedElement, CIM_Collection and 
 124               //          CIM_MemberOfCollection.  
 125               //          Remove Description & Caption from the above classes, where exist.
 126               //      - CR462 Update the Description for ManagedElement, Add qualifier in 
 127 karl  1.1.2.1 //          MemberOfCollection
 128               //  Date 06/04/2000 - Version 2.3.2
 129               //      - Errata, Changes in CR448b not complete / Missing delete of
 130               //          Caption and Description properties where inherited from
 131               //          CIM_ManagedElement for CIM_CollectionOfMSEs
 132               //  Date 06/09/2000 - Version 2.4
 133               //      - CR481 Change the CIM_Statistics association to reference ManagedElement,
 134               //           not just ManagedSystemElement.
 135               //      - CR491a Add to new values to the enumeration for 
 136               //          ManagedSystemElement.Status and update the property's Description.
 137               //  Date 07/14/2000 Version 2.4
 138               //      - CR505 
 139               //          1. Clarify the subclassing of ServiceServiceDependency
 140               //          2. ProvidesServiceToElement needs to come before 
 141               //             ServiceServiceDependency in MOF
 142               //          3. Update the Description for CollectionOfMSEs to include 'bags'
 143               //      - CR519 ERRATA CIM 2.3: correct ValueMap syntax errors in 
 144               //              CIM_LogicalDevice.Availability 
 145               //  Date 12/01/2000 Version 2.5
 146               //      - CR514j Add Deprecated qualifier
 147               //      - CR529 CIM_LogicalDisk.StatusInfo property description refers to it as 
 148 karl  1.1.2.1 //              a string even though the property is a uint16
 149               //      - CR532 Update description on PhysicalElement.OtherIdentifyingInfo 
 150               //              to remove word "asset"
 151               //      - CR534 Update MappingStrings Qualifiers to stay in sync with 
 152               //              updates to the MASTER.MIF.
 153               //      - CR536a Add EXPERIMENTAL Qualifier
 154               //      - CR537a Add Stopped as a valid state in the enumeration for 
 155               //               ManagedSystemElement.Status.
 156               //      - CR544a Add DN qualifier 
 157               //      - CR447e Add PropertyUsage qualifier
 158               //      - CR548a Add a methods to CIM_Setting to allow a subset of the 
 159               //               properties in the CIM_Setting instance to be verified 
 160               //               and/or applied
 161               //      - CR557 Change the reference for ProvidesServiceToElement.
 162               //              Dependent to ME (was MSE) 
 163               //      - CR564 Move AdminDomain to the Core Model, change to concrete, 
 164               //              and update description 
 165               //      - CR568a Corrections to CIM_CollectionOfMSEs Description 
 166               //      - CR569 Add EmbeddedObject qualifier 
 167               //      - CR581 Revise the description of CIM_AdminDomain.NameFormat 
 168               //              to alter reference to Network model 
 169 karl  1.1.2.1 //      - CR585 Company review Changes from Compaq
 170               //          1) Remove word "schema" from qualifier scope declarations 
 171               //             per CIM_Spec_Errat221
 172               //  Date 05/20/2001 Version 2.5 Final
 173               //          Changed format of classes to be consistent.
 174               //  Date 05/24/2001 Version 2.6
 175               //      - CR583d - Moved the following properties and methods from
 176               //                 UnitaryComputerSystem to ComputerSystem:
 177               //                 ResetCapability, PowerManagementCapabilites, and 
 178               //                 SetPowerState.
 179               //      - CR587 - Add boolean CustomerReplaceable to the FRU class.
 180               //      - CR588 - Add new ReplaceableProductFRU association
 181               //      - CR608 - Correct the mapping strings associated with 
 182               //                System.PrimaryOwnerName and System.Primary OwnerContact 
 183               //                properties.
 184               //      - CR609 - Add SetPowerStateWithOptions method to Computer
 185               //                System
 186               // ==================================================================
 187               
 188               // ==================================================================
 189               // Pragmas
 190 karl  1.1.2.1 // ==================================================================
 191               #pragma locale ("en_US")
 192               
 193               // ==================================================================
 194               // Qualifiers
 195               // ==================================================================
 196               Qualifier Abstract : boolean = false, Scope(class, association, 
 197                   indication), Flavor(DisableOverride, Restricted);
 198               Qualifier Aggregate: boolean = false, Scope (reference),
 199                   Flavor(DisableOverride);
 200               Qualifier Aggregation : boolean = false, Scope(association),
 201                   Flavor(DisableOverride);
 202               Qualifier Alias : string = null, Scope(property, reference, 
 203                   method), Flavor(Translatable);
 204               Qualifier ArrayType : string = "Bag", Scope(property, parameter);
 205               Qualifier Association : boolean = false, Scope(class, association), 
 206                     Flavor(DisableOverride);
 207               Qualifier BitMap : string[], Scope(property, method, parameter);
 208               Qualifier BitValues : string[], Scope(property, method,
 209                   parameter), Flavor(Translatable);
 210               Qualifier Counter : boolean = false, Scope(property, method, 
 211 karl  1.1.2.1     parameter);
 212               Qualifier Delete : boolean = false, Scope(association, reference);
 213               Qualifier Deprecated : string [], Scope(class, association, property, method);
 214               Qualifier Description : string = null, Scope(any), 
 215                   Flavor(Translatable);
 216               Qualifier DisplayName : string = null, Scope(any),
 217                   Flavor(Translatable);
 218               Qualifier DN : boolean=false, 
 219                   Scope(property, parameter), Flavor(DisableOverride); 
 220               Qualifier EmbeddedObject : boolean = false, Scope(property);
 221               Qualifier Expensive : boolean = false, 
 222                   Scope(property, reference, method, class, association);
 223               Qualifier Experimental : boolean = false, 
 224                   Scope(any), Flavor (DisableOverride); 
 225               Qualifier Gauge : boolean = false, Scope(property, method, 
 226                   parameter);
 227               Qualifier Ifdeleted : boolean = false, Scope(association, 
 228                   reference);
 229               Qualifier In : boolean = true, Scope(parameter),
 230                   Flavor(DisableOverride);
 231               Qualifier Indication : boolean = false, Scope(class, indication), 
 232 karl  1.1.2.1     Flavor(DisableOverride);
 233               Qualifier Invisible : boolean = false,
 234                   Scope(reference, association, class, property, method);
 235               Qualifier Key : boolean = false, Scope(property, reference), 
 236                   Flavor(DisableOverride);
 237               Qualifier Large : boolean = false, Scope(property, class);
 238               Qualifier MappingStrings : string[],
 239                   Scope(class, property, association, indication, reference);
 240               Qualifier Max : uint32 = null, Scope(reference);
 241               Qualifier MaxLen : uint32 = null, Scope(property, method, 
 242                   parameter);
 243               Qualifier MaxValue : sint64 = null, Scope(property, method,
 244                   parameter);
 245               Qualifier Min : uint32 = 0, Scope(reference);
 246               Qualifier MinValue : sint64 = null, Scope(property, method,
 247                   parameter);
 248               Qualifier ModelCorrespondence : string[], Scope(property);
 249               Qualifier Nonlocal : string = null, Scope(reference);
 250               Qualifier NonlocalType : string = null, Scope(reference);
 251               Qualifier NullValue : string = null, Scope (property),
 252                     Flavor(DisableOverride);
 253 karl  1.1.2.1 Qualifier Octetstring : boolean = false, Scope(property, parameter);
 254               Qualifier Out : boolean = false, Scope(parameter),
 255                   Flavor(DisableOverride);
 256               Qualifier Override : string = null, Scope(property, method, 
 257                   reference), Flavor(DisableOverride);
 258               Qualifier Propagated : string = null, Scope(property),
 259                   Flavor(DisableOverride);
 260               Qualifier PropertyUsage : string = "CurrentContext", Scope(property) ; 
 261               Qualifier Provider : string = null, Scope(any);
 262               Qualifier Read : boolean = true, Scope(property);
 263               Qualifier Required : boolean = false, Scope(property);
 264               Qualifier Revision : string = ".5", Scope(class, 
 265                   association, indication ), Flavor(Translatable);
 266               Qualifier Schema : string = null, Scope (property, method), 
 267                   Flavor(DisableOverride, Translatable);
 268               Qualifier Source : string = null, Scope(class, association, 
 269                   indication);
 270               Qualifier SourceType : string = null, Scope(class, association, 
 271                     indication, reference);
 272               Qualifier Static : boolean = false, Scope(method, property),
 273                   Flavor(DisableOverride);
 274 karl  1.1.2.1 Qualifier Syntax : string = null, Scope(property, reference,
 275                   method, parameter);
 276               Qualifier SyntaxType : string = null, Scope(property, reference,
 277                   method, parameter);
 278               Qualifier Terminal : boolean = FALSE, Scope(class);
 279               Qualifier TriggerType : string = null,
 280                   Scope(class, property, reference, method, association, 
 281                   indication);
 282               Qualifier Units : string = null, Scope(property, method,  
 283                   parameter), Flavor(Translatable);
 284               Qualifier UnknownValues : string[], Scope(property),
 285                   Flavor(DisableOverride);
 286               Qualifier UnsupportedValues : string[], Scope(property),
 287                   Flavor(DisableOverride);
 288               Qualifier ValueMap : string[], Scope(property, method, parameter);
 289               Qualifier Values : string[], Scope(property, method, parameter), 
 290                   Flavor(Translatable);
 291               Qualifier Version : string = "V2.5", Scope(class, 
 292                   association, indication), Flavor(Translatable);
 293               Qualifier Weak : boolean = false, Scope(reference), 
 294                     Flavor(DisableOverride, ToSubclass);
 295 karl  1.1.2.1 Qualifier Write : boolean = false, Scope(property);
 296               
 297               // ==================================================================
 298               //
 299               //  Elements and Collections
 300               //
 301               // ==================================================================
 302               // ==================================================================
 303               // ManagedElement
 304               // ================================================================== 
 305                  [Abstract, Description (
 306                    "ManagedElement is an abstract class that provides a common "  
 307                    "superclass (or top of the inheritance tree) for the "
 308                    "non-association classes in the CIM Schema.")]
 309               class CIM_ManagedElement {  
 310                     [MaxLen (64), Description (  
 311                       "The Caption property is a short textual description (one-"    
 312                       "line string) of the object.") ]   
 313                  string Caption;  
 314                     [Description (  
 315                       "The Description property provides a textual description of "
 316 karl  1.1.2.1         "the object.") ]   
 317                  string Description;    
 318               };
 319                    
 320               
 321               // ================================================================== 
 322               //    ManagedSystemElement
 323               // ==================================================================
 324                  [Abstract, Description (
 325                    "CIM_ManagedSystemElement is the base class for the System "
 326                    "Element hierarchy. Membership Criteria: Any distinguishable "
 327                    "component of a System is a candidate for inclusion in this "
 328                    "class. Examples: software components, such as files; and "
 329                    "devices, such as disk drives and controllers, and physical "
 330                    "components such as chips and cards.") ] 
 331               class CIM_ManagedSystemElement : CIM_ManagedElement {
 332                     [Description (
 333                       "A datetime value indicating when the object was installed. "
 334                       "A lack of a value does not indicate that the object is not "
 335                       "installed."), 
 336                      MappingStrings {"MIF.DMTF|ComponentID|001.5"} ] 
 337 karl  1.1.2.1    datetime InstallDate;
 338                     [MaxLen (256), Description (
 339                       "The Name property defines the label by which the object is "
 340                       "known. When subclassed, the Name property can be overridden "
 341                       "to be a Key property.") ] 
 342                  string Name;
 343                     [MaxLen (10), Description ( 
 344                       "  A string indicating the current status of the object. " 
 345                       "Various operational and non-operational statuses are " 
 346                       "defined. Operational statuses are \"OK\", \"Degraded\", " 
 347                       "\"Stressed\" and \"Pred Fail\". \"Stressed\" indicates that " 
 348                       "the Element is functioning, but needs attention. Examples " 
 349                       "of \"Stressed\" states are overload, overheated, etc. The " 
 350                       "condition \"Pred Fail\" (failure predicted) indicates that " 
 351                       "an Element is functioning properly but predicting a failure " 
 352                       "in the near future. An example is a SMART-enabled hard " 
 353                       "drive. \n" 
 354                       "  Non-operational statuses can also be specified. These " 
 355                       "are \"Error\", \"NonRecover\", \"Starting\", \"Stopping\", " 
 356                       " \"Stopped\", " 
 357                       "\"Service\", \"No Contact\" and \"Lost Comm\". \"NonRecover\" " 
 358 karl  1.1.2.1         "indicates that a non-recoverable error has occurred. " 
 359                       "\"Service\" describes an Element being configured, maintained, " 
 360                       "cleaned, or otherwise administered. This status could apply " 
 361                       "during mirror-resilvering of a disk, reload of a user " 
 362                       "permissions list, or other administrative task. Not all such " 
 363                       "work is on-line, yet the Element is neither \"OK\" nor in " 
 364                       "one of the other states. \"No Contact\" indicates that the " 
 365                       "current instance of the monitoring system has knowledge of " 
 366                       "this Element but has never been able to establish " 
 367                       "communications with it. \"Lost Comm\" indicates that " 
 368                       "the ManagedSystemElement is known to exist and has been " 
 369                       "contacted successfully in the past, but is currently unreachable." 
 370                       "\"Stopped\" indicates that the ManagedSystemElement is known " 
 371                       "to exist, it is not operational (i.e. it is unable to " 
 372                       "provide service to users), but it has not failed. It has purposely " 
 373                       "been made non-operational. The Element " 
 374                       "may have never been \"OK\", the Element may have initiated its " 
 375                       "own stop, or a management system may have initiated the stop."), 
 376                      ValueMap {"OK", "Error", "Degraded", "Unknown", "Pred Fail", 
 377                                "Starting", "Stopping", "Service", "Stressed", 
 378                                "NonRecover", "No Contact", "Lost Comm", "Stopped"} ] 
 379 karl  1.1.2.1    string Status; 
 380               };
 381               
 382               
 383               // ==================================================================
 384               // Collection 
 385               // ================================================================== 
 386                  [Abstract, Description (   
 387                    "Collection is an abstract class that provides a common"   
 388                    "superclass for data elements that represent collections of "
 389                    "ManagedElements and its subclasses.")]
 390               class CIM_Collection : CIM_ManagedElement {   
 391               };
 392               
 393               
 394               // ===================================================================
 395               //    CollectionOfMSEs
 396               // ===================================================================
 397                  [Abstract, Description (
 398                    "The CollectionOfMSEs object allows the grouping of Managed"
 399                    "SystemElements for various identification purposesand to "
 400 karl  1.1.2.1      "reduce the complexity of associating Settings and"
 401                    "Configurations. It is abstract to require furtherdefinition "
 402                    "and semantic refinement in subclasses. TheCollectionOfMSEs "
 403                    "object does not carry any state or statusinformation, but "
 404                    "only represents a grouping or 'bag' of Elements. Forthis "
 405                    "reason, it is incorrect to subclass groups that havestate/"
 406                    "status from CollectionOfMSEs - an example isCIM_Redundancy"
 407                    "Group (which is correctly subclassed fromLogicalElement).\n"
 408                    "Collections typically aggregate 'like'objects, but are " 
 409                    "not required to do so.  They simply identify 'bags' and "
 410                    "may represent an optimization. This is especiallytrue "
 411                    "with respect to their association to Settings and"
 412                    "Configurations. Without Collections, one is forcedto "
 413                    "define individual ElementSetting andElementConfiguration "
 414                    "associations, to tie Settings and Configurationobjects to "
 415                    "individual ManagedSystemElements. There may be much"
 416                    "duplication in assigning the same Setting tomultiple objects. "
 417                    "In addition, using the Collection object allows the"
 418                    "determination that the Setting and Configurationassociations "
 419                    "are indeed the same for the Collection's members.This "
 420                    "information would otherwise be obtained by definingthe "
 421 karl  1.1.2.1      "Collection in a proprietary manner, and thenquerying "
 422                    "the ElementSetting and ElementConfigurationassociations to "
 423                    "determine ifthe Collection set is completely covered.") ]
 424               class CIM_CollectionOfMSEs : CIM_Collection {
 425                     [MaxLen (256), Description (
 426                       "The identification of the Collection object. When subclassed, "
 427                       "the CollectionID property can be overridden to be a Key "
 428                       "property.") ]
 429                  string CollectionID;
 430               };
 431               
 432               
 433               // ==================================================================
 434               //    CollectedCollections
 435               // ==================================================================
 436                  [Association, Aggregation, Description (
 437                    "CIM_CollectedCollections is an aggregation association "
 438                    "representing that a CollectionOfMSEs may itself be contained "
 439                    "in a CollectionOfMSEs.") ]
 440               class CIM_CollectedCollections {
 441                     [Aggregate, Key, Description (
 442 karl  1.1.2.1         "The 'higher level' or parent element in the aggregation.") ]
 443                  CIM_CollectionOfMSEs REF Collection;
 444                     [Key, Description ("The 'collected' Collection.") ]
 445                  CIM_CollectionOfMSEs REF CollectionInCollection;
 446               };
 447               
 448                    
 449               // ================================================================= 
 450               //    PhysicalElement
 451               // ==================================================================
 452                  [Abstract, Description (
 453                    "Subclasses of CIM_PhysicalElement define any component of a " 
 454                    "System that has a distinct physical identity. Instances of "
 455                    "this class can be defined in terms of labels that can be "
 456                    "physically attached to the object. All Processes, Files, "
 457                    "and LogicalDevices are considered not to be Physical"
 458                    "Elements. For example, it is not possible to attach a "
 459                    "label to a modem. It is only possible to attach a label to "
 460                    "the card that implements the modem. The same card could "
 461                    "also implement a LAN  adapter. These are tangible Managed "
 462                    "System Elements (usually actual hardware items) that have a "
 463 karl  1.1.2.1      "physical manifestation of some sort. A Managed System "
 464                    "Element is not necessarily a discrete component. For "
 465                    "example, it is possible for a single Card (which is a type "
 466                    "of Physical Element) to host more than one Logical Device. "
 467                    "The card would be represented by a single Physical Element "
 468                    "associated with multiple Logical Devices.") ] 
 469               class CIM_PhysicalElement : CIM_ManagedSystemElement {
 470                     [Key, MaxLen (256), Description (
 471                       "An arbitrary string that uniquely identifies the Physical"
 472                       "Element and serves as the Element's key.  The Tag property "
 473                       "can contain information such as asset tag or serial number "
 474                       "data. The key for PhysicalElement is placed very high in the "
 475                       "object hierarchy in order to independently identify the "
 476                       "hardware/entity, regardless of physical placement in or on "
 477                       "Cabinets, Adapters, etc.  For example, a hotswappable or "
 478                       "removeable component may be taken from its containing "
 479                       "(scoping) Package and be temporarily unused.  The object "
 480                       "still continues to exist - and may even be inserted into a "
 481                       "different scoping container.  Therefore, the key for Physical"
 482                       "Element is an arbitrary string and is defined independently "
 483                       "of any placement or location-oriented hierarchy.") ]
 484 karl  1.1.2.1    string Tag;
 485                     [Key, MaxLen (256), Description (
 486                       "CreationClassName indicates the name of the class or the "
 487                       "subclass used in the creation of an instance. When used "
 488                       "with the other key properties of this class, this property "
 489                       "allows all instances of this class and its subclasses to "
 490                       "be uniquely identified.") ]
 491                  string CreationClassName;
 492                     [MaxLen (256), Description (
 493                       "The name of the organization responsible for producing the "
 494                       "PhysicalElement. This may be the entity from whom the Element "
 495                       "is purchased, but this is not necessarily true. The latter "
 496                       "information is contained in the Vendor property of "
 497                       "CIM_Product.") ] 
 498                  string Manufacturer;
 499                     [MaxLen (64), Description (
 500                       "The name by which the PhysicalElement is generally known.") ] 
 501                  string Model;
 502                     [MaxLen (64), Description (
 503                       "The stock keeping unit number for this PhysicalElement.") ] 
 504                  string SKU;
 505 karl  1.1.2.1       [MaxLen (64), Description (
 506                       "A manufacturer-allocated number used to identify the Physical"
 507                       "Element.") ] 
 508                  string SerialNumber;
 509                     [MaxLen (64), Description (
 510                       "A string indicating the version of the PhysicalElement.") ] 
 511                  string Version;
 512                     [MaxLen (256), Description (
 513                       "The part number assigned by the organization responsible for "
 514                       "producing or manufacturing the PhysicalElement.") ]
 515                  string PartNumber;
 516                     [Description (
 517                       "OtherIdentifyingInfo captures additional data, beyond that of " 
 518                       "Tag information, that could be used to identify a Physical" 
 519                       "Element. One example is bar code data associated with an " 
 520                       "Element that also has an asset tag. Note that if only bar " 
 521                       "code data is available and is unique/able to be used as an " 
 522                       "Element key, this property would be NULL and the bar code " 
 523                       "data used as the class key, in the Tag property.") ] 
 524                  string OtherIdentifyingInfo;
 525                     [Description (
 526 karl  1.1.2.1         "Boolean indicating that the PhysicalElement is powered on "
 527                       "(TRUE), or is currently off (FALSE).") ]
 528                  boolean PoweredOn;
 529                     [Description (
 530                       "Date that this PhysicalElement was manufactured.") ]
 531                  datetime ManufactureDate;
 532               };
 533               
 534                    
 535               // ==================================================================
 536               //    LogicalElement
 537               // ==================================================================
 538                  [Abstract, Description (
 539                    "CIM_LogicalElement is a base class for all the components of "
 540                    "a System that represent abstract system components, such "
 541                    "as Files, Processes, or system capabilities in the form "
 542                    "of Logical Devices.") ] 
 543               class CIM_LogicalElement : CIM_ManagedSystemElement {
 544               };
 545               
 546                    
 547 karl  1.1.2.1 // ==================================================================
 548               //    LogicalIdentity
 549               // ==================================================================
 550                  [Association, Abstract, Description (
 551                    "CIM_LogicalIdentity is an abstract and generic association, "
 552                    "indicating that two LogicalElements represent different "
 553                    "aspects of the same underlying entity. This relationship "
 554                    "conveys what could be defined with multiple inheritance. It "
 555                    "is restricted to the 'logical' aspects of a ManagedSystem"
 556                    "Element. In most scenarios, the Identity relationship is "
 557                    "determined by the equivalence of Keys or some other "
 558                    "identifying properties of the related Elements. The "
 559                    "association should only be used in well understood scenarios. "
 560                    "This is why the association is abstract - allowing more "
 561                    "concrete definition and clarification in subclasses. One of "
 562                    "the scenarios where this relationship is reasonable is to "
 563                    "represent that a Device is both a 'bus' entity and a "
 564                    "'functional' entity. For example, a Device could be both a "
 565                    "USB (bus) and a Keyboard (functional) entity.") ]
 566               class CIM_LogicalIdentity {
 567                     [Key, Description (
 568 karl  1.1.2.1         "SystemElement represents one aspect of the Logical"
 569                       "Element.") ]
 570                  CIM_LogicalElement ref SystemElement;
 571                     [Key, Description (
 572                       "SameElement represents an alternate aspect of the "
 573                       "System entity.") ]
 574                  CIM_LogicalElement ref SameElement;
 575               };
 576               
 577               
 578               // ==================================================================
 579               //    System
 580               // ==================================================================
 581                  [Abstract, Description (
 582                    "A CIM_System is a LogicalElement that aggregates an "
 583                    "enumerable set of Managed System Elements. The aggregation "
 584                    "operates as a functional whole. Within any particular "
 585                    "subclass of System, there is a well-defined list of "
 586                    "Managed System Element classes whose instances must be "
 587                    "aggregated.") ] 
 588               class CIM_System : CIM_LogicalElement {
 589 karl  1.1.2.1       [Key, MaxLen (256), Description (
 590                       "CreationClassName indicates the name of the class or the "
 591                       "subclass used in the creation of an instance. When used "
 592                       "with the other key properties of this class, this property "
 593                       "allows all instances of this class and its subclasses to "
 594                       "be uniquely identified.") ]
 595                  string CreationClassName;
 596                     [Key, MaxLen (256), Override ("Name"), Description (
 597                       "The inherited Name serves as key of a System instance in " 
 598                       "an enterprise environment.") ] 
 599                  string Name;
 600                     [MaxLen (64), Description (
 601                       "The System object and its derivatives are Top Level Objects "
 602                       "of CIM. They provide the scope for numerous components. " 
 603                       "Having unique System keys is required. A heuristic can be "
 604                       "defined in individual System subclasses to attempt to always "
 605                       "generate the same System Name Key. The NameFormat property "
 606                       "identifies how the System name was generated, using "
 607                       "the subclass' heuristic.") ] 
 608                  string NameFormat;
 609                     [MaxLen (64), Description (
 610 karl  1.1.2.1         "The name of the primary system owner."),
 611                      MappingStrings {"MIF.DMTF|General Information|001.3"} ]  
 612                  string PrimaryOwnerName;
 613                     [MaxLen (256), Description (
 614                       "A string that provides information on how the primary system "
 615                       "owner can be reached (e.g. phone number, email address, "
 616                       "...)."),
 617                      MappingStrings {"MIF.DMTF|General Information|001.4"} ] 
 618                  string PrimaryOwnerContact;
 619                     [Description (
 620                       "An array (bag) of strings that specify the roles this System "
 621                       "plays in the IT-environment. Subclasses of System may "
 622                       "override this property to define explicit Roles values. "
 623                       "Alternately, a Working Group may describe the heuristics, "
 624                       "conventions and guidelines for specifying Roles. For "
 625                       "example, for an instance of a networking system, the Roles "
 626                       "property might contain the string, 'Switch' or 'Bridge'.") ]
 627                  string Roles[];
 628               };
 629               
 630               
 631 karl  1.1.2.1 // ===================================================================
 632               //    ComputerSystem
 633               // ===================================================================
 634                  [Abstract, Description (
 635                    "A class derived from System that is a special collection of "
 636                    "ManagedSystemElements. This collection provides "
 637                    "compute capabilities and serves as aggregation point to "
 638                    "associate one or more of the following elements: FileSystem, "
 639                    "OperatingSystem, Processor and Memory (Volatile and/or "
 640                    "NonVolatile Storage).") ] 
 641               class CIM_ComputerSystem : CIM_System {
 642                     [Override ("NameFormat"), Description (
 643                       "The ComputerSystem object and its derivatives are Top Level "
 644                       "Objects of CIM. They provide the scope for numerous "
 645                       "components. Having unique System keys is required. "
 646                       "A heuristic is defined to create the ComputerSystem Name "
 647                       "to attempt to always generate the same Name, independent of "
 648                       "discovery protocol. This prevents inventory and management "
 649                       "problems where the same asset or entity is discovered "
 650                       "multiple times, but can not be resolved to a single object. "
 651                       "Use of the heuristic is optional, but recommended.\n\n"
 652 karl  1.1.2.1         "The NameFormat property identifies how the ComputerSystem "
 653                       "Name is generated, using a heuristic. The heuristic is "
 654                       "outlined, in detail, in the CIM V2 System Model spec. "
 655                       "It assumes that the documented rules are traversed in order, "
 656                       "to determine and assign a Name. The NameFormat Values "
 657                       "list defines the precedence order for assigning the Computer"
 658                       "System Name. Several rules do map to the same Value.\n\n"
 659                       "Note that the ComputerSystem Name calculated using the "
 660                       "heuristic is the System's key value. Other names can be "
 661                       "assigned and used for the ComputerSystem, that better suit "
 662                       "a business, using Aliases."), 
 663                      ValueMap {"Other", "IP", "Dial", "HID", "NWA", "HWA", "X25", 
 664                                "ISDN", "IPX", "DCC", "ICD", "E.164", "SNA", "OID/OSI"} ]
 665                  string NameFormat;
 666                     [MaxLen (256), ArrayType ("Indexed"), Description (
 667                       "OtherIdentifyingInfo captures additional data, beyond "
 668                       "System Name information, that could be used to identify "
 669                       "a ComputerSystem. One example would be to hold the "
 670                       "Fibre Channel World-Wide Name (WWN) of a node. Note that "
 671                       "if only the Fibre Channel name is available and is "
 672                       "unique (able to be used as the System key), then this "
 673 karl  1.1.2.1         "property would be NULL and the WWN would become the "
 674                       "System key, its data placed in the Name property."),
 675                      ModelCorrespondence {
 676                       "CIM_ComputerSystem.IdentifyingDescriptions"} ]
 677                  string OtherIdentifyingInfo[];
 678                     [ArrayType ("Indexed"), Description (
 679                       "An array of free-form strings providing explanations "
 680                       "and details behind the entries in the OtherIdentifying"
 681                       "Info array. Note, each entry of this array is related "
 682                       "to the entry in OtherIdentifyingInfo that is located at "
 683                       "the same index."),
 684                      ModelCorrespondence {
 685                       "CIM_ComputerSystem.OtherIdentifyingInfo"} ]
 686                  string IdentifyingDescriptions[];
 687                     [Description (
 688                       "Enumeration indicating whether the ComputerSystem is "
 689                       "a special-purpose System (ie, dedicated to a particular "
 690                       "use), versus being 'general purpose'. For example, one "
 691                       "could specify that the System is dedicated to \"Print\" "
 692                       "(value=11) or acts as a \"Hub\" (value=8)."),
 693                      Values {"Not Dedicated", "Unknown", "Other", "Storage", 
 694 karl  1.1.2.1                "Router", "Switch", "Layer 3 Switch", 
 695                              "Central Office Switch", "Hub", "Access Server", 
 696                              "Firewall", "Print", "I/O", "Web Caching", "Management"} ]
 697                  uint16 Dedicated[];
 698                     [Description (
 699                       "If enabled (value = 4), the UnitaryComputerSystem can be "
 700                       "reset via hardware (e.g. the power and reset buttons). If "
 701                       "disabled (value = 3), hardware reset is not allowed. In "
 702                       "addition to Enabled and Disabled, other Values for the "
 703                       "property are also defined - \"Not Implemented\" (5), "
 704                       "\"Other\" (1) and \"Unknown\" (2)."),
 705                      ValueMap {"1", "2", "3", "4", "5"},
 706                      Values {"Other", "Unknown", "Disabled",
 707                              "Enabled", "Not Implemented"},
 708                      MappingStrings {"MIF.DMTF|System Hardware Security|001.4"} ]
 709                  uint16 ResetCapability;
 710                     [Description(
 711                       "Indicates the specific power-related capabilities of a "
 712                       "ComputerSystem and its associated running OperatingSystem. "
 713                       "The values, 0=\"Unknown\", 1=\"Not Supported\", and "
 714                       "2=\"Disabled\" are self-explanatory. "
 715 karl  1.1.2.1         "The value, 3=\"Enabled\" indicates that the power management "
 716                       "features are currently enabled but the exact feature set "
 717                       "is unknown or the information is unavailable. "
 718                       "\"Power Saving Modes Entered Automatically\" (4) describes "
 719                       "that a system can change its power state based on usage or "
 720                       "other criteria. \"Power State Settable\" (5) indicates that "
 721                       "the SetPowerState method is supported. \"Power Cycling "
 722                       "Supported\" (6) indicates that the SetPowerState method "
 723                       "can be invoked with the PowerState input variable set to 5 ("
 724                       "\"Power Cycle\"). \"Timed Power On Supported\" (7) indicates "
 725                       "that the SetPowerState method can be invoked with the Power"
 726                       "State input variable set to 5 (\"Power Cycle\") and the Time "
 727                       "parameter set to a specific date and time, or interval, "
 728                       "for power-on."),
 729                      Values {"Unknown", "Not Supported", "Disabled", 
 730                              "Enabled", "Power Saving Modes Entered Automatically",
 731                              "Power State Settable", "Power Cycling Supported",
 732                              "Timed Power On Supported"},
 733                      MappingStrings {"MIF.DMTF|System Power Controls|001.2"} ]
 734                  uint16 PowerManagementCapabilities[];
 735                     [Description(
 736 karl  1.1.2.1         "SetPowerState defines the desired power state of a "
 737                       "ComputerSystem and its running OperatingSystem, and when "
 738                       "the system should be put into that state. The PowerState "
 739                       "parameter is specified as one of the following integer "
 740                       "values: 1=\"Full Power\", 2=\"Power Save - Low Power Mode\", "
 741                       "3=\"Power Save - Standby\", 4=\"Power Save - Other\", "
 742                       "5=\"Power Cycle\", 6=\"Power Off\", 7=\"Hibernate\" and "
 743                       "8=\"Soft Off\". The Time parameter (for all state changes "
 744                       "but 5, \"Power Cycle\") indicates when the power state "
 745                       "should be set, either as a regular date-time value or as "
 746                       "an interval value (where the interval begins when the "
 747                       "method invocation is received). When the PowerState "
 748                       "parameter is equal to 5, \"Power Cycle\", the Time "
 749                       "parameter indicates when the system should power on "
 750                       "again. Power off is immediate. SetPowerState should "
 751                       "return 0 if successful, 1 if the specified State and "
 752                       "Time request is not supported, and some other value if "
 753                       "any other error occurred. In a subclass, the "
 754                       "set of possible return codes could be specified, using a "
 755                       "ValueMap qualifier on the method. The strings to which the "
 756                       "ValueMap contents are 'translated' may also be specified in "
 757 karl  1.1.2.1         "the subclass as a Values array qualifier.") ]
 758                  uint32 SetPowerState(
 759                     [IN, ValueMap {"1", "2", "3", "4", "5", "6", "7", "8"},
 760                          Values {"Full Power", "Power Save - Low Power Mode", 
 761                                  "Power Save - Standby", "Power Save - Other", 
 762                                  "Power Cycle", "Power Off", "Hibernate", "Soft Off"}] 
 763                  uint32 PowerState, 
 764                     [IN] datetime Time);
 765                     [Description( 
 766                       "SetPowerStateWithBootFlags defines the desired power state of a " 
 767                       "ComputerSystem and its running OperatingSystem, and when " 
 768                       "the system should be put into that state. The PowerState " 
 769                       "parameter is specified as one of the following integer " 
 770                       "values: 1=\"Full Power\", 2=\"Power Save - Low Power Mode\", " 
 771                       "3=\"Power Save - Standby\", 4=\"Power Save - Other\", " 
 772                       "5=\"Power Cycle\", 6=\"Power Off\", 7=\"Hibernate\", " 
 773                       "8=\"Soft Off\" and 9=\"Reset\" " 
 774                       "The Time parameter (for all state changes " 
 775                       "but 5, \"Power Cycle\") indicates when the power state " 
 776                       "should be set, either as a regular date-time value or as " 
 777                       "an interval value (where the interval begins when the " 
 778 karl  1.1.2.1         "method invocation is received). When the PowerState " 
 779                       "parameter is equal to 5, \"Power Cycle\", the Time " 
 780                       "parameter indicates when the system should power on " 
 781                       "again. Power off is immediate. " 
 782                       "BootOptions parameter provides the options to be used " 
 783                       "when the system comes back up. These options are not " 
 784                       "used when the PowerState parameter is \"Power Off\", or " 
 785                       "\"Soft Off\". This method could also be used to make the " 
 786                       "bootOptions effective without changing the powerState. " 
 787                       "For example, the system could be already in \"Full Power\" " 
 788                       "state, but waiting at a boot loader state to receive a " 
 789                       "command for BootOptions. The BootOptions can be specified " 
 790                       "using this method. SetPowerStateWithBootFlags should " 
 791                       "return 0 if successful, 1 if the specified State and " 
 792                       "Time request is not supported, and some other value if " 
 793                       "any other error occurred. In a subclass, the " 
 794                       "set of possible return codes could be specified, using a " 
 795                       "ValueMap qualifier on the method. The strings to which the " 
 796                       "ValueMap contents are 'translated' may also be specified in " 
 797                       "the subclass as a Values array qualifier.") ] 
 798                  uint32 SetPowerStateWithOptions( 
 799 karl  1.1.2.1       [IN, ValueMap {"1", "2", "3", "4", "5", "6", "7", "8", "9"}, 
 800                          Values {"Full Power", "Power Save - Low Power Mode", 
 801                                  "Power Save - Standby", "Power Save - Other", 
 802                                  "Power Cycle", "Power Off", "Hibernate", "Soft Off", "Reset"} ] 
 803                      uint16 PowerState, 
 804                     [IN] datetime Time, 
 805                     [IN] CIM_Settings REF Options);
 806               };
 807                    
 808               
 809               // ===================================================================
 810               //    LogicalDevice
 811               // ===================================================================
 812                  [Abstract, Description (
 813                    "An abstraction or emulation of a hardware entity, that may "
 814                    "or may not be Realized in physical hardware. Any "
 815                    "characteristics of a LogicalDevice that are used to manage "
 816                    "its operation or configuration are contained in, or "
 817                    "associated with, the LogicalDevice object. Examples of the "
 818                    "operational properties of a Printer would be paper sizes "
 819                    "supported, or detected errors. Examples of the configuration "
 820 karl  1.1.2.1      "properties of a Sensor Device would be threshold settings. "
 821                    "Various configurations could exist for a LogicalDevice. "
 822                    "These configurations could be contained in Setting objects "
 823                    "and associated with the LogicalDevice.") ] 
 824               class CIM_LogicalDevice : CIM_LogicalElement {
 825                     [Propagated("CIM_System.CreationClassName"), 
 826                      Key, MaxLen (256), Description (
 827                       "The scoping System's CreationClassName.") ]
 828                  string SystemCreationClassName;
 829                     [Propagated("CIM_System.Name"),
 830                      Key, MaxLen (256), Description (
 831                       "The scoping System's Name.") ]
 832                  string SystemName;
 833                     [Key, MaxLen (256), Description (
 834                       "CreationClassName indicates the name of the class or "
 835                       "the subclass used in the creation of an instance. When "
 836                       "used with the other key properties of this class, this "
 837                       "property allows all instances of this class and its "
 838                       "subclasses to be uniquely identified.") ]
 839                  string CreationClassName;
 840                     [Key, MaxLen (64), Description (
 841 karl  1.1.2.1         "An address or other identifying information to uniquely "
 842                       "name the LogicalDevice.") ]
 843                  string DeviceID;
 844                     [Description (
 845                       "Boolean indicating that the Device can be power managed "
 846                       "- ie, put into a power save state. This boolean does not "
 847                       "indicate that power management features are currently "
 848                       "enabled, or if enabled, what features are supported. "
 849                       "Refer to the PowerManagementCapabilities array for this "
 850                       "information. If this boolean is false, the integer value "
 851                       "1, for the string, \"Not Supported\", should be the only "
 852                       "entry in the PowerManagementCapabilities array.") ]    
 853                  boolean PowerManagementSupported;
 854                     [Description(
 855                       "Indicates the specific power-related capabilities of a "
 856                       "LogicalDevice. The array values, 0=\"Unknown\", 1="
 857                       "\"Not Supported\" and 2=\"Disabled\" are self-explanatory. "
 858                       "The value, 3=\"Enabled\" indicates that the power management "
 859                       "features are currently enabled but the exact feature set "
 860                       "is unknown or the information is unavailable. "
 861                       "\"Power Saving Modes Entered Automatically\" (4) describes "
 862 karl  1.1.2.1         "that a Device can change its power state based on usage or "
 863                       "other criteria. \"Power State Settable\" (5) indicates that "
 864                       "the SetPowerState method is supported. \"Power Cycling "
 865                       "Supported\" (6) indicates that the SetPowerState method "
 866                       "can be invoked with the PowerState input variable set to 5 ("
 867                       "\"Power Cycle\"). \"Timed Power On Supported\" (7) indicates "
 868                       "that the SetPowerState method can be invoked with the Power"
 869                       "State input variable set to 5 (\"Power Cycle\") and the Time "
 870                       "parameter set to a specific date and time, or interval, "
 871                       "for power-on."),
 872                      Values {"Unknown", "Not Supported", "Disabled", 
 873                              "Enabled", "Power Saving Modes Entered Automatically",
 874                              "Power State Settable", "Power Cycling Supported",
 875                              "Timed Power On Supported"} ]
 876                  uint16 PowerManagementCapabilities[];
 877                     [Description (
 878                       "The primary availability and status of the Device. (Additional "
 879                       "status information can be specified using the AdditionalAvailability "
 880                       "array property.) For example, the Availability property indicates "
 881                       "that the Device is running and has full power (value=3), or is in "
 882                       "a warning (4), test (5), degraded (10) or power save state (values "
 883 karl  1.1.2.1         "13-15 and 17). Regarding the Power Save states, these are defined "
 884                       "as follows: Value 13 (\"Power Save - Unknown\") indicates "
 885                       "that the Device is known to be in a power save mode, but its "
 886                       "exact status in this mode is unknown; 14 (\"Power Save - Low "
 887                       "Power Mode\") indicates that the Device is in a power save "
 888                       "state but still functioning, and may exhibit degraded "
 889                       "performance; 15 (\"Power Save - Standby\") describes that "
 890                       "the Device is not functioning but could be brought to full "
 891                       "power 'quickly'; and value 17 (\"Power Save - Warning\") "
 892                       "indicates that the Device is in a warning state, though also "
 893                       "in a power save mode."), 
 894                      ValueMap {"1", "2", "3", "4", "5", "6", "7", "8", "9",
 895                               "10", "11", "12", "13", "14", "15", "16", "17", "18", "19",
 896                               "20", "21"},
 897                      Values {"Other", "Unknown", "Running/Full Power", "Warning", 
 898                              "In Test", "Not Applicable", "Power Off", "Off Line", 
 899                              "Off Duty", "Degraded", "Not Installed", "Install Error",
 900                              "Power Save - Unknown", "Power Save - Low Power Mode", 
 901                              "Power Save - Standby", "Power Cycle","Power Save - Warning", 
 902                              "Paused", "Not Ready", "Not Configured", "Quiesced"}, 
 903                      MappingStrings {"MIF.DMTF|Operational State|006",
 904 karl  1.1.2.1         "MIB.IETF|HOST-RESOURCES-MIB.hrDeviceStatus", 
 905                       "MIF.DMTF|Host Device|001.5"},
 906                      ModelCorrespondence {"CIM_LogicalDevice.AdditionalAvailability"}]
 907                  uint16 Availability;
 908                     [Description (
 909                       "The StatusInfo property indicates whether the Logical"
 910                       "Device is in an enabled (value = 3), disabled (value = "
 911                       "4) or some other (1) or unknown (2) state. If this "
 912                       "property does not apply to the LogicalDevice, the value, "
 913                       "5 (\"Not Applicable\"), should be used.  "
 914                       "If a Device is (\"Enabled\")(value=3), it has been "
 915                       "powered up, and is configured and operational.  The Device "
 916                       "may or may not be functionally active, depending on whether "
 917                       "its Availability (or AdditionalAvailability) indicate that "
 918                       "it is (\"Running/Full Power\")(value=3) or (\"Off line\")"
 919                       "(value=8). In an enabled but offline mode, a Device may be "
 920                       "performing out-of-band requests, such as running Diagnostics.  "
 921                       "If (\"Disabled\") StatusInfo value=4), a Device can only be " 
 922                       "\"enabled\" or powered off.  In a personal computer environment, "
 923                       "(\"Disabled\") means that the Device's driver is not "
 924                       "available in the stack. In other environments, a Device can "
 925 karl  1.1.2.1         "be disabled by removing its configuration file. A disabled "
 926                       "device is physically present in a System and consuming "
 927                       "resources, but can not be communicated with until a load "
 928                       "of a driver, a load of a configuration file or some other "
 929                       "\"enabling\" activity has occurred."),
 930                      ValueMap {"1", "2", "3", "4", "5"},
 931                      Values {"Other", "Unknown", "Enabled",
 932                              "Disabled", "Not Applicable"},
 933                      MappingStrings {"MIF.DMTF|Operational State|006"} ]
 934                  uint16 StatusInfo;
 935                     [Description (
 936                       "LastErrorCode captures the last error code reported by " 
 937                       "the LogicalDevice.")]
 938                  uint32 LastErrorCode;
 939                     [Description (
 940                       "ErrorDescription is a free-form string supplying more " 
 941                       "information about the error recorded in LastErrorCode, and " 
 942                       "information on any corrective actions that may be taken.")]
 943                  string ErrorDescription;
 944                     [Description (
 945                       "ErrorCleared is a boolean property indicating that the " 
 946 karl  1.1.2.1         "error reported in LastErrorCode is now cleared.")]
 947                  boolean ErrorCleared;
 948                     [MaxLen (256), ArrayType ("Indexed"), Description (
 949                       "OtherIdentifyingInfo captures additional data, beyond "
 950                       "DeviceID information, that could be used to identify a "
 951                       "LogicalDevice. One example would be to hold the Operating"
 952                       "System's user friendly name for the Device in this "
 953                       "property."),
 954                      ModelCorrespondence {
 955                       "CIM_LogicalDevice.IdentifyingDescriptions"} ]
 956                  string OtherIdentifyingInfo[];
 957                     [Description (
 958                       "The number of consecutive hours that this Device has been "
 959                       "powered, since its last power cycle."),
 960                      Units ("Hours"), Counter ]
 961                  uint64 PowerOnHours;
 962                     [Description (
 963                       "The total number of hours that this Device has been "
 964                       "powered."),
 965                      Units ("Hours"), Counter ]
 966                  uint64 TotalPowerOnHours;
 967 karl  1.1.2.1       [ArrayType ("Indexed"), Description (
 968                       "An array of free-form strings providing explanations "
 969                       "and details behind the entries in the OtherIdentifyingInfo "
 970                       "array. Note, each entry of this array is related to the "
 971                       "entry in OtherIdentifyingInfo that is located at the same "
 972                       "index."),
 973                      ModelCorrespondence {"CIM_LogicalDevice.OtherIdentifyingInfo"} ]
 974                  string IdentifyingDescriptions[];
 975                     [Description (
 976                       "Additional availability and status of the Device, beyond that "
 977                       "specified in the Availability property. The Availability property "
 978                       "denotes the primary status and availability of the Device. In "
 979                       "some cases, this will not be sufficient to denote the complete "
 980                       "status of the Device.  In those cases, the AdditionalAvailability "
 981                       "property can be used to provide further information. For example, "
 982                       "a Device's primary Availability may be \"Off line\" (value=8), "
 983                       "but it may also be in a low power state (AdditonalAvailability "
 984                       "value=14), or the Device could be running Diagnostics (Additional"
 985                       "Availability value=5, \"In Test\")."),
 986                      ValueMap {"1", "2", "3", "4", "5", "6", "7", "8", "9",
 987                                "10", "11", "12", "13", "14", "15", "16", "17", "18", "19", 
 988 karl  1.1.2.1                  "20", "21"},
 989                      Values {"Other", "Unknown", "Running/Full Power", "Warning", 
 990                              "In Test", "Not Applicable", "Power Off", "Off Line", 
 991                              "Off Duty", "Degraded", "Not Installed", "Install Error",
 992                              "Power Save - Unknown", "Power Save - Low Power Mode", 
 993                              "Power Save - Standby", "Power Cycle", 
 994                              "Power Save - Warning", "Paused", "Not Ready",
 995                              "Not Configured", "Quiesced"}, 
 996                      ModelCorrespondence {"CIM_LogicalDevice.Availability"}]
 997                  uint16 AdditionalAvailability[];
 998                     [Description (
 999                       "Maximum time in milliseconds, that a Device can run in "
1000                       "a \"Quiesced\" state. A Device's state is defined in its "
1001                       "Availability and AdditionalAvailability properties, where "
1002                       "\"Quiesced\" is conveyed by the value 21. What occurs at "
1003                       "the end of the time limit is device-specific. The Device "
1004                       "may unquiesce, may offline or take other action. A value of "
1005                       "0 indicates that a Device can remain quiesced indefinitely."), 
1006                      Units ("MilliSeconds")]
1007                  uint64 MaxQuiesceTime;
1008                     [Description(
1009 karl  1.1.2.1         "SetPowerState defines the desired power state for a "
1010                       "LogicalDevice and when a Device should be put into that "
1011                       "state. The desired power state is specified by setting "
1012                       "the PowerState parameter to one of the "
1013                       "following integer values: 1=\"Full Power\", 2=\"Power Save "
1014                       "- Low Power Mode\", 3=\"Power Save - Standby\", 4=\"Power "
1015                       "Save - Other\", 5=\"Power Cycle\" or 6=\"Power Off\". "
1016                       "The Time parameter (for all state changes but 5, "
1017                       "\"Power Cycle\") indicates when the power state should be "
1018                       "set, either as a regular date-time value or as an interval "
1019                       "value (where the interval begins when the method "
1020                       "invocation is received). When the PowerState parameter is "
1021                       "equal to 5, \"Power Cycle\", the Time parameter indicates "
1022                       "when the Device should power on again. Power off is "
1023                       "immediate. SetPowerState should return 0 if successful, 1 "
1024                       "if the specified PowerState and Time request is not "
1025                       "supported, and some other value if any other error "
1026                       "occurred. In a subclass, the set of possible return codes "
1027                       "could be specified, using a ValueMap qualifier on the method. "
1028                       "The strings to which the ValueMap contents are 'translated' "
1029                       "may also be specified in the subclass as a Values array "
1030 karl  1.1.2.1         "qualifier.") ]
1031                  uint32 SetPowerState(
1032                     [IN, ValueMap {"1", "2", "3", "4", "5", "6"},
1033                          Values {"Full Power", "Power Save - Low Power Mode", 
1034                                  "Power Save - Standby", "Power Save - Other", 
1035                                  "Power Cycle", "Power Off"}] 
1036                      uint16 PowerState, 
1037                     [IN] datetime Time);
1038                     [Description (
1039                       "Requests a reset of the LogicalDevice. The return value "
1040                       "should be 0 if the request was successfully executed, "
1041                       "1 if the request is not supported and some other value "
1042                       "if an error occurred. In a subclass, the set of possible "
1043                       "return codes could be specified, using a ValueMap qualifier "
1044                       "on the method. The strings to which the ValueMap contents "
1045                       "are 'translated' may also be specified in the subclass as a "
1046                       "Values array qualifier.") ]
1047                   uint32 Reset();
1048                     [Description (
1049                       "Requests that the LogicalDevice be enabled (\"Enabled\" "
1050                       "input parameter = TRUE) or disabled (= FALSE). If "
1051 karl  1.1.2.1         "successful, the Device's StatusInfo property should also "
1052                       "reflect the desired state (enabled/disabled). The return "
1053                       "code should be 0 if the request was successfully executed, "
1054                       "1 if the request is not supported and some other value if "
1055                       "an error occurred. In a subclass, the set of possible "
1056                       "return codes could be specified, using a ValueMap qualifier "
1057                       "on the method. The strings to which the ValueMap contents "
1058                       "are 'translated' may also be specified in the subclass as a "
1059                       "Values array qualifier.") ]
1060                   uint32 EnableDevice(
1061                     [IN] boolean Enabled);
1062                     [Description (
1063                       "Requests that the LogicalDevice be brought online (\"Online\" "
1064                       "input parameter = TRUE) or taken offline (= FALSE). "
1065                       "\"Online\" indicates that the Device is ready to accept "
1066                       "requests, and is operational and fully functioning. In this "
1067                       "case, the Device's Availability property would be set to "
1068                       "a value of 3 (\"Running/Full Power\"). \"Offline\" indicates "
1069                       "that a Device is powered up and operational, but not processing "
1070                       "functional requests. In an offline state, a Device may be capable "
1071                       "of running diagnostics or generating operational alerts. For "
1072 karl  1.1.2.1         "example, when the \"Offline\" button is pushed on a Printer, the "
1073                       "Device is no longer available to process print jobs, but "
1074                       "could be available for diagnostics or maintenance.\n"
1075                       "If this method is successful, the Device's Availability and "
1076                       "AdditionalAvailability properties should reflect the updated "
1077                       "status. If a failure occurs trying to bring the Device online "
1078                       "or offline, it should remain in its current state. IE, the "
1079                       "request, if unsuccessful, should not leave the Device in an "
1080                       "indeterminate state. When bringing a Device back \"Online\", "
1081                       "from an \"Offline\" mode, the Device should be restored to its "
1082                       "last \"Online\" state, if at all possible. Only a Device that "
1083                       "has a StatusInfo of \"Enabled\" (value=3) and has been "
1084                       "configured can be brought online or taken offline.\n"
1085                       "OnlineDevice should return 0 if successful, 1 if the request is not "
1086                       "supported at all, 2 if the request is not supported due to the "
1087                       "current state of the Device, and some other value if any other "
1088                       "error occurred. In a subclass, the set of possible return codes "
1089                       "could be specified, using a ValueMap qualifier on the method. "
1090                       "The strings to which the ValueMap contents are 'translated' may "
1091                       "also be specified in the subclass as a Values array qualifier.") ]
1092                  uint32 OnlineDevice(
1093 karl  1.1.2.1       [IN] boolean Online);
1094                     [Description (
1095                       "Requests that the LogicalDevice cleanly cease all current "
1096                       "activity (\"Quiesce\" input parameter = TRUE) or resume "
1097                       "activity (= FALSE). For this method to quiesce a Device, "
1098                       "that Device should have an Availability (or Additional"
1099                       "Availability) of \"Running/Full Power\" (value=3) and a "
1100                       "StatusInfo of \"Enabled\" (value=3). For example, if quiesced, "
1101                       "a Device may then be offlined for diagnostics, or disabled "
1102                       "for power off and hot swap.  For the method to \"unquiesce\" "
1103                       "a Device, that Device should have an Availability (or Additional"
1104                       "Availability) of \"Quiesced\" (value=21) and a StatusInfo of "
1105                       "\"Enabled\" (value=3). In this case, the Device would "
1106                       "be returned to an \"Enabled\" and \"Running/Full Power\" "
1107                       "status.\n"
1108                       "The method's return code should indicate the success or "
1109                       "failure of the quiesce. It should return 0 if successful, "
1110                       "1 if the request is not supported at all, 2 if the request "
1111                       "is not supported due to the current state of the Device, "
1112                       "and some other value if any other error occurred. In a subclass, "
1113                       "the set of possible return codes could be specified, using a "
1114 karl  1.1.2.1         "ValueMap qualifier on the method.  The strings to which the "
1115                       "ValueMap contents are 'translated' may also be specified in "
1116                       "the subclass as a Values array qualifier.") ]
1117                  uint32 QuiesceDevice(
1118                     [IN] boolean Quiesce);
1119                     [Description (
1120                       "Requests that the Device capture its current configuration, "
1121                       "setup and/or state information in a backing store. The goal "
1122                       "would be to use this information at a later time (via the "
1123                       "RestoreProperties method), to return a Device to its present "
1124                       "\"condition\". This method may not be supported by all Devices.  "
1125                       "The method should return 0 if successful, 1 if the request is "
1126                       "not supported, and some other value if any other error occurred. "
1127                       "In a subclass, the set of possible return codes could be "
1128                       "specified, using a ValueMap qualifier on the method. The strings "
1129                       "to which the ValueMap contents are 'translated' may also be "
1130                       "specified in the subclass as a Values array qualifier.") ]
1131                  uint32 SaveProperties();
1132                     [Description (
1133                       "Requests that the Device re-establish its configuration, "
1134                       "setup and/or state information from a backing store. The "
1135 karl  1.1.2.1         "intent is to capture this information at an earlier time "
1136                       "(via the SaveProperties method), and use it to return a "
1137                       "Device to this earlier \"condition\". This method may not "
1138                       "be supported by all Devices. The method should return 0 if "
1139                       "successful, 1 if the request is not supported, and some "
1140                       "other value if any other error occurred. In a subclass, "
1141                       "the set of possible return codes could be specified, using "
1142                       "a ValueMap qualifier on the method. The strings to which "
1143                       "the ValueMap contents are 'translated' may also be specified "
1144                       "in the subclass as a Values array qualifier.") ]
1145                  uint32 RestoreProperties();        
1146               };  
1147               
1148                  
1149               // ==================================================================
1150               //    Service
1151               // ==================================================================  
1152                  [Abstract, Description (
1153                    "A CIM_Service is a Logical Element that contains the "
1154                    "information necessary to represent and manage the "
1155                    "functionality provided by a Device and/or SoftwareFeature. "
1156 karl  1.1.2.1      "A Service is a general-purpose object to configure and "
1157                    "manage the implementation of functionality.  It is not the "
1158                    "functionality itself.") ] 
1159               class CIM_Service : CIM_LogicalElement {
1160                     [Propagated ("CIM_System.CreationClassName"), Key, 
1161                      MaxLen (256), Description (
1162                       "The scoping System's CreationClassName. ") ] 
1163                  string SystemCreationClassName;
1164                     [Propagated ("CIM_System.Name"), Key, MaxLen (256),
1165                      Description ("The scoping System's Name.") ] 
1166                  string SystemName;
1167                     [Key, MaxLen (256), Description (
1168                       "CreationClassName indicates the name of the class or the "
1169                       "subclass used in the creation of an instance. When used "
1170                       "with the other key properties of this class, this property "
1171                       "allows all instances of this class and its subclasses to "
1172                       "be uniquely identified.") ]
1173                  string CreationClassName;
1174                     [Override ("Name"), Key, MaxLen (256), Description (
1175                       "The Name property uniquely identifies the Service and "
1176                       "provides an indication of the functionality that is "
1177 karl  1.1.2.1         "managed. This functionality is described in more detail in "
1178                       "the object's Description property. ") ] 
1179                  string Name;
1180                     [MaxLen (10), Description (
1181                       "StartMode is a string value indicating whether the Service "
1182                       "is automatically started by a System, Operating System, etc. "
1183                       "or only started upon request."), 
1184                      ValueMap {"Automatic", "Manual"} ] 
1185                  string StartMode;
1186                     [Description (
1187                       "Started is a boolean indicating whether the Service "
1188                       "has been started (TRUE), or stopped (FALSE).") ] 
1189                  boolean Started;
1190                     [Description (
1191                       "The StartService method places the Service in the started "
1192                       "state. It returns an integer value of 0 if the Service was "
1193                       "successfully started, 1 if the request is not supported and "
1194                       "any other number to indicate an error. In a subclass, the "
1195                       "set of possible return codes could be specified, using a "
1196                       "ValueMap qualifier on the method. The strings to which the "
1197                       "ValueMap contents are 'translated' may also be specified in "
1198 karl  1.1.2.1         "the subclass as a Values array qualifier.") ] 
1199                  uint32 StartService();
1200                     [Description (
1201                       "The StopService method places the Service in the stopped "
1202                       "state. It returns an integer value of 0 if the Service was "
1203                       "successfully stopped, 1 if the request is not supported and "
1204                       "any other number to indicate an error. In a subclass, the "
1205                       "set of possible return codes could be specified, using a "
1206                       "ValueMap qualifier on the method. The strings to which the "
1207                       "ValueMap contents are 'translated' may also be specified in "
1208                       "the subclass as a Values array qualifier.") ] 
1209                  uint32 StopService();
1210               };
1211               
1212                    
1213               // ==================================================================
1214               //    ServiceAccessPoint
1215               // ==================================================================
1216                  [Abstract, Description (
1217                    "CIM_ServiceAccessPoint represents the ability to utilize or "
1218                    "invoke a Service.  Access points represent that a Service is "
1219 karl  1.1.2.1      "made available to other entities for use.") ] 
1220               class CIM_ServiceAccessPoint : CIM_LogicalElement {
1221                     [Propagated ("CIM_System.CreationClassName"), Key, 
1222                      MaxLen (256), Description (
1223                       "The scoping System's CreationClassName.") ] 
1224                  string SystemCreationClassName;
1225                     [Propagated ("CIM_System.Name"), Key, MaxLen (256),
1226                      Description ("The scoping System's Name.") ] 
1227                  string SystemName;
1228                     [Key, MaxLen (256), Description (
1229                       "CreationClassName indicates the name of the class or the "
1230                       "subclass used in the creation of an instance. When used "
1231                       "with the other key properties of this class, this property "
1232                       "allows all instances of this class and its subclasses to "
1233                       "be uniquely identified.") ]
1234                  string CreationClassName;
1235                     [Override ("Name"), Key, MaxLen (256), Description (
1236                       "The Name property uniquely identifies the ServiceAccessPoint "
1237                       "and provides an indication of the functionality that is "
1238                       "managed.  This functionality is described in more detail in "
1239                       "the object's Description property.") ] 
1240 karl  1.1.2.1    string Name;
1241               };
1242               
1243                    
1244               // ==================================================================
1245               // Dependency   
1246               // ==================================================================
1247                  [Association, Abstract, Description (   
1248                    "CIM_Dependency is a generic association used to establish "   
1249                    "dependency relationships between ManagedElements.") ]    
1250               class CIM_Dependency {   
1251                     [Key, Description (   
1252                       "Antecedent represents the independent object in this "   
1253                       "association.") ]    
1254                  CIM_ManagedElement REF Antecedent;   
1255                     [Key, Description (   
1256                       "Dependent represents the object dependent on the "   
1257                       "Antecedent.") ]    
1258                  CIM_ManagedElement REF Dependent;   
1259               };   
1260                
1261 karl  1.1.2.1                  
1262               // ==================================================================
1263               // MemberOfCollection    
1264               // ==================================================================
1265                  [Association, Aggregation, Description (   
1266                    "CIM_MemberOfCollection is an aggregation used to establish "   
1267                    "membership of ManagedElements in a Collection." ) ]  
1268               class CIM_MemberOfCollection {   
1269                     [Key, Aggregate, Description (
1270                       "The Collection that aggregates members") ]    
1271                  CIM_Collection REF Collection;
1272                     [Key, Description (
1273                       "The aggregated member of the collection.") ]    
1274                  CIM_ManagedElement REF Member;   
1275               };   
1276               
1277               
1278               // ==================================================================
1279               //    CollectedMSEs
1280               // ==================================================================
1281                  [Association, Aggregation, Description (
1282 karl  1.1.2.1      "CIM_CollectedMSEs is a generic association used to "
1283                    "establish the members of the grouping object, CollectionOf"
1284                    "MSEs.") ]
1285               class CIM_CollectedMSEs : CIM_MemberOfCollection {
1286                     [Aggregate, Description (
1287                       "The grouping or 'bag' object that represents the "
1288                       "Collection."), Override("Collection") ]
1289                  CIM_CollectionOfMSEs REF Collection;
1290                     [Description ("The members of the Collection."),
1291                      Override("Member") ]
1292                  CIM_ManagedSystemElement REF Member;
1293               };
1294               
1295               
1296               // ==================================================================
1297               //    ServiceAccessBySAP
1298               // ==================================================================
1299                  [Association, Description (
1300                    "CIM_ServiceAccessBySAP is an association that identifies the "
1301                    "access points for a Service. For example, a printer may be "
1302                    "accessed by Netware, MacIntosh or Windows ServiceAccess"
1303 karl  1.1.2.1      "Points, potentially hosted on different Systems.") ] 
1304               class CIM_ServiceAccessBySAP : CIM_Dependency {
1305                     [Override ("Antecedent"),
1306                      Description ("The Service. ") ] 
1307                  CIM_Service REF Antecedent;
1308                     [Override ("Dependent"), Description (
1309                       "An Access Point for a Service. Access points are dependent " 
1310                       "in this relationship since they have no function without a "
1311                       "corresponding Service. ") ] 
1312                  CIM_ServiceAccessPoint REF Dependent;
1313               };
1314               
1315                    
1316               // ==================================================================
1317               //    HostedService
1318               // ==================================================================
1319                  [Association, Description (
1320                    "CIM_HostedService is an association between a Service and "
1321                    "the System on which the functionality resides.  The "
1322                    "cardinality of this association is 1-to-many.  A System may "
1323                    "host many Services. Services are weak with respect to their "
1324 karl  1.1.2.1      "hosting System. Heuristic:  A Service is hosted on the "
1325                    "System where the LogicalDevices or SoftwareFeatures that "
1326                    "implement the Service are located.  The model does not "
1327                    "represent Services hosted across multiple systems.  This is "
1328                    "modeled as an ApplicationSystem that acts as an aggregation "
1329                    "point for Services, that are each located on a single "
1330                    "host.") ] 
1331               class CIM_HostedService : CIM_Dependency {
1332                     [Override ("Antecedent"), Max (1), Min (1),
1333                      Description ("The hosting System.") ] 
1334                  CIM_System REF Antecedent;
1335                     [Override ("Dependent"), Weak,
1336                      Description ("The Service hosted on the System.") ] 
1337                  CIM_Service REF Dependent;
1338               };
1339               
1340                    
1341               // ==================================================================
1342               //    HostedAccessPoint
1343               // ==================================================================
1344                  [Association, Description (
1345 karl  1.1.2.1      "CIM_HostedAccessPoint is an association between a Service"
1346                    "AccessPoint and the System on which it is provided.  The "
1347                    "cardinality of this association is 1-to-many and is weak "
1348                    "with respect to the System. Each System may host many "
1349                    "ServiceAccessPoints.  Heuristic:  If the implementation of "
1350                    "the ServiceAccessPoint is modeled, it must be "
1351                    "implemented by a Device or SoftwareFeature that is part of "
1352                    "the System hosting the ServiceAccessPoint.") ] 
1353               class CIM_HostedAccessPoint:CIM_Dependency {
1354                     [Override ("Antecedent"), Max (1), Min (1), 
1355                      Description ("The hosting System.") ] 
1356                  CIM_System REF Antecedent;
1357                     [Override ("Dependent"), Weak,
1358                      Description ("The SAP(s) that are hosted on this System.") ] 
1359                  CIM_ServiceAccessPoint REF Dependent;
1360               };
1361                  
1362               
1363               // ==================================================================
1364               //    ProvidesServiceToElement
1365               // ==================================================================
1366 karl  1.1.2.1    [Association, Description (
1367                    "CIM_ProvidesServiceToElement is used to describe that "
1368                    "ManagedElements may be dependent on the functionality "
1369                    "of one or more Services. An example is that a Processor "
1370                    "and an Enclosure (PhysicalElement) are dependent on AlertOn"
1371                    "LAN Services to signal an incomplete or erroneous boot, and "
1372                    "hardware-related errors.") ]
1373               class CIM_ProvidesServiceToElement : CIM_Dependency {
1374                     [Override ("Antecedent"), Description (
1375                       "The Service provided.") ]
1376                  CIM_Service ref Antecedent;
1377                     [Override ("Dependent"), Description (
1378                       "The ManagedElement dependent on the Service.") ]
1379                  CIM_ManagedElement ref Dependent;
1380               };
1381               
1382               
1383               // ==================================================================
1384               //    ServiceServiceDependency
1385               // ==================================================================
1386                  [Association, Description (
1387 karl  1.1.2.1      "CIM_ServiceServiceDependency is an association between a " 
1388                    "Service and another Service, indicating that the latter is "
1389                    "required to be present, required to have completed, or must " 
1390                    "be absent for the former Service to provide its "
1391                    "functionality. For example, Boot Services may be dependent "
1392                    "upon underlying BIOS Disk and initialization Services. "
1393                    "In the case of the initialization Services, the Boot Service "
1394                    "is simply dependent on the init Services completing.  For "
1395                    "the Disk Services, Boot Services may actually utilize the "
1396                     "SAPs of this Service.  This usage dependency is modeled via "
1397                    "the CIM_ServiceSAPDependency association.") ] 
1398               class CIM_ServiceServiceDependency : CIM_ProvidesServiceToElement {
1399                     [Override ("Antecedent"), 
1400                      Description ("The required Service.") ] 
1401                  CIM_Service REF Antecedent;
1402                     [Override ("Dependent"), Description (
1403                       "The Service that is dependent on an underlying Service.") ] 
1404                  CIM_Service REF Dependent;
1405                     [Description (
1406                       "The nature of the Service to Service dependency. This "
1407                       "property describes that the associated Service must have "
1408 karl  1.1.2.1         "completed (value=2), must be started (3) or must not be "
1409                       "started (4) in order for the Service to function."),  
1410                      Values {"Unknown", "Other", "Service Must Have Completed",
1411                              "Service Must Be Started", 
1412                              "Service Must Not Be Started"} ]
1413                  uint16 TypeOfDependency;
1414                     [Description(
1415                       "this property describes that the antecedent service "
1416                       "must be restarted after the dependent operation is complete.")]
1417                  boolean RestartService;
1418               };
1419               
1420               
1421               // ==================================================================
1422               //    ServiceSAPDependency
1423               // ==================================================================
1424                  [Association, Description (
1425                    "CIM_ServiceSAPDependency is an association between a Service "
1426                    "and a ServiceAccessPoint indicating that the referenced SAP "
1427                    "is utilized by the Service to provide its functionality. For "
1428                    "example, Boot Services may invoke BIOS' Disk Services "
1429 karl  1.1.2.1      "(interrupts) in order to function.") ] 
1430               class CIM_ServiceSAPDependency : CIM_Dependency {
1431                     [Override ("Antecedent"), 
1432                      Description ("The required ServiceAccessPoint") ] 
1433                  CIM_ServiceAccessPoint REF Antecedent;
1434                     [Override ("Dependent"), Description (
1435                       "The Service that is dependent on an underlying SAP.") ] 
1436                  CIM_Service REF Dependent;
1437               };
1438               
1439                    
1440               // ==================================================================
1441               //    SAPSAPDependency
1442               // ==================================================================
1443                  [Association, Description (
1444                    "CIM_SAPSAPDependency is an association between a Service"
1445                    "AccessPoint and another ServiceAccessPoint indicating that "
1446                    "the latter is required in order for the former ServiceAccess"
1447                    "Point to utilize or connect with its Service. For example, "
1448                    "to print at a network printer, local Print Access Points "
1449                    "must utilize underlying network-related SAPs, or "
1450 karl  1.1.2.1      "ProtocolEndpoints, in order to send the print request.") ] 
1451               class CIM_SAPSAPDependency:CIM_Dependency {
1452                     [Override ("Antecedent"), Description (
1453                       "The required ServiceAccessPoint.") ] 
1454                  CIM_ServiceAccessPoint REF Antecedent;
1455                     [Override ("Dependent"), Description (
1456                       "The ServiceAccessPoint that is dependent on an underlying "
1457                       "SAP.") ] 
1458                  CIM_ServiceAccessPoint REF Dependent;
1459               };
1460               
1461               
1462               // ==================================================================
1463               //    Realizes
1464               // ==================================================================
1465                  [Association, Description (
1466                    "CIM_Realizes is the association that defines the mapping "
1467                    "between a Logical Device and the physical component that "
1468                    "implements the Device.") ] 
1469               class CIM_Realizes : CIM_Dependency {
1470                     [Override ("Antecedent"), Description (
1471 karl  1.1.2.1         "The physical component that implements the Device.") ]
1472                  CIM_PhysicalElement REF Antecedent;
1473                     [Override ("Dependent"), Description (
1474                       "The LogicalDevice.") ]
1475                  CIM_LogicalDevice REF Dependent;
1476               };
1477               
1478                    
1479               // ==================================================================
1480               //    Component
1481               // ==================================================================
1482                  [Association, Abstract, Aggregation, Description (
1483                    "CIM_Component is a generic association used to establish "
1484                    "'part of' relationships between Managed System Elements. For "
1485                    "example, the SystemComponent association defines parts of "
1486                    "a System.") ] 
1487               class CIM_Component {
1488                     [Aggregate, Key, Description (
1489                       "The parent element in the association.") ] 
1490                  CIM_ManagedSystemElement REF GroupComponent;
1491                     [Key, Description (
1492 karl  1.1.2.1         "The child element in the association.") ] 
1493                  CIM_ManagedSystemElement REF PartComponent;
1494               };
1495               
1496                    
1497               // ==================================================================
1498               //    SystemComponent
1499               // ==================================================================
1500                  [Association, Aggregation, Description (
1501                    "CIM_SystemComponent is a specialization of the CIM_Component "
1502                    "association that establishes 'part of' relationships between "
1503                    "a System and the Managed System Elements of which it is "
1504                    "composed.") ] 
1505               class CIM_SystemComponent : CIM_Component {
1506                     [Override ("GroupComponent"), Aggregate, 
1507                      Description ("The parent System in the Association.") ] 
1508                  CIM_System REF GroupComponent;
1509                     [Override ("PartComponent"), Description (
1510                       "The child element that is a component of a System.") ] 
1511                  CIM_ManagedSystemElement REF PartComponent;
1512               }; 
1513 karl  1.1.2.1      
1514               // ==================================================================
1515               //    SystemDevice
1516               // ==================================================================
1517                  [Association, Aggregation, Description (
1518                    "LogicalDevices may be aggregated by a System.  This " 
1519                    "relationship is made explicit by the SystemDevice "
1520                    "association. ") ]
1521               class CIM_SystemDevice:CIM_SystemComponent {
1522                     [Override ("GroupComponent"), Aggregate, Max (1), Min (1), 
1523                      Description ("The parent system in the Association.") ] 
1524                  CIM_System REF GroupComponent;
1525                     [Override ("PartComponent"), Weak, Description (
1526                       "The LogicalDevice that is a component of a System.") ] 
1527                  CIM_LogicalDevice REF PartComponent;
1528               };
1529               
1530               
1531               // ==================================================================
1532               //    ServiceComponent
1533               // ==================================================================
1534 karl  1.1.2.1    [Association, Aggregation, Description (
1535                    "The ServiceComponent aggregation models a set of "
1536                    "subordinate Services that are aggregated together to form "
1537                    "a higher-level service.") ]
1538               class CIM_ServiceComponent : CIM_Component {
1539                     [Override ("GroupComponent"), Aggregate, 
1540                      Description ("The parent Service.") ]
1541                  CIM_Service REF GroupComponent;
1542                     [Override ("PartComponent"), 
1543                      Description ("The component Service.") ]
1544                  CIM_Service REF PartComponent;
1545               };
1546               
1547                    
1548               // ==================================================================
1549               //    Synchrononized
1550               // ==================================================================
1551                  [Association, Description (
1552                    "Indicates that two LogicalElements were aligned or made to "
1553                    "be equivalent at the specified point in time. If the boolean "
1554                    "property SyncMaintained is TRUE, then synchronization "
1555 karl  1.1.2.1      "of the Elements is preserved. Both like and unlike objects "
1556                    "may be synchronized. For example, two WatchDog timers may be "
1557                    "aligned, or the contents of a LogicalFile may be synchronized "
1558                    "with the contents of a StorageExtent.") ]
1559               class CIM_Synchronized {
1560                     [Key, Description (
1561                       "SystemElement represents one LogicalElement that is "
1562                       "synchronized with the entity referenced as SyncedElement.") ]
1563                  CIM_LogicalElement ref SystemElement;
1564                     [Key, Description (
1565                       "SyncedElement represents another LogicalElement that is "
1566                       "synchronized with the entity referenced as SystemElement.") ]
1567                  CIM_LogicalElement ref SyncedElement;
1568                     [Description (
1569                       "The point in time that the Elements were synchronized.") ]
1570                  datetime WhenSynced;
1571                     [Description (
1572                       "Boolean indicating whether synchronization is "
1573                       "maintained.") ]
1574                  boolean SyncMaintained;
1575               };
1576 karl  1.1.2.1 
1577               
1578               // ==================================================================
1579               //     AdminDomain
1580               // ==================================================================
1581                  [Description (
1582                    "This is a special grouping of ManagedSystemElements. The "
1583                    "grouping is viewed as a single entity, reflecting that all "
1584                    "of its components are administered similarly - either by "
1585                    "the same user, group of users or policy. It serves as "
1586                    "an aggregation point to associate one or more of the "
1587                    "following elements: network devices, such as routers and "
1588                    "switches, servers, and other resources that can be "
1589                    "accessed by end systems. This grouping of devices "
1590                    "plays an essential role in ensuring that the same "
1591                    "administrative policy and actions are applied to all "
1592                    "of the devices in the grouping. The specific behavior "
1593                    "and/or semantics of the AdminDomain can be identified "
1594                    "through its aggregated and associated entities."
1595                    "\n\n"
1596                    "The System class and its subclasses provide the scope for "
1597 karl  1.1.2.1      "numerous types of managed objects. As such, these classes "
1598                    "must have the ability to create unique keys. This attribute "
1599                    "is used by the System class and its subclasses to define a "
1600                    "unique Name, independent of the specific discovery protocol "
1601                    "used. Use of the heuristic is optional, but recommended."
1602                    "\n\n"
1603                    "AdminDomain is a part of the Core model, which has frequently "
1604                    "been used in the Networks Model to group "
1605                    "together various network resources that must be "
1606                    "administered the same way, perhaps using the same "
1607                    "policies. Viewed in this light, its principal subclass is "
1608                    "AutonomousSystem.") ]
1609               class CIM_AdminDomain : CIM_System {
1610                     [Override ("NameFormat"), Description (
1611                       "The NameFormat property identifies how the Name of the "
1612                       "AdminDomain is generated, using the heuristic specified "
1613                       "in the CIM V2 System Model spec. It assumes that the "
1614                       "documented rules are traversed in order, to determine and "
1615                       "assign a Name. The NameFormat Values list defines the "
1616                       "precedence order for assigning the Name of the "
1617                       "AdminDomain."), 
1618 karl  1.1.2.1        ValueMap {"Other", "AS", "NAP", "NOC", "POP", "RNP", "IP",
1619                           "IPX", "SNA", "Dial", "WAN", "LAN", "ISDN", "Frame Relay",
1620                           "ATM", "E.164", "IB", "FC", "Policy Repository" },
1621                      Values {"Other", "Autonomous System",
1622                              "Network Access Provider", "Network Operations Center",
1623                              "Point of Presence", "Regional Network Provider",
1624                              "IP", "IPX", "SNA", "Dial", "WAN", "LAN", "ISDN",
1625                              "Frame Relay", "ATM", "E.164", "Infiniband", 
1626                              "Fibre Channel", "Policy Repository"} ]
1627                  string NameFormat;
1628               };
1629               
1630               
1631               // ==================================================================
1632               //
1633               //  2 - Products, FRUs, and Statistics
1634               //
1635               // ==================================================================
1636               
1637               
1638               // ==================================================================
1639 karl  1.1.2.1 //    Product
1640               // ==================================================================
1641                  [Description (
1642                    "CIM_Product is a concrete class that is a collection of "
1643                    "PhysicalElements, SoftwareFeatures and/or other Products, "
1644                    "acquired as a unit. Acquisition implies an agreement "
1645                    "between supplier and consumer which may have implications "
1646                    "to Product licensing, support and warranty. Non-commercial "
1647                    "(e.g., in-house developed Products) should also be "
1648                    "identified as an instance of CIM_Product.") ] 
1649               class CIM_Product : CIM_ManagedElement {
1650                     [Key, MaxLen (256),
1651                      Description ("Commonly used Product name."), 
1652                      MappingStrings {"MIF.DMTF|ComponentID|001.2"} ] 
1653                  string Name;
1654                     [Key, MaxLen (64), Description (
1655                       "Product identification such as a serial number on software, "
1656                       "a die number on a hardware chip, or (for non-commercial "
1657                       "Products) a project number."), 
1658                      MappingStrings {"MIF.DMTF|ComponentID|001.4"} ] 
1659                  string IdentifyingNumber;
1660 karl  1.1.2.1       [Key, MaxLen (256), Description (
1661                       "The name of the Product's supplier, or entity selling the "
1662                       "Product (the manufacturer, reseller, OEM, etc.). Corresponds "
1663                       "to the Vendor property in the Product object in the DMTF "
1664                       "Solution Exchange Standard."), 
1665                      MappingStrings {"MIF.DMTF|ComponentID|001.1"} ] 
1666                  string Vendor;
1667                     [Key, MaxLen (64), Description (
1668                       "Product version information.  Corresponds to the Version "
1669                       "property in the Product object in the DMTF Solution "
1670                       "Exchange Standard."), 
1671                      MappingStrings {"MIF.DMTF|ComponentID|001.3"} ] 
1672                  string Version;
1673                     [MaxLen (64), Description (
1674                       "Product SKU (stock keeping unit) information.") ] 
1675                  string SKUNumber;
1676                     [Description (
1677                       "If this Product is under warranty, the start date of the "
1678                       "warranty."),
1679                      ModelCorrespondence {"CIM_Product.WarrantyDuration"},
1680                      MappingStrings {"MIF.DMTF|FRU|002.9"} ]
1681 karl  1.1.2.1    datetime WarrantyStartDate;
1682                     [Description (
1683                       "If this Product is under warranty, the duration of the "
1684                       "warranty in days."), Units ("Days"), 
1685                      ModelCorrespondence {"CIM_Product.WarrantyStartDate"},
1686                      MappingStrings {"MIF.DMTF|FRU|002.10"}]
1687                  uint32 WarrantyDuration;
1688               };
1689               
1690                    
1691               // ==================================================================
1692               //    ProductParentChild
1693               // ==================================================================
1694                  [Association, Aggregation, Description (
1695                    "The CIM_ProductParentChild association defines a parent "
1696                    "child hierarchy among Products.  For example, a Product may "
1697                    "come bundled with other Products. ") ] 
1698               class CIM_ProductParentChild {
1699                     [Aggregate, Key, Description (
1700                       "The parent Product in the association.") ] 
1701                  CIM_Product REF Parent;
1702 karl  1.1.2.1       [Key, Description (
1703                       "The child Product in the association.") ] 
1704                  CIM_Product REF Child;
1705               };
1706               
1707               
1708               // ==================================================================
1709               //    CompatibleProduct
1710               // ================================================================== 
1711                  [Association, Description ( 
1712                    "CIM_CompatibleProduct is an association between Products " 
1713                    "that can indicate a wide variety of information. For " 
1714                    "example, it can indicate that the two referenced Products " 
1715                    "interoperate, that they can be installed together, that " 
1716                    "one can be the physical container for the other, etc. The " 
1717                    "string property, CompatibilityDescription, defines how the " 
1718                    "Products interoperate or are compatible, any limitations " 
1719                    "regarding interoperability or installation, ...") ]
1720               class CIM_CompatibleProduct {
1721                     [Key, Description ( 
1722                       "The Product for which compatible offerings are defined.") ] 
1723 karl  1.1.2.1    CIM_Product REF Product; 
1724                     [Key, Description (
1725                       "The compatible Product.") ]
1726                  CIM_Product REF CompatibleProduct; 
1727                     [Description ( 
1728                       "CompatibilityDescription is a free-form string defining " 
1729                       "how the two referenced Products interoperate or are " 
1730                       "compatible, any limitations to compatibility, etc.") ]
1731                  string CompatibilityDescription;
1732               };
1733               
1734               
1735               // ==================================================================
1736               //    ProductProductDependency
1737               // ================================================================== 
1738                  [Association, Description ( 
1739                    "CIM_ProductProductDependency is an association between two " 
1740                    "Products, indicating that one must be installed, or must be " 
1741                    "absent, for the other to function. This is conceptually " 
1742                    "equivalent to the ServiceServiceDependency association.") ] 
1743               class CIM_ProductProductDependency { 
1744 karl  1.1.2.1       [Key, Description ("The required Product.") ] 
1745                  CIM_Product REF RequiredProduct; 
1746                     [Key, Description ( 
1747                       "The Product that is dependent on another Product.") ] 
1748                  CIM_Product REF DependentProduct; 
1749                     [Description ( 
1750                       "The nature of the Product dependency. This property " 
1751                       "describes that the associated Product must be installed "
1752                       "(value=2) or must be absent (value=3) in order for the "
1753                       "Product to function."),  
1754                      Values {"Unknown", "Other", "Product Must Be Installed", 
1755                              "Product Must Not Be Installed"} ]
1756                  uint16 TypeOfDependency; 
1757               };
1758               
1759                    
1760               // ==================================================================
1761               //    SupportAccess
1762               // ==================================================================
1763                  [Description (
1764                    "The CIM_SupportAccess association defines how to obtain "
1765 karl  1.1.2.1      "assistance for a Product.") ] 
1766               class CIM_SupportAccess : CIM_ManagedElement {
1767                     [Override ("Description"), Description (
1768                       "A textual description of the type of Support provided."),
1769                      MappingStrings {"MIF.DMTF|Support|001.3"} ] 
1770                  string Description;
1771                     [Key, MaxLen (256), Description (
1772                       "SupportAccessID is an arbitrary, free form string defined by "
1773                       "the Product Vendor or by the organization that deploys the "
1774                       "Product.  This property, since it is a key, should be unique "
1775                       "throughout the enterprise.") ] 
1776                  string SupportAccessId;
1777                     [Description (
1778                       "CommunicationInfo provides the details of the Communication"
1779                       "Mode. For example, if the CommunicationMode is 'Phone', "
1780                       "CommunicationInfo specifies the phone number to be called."), 
1781                      MappingStrings {"MIF.DMTF|FRU|002.11", "MIF.DMTF|FRU|002.12"} ] 
1782                  string CommunicationInfo;
1783                     [Description (
1784                       "CommunicationMode defines the form of communication in order "
1785                       "to obtain support. For example, phone communication (value"
1786 karl  1.1.2.1         "=2), fax (3) or email (8) can be specified."), 
1787                      ValueMap {"1", "2", "3", "4", "5", "6", "7", "8"}, 
1788                      Values {"Other", "Phone", "Fax", "BBS", 
1789                              "Online Service", "Web Page", "FTP", "E-mail"}, 
1790                      MappingStrings {"MIF.DMTF|Support|001.5"} ] 
1791                  uint16 CommunicationMode;
1792                     [MaxLen (64), Description (
1793                       "Locale defines the geographic region and/or language dialect "
1794                       "to which this Support resource pertains."), 
1795                      MappingStrings {"MIF.DMTF|Support|001.2"} ] 
1796                  string Locale;
1797               };
1798               
1799                    
1800               // ==================================================================
1801               //    ProductSupport
1802               // ==================================================================
1803                  [Association, Description (
1804                    "CIM_ProductSupport is an association between Product and "
1805                    "SupportAccess that conveys how support is obtained for the "
1806                    "Product.  This is a many-to-many relationship, implying that "
1807 karl  1.1.2.1      "various types of Support are available for a Product, and "
1808                    "that the same Support object can provide assistance for "
1809                    "multiple Products.") ] 
1810               class CIM_ProductSupport {
1811                     [Key, Description ("The Product.") ]     
1812                  CIM_Product REF Product;
1813                     [Key, Description ("Support for the Product.") ]
1814                  CIM_SupportAccess REF Support;
1815               };
1816               
1817                    
1818               // ==================================================================
1819               //    FRU
1820               // ==================================================================
1821                  [Description (
1822                    "The CIM_FRU class is a vendor-defined collection of Products "
1823                    "and/or PhysicalElements that is associated with a "
1824                    "Product for the purpose of supporting, maintaining or "
1825                    "upgrading that Product at the customer's location. FRU is "
1826                    "an acronym for 'field replaceable unit'. ") ] 
1827               class CIM_FRU : CIM_ManagedElement {
1828 karl  1.1.2.1       [Override ("Description"), Description (
1829                       "A textual description of the FRU."), 
1830                      MappingStrings {"MIF.DMTF|FRU|002.3"} ] 
1831                  string Description;
1832                     [Key, MaxLen (64), Description (
1833                       "FRU ordering information."), 
1834                      MappingStrings {"MIF.DMTF|FRU|002.6"} ] 
1835                  string FRUNumber;
1836                     [Key, MaxLen (64), Description (
1837                       "FRU identification such as a serial number on software or "
1838                       "a die number on a hardware chip."), 
1839                      MappingStrings {"MIF.DMTF|FRU|002.7"} ] 
1840                  string IdentifyingNumber;
1841                     [Key, MaxLen (256),
1842                      Description ("The name of the FRU's supplier."), 
1843                      MappingStrings {"MIF.DMTF|FRU|002.4"} ] 
1844                  string Vendor;
1845                     [Description ("FRU name."), MaxLen (256) ] 
1846                  string Name;
1847                     [MaxLen (64), Description ("The FRU's revision level."),
1848                      MappingStrings {"MIF.DMTF|FRU|002.8"} ] 
1849 karl  1.1.2.1    string RevisionLevel;
1850                     [Description ("Indicates whether the FRU is "
1851                       "customer replaceable.")]
1852                  boolean CustomerReplaceable;
1853               };
1854                   
1855                    
1856               // ==================================================================
1857               //    ProductFRU
1858               // ==================================================================
1859                  [Association, Description (
1860                    "CIM_ProductFRU is an association between Product and FRU "
1861                    "that provides information regarding what Product components "
1862                    "have been or are being replaced.  The association is one to "
1863                    "many, conveying that a Product can have many FRUs, and that "
1864                    "a particular instance of a FRU is only applied to one " 
1865                    "(instance of a) Product.") ] 
1866               class CIM_ProductFRU {
1867                     [Max (1), Key, Description (
1868                       "The Product to which the FRU is applied.") ] 
1869                  CIM_Product REF Product;
1870 karl  1.1.2.1       [Key, Description ("The FRU.") ]
1871                  CIM_FRU REF FRU;
1872               };
1873               
1874                    
1875               // ==================================================================
1876               //    ReplaceableProductFRU
1877               // ==================================================================
1878                  [Association, Description (
1879                    "ReplaceableProductFRU is an association between Product and "
1880                    "FRU that shows what Product components may be replaced.  "
1881                    "The association is one to many, conveying that a Product "
1882                    "can have many FRUs, and that a particular instance of a "
1883                    "FRU is only applied to one (instance of a) Product.") ] 
1884               class CIM_ReplaceableProductFRU {
1885                     [Max (1), Key, Description (
1886                       "The Product to which the FRU is applied.") ] 
1887                  CIM_Product REF Product;
1888                     [Key, Description ("The FRU.") ]
1889                  CIM_FRU REF FRU;
1890               };
1891 karl  1.1.2.1 
1892                    
1893               // ==================================================================
1894               //    ProductPhysicalElements
1895               // ==================================================================
1896                  [Association, Aggregation, Description (
1897                    "Indicates the PhysicalElements that make up a Product.") ]
1898               class CIM_ProductPhysicalElements {
1899                     [Max (1), Aggregate, Key, Description (
1900                       "The Product.") ]
1901                  CIM_Product REF Product;
1902                     [Key, Description (
1903                       "The PhysicalElement which is a part of the Product.") ]
1904                  CIM_PhysicalElement REF Component;
1905               };
1906               
1907               
1908               // ==================================================================
1909               //    FRUPhysicalElements
1910               // ==================================================================
1911                  [Association, Aggregation, Description (
1912 karl  1.1.2.1      "Indicates the PhysicalElements that make up a FRU.") ]
1913               class CIM_FRUPhysicalElements {
1914                     [Max (1), Aggregate, Key, Description (
1915                       "The FRU.") ]
1916                  CIM_FRU REF FRU;
1917                     [Key, Description (
1918                       "The PhysicalElement which is a part of the FRU.") ]
1919                  CIM_PhysicalElement REF Component;
1920               };
1921               
1922               
1923               // ==================================================================
1924               //    FRUIncludesProduct
1925               // ==================================================================
1926                  [Association, Aggregation, Description (
1927                    "Indicates that a FRU may be composed of other Product(s).") ]
1928               class CIM_FRUIncludesProduct {
1929                     [Max (1), Aggregate, Key, Description (
1930                       "The FRU.") ]
1931                  CIM_FRU REF FRU;
1932                     [Key, Description (
1933 karl  1.1.2.1         "The Product which is a part of the FRU.") ]
1934                  CIM_Product REF Component;
1935               };
1936               
1937               
1938               // ==================================================================
1939               //    StatisticalInformation
1940               // ================================================================== 
1941                  [Abstract, Description ( 
1942                    "CIM_StatisticalInformation is a root class for any arbitrary " 
1943                    "collection of statistical data and/or metrics applicable to " 
1944                    "one or more ManagedSystemElements.") ] 
1945               class CIM_StatisticalInformation : CIM_ManagedElement { 
1946                     [MaxLen (256), Description ( 
1947                       "The Name property defines the label by which the statistic " 
1948                       "or metric is known. When subclassed, the property can be " 
1949                       "overridden to be a Key property. ") ] 
1950                  string Name; 
1951               };
1952               
1953               
1954 karl  1.1.2.1 // ==================================================================
1955               //    Statistics
1956               // ================================================================== 
1957                  [Association, Description ( 
1958                    "CIM_Statistics is an association that relates Managed" 
1959                    "Elements to the StatisticalGroup(s) that apply to them.") ]
1960               class CIM_Statistics { 
1961                     [Key, Description (
1962                       "The statistic information/object.") ] 
1963                  CIM_StatisticalInformation REF Stats; 
1964                     [Key, Description ( 
1965                       "The ManagedElement for which statistical or metric " 
1966                       "data is defined.") ] 
1967                  CIM_ManagedElement REF Element;
1968               };
1969               
1970               
1971               // ==================================================================
1972               //    RelatedStatistics
1973               // ================================================================== 
1974                  [Association, Description( 
1975 karl  1.1.2.1      "CIM_RelatedStatistics is an association that defines " 
1976                    "hierarchies and/or dependencies of related CIM_Statistical" 
1977                    "Information classes.") ]
1978               class CIM_RelatedStatistics { 
1979                     [Key, Description (
1980                       "The statistic information/object.") ] 
1981                  CIM_StatisticalInformation REF Stats; 
1982                     [Key, Description (
1983                       "The related statistics or metrics.") ] 
1984                  CIM_StatisticalInformation REF RelatedStats;
1985               };
1986               
1987               
1988               // ==================================================================
1989               //    SystemStatisticalInformation
1990               // ==================================================================
1991                  [Description (
1992                    "Statistical information associated with a System object "
1993                    "or one of its subclasses.") ]
1994               class CIM_SystemStatisticalInformation : CIM_StatisticalInformation {
1995                     [Propagated("CIM_System.CreationClassName"), Key, 
1996 karl  1.1.2.1        MaxLen (256), Description (
1997                       "The scoping System's CreationClassName.") ]
1998                  string SystemCreationClassName;
1999                     [Propagated("CIM_System.Name"), Key, MaxLen (256), 
2000                      Description ("The scoping System's Name.") ]
2001                  string SystemName;
2002                     [Key, MaxLen (256), Description (
2003                       "CreationClassName indicates the name of the class or the "
2004                       "subclass used in the creation of an instance. When used "
2005                       "with the other key properties of this class, this property "
2006                       "allows all instances of this class and its subclasses to "
2007                       "be uniquely identified.") ]
2008                  string CreationClassName;
2009                     [Key, MaxLen (256), Override ("Name"), Description (
2010                       "The Name property, inherited from StatisticalInformation, "
2011                       "serves as part of the object key.") ]
2012                  string Name;
2013               };
2014               
2015               
2016               // ==================================================================
2017 karl  1.1.2.1 //    SystemStatistics
2018               // ==================================================================
2019                  [Association, Description (
2020                    "SystemStatistics relates the SystemStatisticalInformation "
2021                    "class to the System to which it applies.") ]
2022               class CIM_SystemStatistics : CIM_Statistics {
2023                     [Override ("Stats"), Weak, Description (
2024                       "The statistical object.") ]
2025                  CIM_SystemStatisticalInformation REF Stats;
2026                     [Override ("Element"), Min(1), Max(1), 
2027                      Description ( "The System to which the statistics apply.") ]
2028                  CIM_System REF Element;
2029               };
2030               
2031               
2032               // ==================================================================
2033               //    ServiceStatisticalInformation
2034               // ==================================================================
2035                  [Description (
2036                    "Statistical information associated with a Service object "
2037                    "or one of its subclasses.") ]
2038 karl  1.1.2.1 class CIM_ServiceStatisticalInformation : CIM_StatisticalInformation {
2039                     [Propagated("CIM_Service.SystemCreationClassName"), Key, 
2040                      MaxLen (256), Description (
2041                       "The scoping System's CreationClassName.") ]
2042                  string SystemCreationClassName;
2043                     [Propagated("CIM_Service.SystemName"), Key, MaxLen (256), 
2044                      Description ("The scoping System's Name.") ]
2045                  string SystemName;
2046                     [Propagated("CIM_Service.CreationClassName"), Key, 
2047                      MaxLen (256), Description (
2048                       "The scoping Service's CreationClassName.") ]
2049                  string ServiceCreationClassName;
2050                     [Propagated("CIM_Service.Name"), Key, MaxLen (256), 
2051                      Description ("The scoping Service's Name.") ]
2052                  string ServiceName;
2053                     [Key, MaxLen (256), Description (
2054                       "CreationClassName indicates the name of the class or the "
2055                       "subclass used in the creation of an instance. When used "
2056                       "with the other key properties of this class, this property "
2057                       "allows all instances of this class and its subclasses to "
2058                       "be uniquely identified.") ]
2059 karl  1.1.2.1    string CreationClassName;
2060                     [Key, MaxLen (256), Override ("Name"), Description (
2061                       "The Name property, inherited from StatisticalInformation, "
2062                       "serves as part of the object key.") ]
2063                  string Name;
2064               };
2065               
2066               
2067               // ==================================================================
2068               //    ServiceStatistics
2069               // ==================================================================
2070                  [Association, Description (
2071                    "ServiceStatistics relates the ServiceStatisticalInformation "
2072                    "class to the Service to which it applies.") ]
2073               class CIM_ServiceStatistics : CIM_Statistics {
2074                     [Override ("Stats"), Weak, 
2075                      Description ( "The statistical object.") ]
2076                  CIM_ServiceStatisticalInformation REF Stats;
2077                     [Override ("Element"), Min(1), Max(1), 
2078                      Description ( 
2079                       "The Service to which the statistics apply.") ]
2080 karl  1.1.2.1    CIM_Service REF Element;
2081               };
2082               
2083               
2084               // ==================================================================
2085               //    SAPStatisticalInformation
2086               // ==================================================================
2087                  [Description (
2088                    "Statistical information associated with a Service"
2089                    "AccessPoint object or one of its subclasses.") ]
2090               class CIM_SAPStatisticalInformation : CIM_StatisticalInformation {
2091                     [Propagated("CIM_ServiceAccessPoint.SystemCreationClassName"),  
2092                      Key, MaxLen (256), Description (
2093                       "The scoping System's CreationClassName.") ]
2094                  string SystemCreationClassName;
2095                     [Propagated("CIM_ServiceAccessPoint.SystemName"), Key, 
2096                      MaxLen (256), Description ("The scoping System's Name.") ]
2097                  string SystemName;
2098                     [Propagated("CIM_ServiceAccessPoint.CreationClassName"), 
2099                      Key, MaxLen (256), Description (
2100                       "The scoping SAP's CreationClassName.") ]
2101 karl  1.1.2.1    string SAPCreationClassName;
2102                     [Propagated("CIM_ServiceAccessPoint.Name"), Key, 
2103                      MaxLen (256), Description ("The scoping SAP's Name.") ]
2104                  string SAPName;
2105                     [Key, MaxLen (256), Description (
2106                       "CreationClassName indicates the name of the class or the "
2107                       "subclass used in the creation of an instance. When used "
2108                       "with the other key properties of this class, this property "
2109                       "allows all instances of this class and its subclasses to "
2110                       "be uniquely identified.") ]
2111                  string CreationClassName;
2112                     [Key, MaxLen (256), Override ("Name"), Description (
2113                       "The Name property, inherited from StatisticalInformation, "
2114                       "serves as part of the object key.") ]
2115                  string Name;
2116               };
2117               
2118               
2119               // ==================================================================
2120               //    SAPStatistics
2121               // ==================================================================
2122 karl  1.1.2.1    [Association, Description (
2123                    "SAPStatistics relates the SAPStatisticalInformation "
2124                    "class to the ServiceAccessPoint to which it applies. ") ]
2125               class CIM_SAPStatistics : CIM_Statistics {
2126                     [Override ("Stats"), Weak, 
2127                      Description ( "The statistical object.") ]
2128                  CIM_SAPStatisticalInformation REF Stats;
2129                     [Override ("Element"), Min(1), Max(1), Description (
2130                       "The ServiceAccessPoint to which the statistics apply.") ]
2131                  CIM_ServiceAccessPoint REF Element;
2132               };
2133               
2134               
2135               // ==================================================================
2136               //    DeviceStatisticalInformation
2137               // ==================================================================
2138                  [Description (
2139                    "Statistical information associated with a LogicalDevice "
2140                    "or one of its subclasses.") ]
2141               class CIM_DeviceStatisticalInformation : CIM_StatisticalInformation {
2142                     [Propagated("CIM_LogicalDevice.SystemCreationClassName"), Key, 
2143 karl  1.1.2.1        MaxLen (256), Description (
2144                       "The scoping System's CreationClassName.") ]
2145                  string SystemCreationClassName;
2146                     [Propagated("CIM_LogicalDevice.SystemName"), Key, MaxLen (256), 
2147                      Description ("The scoping System's Name.") ]
2148                  string SystemName;
2149                     [Propagated("CIM_LogicalDevice.CreationClassName"), Key, 
2150                      MaxLen (256), 
2151                      Description ("The scoping Device's CreationClassName.") ]
2152                  string DeviceCreationClassName;
2153                     [Propagated("CIM_LogicalDevice.DeviceID"), Key, MaxLen (64), 
2154                      Description ("The scoping Device's ID.") ]
2155                  string DeviceID;
2156                     [Key, MaxLen (256), Description (
2157                       "CreationClassName indicates the name of the class or the "
2158                       "subclass used in the creation of an instance. When used "
2159                       "with the other key properties of this class, this property "
2160                       "allows all instances of this class and its subclasses to "
2161                       "be uniquely identified.") ]
2162                  string CreationClassName;
2163                     [Key, MaxLen (256), Override ("Name"), Description (
2164 karl  1.1.2.1         "The Name property, inherited from StatisticalInformation, "
2165                       "serves as part of the object key.") ]
2166                  string Name;
2167               };
2168               
2169               
2170               // ==================================================================
2171               //    DeviceStatistics
2172               // ==================================================================
2173                  [Association, Description (
2174                    "DeviceStatistics relates the DeviceStatisticalInformation "
2175                    "class to the LogicalDevice to which it applies. ") ]
2176               class CIM_DeviceStatistics : CIM_Statistics {
2177                     [Override ("Stats"), Weak, 
2178                      Description ( "The statistical object.") ]
2179                  CIM_DeviceStatisticalInformation REF Stats;
2180                     [Override ("Element"), Min(1), Max(1), 
2181                      Description ("The Device to which the statistics apply.") ]
2182                  CIM_LogicalDevice REF Element;
2183               };
2184               
2185 karl  1.1.2.1 
2186               // ==================================================================
2187               //    PhysicalStatisticalInformation
2188               // ==================================================================
2189                  [Description (
2190                    "Statistical information associated with a PhysicalElement "
2191                    "or one of its subclasses.") ]
2192               class CIM_PhysicalStatisticalInformation : CIM_StatisticalInformation {
2193                     [Propagated("CIM_PhysicalElement.CreationClassName"), Key, 
2194                      MaxLen (256), 
2195                      Description ("The scoping Element's CreationClassName.") ]
2196                  string PhysicalCreationClassName;
2197                     [Propagated("CIM_PhysicalElement.Tag"), Key, MaxLen (256), 
2198                      Description ("The scoping Element's identifying Tag.") ]
2199                  string Tag;
2200                     [Key, MaxLen (256), Description (
2201                       "CreationClassName indicates the name of the class or the "
2202                       "subclass used in the creation of an instance. When used "
2203                       "with the other key properties of this class, this property "
2204                       "allows all instances of this class and its subclasses to "
2205                       "be uniquely identified.") ]
2206 karl  1.1.2.1    string CreationClassName;
2207                     [Key, MaxLen (256), Override ("Name"), Description (
2208                       "The Name property, inherited from StatisticalInformation, "
2209                       "serves as part of the object key.") ]
2210                  string Name;
2211               };
2212               
2213               
2214               // ==================================================================
2215               //    PhysicalStatistics
2216               // ==================================================================
2217                  [Association, Description (
2218                    "PhysicalStatistics relates the PhysicalStatisticalInformation "
2219                    "class to the PhysicalElement to which it applies. ") ]
2220               class CIM_PhysicalStatistics : CIM_Statistics {
2221                     [Override ("Stats"), Weak, 
2222                      Description ( "The statistical object.") ]
2223                  CIM_PhysicalStatisticalInformation REF Stats;
2224                     [Override ("Element"), Min(1), Max(1), Description (
2225                       "The PhysicalElement to which the statistics apply.") ]
2226                  CIM_PhysicalElement REF Element;
2227 karl  1.1.2.1 };
2228               
2229               
2230               // ==================================================================
2231               //
2232               //  3 - Settings and Configuration
2233               //
2234               // ==================================================================
2235               // ===================================================================
2236               //    Configuration
2237               // ===================================================================
2238                  [Description (
2239                    "The Configuration object allows the grouping of sets of "
2240                    "parameters (defined in Setting objects) and dependencies for "
2241                    "one or more ManagedSystemElements. The Configuration object "
2242                    "represents a certain behavior, or a desired functional state "
2243                    "for the ManagedSystemElements. The desired functional state "
2244                    "is typically driven by external requirements such as time or "
2245                    "location. For example, to connect to a Mail System from "
2246                    "'home', a dependency on a modem exists, but a dependency on "
2247                    "a network adapter exists at 'work'. Settings for the "
2248 karl  1.1.2.1      "pertinent LogicalDevices (in this example, POTSModem and "
2249                    "NetworkAdapter) can be defined and aggregated by the "
2250                    "Configuration. Therefore, two 'Connect to Mail' "
2251                    "Configurations may be defined grouping the relevant "
2252                    "dependencies and Setting objects.") ]
2253               class CIM_Configuration : CIM_ManagedElement {
2254                     [Key, MaxLen (256), Description (
2255                       "The label by which the Configuration object is known.") ]
2256                  string Name;
2257               };
2258               
2259               
2260               // ===================================================================
2261               //    ConfigurationComponent
2262               // ===================================================================
2263                  [Association, Aggregation, Description (
2264                    "ConfigurationComponent aggregates 'lower-level' "
2265                    "Configuration objects into a 'high-level' Configuration. "
2266                    "This enables the assembly of complex Configurations by "
2267                    "grouping together simpler ones. For example, a logon policy "
2268                    "for the United States could consist of two Configuration "
2269 karl  1.1.2.1      "groups, one for the east coast and one for the west coast. "
2270                    "Each of these could in turn consist of multiple "
2271                    "Configurations to handle different aspects of the logon "
2272                    "process.") ]
2273               class CIM_ConfigurationComponent {
2274                     [Aggregate, Key, Description (
2275                       "The Configuration that aggregates additional "
2276                       "Configurations." ) ]
2277                  CIM_Configuration REF ConfigGroup;
2278                     [Key, Description (
2279                       "A Configuration that is part of a 'higher-level' "
2280                       "Configuration.") ]
2281                  CIM_Configuration REF ConfigComponent;
2282               };
2283               
2284               
2285               // ===================================================================
2286               //    ElementConfiguration
2287               // ===================================================================
2288                  [Association, Description (
2289                    "This association relates a Configuration object to one or "
2290 karl  1.1.2.1      "more ManagedSystemElements. The Configuration object "
2291                    "represents a certain behavior, or a desired functional state "
2292                    "for the associated ManagedSystemElements.") ]
2293               class CIM_ElementConfiguration {
2294                     [Key, Description ("The ManagedSystemElement.")]
2295                  CIM_ManagedSystemElement REF Element;
2296                     [Key, Description (
2297                       "The Configuration object that groups the Settings and "
2298                       "dependencies associated with the ManagedSystemElement.") ] 
2299                  CIM_Configuration REF Configuration;
2300               };
2301               
2302               
2303               // ===================================================================
2304               //    CollectionConfiguration
2305               // ===================================================================
2306                  [Association, Description (
2307                    "This association relates a Configuration object to one or "
2308                    "more CollectionOfMSEs objects. The Configuration object "
2309                    "represents a certain behavior, or a desired functional state "
2310                    "for the associated Collection.") ]
2311 karl  1.1.2.1 class CIM_CollectionConfiguration {
2312                     [Key, Description ("The CollectionOfMSEs.") ]
2313                  CIM_CollectionOfMSEs REF Collection;
2314                     [Key, Description (
2315                       "The Configuration object that groups the Settings and "
2316                       "dependencies associated with the Collection.") ]
2317                  CIM_Configuration REF Configuration;
2318               };
2319               
2320               
2321               // ===================================================================
2322               //    Setting
2323               // ===================================================================
2324                  [Abstract, Description (
2325                    "The Setting class represents configuration-related and "
2326                    "operational parameters for one or more ManagedSystem"
2327                    "Element(s). A ManagedSystemElement may have multiple Setting "
2328                    "objects associated with it. The current operational values "
2329                    "for an Element's parameters are reflected by properties in "
2330                    "the Element itself or by properties in its associations. "
2331                    "These properties do not have to be the same values present "
2332 karl  1.1.2.1      "in the Setting object. For example, a modem may have a "
2333                    "Setting baud rate of 56Kb/sec but be operating "
2334                    "at 19.2Kb/sec.") ]
2335               class CIM_Setting : CIM_ManagedElement {
2336                     [MaxLen (256), Description (
2337                       "The identifier by which the Setting object is known.") ]
2338                  string SettingID;
2339                     [Description (
2340                       "The VerifyOKToApplyToMSE method is used to verify that "
2341                       "this Setting can be 'applied' to the referenced Managed"
2342                       "SystemElement, at the given time or time interval. This "
2343                       "method takes three input parameters: MSE (the Managed"
2344                       "SystemElement that is being verified), TimeToApply (which, "
2345                       "being a datetime, can be either a specific time or a time "
2346                       "interval), and MustBeCompletedBy (which indicates the "
2347                       "required completion time for the method). The return "
2348                       "value should be 0 if it is OK to apply the Setting, 1 if "
2349                       "the method is not supported, 2 if the Setting can not be "
2350                       "applied within the specified times, and any other number "
2351                       "if an error occurred. In a subclass, the "
2352                       "set of possible return codes could be specified, using a "
2353 karl  1.1.2.1         "ValueMap qualifier on the method. The strings to which the "
2354                       "ValueMap contents are 'translated' may also be specified in "
2355                       "the subclass as a Values array qualifier.") ]
2356                  uint32 VerifyOKToApplyToMSE(
2357                     [IN] CIM_ManagedSystemElement ref MSE, 
2358                     [IN] datetime TimeToApply, 
2359                     [IN] datetime MustBeCompletedBy);
2360                     [Description (
2361                       "The ApplyToMSE method performs the actual application of "
2362                       "the Setting to the referenced ManagedSystemElement. It "
2363                       "takes three input parameters: MSE (the ManagedSystem"
2364                       "Element to which the Setting is being applied), "
2365                       "TimeToApply (which, being a datetime, can be either a "
2366                       "specific time or a time interval), and MustBeCompletedBy "
2367                       "(which indicates the required completion time for the "
2368                       "method). Note that the semantics of this method are that "
2369                       "individual Settings are either wholly applied or not "
2370                       "applied at all to their target ManagedSystemElement. The "
2371                       "return value should be 0 if the Setting is successfully "
2372                       "applied to the referenced ManagedSystemElement, 1 if the "
2373                       "method is not supported, 2 if the Setting was not applied "
2374 karl  1.1.2.1         "within the specified times, and any other number if an "
2375                       "error occurred. In a subclass, the set of possible return "
2376                       "codes could be specified, using a ValueMap qualifier on "
2377                       "the method. The strings to which the ValueMap contents are "
2378                       "'translated' may also be specified in the subclass as a "
2379                       "Values array qualifier.\n"
2380                       "Note: If an error occurs in applying the Setting to a "
2381                       "ManagedSystemElement, the Element must be configured as "
2382                       "when the 'apply' attempt began. That is, the Element "
2383                       "should NOT be left in an indeterminate state.") ]
2384                  uint32 ApplyToMSE(
2385                     [IN] CIM_ManagedSystemElement ref MSE, 
2386                     [IN] datetime TimeToApply, 
2387                     [IN] datetime MustBeCompletedBy);
2388                     [Description (
2389                       "The VerifyOKToApplyToCollection method is used to verify "
2390                       "that this Setting can be 'applied' to the referenced "
2391                       "Collection of ManagedSystemElements, at the given time "
2392                       "or time interval, without causing adverse effects to "
2393                       "either the Collection itself or its surrounding "
2394                       "environment. The net effect is to execute the "
2395 karl  1.1.2.1         "VerifyOKToApply method against each of the Elements "
2396                       "aggregated by the Collection. This method takes three "
2397                       "input parameters: Collection (the Collection of Managed"
2398                       "SystemElements that is being verified), TimeToApply (which, "
2399                       "being a datetime, can be either a specific time or a time "
2400                       "interval), and MustBeCompletedBy (which indicates the "
2401                       "required completion time for the method). The return "
2402                       "value should be 0 if it is OK to apply the Setting, 1 if "
2403                       "the method is not supported, 2 if the Setting can not be "
2404                       "applied within the specified times, and any other number if "
2405                       "an error occurred. One output parameter is defined - "
2406                       "CanNotApply - which is a string array that lists the keys of "
2407                       "the ManagedSystemElements to which the Setting can NOT be "
2408                       "applied. This enables those Elements to be revisited and "
2409                       "either fixed, or other corrective action taken.\n"
2410                       "In a subclass, the set of possible return codes could be "
2411                       "specified, using a ValueMap qualifier on the method. The "
2412                       "strings to which the ValueMap contents are 'translated' may "
2413                       "also be specified in the subclass as a Values array "
2414                       "qualifier.") ] 
2415                  uint32 VerifyOKToApplyToCollection (
2416 karl  1.1.2.1       [IN] CIM_CollectionOfMSEs ref Collection,
2417                     [IN] datetime TimeToApply, 
2418                     [IN] datetime MustBeCompletedBy,
2419                     [OUT] string CanNotApply[]);
2420                     [Description (
2421                       "The ApplyToCollection method performs the application of "
2422                       "the Setting to the referenced Collection of ManagedSystem"
2423                       "Elements. The net effect is to execute the ApplyToMSE "
2424                       "method against each of the Elements aggregated by the "
2425                       "Collection. If the input value ContinueOnError is FALSE, "
2426                       "this method applies the Setting to all Elements in the "
2427                       "Collection until it encounters an error, in which case it "
2428                       "stops execution, logs the key of the Element that caused "
2429                       "the error in the CanNotApply array, and issues a return code "
2430                       "of 2. If the input value ContinueOnError is TRUE, then this "
2431                       "method applies the Setting to all the ManagedSystemElements "
2432                       "in the Collection, and reports the failed Elements in the "
2433                       "array, CanNotApply. For the latter, processing will continue "
2434                       "until the method is applied to all Elements in the "
2435                       "Collection, regardless of any errors encountered. The key of "
2436                       "each ManagedSystemElement to which the Setting could not be "
2437 karl  1.1.2.1         "applied is logged into the CanNotApply array. This method "
2438                       "takes four input parameters: Collection (the Collection of "
2439                       "Elements to which the Setting is being applied), TimeToApply "
2440                       "(which, being a datetime, can be either a specific time or a "
2441                       "time interval), ContinueOnError (TRUE means to continue "
2442                       "processing on encountering an error), and MustBeCompletedBy "
2443                       "(which indicates the required completion time for the "
2444                       "method). The return value should be 0 if the Setting is "
2445                       "successfully applied to the referenced Collection, 1 if the "
2446                       "method is not supported, 2 if the Setting was not applied "
2447                       "within the specified times, 3 if the Setting can not be "
2448                       "applied using the input value for ContinueOnError, and any "
2449                       "other number if an error occurred. One output parameter is "
2450                       "defined, CanNotApplystring, which is an array that lists "
2451                       "the keys of the ManagedSystemElements to which the Setting "
2452                       "was NOT able to be applied. This output parameter has "
2453                       "meaning only when the ContinueOnError parameter is TRUE.\n"
2454                       "In a subclass, the set of possible return codes could be "
2455                       "specified, using a ValueMap qualifier on the method. The "
2456                       "strings to which the ValueMap contents are 'translated' may "
2457                       "also be specified in the subclass as a Values array "
2458 karl  1.1.2.1         "qualifier.\n"
2459                       "Note: if an error occurs in applying the Setting to a "
2460                       "ManagedSystemElement in the Collection, the Element must be "
2461                       "configured as when the 'apply' attempt began. That is, the "
2462                       "Element should NOT be left in an indeterminate state.") ]
2463                  uint32 ApplyToCollection(
2464                     [IN] CIM_CollectionOfMSEs ref Collection, 
2465                     [IN] datetime TimeToApply, 
2466                     [IN] boolean ContinueOnError,
2467                     [IN] datetime MustBeCompletedBy, 
2468                     [OUT] string CanNotApply[]);
2469                     [Description ( 
2470                       "The VerifyOKToApplyIncrementalChangeToMSE method " 
2471                       "is used to verify that a subset of the properties in " 
2472                       "this Setting can be 'applied' to the referenced Managed" 
2473                       "SystemElement, at the given time or time interval. This " 
2474                       "method takes four input parameters: MSE (the Managed" 
2475                       "SystemElement that is being verified), TimeToApply (which, " 
2476                       "being a datetime, can be either a specific time or a time " 
2477                       "interval), MustBeCompletedBy (which indicates the " 
2478                       "required completion time for the method), and a " 
2479 karl  1.1.2.1         "PropertiesToApply array (which contains a list of the " 
2480                       "property names whose values will be verified. " 
2481                       "If they array is null or empty or constains the string \"all\" " 
2482                       "as a property name then all Settings properties shall be " 
2483                       "verified.  If it is set to \"none\" then no Settings properties " 
2484                       "will be verified). The return " 
2485                       "value should be 0 if it is OK to apply the Setting, 1 if " 
2486                       "the method is not supported, 2 if the Setting can not be " 
2487                       "applied within the specified times, and any other number " 
2488                       "if an error occurred. In a subclass, the " 
2489                       "set of possible return codes could be specified, using a " 
2490                       "ValueMap qualifier on the method. The strings to which the " 
2491                       "ValueMap contents are 'translated' may also be specified in " 
2492                       "the subclass as a Values array qualifier.") ] 
2493                  uint32 VerifyOKToApplyIncrementalChangeToMSE( 
2494                     [IN] CIM_ManagedSystemElement ref MSE, 
2495                     [IN] datetime TimeToApply, 
2496                     [IN] datetime MustBeCompletedBy, 
2497                     [IN] string PropertiesToApply[]); 
2498                     [Description ( 
2499                       "The ApplyIncrementalChangeToMSE method performs the " 
2500 karl  1.1.2.1         "actual application of  a subset of the properties in " 
2501                       "the Setting to the referenced ManagedSystemElement. It " 
2502                       "takes four input parameters: MSE (the ManagedSystem" 
2503                       "Element to which the Setting is being applied), " 
2504                       "TimeToApply (which, being a datetime, can be either a " 
2505                       "specific time or a time interval), MustBeCompletedBy " 
2506                       "(which indicates the required completion time for the " 
2507                       "method), and a " 
2508                       "PropertiesToApply array (which contains a list of the " 
2509                       "property names whose values will be applied. If a " 
2510                       "property is not in this list, it will be ignored by the apply. " 
2511                       "If they array is null or empty or constains the string \"all\" " 
2512                       "as a property name then all Settings properties shall be " 
2513                       "applied.  If it is set to \"none\" then no Settings properties " 
2514                       "will be applied. ). " 
2515                       "Note that the semantics of this method are that " 
2516                       "individual Settings are either wholly applied or not " 
2517                       "applied at all to their target ManagedSystemElement. The " 
2518                       "return value should be 0 if the Setting is successfully " 
2519                       "applied to the referenced ManagedSystemElement, 1 if the " 
2520                       "method is not supported, 2 if the Setting was not applied " 
2521 karl  1.1.2.1         "within the specified times, and any other number if an " 
2522                       "error occurred. In a subclass, the set of possible return " 
2523                       "codes could be specified, using a ValueMap qualifier on " 
2524                       "the method. The strings to which the ValueMap contents are " 
2525                       "'translated' may also be specified in the subclass as a " 
2526                       "Values array qualifier.\n" 
2527                       "Note: If an error occurs in applying the Setting to a " 
2528                       "ManagedSystemElement, the Element must be configured as " 
2529                       "when the 'apply' attempt began. That is, the Element " 
2530                       "should NOT be left in an indeterminate state.") ] 
2531                  uint32 ApplyIncrementalChangeToMSE( 
2532                     [IN] CIM_ManagedSystemElement ref MSE, 
2533                     [IN] datetime TimeToApply, 
2534                     [IN] datetime MustBeCompletedBy, 
2535                     [IN] string PropertiesToApply[]); 
2536                     [Description ( 
2537                       "The VerifyOKToApplyIncrementalChangeToCollection method " 
2538                       "is used to verify that a subset of the properties in " 
2539                       "this Setting can be 'applied' to the referenced " 
2540                       "Collection of ManagedSystemElements, at the given time " 
2541                       "or time interval, without causing adverse effects to " 
2542 karl  1.1.2.1         "either the Collection itself or its surrounding " 
2543                       "environment. The net effect is to execute the " 
2544                       "VerifyOKToApplyIncrementalChangeToMSE method " 
2545                       "against each of the Elements " 
2546                       "aggregated by the Collection. This method takes three " 
2547                       "input parameters: Collection (the Collection of Managed" 
2548                       "SystemElements that is being verified), TimeToApply (which, " 
2549                       "being a datetime, can be either a specific time or a time " 
2550                       "interval), MustBeCompletedBy (which indicates the " 
2551                       "required completion time for the method), and a " 
2552                       "PropertiesToApply array (which contains a list of the " 
2553                       "property names whose values will be verified. " 
2554                       "If they array is null or empty or constains the string \"all\" " 
2555                       "as a property name then all Settings properties shall be " 
2556                       "verified.  If it is set to \"none\" then no Settings properties " 
2557                       "will be verified). The return " 
2558                       "value should be 0 if it is OK to apply the Setting, 1 if " 
2559                       "the method is not supported, 2 if the Setting can not be " 
2560                       "applied within the specified times, and any other number if " 
2561                       "an error occurred. One output parameter is defined - " 
2562                       "CanNotApply - which is a string array that lists the keys of " 
2563 karl  1.1.2.1         "the ManagedSystemElements to which the Setting can NOT be " 
2564                       "applied. This enables those Elements to be revisited and " 
2565                       "either fixed, or other corrective action taken.\n" 
2566                       "In a subclass, the set of possible return codes could be " 
2567                       "specified, using a ValueMap qualifier on the method. The " 
2568                       "strings to which the ValueMap contents are 'translated' may " 
2569                       "also be specified in the subclass as a Values array " 
2570                       "qualifier.") ] 
2571                  uint32 VerifyOKToApplyIncrementalChangeToCollection ( 
2572                     [IN] CIM_CollectionOfMSEs ref Collection, 
2573                     [IN] datetime TimeToApply, 
2574                     [IN] datetime MustBeCompletedBy, 
2575                     [IN] string PropertiesToApply[], 
2576                     [OUT] string CanNotApply[]); 
2577                     [Description ( 
2578                       "The ApplyIncrementalChangeToCollection method performs " 
2579                       "the application of a subset of the properties in this " 
2580                       "Setting to the referenced Collection of ManagedSystem" 
2581                       "Elements. The net effect is to execute the " 
2582                       "ApplyIncrementalChangeToMSE " 
2583                       "method against each of the Elements aggregated by the " 
2584 karl  1.1.2.1         "Collection. If the input value ContinueOnError is FALSE, " 
2585                       "this method applies the Setting to all Elements in the " 
2586                       "Collection until it encounters an error, in which case it " 
2587                       "stops execution, logs the key of the Element that caused " 
2588                       "the error in the CanNotApply array, and issues a return code " 
2589                       "of 2. If the input value ContinueOnError is TRUE, then this " 
2590                       "method applies the Setting to all the ManagedSystemElements " 
2591                       "in the Collection, and reports the failed Elements in the " 
2592                       "array, CanNotApply. For the latter, processing will continue " 
2593                       "until the method is applied to all Elements in the " 
2594                       "Collection, regardless of any errors encountered. The key of " 
2595                       "each ManagedSystemElement to which the Setting could not be " 
2596                       "applied is logged into the CanNotApply array. This method " 
2597                       "takes four input parameters: Collection (the Collection of " 
2598                       "Elements to which the Setting is being applied), TimeToApply " 
2599                       "(which, being a datetime, can be either a specific time or a " 
2600                       "time interval), ContinueOnError (TRUE means to continue " 
2601                       "processing on encountering an error), and MustBeCompletedBy " 
2602                       "(which indicates the required completion time for the " 
2603                       "method), and a PropertiesToApply array (which contains a list " 
2604                       "of the property names whose values will be applied. If a " 
2605 karl  1.1.2.1         "property is not in this list, it will be ignored by the apply. " 
2606                       "If they array is null or empty or constains the string \"all\" " 
2607                       "as a property name then all Settings properties shall be " 
2608                       "applied.  If it is set to \"none\" then no Settings properties " 
2609                       "will be applied. ). " 
2610                       "The return value should be 0 if the Setting is " 
2611                       "successfully applied to the referenced Collection, 1 if the " 
2612                       "method is not supported, 2 if the Setting was not applied " 
2613                       "within the specified times, 3 if the Setting can not be " 
2614                       "applied using the input value for ContinueOnError, and any " 
2615                       "other number if an error occurred. One output parameter is " 
2616                       "defined, CanNotApplystring, which is an array that lists " 
2617                       "the keys of the ManagedSystemElements to which the Setting " 
2618                       "was NOT able to be applied. This output parameter has " 
2619                       "meaning only when the ContinueOnError parameter is TRUE.\n" 
2620                       "In a subclass, the set of possible return codes could be " 
2621                       "specified, using a ValueMap qualifier on the method. The " 
2622                       "strings to which the ValueMap contents are 'translated' may " 
2623                       "also be specified in the subclass as a Values array " 
2624                       "qualifier.\n" 
2625                       "Note: if an error occurs in applying the Setting to a " 
2626 karl  1.1.2.1         "ManagedSystemElement in the Collection, the Element must be " 
2627                       "configured as when the 'apply' attempt began. That is, the " 
2628                       "Element should NOT be left in an indeterminate state.") ] 
2629                  uint32 ApplyIncrementalChangeToCollection( 
2630                     [IN] CIM_CollectionOfMSEs ref Collection, 
2631                     [IN] datetime TimeToApply, 
2632                     [IN] boolean ContinueOnError, 
2633                     [IN] datetime MustBeCompletedBy, 
2634                     [IN] string PropertiesToApply[], 
2635                     [OUT] string CanNotApply[]); 
2636               };
2637               
2638               
2639               // ===================================================================
2640               //    ElementSetting
2641               // ===================================================================
2642                  [Association, Description (
2643                    "ElementSetting represents the association between Managed"
2644                    "SystemElements and the Setting class(es) defined for them.") ]
2645               class CIM_ElementSetting {
2646                     [Key, Description ("The ManagedSystemElement.") ]
2647 karl  1.1.2.1    CIM_ManagedSystemElement REF Element;
2648                     [Key, Description (
2649                       "The Setting object associated with the ManagedSystem"
2650                       "Element.") ]
2651                  CIM_Setting REF Setting;
2652               };
2653               
2654               
2655               // ===================================================================
2656               //    DefaultSetting
2657               // ===================================================================
2658                  [Association, Description (
2659                    "DefaultSetting represents the association between a Managed"
2660                    "SystemElement and the single Setting class that is defined "
2661                    "to be the default setting for this Element.") ]
2662               class CIM_DefaultSetting : CIM_ElementSetting {
2663                     [Override ("Setting"), Max (1), Description (
2664                       "The Setting object which is the default.") ]
2665                  CIM_Setting REF Setting;
2666               };
2667               
2668 karl  1.1.2.1 
2669               // ===================================================================
2670               //    DependencyContext
2671               // ===================================================================
2672                  [Association, Aggregation, Description (
2673                    "This relationship associates a Dependency with one or more "
2674                    "Configuration objects. For example, a ComputerSystem's "
2675                    "dependencies could change based on the site/network to which "
2676                    "the System is attached.") ]
2677               class CIM_DependencyContext {
2678                     [Aggregate, Key, Description (
2679                       "The Configuration object that aggregates the Dependency.") ]
2680                  CIM_Configuration REF Context;
2681                     [Key, Description ("An aggregated Dependency.") ]
2682                  CIM_Dependency REF Dependency;
2683               };
2684               
2685                    
2686               // ===================================================================
2687               //    SettingContext
2688               // ===================================================================
2689 karl  1.1.2.1    [Association, Aggregation, Description (
2690                    "This relationship associates Configuration objects with "
2691                    "Setting objects. For example, a NetworkAdapter's Settings "
2692                    "could change based on the site/network to which its hosting "
2693                    "ComputerSystem is attached. In this case, the ComputerSystem "
2694                    "would have two different Configuration objects, corresponding "
2695                    "to the differences in network configuration for the two network "
2696                    "segments. Configuration A would aggregate a Setting object for "
2697                    "the NetworkAdapter when operating on segment \"ANet\", whereas "
2698                    "Configuration B would aggregate a different NetworkAdapter "
2699                    "Setting object, specific to segment \"BNet\". Note that many "
2700                    "Settings of the computer are independent of the network "
2701                    "Configuration. For example, both Configurations A and B would "
2702                    "aggregate the same Setting object for the ComputerSystem's "
2703                    "MonitorResolution.") ]
2704               class CIM_SettingContext {
2705                     [Aggregate, Key, Description (
2706                       "The Configuration object that aggregates the Setting.") ]
2707                  CIM_Configuration REF Context;
2708                     [Key, Description ("An aggregated Setting.")]
2709                  CIM_Setting REF Setting;
2710 karl  1.1.2.1 };
2711               
2712               
2713               // ===================================================================
2714               //    CollectionSetting
2715               // ===================================================================
2716                  [Association, Description (
2717                    "CollectionSetting represents the association between a "
2718                    "CollectionOfMSEs class and the Setting class(es) defined for "
2719                    "them.") ]
2720               class CIM_CollectionSetting {
2721                     [Key, Description ("The CollectionOfMSEs.") ]
2722                  CIM_CollectionOfMSEs REF Collection;
2723                     [Key, Description (
2724                       "The Setting object associated with the Collection.") ]
2725                  CIM_Setting REF Setting;
2726               };
2727               
2728               
2729               // ==================================================================
2730               // Pragmas for new classes in premliminary release status
2731 karl  1.1.2.1 // ==================================================================
2732               
2733               #pragma include ("CIM_Core26_Add.mof")
2734               
2735                
2736               // ===================================================================
2737               // end of file
2738               // ===================================================================
2739               

No CVS admin address has been configured
Powered by
ViewCVS 0.9.2