1 krisbash 1.1 // 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 krisbash 1.1 "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 krisbash 1.1 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 krisbash 1.1 "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 };
|