/* $Log: definitions.dxx,v $ Revision 1.4 2001/02/05 14:14:00 karl doc++ extension for respository Revision 1.3 2001/02/02 18:48:20 karl Doc++ expansion Revision 1.2 2001/01/30 23:38:18 karl Add to documentation Revision 1.1 2001/01/24 14:18:49 karl import Dev Doc Files $Author: karl $ */ /** @name Definition of Terms 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. Namespace\Label{NAMESPACE} - TBD definition of Namespace CIMOM \Label{CIMOM} = TBD Definition of Namespace Repository \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. PROPERTY \Label{PROPERTY} - ATTN: FLAVOR \Label{FLAOVOR - ATTN: CIM INSTANCE \Label{CIMINSTANCE} - ATTN: METHOD \Label{METHOD} - ATTN: MOF \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. Association \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. 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. WBEM \Label{WBEM} - ATTN: DMTF \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. MOF \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. XmlCIM \Label{XMLCIM} - ATTN: The XML Schema describes the CIM metaschema. The CIM classes and instances are valid XML documents. 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 For more detailed information on the mapping of XML to CIM schema, see http://www.dmtf.org/download/spec/xmls/CIM_XML_Mapping20.htm and http://www.dmtf.org/download/spec/xmls/CIM_HTTP_Mapping10.htm. 1.5 Managed Object Format QUALIFIERR \Label{qualifier} - Qualifiers are values that provide additional information about classes, associations, indications, methods, method parameters, triggers, instances, properties or 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. Qualifiers are defined in detail in the DMTF CIM Specificaiton. There are several types of Qualifiers as listed below: ATTN: Should we include the table of qualifiers????? Aggregation \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. Association \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. Cardinality \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. CIM \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. Class \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. Core model \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. Domain \Label{Domain} - A virtual room for object names that establishes the range in which the names of objects are unique. Explicit Qualifier \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. Extended schema \Label{Extended schema} - A platform specific schema derived from the Common model. An example is the Win32 schema. Feature \Label{Feature} - A property or method belonging to a class. Flavor \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. Implicit Qualifier \Label{Implicit Qualifier} - A qualifier defined as a part of the definition of a class, property or other schema element (see explicit qualifier). Indication \Label{Indication} - A type of class usually created as a result of the occurrence of a trigger. Inheritance \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. Instance \Label{Instance} - A unit of data. An instance is a set of property values that can be uniquely identified by a key. Key \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. Managed Object \Label{Managed Object} - The actual item in the system environment that is accessed by the provider. For example, a Network Interface Card. Meta model \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. Meta schemaMeta schema \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. Model \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. Model Path \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. Namespath Path \Label{Namespath Path} - A reference to a namespace within an implementation that is capable of hosting CIM objects. Name \Label{Name} - Combination of a Namespace path and a Model path that identifies a unique object. Trigger \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. \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. Property \Label{Property} - A value used to characterize an instance of a class. For example, a Device may have aproperty called status. Provider \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. Reference \Label{Reference} - Special property types that are references or "pointers" to other instances. Schema \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. Scope \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. Scoping Object \Label{ScopingObject} - Objects which represent a real-world managed element, which in turn propagate keys to other objects. Signature \Label{Signature} - The return type and parameters supported by a method. Subclass \Label{Subclass} - See Inheritance. Superclass \Label{Superclass} - See Inheritance. Top Level Object \Label{TopLevelObject} - A class or object that has no scoping object. */ //@{ /** @name NAMESPACE. Defintion of thamespace. */ //@}