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