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 };