pegasus/doc/DevManual/definitions.dxx - diff

Return to definitions.dxx CVS log

Up to [Pegasus] / pegasus / doc / DevManual

Diff for /pegasus/doc/DevManual/definitions.dxx between version 1.8 and 1.9

version 1.8, 2001/05/27 10:11:50

version 1.9, 2003/11/13 16:02:37

Line 40

TODO LIST

Add classname definition this is alreadyreferences as CLASSNAME

Add classname definition this is alreadyreferenced as CLASSNAME

/** @name Definition of Terms

/** @name Glossary

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.

This section provides definitions of terms and concepts used in the specification of the DMTF CIM and WBEM specifications

or in the definition and documentation of of the OpenPegasus implementation.

Namespace\Label{NAMESPACE} An object that defines a scope within which object keys must be unique. Multiple namespaces typically indicate the presence

of multiple management spaces or multiple devices.

The namespace pragma

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.

<PRE>

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.

#pragma namespace( )

</PRE>

This pragma is used to specify a Namespace path. The syntax

needs to conform to the following:

<PRE>

<namespacetype&gt://<namespacehandle&gt

</PRE>

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.

The contents of a MOF file are loaded into a Namespace that provides a domain (in other words, a container), in which the instances of the classes are guaranteed to be unique per the KEY qualifier definitions. The term namespace is used to refer to an implementation that provides such a domain.

CIM INSTANCE \Label{CIMINSTANCE} -

Namespaces can be used to:

<UL>

<LI>Define chunks of management information (objects and associations) to limit implementation resource requirements, such as database size.

<LI>Define views on the model for applications managing only specific objects, such as hubs.

<LI>Pre-structure groups of objects for optimized query speed.

</UL>

CIMOM \Label{CIMOM} A CIMOM (CIM Object Manager) is the the terminology used to define the implementation of the CIM_Server defined in the CIM Operations over HTTP specification. Typically a CIMOM includes the functions of the CIM Server, repositories, providers and the tools to start, run, etc. the CIM server. CIMOM is an implement term and is not clearly defined in the DMTF documents as opposed to CIM Server which has a clear definition.

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.

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.

PROPERTY \Label{PROPERTY} - ATTN:

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.

FLAVOR \Label{FLAOVOR - ATTN:

CIM INSTANCE \Label{CIMINSTANCE} - ATTN:

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.

FLAVOR \Label{FLAVOR - ATTN:

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 defined by a CIM Class 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 for an instance.

The key uniquely identify instances of this instance in a namespace. Key properties are defined by the existence of the key qualifier attached to the

property. All instances MUST have keys except for those types of instances specifically identified as exceptions in the CIM Specification. This includes

indications which DO NOT have keys because they are transitory and the singleton class which provides for the concept of a class with only one

instance. NOTE: TOday there is an issue with the concept of the singleton class since it is defined only in the cimxm. documentation.

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.

PROPERTY \Label{PROPERTY} - ATTN:

WBEM \Label{WBEM} - ATTN:

XmlCIM \Label{XMLCIM} - ATTN: The XML Schema describes the CIM metaschema. The CIM classes and instances are valid XML documents.

XmlCIM \Label{XMLCIM} - 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

Line 101

Line 120

http://www.dmtf.org/download/spec/xmls/CIM_HTTP_Mapping10.htm.

1.5 Managed Object Format

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 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.

METHOD \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.

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.

Including a method in a class does not guarantee an implementation of the method.

The Implemented qualifier is attached to the method to indicate that an implementation is available for the class.

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.

A reference to an object within a namespace. Namespace An object that defines a scope within which object keys must be unique.

QUALIFIERR \Label{qualifier} - Qualifiers

Namespace\Label{NAMESPACE} An object that defines a scope within which object keys must be unique. Multiple namespaces typically indicate the presence

of multiple management spaces or multiple devices.

The namespace pragma

<PRE>

#pragma namespace( )

</PRE>

This pragma is used to specify a Namespace path. The syntax

needs to conform to the following:

<PRE>

<namespacetype&gt://<namespacehandle&gt

</PRE>

Namespaces can be used to:

<UL>

<LI>Define chunks of management information (objects and associations) to limit implementation resource requirements, such as database size.

<LI>Define views on the model for applications managing only specific objects, such as hubs.

<LI>Pre-structure groups of objects for optimized query speed.

</UL>

QUALIFIER \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.

Line 127

Line 187

</UL>

ATTN: Should we include the table of qualifiers?????

Domain \Label{Domain} - A virtual room for object names that establishes the range in which the names of objects are unique.

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.

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.

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 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.

METHOD \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.

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 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.

Line 200

Line 215

Superclass \Label{Superclass} - See Inheritance.

Top Level Object \Label{TopLevelObject} - A class or object that has no scoping object.

//@{

/** @name NAMESPACE.

Defintion of the namespace.

//@}

Legend:

Removed from v.1.8
changed lines
	Added in v.1.9

No CVS admin address has been configured