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           */
25           /** @name CIM Objects in Pegasus
26           
27           The Common Information model (CIM) consists of a number of basic objects
28           defined in the CIM specification.  This includes:
29           <UL>
30           <LI>Classes \Ref{CLASS}
31           <LI>Instances of Classes \Rf{REFERENCE}
32           <LI>Qualifiers \Ref{QUALIFIER}
33           <LI>Properties
34           <LI>Methods
35           <LI>Arrays
36           </UL>
37           Pegasus implements representations of these objects in C++ classes and
38           provides methods for creation, manipulation, and deletion of the objects.
39           
40           
41           In addition, Pegasus implements a number of the key concepts built into CIM as objects including:
42           <UL>
43 mike  1.2 <LI> Scope
44           <LI> Flavor
45           <LI>Object Path
46           <LI>etc.
47           </UL>
48           
49           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.
50           
51           Each Pegasus CIM C++ Object representation includes:
52           
53           <UL>
54           <LI>TConstructors and destructors
55           <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.
56           <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.
57           <LI>Methods for comparison
58           <LI>Methods for cloning
59           <LI>Methods to convert the object to XML
60           <LI>Methods to convert the object to MOF (Planned)
61           </UL>
62           There is a class for every major CIM object and concept as shown in the table in \Ref{CIM Object Table}
63           */