cim_concretecollection.mof

Pegasus is an open-source implementationof the DMTF CIM and WBEM standards. It is designed to be por

// Copyright (c) 2005 DMTF.  All rights reserved.
// <change cr="SysDevCR00707.002" type ="add">CPUBS corrections to
// CoreCollection.mof</change>
// <change cr="ArchCR00066.004" type="add">Add UmlPackagePath
// qualifier values to CIM Schema.</change>
// ==================================================================
//  CIM_ConcreteCollection
// ==================================================================
   [UMLPackagePath ( "CIM::Core::Collection" ), Version ( "2.10.0" ), 
    Description (
       "A concrete version of Collection. This class represents a "
       "generic and instantiable collection, such as a group of "
       "ComputerSystems (for example, a pool of hosts available for "
       "executing jobs). It is defined as a concrete subclass of the "
       "abstract CIM_Collection class, to be used in place of many "
       "specific subclasses that add no semantics. Note that when "
       "defining additional semantics for Collection, this class must "
       "not be subclassed. Specific semantics continue to be defined "
       "as subclasses of the abstract CIM_Collection. "
       "ConcreteCollection is limited in its use as a concrete form of "
       "a general collection or bag. It was deemed more prudent to "
       "create this concrete subclass than to change Collection from "
       "an abstract to a concrete class.")]
class CIM_ConcreteCollection : CIM_Collection {

      [Key, Description (
          "Within the scope of the instantiating Namespace, InstanceID "
          "opaquely and uniquely identifies an instance of this class. "
          "To ensure uniqueness within the NameSpace, the value of "
          "InstanceID should be constructed using the following "
          "'preferred' algorithm: \n"
          "<OrgID>:<LocalID> \n"
          "Where <OrgID> and <LocalID> are separated by a colon ':', "
          "and where <OrgID> must include a unique name. It can be a "
          "copyrighted, trademarked, or otherwise unique name that is "
          "owned by the business entity that is creating or defining "
          "the InstanceID. Or, it could be a registered ID that is "
          "assigned to the business entity by a recognized global "
          "authority. (This requirement is similar to the <Schema "
          "Name>_<Class Name> structure of Schema class names.) In "
          "addition, to ensure uniqueness <OrgID> must not contain a "
          "colon (':'). When using this algorithm, the first colon to "
          "appear in InstanceID must appear between <OrgID> and "
          "<LocalID>. \n"
          "\n"
          "<LocalID> is chosen by the business entity and should not "
          "be re-used to identify different underlying (real-world) "
          "elements. If the above 'preferred' algorithm is not used, "
          "the defining entity must ensure that the resulting "
          "InstanceID is not re-used as any of the InstanceIDs "
          "produced by this or other providers for the NameSpace of "
          "this instance.")]
   string InstanceID;
};