1 karl  1.1.2.2 // 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 karl  1.1.2.2           "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 karl  1.1.2.2           "(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               };