// Copyright (c) 2008 DMTF. All rights reserved. [Abstract, Version ( "2.19.0" ), UMLPackagePath ( "CIM::Core::Settings" ), Description ( "CIM_SettingData is used to represent configuration and and " "operational parameters for CIM_ManagedElement instances. There " "are a number of different uses of CIM_SettingData supported in " "the model today. Additional uses may be defined in the future.\n" "Instances of CIM_SettingData may represent Aspects of a " "CIM_ManagedElement instance. This is modeled using the " "CIM_SettingsDefineState association. CIM_SettingData may be " "used to define capabilities when associated to an instance of " "CIM_Capabilities through the CIM_SettingsDefineCapabilities " "association. \n" "Instances of CIM_SettingData may represent different types of " "configurations for a CIM_ManagedElement, including persistent " "configurations, in progress configuration changes, or " "requested configurations. The CIM_ElementSettingData " "association is used to model the relationship between a " "CIM_SettingData instance and the CIM_ManagedElement for which " "it is a configuration. \n" "When an instance of CIM_SettingData represents a " "configuration, the current operational values for the " "parameters of the element are reflected by properties in the " "Element itself or by properties in its associations. These " "properties do not have to be the same values that are present " "in the SettingData object. For example, a modem might have a " "SettingData baud rate of 56Kb/sec but be operating at " "19.2Kb/sec. \n" "Note: The CIM_SettingData class is very similar to " "CIM_Setting, yet both classes are present in the model because " "many implementations have successfully used CIM_Setting. " "However, issues have arisen that could not be resolved without " "defining a new class. Therefore, until a new major release " "occurs, both classes will exist in the model. Refer to the " "Core White Paper for additional information. SettingData " "instances can be aggregated together into higher- level " "SettingData objects using ConcreteComponent associations." )] class CIM_SettingData : CIM_ManagedElement { [Key, Override ( "InstanceID" ), Description ( "Within the scope of the instantiating Namespace, " "InstanceID opaquely and uniquely identifies an instance " "of this class. To ensure uniqueness within the " "NameSpace, the value of InstanceID should be constructed " "using the following \"preferred\" algorithm: \n" ": \n" "Where and are separated by a colon " "(:), and where must include a copyrighted, " "trademarked, or otherwise unique name that is owned by " "the business entity that is creating or defining the " "InstanceID or that is a registered ID assigned to the " "business entity by a recognized global authority. (This " "requirement is similar to the _ " "structure of Schema class names.) In addition, to ensure " "uniqueness, must not contain a colon (:). When " "using this algorithm, the first colon to appear in " "InstanceID must appear between and . \n" " is chosen by the business entity and should " "not be reused to identify different underlying " "(real-world) elements. If the above \"preferred\" " "algorithm is not used, the defining entity must assure " "that the resulting InstanceID is not reused across any " "InstanceIDs produced by this or other providers for the " "NameSpace of this instance. \n" "For DMTF-defined instances, the \"preferred\" algorithm " "must be used with the set to CIM." )] string InstanceID; [Required, Override ( "ElementName" ), Description ( "The user-friendly name for this instance of SettingData. " "In addition, the user-friendly name can be used as an " "index property for a search or query. (Note: The name " "does not have to be unique within a namespace.)" )] string ElementName; };