1 karl  1.1.2.2 // Copyright (c) 2009 DMTF.  All rights reserved.
 2                  [Abstract, Version ( "2.19.0" ), 
 3                   UMLPackagePath ( "CIM::Core::CoreElements" ), 
 4                   Description ( 
 5                      "ManagedElement is an abstract class that provides a common "
 6                      "superclass (or top of the inheritance tree) for the "
 7                      "non-association classes in the CIM Schema." )]
 8               class CIM_ManagedElement {
 9               
10                     [Description ( 
11                         "InstanceID is an optional property that may be used to "
12                         "opaquely and uniquely identify an instance of this class "
13                         "within the scope of the instantiating Namespace. Various "
14                         "subclasses of this class may override this property to "
15                         "make it required, or a key. Such subclasses may also "
16                         "modify the preferred algorithms for ensuring uniqueness "
17                         "that are defined below.\n"
18                         "To ensure uniqueness within the NameSpace, the value of "
19                         "InstanceID should be constructed using the following "
20                         "\"preferred\" algorithm: \n"
21                         "<OrgID>:<LocalID> \n"
22 karl  1.1.2.2           "Where <OrgID> and <LocalID> are separated by a colon "
23                         "(:), and where <OrgID> must include a copyrighted, "
24                         "trademarked, or otherwise unique name that is owned by "
25                         "the business entity that is creating or defining the "
26                         "InstanceID or that is a registered ID assigned to the "
27                         "business entity by a recognized global authority. (This "
28                         "requirement is similar to the <Schema Name>_<Class Name> "
29                         "structure of Schema class names.) In addition, to ensure "
30                         "uniqueness, <OrgID> must not contain a colon (:). When "
31                         "using this algorithm, the first colon to appear in "
32                         "InstanceID must appear between <OrgID> and <LocalID>. \n"
33                         "<LocalID> is chosen by the business entity and should "
34                         "not be reused to identify different underlying "
35                         "(real-world) elements. If not null and the above "
36                         "\"preferred\" algorithm is not used, the defining entity "
37                         "must assure that the resulting InstanceID is not reused "
38                         "across any InstanceIDs produced by this or other "
39                         "providers for the NameSpace of this instance. \n"
40                         "If not set to null for DMTF-defined instances, the "
41                         "\"preferred\" algorithm must be used with the <OrgID> "
42                         "set to CIM." )]
43 karl  1.1.2.2    string InstanceID;
44               
45                     [Description ( 
46                         "The Caption property is a short textual description "
47                         "(one- line string) of the object." ), 
48                      MaxLen ( 64 )]
49                  string Caption;
50               
51                     [Description ( 
52                         "The Description property provides a textual description "
53                         "of the object." )]
54                  string Description;
55               
56                     [Description ( 
57                         "A user-friendly name for the object. This property "
58                         "allows each instance to define a user-friendly name in "
59                         "addition to its key properties, identity data, and "
60                         "description information. \n"
61                         "Note that the Name property of ManagedSystemElement is "
62                         "also defined as a user-friendly name. But, it is often "
63                         "subclassed to be a Key. It is not reasonable that the "
64 karl  1.1.2.2           "same property can convey both identity and a "
65                         "user-friendly name, without inconsistencies. Where Name "
66                         "exists and is not a Key (such as for instances of "
67                         "LogicalDevice), the same information can be present in "
68                         "both the Name and ElementName properties. Note that if "
69                         "there is an associated instance of "
70                         "CIM_EnabledLogicalElementCapabilities, restrictions on "
71                         "this properties may exist as defined in ElementNameMask "
72                         "and MaxElementNameLen properties defined in that class." )]
73                  string ElementName;
74               
75               
76               };