1 mike  1.2 //%/////////////////////////////////////////////////////////////////////////////
 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 mike  1.2 //==============================================================================
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 mike  1.2 <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 mike  1.2 */