1 karl  1.1.2.1 //%/////////////////////////////////////////////////////////////////////////////
 2               //
 3               // Copyright (c) 2000, 2001 BMC Software, Hewlett-Packard Company, IBM, 
 4               // The Open Group, Tivoli Systems
 5               //
 6               // Permission is hereby granted, free of charge, to any person obtaining a copy
 7               // of this software and associated documentation files (the "Software"), to 
 8               // deal in the Software without restriction, including without limitation the 
 9               // rights to use, copy, modify, merge, publish, distribute, sublicense, and/or 
10               // sell copies of the Software, and to permit persons to whom the Software is
11               // furnished to do so, subject to the following conditions:
12               // 
13               // THE ABOVE COPYRIGHT NOTICE AND THIS PERMISSION NOTICE SHALL BE INCLUDED IN 
14               // ALL COPIES OR SUBSTANTIAL PORTIONS OF THE SOFTWARE. THE SOFTWARE IS PROVIDED
15               // "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT
16               // LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR 
17               // PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT 
18               // HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN 
19               // ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
20               // WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
21               //
22 karl  1.1.2.1 //==============================================================================
23               /*
24                   $Author:
25               */
26               /** @name CIM Objects in Pegasus
27               
28               The Common Information model (CIM) consists of a number of basic objects
29               defined in the CIM specification.  This includes:
30               <UL>
31               <LI>Classes \Ref{CLASS}
32               <LI>Instances of Classes \Rf{REFERENCE}
33               <LI>Qualifiers \Ref{QUALIFIER}
34               <LI>Properties
35               <LI>Methods
36               <LI>Arrays
37               </UL>
38               Pegasus implements representations of these objects in C++ classes and
39               provides methods for creation, manipulation, and deletion of the objects.
40               
41               
42               In addition, Pegasus implements a number of the key concepts built into CIM as objects including:
43 karl  1.1.2.1 <UL>
44               <LI> Scope
45               <LI> Flavor
46               <LI>Object Path
47               <LI>etc.
48               </UL>
49               
50               Much of the programming of the Pegasus object broker, clients, and in particular providers and service extensions in the Pegasus envrinment depends on the use of these C++ representations of CIM Objects and concepts.
51               
52               Each Pegasus CIM C++ Object representation includes:
53               
54               <UL>
55               <LI>TConstructors and destructors
56               <LI>Methods for manipulation of sub-objects.  Thus, the class and instance classes provide for manipulation of the property, qualifier, and method objects that are contained in these classes.
57               <LI>Methods for finding sub-objects. Thus, the class and instance classes provide for finding property, qualifier, and method objects within an instnace of a CIMClass or CIMInstance. These methods are generally built around defining the name of the object to be found and having an index to that object returned.
58               <LI>Methods for comparison
59               <LI>Methods for cloning
60               <LI>Methods to convert the object to XML
61               <LI>Methods to convert the object to MOF (Planned)
62               </UL>
63               There is a class for every major CIM object and concept as shown in the table in \Ref{CIM Object Table}
64 karl  1.1.2.1 */