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

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

No CVS admin address has been configured
Powered by
ViewCVS 0.9.2