1 krisbash 1.1 // Copyright (c) 2008 DMTF.  All rights reserved.
 2                 [Version ( "2.19.0" ), 
 3                  UMLPackagePath ( "CIM::Core::Collection" ), 
 4                  Description ( 
 5                     "A concrete version of Collection. This class represents a "
 6                     "generic and instantiable collection, such as a group of "
 7                     "ComputerSystems (for example, a pool of hosts available for "
 8                     "executing jobs). It is defined as a concrete subclass of the "
 9                     "abstract CIM_Collection class, to be used in place of many "
10                     "specific subclasses that add no semantics. Note that when "
11                     "defining additional semantics for Collection, this class must "
12                     "not be subclassed. Specific semantics continue to be defined "
13                     "as subclasses of the abstract CIM_Collection. "
14                     "ConcreteCollection is limited in its use as a concrete form of "
15                     "a general collection or bag. It was deemed more prudent to "
16                     "create this concrete subclass than to change Collection from "
17                     "an abstract to a concrete class." )]
18              class CIM_ConcreteCollection : CIM_Collection {
19              
20                    [Key, Override ( "InstanceID" ), 
21                     Description ( 
22 krisbash 1.1           "Within the scope of the instantiating Namespace, "
23                        "InstanceID opaquely and uniquely identifies an instance "
24                        "of this class. To ensure uniqueness within the "
25                        "NameSpace, the value of InstanceID should be constructed "
26                        "using the following \'preferred\' algorithm: \n"
27                        "<OrgID>:<LocalID> \n"
28                        "Where <OrgID> and <LocalID> are separated by a colon "
29                        "\':\', and where <OrgID> must include a unique name. It "
30                        "can be a copyrighted, trademarked, or otherwise unique "
31                        "name that is owned by the business entity that is "
32                        "creating or defining the InstanceID. Or, it could be a "
33                        "registered ID that is assigned to the business entity by "
34                        "a recognized global authority.(This requirement is "
35                        "similar to the <Schema Name>_<Class Name> structure of "
36                        "Schema class names.) In addition, to ensure uniqueness "
37                        "<OrgID> must not contain a colon (\':\'). When using "
38                        "this algorithm, the first colon to appear in InstanceID "
39                        "must appear between <OrgID> and <LocalID>. \n"
40                        "\n"
41                        "<LocalID> is chosen by the business entity and should "
42                        "not be re-used to identify different underlying "
43 krisbash 1.1           "(real-world) elements. If the above \'preferred\' "
44                        "algorithm is not used, the defining entity must ensure "
45                        "that the resulting InstanceID is not re-used as any of "
46                        "the InstanceIDs produced by this or other providers for "
47                        "the NameSpace of this instance." )]
48                 string InstanceID;
49              
50              
51              };