1 marek 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 marek 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 marek 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 marek 1.1 };