1 karl  1.1 /*

  2 karl  1.2 	$Log: definitions.dxx,v $

  3 karl  1.5 	Revision 1.4  2001/02/05 14:14:00  karl
  4           	doc++ extension for respository
  5           	

  6 karl  1.4 	Revision 1.3  2001/02/02 18:48:20  karl
  7           	Doc++ expansion
  8           	

  9 karl  1.3 	Revision 1.2  2001/01/30 23:38:18  karl
 10           	Add to documentation
 11           	

 12 karl  1.2 	Revision 1.1  2001/01/24 14:18:49  karl
 13           	import Dev Doc Files
 14           	
 15           	$Author: karl $

 16 karl  1.1 */
 17           /** @name Definition of Terms

 18 karl  1.4 This section provides definitions of terms and concepts used in the specification of the  DMTF CIM and WBEM specifications and of the Pegasus Managability Services Broker and its implementation.

 19 karl  1.1 

 20 karl  1.5 <B>Namespace</B>\Label{NAMESPACE} - An object that defines a scope within which object keys must be unique.

 21 karl  1.1 
 22           <B>CIMOM</B> \Label{CIMOM} = TBD Definition of Namespace

 23 karl  1.2 

 24 karl  1.3 <B>Repository</B> \Label{} - The CIM Repository stores the CIM metaschema (class repository) and instance information (instance repository). TheRepository is provided as part of the reference implementation,  but is considered an independent service for the CIMOM. The interfaces to the respository are fixed but the supplied respository can be replaced with a different implementation.

 25 karl  1.2 
 26           <B>PROPERTY</B> \Label{PROPERTY} - ATTN:
 27           
 28           <B>FLAVOR</B> \Label{FLAOVOR - ATTN:
 29           
 30           <B>CIM INSTANCE</B> \Label{CIMINSTANCE} - ATTN:
 31           

 32 karl  1.5 

 33 karl  1.3 
 34           <B>MOF</B> \Label{MOF} - MOF is the standard language used to define elements of the Common Information Model (CIM). The MOF language specifies syntax for defining CIM classes and instances. Compilation of MOF files provides developers and administrators with a simple and fast technique for modifying the CIM Repository. For more information about MOF, see the DMTF web page at http://www.dmtf.org.

 35 karl  1.2 
 36           <B>Association</B> \Label{ASSOCIATION} -An association is a relationship between two classes or between instances of two classes. The properties of an association class include pointers, or references, to the two classes or instances.
 37           

 38 karl  1.4 Class association is one of the most powerful CIM features. It provides a way to organize a collection of management objects into meaningful relationships. For example, a CIM_ComputerSystem object might contain a CIM_Disk, Processor A, and Processor B. The CIM_ComputerSystem has an association with each of the objects it contains. Because this particular association is a containment association, it is represented by a class called CIM_contains. The CIM_contains class contains references to each of the objects that belong to the association. In this case, CIM_contains has a reference to Solaris_Disk and a reference to CIM_ComputerSystem.

 39 karl  1.2 
 40           <B>WBEM</B> \Label{WBEM} - ATTN:
 41           
 42           <B>DMTF</B> \Label{DMTF} - The Distributed Management Task Force (DMTF), a group representing corporations in the computer and telecommunications industries, is leading the effort to develop and disseminate standards for management of desktop environments, enterprise-wide systems, and the Internet. The goal of the DMTF is to develop an integrated approach to managing networks across platforms and protocols, resulting in cost-effective products that interoperate as flawlessly as possible. For information about DMTF initiatives and outcomes, see the DMTF web site at http://www.dmtf.org.
 43           
 44           <B>MOF</B> \Label{MOF} - MOF is the standard language used to define elements of the Common Information Model (CIM). The MOF language specifies syntax for defining CIM classes and instances. Compilation of MOF files provides developers and administrators with a simple and fast technique for modifying the CIM Repository. For more information about MOF, see the DMTF web page at http://www.dmtf.org.
 45           
 46           <B>XmlCIM</B> \Label{XMLCIM} - ATTN: The XML Schema describes the CIM metaschema. The CIM classes and instances are valid XML documents.
 47           
 48           A Metaschema Mapping is one where the XML schema is used to describe the CIM metaschema, and both CIM classes and instances are valid XML documents for that schema. In this case, the DTD is used to describe, in a generic fashion, the notion of a CIM class or instance. CIM element names are mapped to XML attribute or element values. An alternate mechanism maps XML documents directly to CIM schema classes and instances. In this case, CIM element names are mapped to XML element names The advantages of the XML descriptions are: Only one DTD needs to be defined Avoids the limitations of DTD's (ordering, scoping, and no inheritance) Straightforward
 49           
 50           For more detailed information on the mapping of XML to CIM schema, see
 51           http://www.dmtf.org/download/spec/xmls/CIM_XML_Mapping20.htm and
 52           http://www.dmtf.org/download/spec/xmls/CIM_HTTP_Mapping10.htm.
 53           1.5 Managed Object Format
 54           
 55           
 56           <B>QUALIFIERR</B> \Label{qualifier} - Qualifiers
 57               are values that provide additional information about classes, associations,
 58               indications, methods, method parameters, triggers, instances, properties or
 59               references. All qualifiers have a name, type, value, scope, flavor and default value. Qualifiers cannot be duplicated; there cannot be more than one qualifier of the same name for any given class, instance, or property.
 60 karl  1.2     
 61               Qualifiers are defined in detail in the DMTF CIM Specificaiton.
 62               
 63               There are several types of Qualifiers as listed below:
 64               <UL>
 65               <LI><B>Meta-Qualifiers</B> - (ASSOCIATION,INDICATION are the MetaQualifiers) are used to refine the definition of the meta constructs in the model. These qualifiers are used to refine the actual usage of an object class or property declaration within the MOF syntax.
 66               
 67               <LI><B>StandardQualifiers</B> -(See CIM Specificaiton for a list) All CIM-compliant implementations are required to handle. Any given object will not have all of the qualifiers listed.
 68               
 69               <LI><B>Optional Qualifiers</B> - The optional qualifiers listed in the CIM Specificaiton address situations that are not common to all CIM-compliant
 70           implementations. Thus, CIM-compliant implementations can ignore optional
 71           qualifiers since they are not required to interpret or understand these qualifiers.
 72           
 73           PEGASUS Implements the following optional Qualifiers - ATTN:
 74               
 75               <LI>User Defined Qualifiers</B> - The user can define any additional arbitrary named qualifiers. However, the CIM specificaiton recommends that
 76           only defined qualifiers be used, and that the list of qualifiers be extended only if there is no other way to accomplish a particular objective.
 77               
 78               </UL>
 79               ATTN: Should we include the table of qualifiers?????
 80           
 81 karl  1.2 <B>Aggregation</B> \Label{Aggregation } -A strong form of an association. For example, the containment relationship between a system and the components that make up the system can be called an aggregation. An aggregation is expressed as a Qualifier on the association class. Aggregation often implies, but does not require, that the aggregated objects have mutual dependencies.
 82           
 83            <B>Association</B> \Label{Association} - A class that expresses the relationship between two other classes. The relationship is established by the presence of two or more references in the association class pointing to the related classes.
 84           
 85           <B>Cardinality</B> \Label{Cardinality} -  A relationship between two classes that allows more than one object to be related to a single object. For example, Microsoft Office* is made up of the software elements Word, Excel, Access and PowerPoint.
 86           
 87           <B>CIM</B> \Label{CIM} -  Common Information Model is the schema of the overall managed environment. It is divided into a Core model, Common model and extended schemas. CIM Schema The schema representing the Core and Common models. Versions of this schema will be released by the DMTF over time as the schema evolves.
 88           

 89 karl  1.4 <B>Class</B> \Label{CLASSDEFINITION} -  A collection of instances, all of which support a common type; that is, a set of properties and methods. The common properties and methods are defined as features of the class. For example, the class called Modem represents all the modems present in a system. Common model A collection of models specific to a particular area, derived from the Core model. Included are the system model, the application model, the network model and the device model.

 90 karl  1.2 
 91           <B>Core model</B> \Label{Core model} -  A subset of CIM, not specific to any platform. The Core model is set of classes and associations that establish a conceptual framework for the schema of the rest of the managed environment. Systems, applications, networks and related information are modeled as extensions to the Core model.
 92           
 93           <B>Domain</B> \Label{Domain} -  A virtual room for object names that establishes the range in which the names of objects are unique.
 94           
 95           <B>Explicit Qualifier</B> \Label{Explicit Qualifier} -  A qualifier defined separately from the definition of a class, property or other schema element (see implicit qualifier). Explicit qualifier names must be unique across the entire schema. Implicit qualifier names must be unique within the defining schema element; that is, a given schema element may not have two qualifiers with the same name.
 96           
 97           <B>Extended schema</B> \Label{Extended schema} -  A platform specific schema derived from the Common model. An example is the Win32 schema.
 98           
 99           <B>Feature</B> \Label{Feature} -  A property or method belonging to a class.
100           
101           <B>Flavor</B> \Label{Flavor} -  Part of a qualifier spcification indicating overriding and inheritance rules. For example, the qualifier KEY has Flavor(DisableOverride ToSubclass), meaning that every subclass must inherit it and cannot override it.
102           
103           <B>Implicit Qualifier</B> \Label{Implicit Qualifier} -  A qualifier defined as a part of the definition of a class, property or other schema element (see explicit qualifier).
104           
105           <B>Indication</B> \Label{Indication} - A type of class usually created as a result of the occurrence of a trigger.
106           
107           <B>Inheritance</B> \Label{Inheritance} -  A relationship between two classes in which all the members of the subclass are required to be members of the superclass. Any member of the subclass must also support any method or property supported by the superclass. For example, Modem is a subclass of Device.
108           
109           <B>Instance</B> \Label{Instance} -  A unit of data. An instance is a set of property values that can be uniquely identified by a key.
110           
111 karl  1.2 <B>Key</B> \Label{Key} -  One or more qualified class properties that can be used to construct a name. One or more qualified object properties which uniquely identify instances of this object in a namespace.
112           
113           <B>Managed Object</B> \Label{Managed Object} - The actual item in the system environment that is accessed by the provider. For example, a Network Interface Card.
114           
115           <B>Meta model</B> \Label{Meta model} -  A set of classes, associations and properties that expresses the types of things that can be defined in a Schema. For example, the meta model includes a class called property which defines the properties known to the system, a class called method which defines the methods known to the system, and a class called class which defines the classes known to the system.
116           
117           Meta schema<B>Meta schema</B> \Label{Meta schema} -  The schema of the meta model. Method A declaration of a signature; that is, the method name, return type and parameters, and, in the case of a concrete class, may imply an implementation.
118           

119 karl  1.5 <B>METHOD</B> \Label{METHOD} - Methods represent the behavior relevant for a class. A method is defined as an operation together with its signature. The signature consists of a possibly empty list of parameters and a return type.
120           
121           A declaration of a signature; that is, the method name, return type and parameters, and, in the case of a concrete class, may imply an implementation.
122           
123           <B>Model</B> \Label{MODEL} - A set of classes, properties and associations that allows the expression of information about a specific domain. For example, a Network may consist of Network Devices and Logical Networks. The Network Devices may have attachment associations to each other, and may have member associations to Logical Networks.

124 karl  1.2 

125 karl  1.5 <B>Model Path</B> \Label{Model Path} -  A reference to an object within a namespace. Namespace An object that defines a scope within which object keys must be unique.

126 karl  1.2 
127           <B>Namespath Path</B> \Label{Namespath Path} -  A reference to a namespace within an implementation that is capable of hosting CIM objects.
128           
129           <B>Name</B> \Label{Name} -  Combination of a Namespace path and a Model path that identifies a unique object.
130           
131           <B>Trigger</B> \Label{Trigger} -  The occurrence of some action such as the creation, modification or deletion of an object, access to an object, or modification or access to a property. Triggers may also be fired as a result of the passage of a specified period of time. A trigger typically results in an Indication.
132           
133           <BPolymorphism></B> \Label{Polymorphism} -  A subclass may redefine the implementation of a method or property inherited from its superclass. The property or method is thereby redefined, even if the superclass is used to access the object. For example, Device may define availability as a string, and may return the values “powersave”, "on" or "off." The Modem subclass of Device may redefine (override) availability by returning "on," "off," but not "powersave". If all Devices are enumerated, any Device that happens to be a modem will not return the value "powersave" for the availability property.
134           
135           <B>Property</B> \Label{Property} -  A value used to characterize an instance of a class. For example, a Device may have aproperty called status.
136           
137           <B>Provider</B> \Label{Provider} -  An executable that can return or set information about a given managed object. Qualifier A value used to characterize a method, property, or class in the meta schema. For example, if a property has the qualifier KEY with the value TRUE, the property is a key for the class.
138           
139           <B>Reference</B> \Label{Reference} -  Special property types that are references or "pointers" to other instances.
140           
141           <B>Schema</B> \Label{Schema} -  A namespace and unit of ownership for a set of classes. Schemas may come in forms such as a text file, information in a repository, or diagrams in a CASE tool.
142           
143           <B>Scope</B> \Label{}Scope -  Part of a Qualifier specification indicating with which meta constructs the Qualifier can be used. For example, the Qualifier ABSTRACT has Scope(Class Association Indication), meaning that it can only be used with Classes, Associations and Indications.
144           
145           <B>Scoping Object</B> \Label{ScopingObject} -  Objects which represent a real-world managed element, which in turn propagate keys to other objects.
146           
147 karl  1.2 <B>Signature</B> \Label{Signature} -  The return type and parameters supported by a method.
148           
149           <B>Subclass</B> \Label{Subclass} -  See Inheritance.
150           
151           <B>Superclass</B> \Label{Superclass} -  See Inheritance.
152           
153           <B>Top Level Object</B> \Label{TopLevelObject} -  A class or object that has no scoping object.

154 karl  1.1 */
155           //@{
156           
157           /** @name NAMESPACE. 

158 karl  1.5 Defintion of the namespace.

159 karl  1.1 */
160           
161           
162           //@}
163           
164           
165