1 krisbash 1.1 // Copyright (c) 2008 DMTF. All rights reserved.
2 [Abstract, Version ( "2.19.0" ),
3 UMLPackagePath ( "CIM::Core::Capabilities" ),
4 Description (
5 "Capabilities is an abstract class whose subclasses describe "
6 "abilities and/or potential for use. For example, one may "
7 "describe the maximum number of VLANs that can be supported on "
8 "a system using a subclass of Capabilities. Capabilities are "
9 "tied to the elements which they describe using the "
10 "ElementCapabilities association. Note that the cardinality of "
11 "the ManagedElement reference is Min(1), Max(1). This "
12 "cardinality mandates the instantiation of the "
13 "ElementCapabilities association for the referenced instance of "
14 "Capabilities. ElementCapabilities describes the existence "
15 "requirements and context for the referenced instance of "
16 "ManagedElement. Specifically, the ManagedElement MUST exist "
17 "and provides the context for the Capabilities. Note that "
18 "Capabilities do not indicate what IS configured or "
19 "operational, but what CAN or CANNOT exist, be defined or be "
20 "used. Note that it is possible to describe both supported and "
21 "excluded abilities and functions (both capabilities and "
22 krisbash 1.1 "limitations) using this class." )]
23 class CIM_Capabilities : CIM_ManagedElement {
24
25 [Key, Override ( "InstanceID" ),
26 Description (
27 "Within the scope of the instantiating Namespace, "
28 "InstanceID opaquely and uniquely identifies an instance "
29 "of this class. In order to ensure uniqueness within the "
30 "NameSpace, the value of InstanceID SHOULD be constructed "
31 "using the following \'preferred\' algorithm: \n"
32 "<OrgID>:<LocalID> \n"
33 "Where <OrgID> and <LocalID> are separated by a colon "
34 "\':\', and where <OrgID> MUST include a copyrighted, "
35 "trademarked or otherwise unique name that is owned by "
36 "the business entity creating/defining the InstanceID, or "
37 "is a registered ID that is assigned to the business "
38 "entity by a recognized global authority (This is similar "
39 "to the <Schema Name>_<Class Name> structure of Schema "
40 "class names.) In addition, to ensure uniqueness <OrgID> "
41 "MUST NOT contain a colon (\':\'). When using this "
42 "algorithm, the first colon to appear in InstanceID MUST "
43 krisbash 1.1 "appear between <OrgID> and <LocalID>. \n"
44 "<LocalID> is chosen by the business entity and SHOULD "
45 "not be re-used to identify different underlying "
46 "(real-world) elements. If the above \'preferred\' "
47 "algorithm is not used, the defining entity MUST assure "
48 "that the resultant InstanceID is not re-used across any "
49 "InstanceIDs produced by this or other providers for this "
50 "instance\'s NameSpace. \n"
51 "For DMTF defined instances, the \'preferred\' algorithm "
52 "MUST be used with the <OrgID> set to \'CIM\'." )]
53 string InstanceID;
54
55 [Required, Override ( "ElementName" ),
56 Description (
57 "The user friendly name for this instance of "
58 "Capabilities. In addition, the user friendly name can be "
59 "used as a index property for a search of query. (Note: "
60 "Name does not have to be unique within a namespace.)" )]
61 string ElementName;
62
63
64 krisbash 1.1 };
|