pegasus/doc/WorkPapers/PegasusQualifiers.htm - diff

Return to PegasusQualifiers.htm CVS log

Up to [Pegasus] / pegasus / doc / WorkPapers

Diff for /pegasus/doc/WorkPapers/PegasusQualifiers.htm between version 1.2 and 1.3

version 1.2, 2002/02/20 19:43:49

version 1.3, 2002/02/28 08:17:24

Line 13

<o:DocumentProperties>

<o:Author>Karl</o:Author>

<o:LastAuthor>Karl</o:LastAuthor>

<o:Revision>12</o:Revision>

<o:Revision>13</o:Revision>

<o:TotalTime>289</o:TotalTime>

<o:TotalTime>294</o:TotalTime>

<o:Created>2002-02-19T16:31:00Z</o:Created>

<o:LastSaved>2002-02-20T19:42:00Z</o:LastSaved>

<o:LastSaved>2002-02-25T09:44:00Z</o:LastSaved>

<o:Pages>7</o:Pages>

<o:Words>3281</o:Words>

<o:Words>3388</o:Words>

<o:Characters>18707</o:Characters>

<o:Characters>19313</o:Characters>

<o:Company>Inova</o:Company>

<o:Lines>155</o:Lines>

<o:Lines>160</o:Lines>

<o:Paragraphs>37</o:Paragraphs>

<o:Paragraphs>38</o:Paragraphs>

<o:CharactersWithSpaces>22973</o:CharactersWithSpaces>

<o:CharactersWithSpaces>23717</o:CharactersWithSpaces>

<o:Version>9.4402</o:Version>

</o:DocumentProperties>

</xml><![endif]--><!--[if gte mso 9]><xml>

Line 95

<![if !supportEmptyParas]> <![endif]><o:p></o:p>

This table defines the qualifiers that are valid for CIM

This table defines the qualifiers that are valid for CIM effective

effective with the CIM Specification 2.2.1 (specification 2.2, errata, and

with the CIM Specification 2.2.1 (specification 2.2, errata, and addendum

addendum 2.2.1). It does not yet cover

2.2.1). It does not yet cover

extensions for CIM specification 2.3.

That will be added. We have attempted to define the qualifier and its characteristics

That will be added. We have attempted to define the qualifier and its

from the existing documentation and then to define the state of usage of the

characteristics from the existing documentation and then to define the state of

qualifier in Pegasus and any work needed for Pegasus 2.0. This document does

usage of the qualifier in Pegasus and any work needed for Pegasus 2.0. This

not yet define the changes at module level but the majority of the extensions

document does not yet define the changes at module level but the majority of

are expected to be between the CIM Operations processors (request dispatcher

the extensions are expected to be between the CIM Operations processors

and response module) and the compiler.

(request dispatcher and response module) and the compiler.<span

The remaning question is what special support must we supply for

style="mso-spacerun: yes"> The remaning question is what special

management, manipulation, validation of qualifiers for providers.

support must we supply for management, manipulation, validation of qualifiers

for providers.

<![if !supportEmptyParas]> <![endif]><o:p></o:p>

Line 371

Line 372

style='font-size:9.0pt;color:navy'><![if !supportEmptyParas]> <![endif]><o:p></o:p>

<span

style='font-size:9.0pt;color:navy'>Usage Rule: <span

style='font-size:9.0pt;color:navy'>The Aggregation and Aggregate qualifiers

style='font-size:9.0pt;color:navy'>The Aggregation and Aggregate qualifiers are

are used together – Aggregation qualifying the association, and Aggregate

used together – Aggregation qualifying the association, and Aggregate

specifying the "parent"

reference.<o:p></o:p>

<![if !supportEmptyParas]> <![endif]><o:p></o:p>

Line 622

Line 623

style='font-size:9.0pt;color:navy'>Indicates which bit positions are<o:p></o:p>

significant in a

bit map. The position of a specific

value in the BitMap array defines an index

value in the BitMap array defines an

that is used in selecting a string literal from the BitValues array.

index that is used in selecting a string literal from the BitValues array.

</td>

<td width=89 valign=top style='width:66.8pt;border-top:none;border-left:none;

border-bottom:solid windowtext .5pt;border-right:solid windowtext .5pt;

Line 680

Line 681

<span

style='font-size:9.0pt;color:navy'>Provides translation between a bit<o:p></o:p>

<span

style='font-size:9.0pt;color:navy'>position value and an associated string.

style='font-size:9.0pt;color:navy'>position value and an associated string. See

See the description for the BitMap qualifier.<span style='font-size:

the description for the BitMap qualifier.<span style='font-size:10.0pt;

10.0pt;color:black'><o:p></o:p>

color:black'><o:p></o:p>

<![if !supportEmptyParas]> <![endif]><o:p></o:p>

</td>

<td width=89 valign=top style='width:66.8pt;border-top:none;border-left:none;

Line 747

Line 748

<span

style='font-size:9.0pt;color:navy'>to which the qualifier is applied.<o:p></o:p>

<span

style='font-size:9.0pt;color:navy'>Counters have no defined

style='font-size:9.0pt;color:navy'>Counters have no defined "initial"<o:p></o:p>

"initial"<o:p></o:p>

<span

style='font-size:9.0pt;color:navy'>value, and thus, a single value of a

Counter has (in general) no information content<span style='font-size:

Line 771

<tr>

<td width=144 valign=top style='width:107.8pt;border:solid windowtext .5pt;

border-top:none;mso-border-top-alt:solid windowtext .5pt;padding:0in 5.4pt 0in 5.4pt'>

Deprecated

</td>

<td width=114 valign=top style='width:85.8pt;border-top:none;border-left:

none;border-bottom:solid windowtext .5pt;border-right:solid windowtext .5pt;

mso-border-top-alt:solid windowtext .5pt;mso-border-left-alt:solid windowtext .5pt;

padding:0in 5.4pt 0in 5.4pt'>

Null

</td>

<td width=72 valign=top style='width:53.8pt;border-top:none;border-left:none;

border-bottom:solid windowtext .5pt;border-right:solid windowtext .5pt;

mso-border-top-alt:solid windowtext .5pt;mso-border-left-alt:solid windowtext .5pt;

padding:0in 5.4pt 0in 5.4pt'>

<![if !supportEmptyParas]> <![endif]><o:p></o:p>

</td>

<td width=85 valign=top style='width:63.8pt;border-top:none;border-left:none;

border-bottom:solid windowtext .5pt;border-right:solid windowtext .5pt;

mso-border-top-alt:solid windowtext .5pt;mso-border-left-alt:solid windowtext .5pt;

padding:0in 5.4pt 0in 5.4pt'>

<![if !supportEmptyParas]> <![endif]><o:p></o:p>

</td>

<td width=94 valign=top style='width:70.8pt;border-top:none;border-left:none;

border-bottom:solid windowtext .5pt;border-right:solid windowtext .5pt;

mso-border-top-alt:solid windowtext .5pt;mso-border-left-alt:solid windowtext .5pt;

padding:0in 5.4pt 0in 5.4pt'>

Class, association, property

</td>

<td width=66 valign=top style='width:49.8pt;border-top:none;border-left:none;

border-bottom:solid windowtext .5pt;border-right:solid windowtext .5pt;

mso-border-top-alt:solid windowtext .5pt;mso-border-left-alt:solid windowtext .5pt;

padding:0in 5.4pt 0in 5.4pt'>

String array

</td>

<td width=388 valign=top style='width:290.8pt;border-top:none;border-left:

none;border-bottom:solid windowtext .5pt;border-right:solid windowtext .5pt;

mso-border-top-alt:solid windowtext .5pt;mso-border-left-alt:solid windowtext .5pt;

padding:0in 5.4pt 0in 5.4pt'>

<span

style='font-size:9.0pt'>Indicates that the feature to which the qualifier is

attached is tolerated byt not recommended and may be superceded by another.

Existing instrumentation should continue to support deprecated features. The

qualifier serves only as an indication that the feature should not be used in

new development<o:p></o:p>

</td>

<td width=89 valign=top style='width:66.8pt;border-top:none;border-left:none;

border-bottom:solid windowtext .5pt;border-right:solid windowtext .5pt;

mso-border-top-alt:solid windowtext .5pt;mso-border-left-alt:solid windowtext .5pt;

padding:0in 5.4pt 0in 5.4pt'>

Nothing

</td>

<td width=218 valign=top style='width:163.7pt;border-top:none;border-left:

none;border-bottom:solid windowtext .5pt;border-right:solid windowtext .5pt;

mso-border-top-alt:solid windowtext .5pt;mso-border-left-alt:solid windowtext .5pt;

padding:0in 5.4pt 0in 5.4pt'>

No action required.

</td>

</tr>

<tr>

<td width=144 valign=top style='width:107.8pt;border:solid windowtext .5pt;

border-top:none;mso-border-top-alt:solid windowtext .5pt;padding:0in 5.4pt 0in 5.4pt'>

Description

</td>

<td width=114 valign=top style='width:85.8pt;border-top:none;border-left:

Line 1238

Line 1297

mso-border-top-alt:solid windowtext .5pt;mso-border-left-alt:solid windowtext .5pt;

padding:0in 5.4pt 0in 5.4pt'>

Reference Indicates that the property is part of the

namespace handle (see Section 5.3.1.2 for information about namespace

namespace handle (see Section 5.3.1.2 for information about namespace handles).

handles). If more than one property has the KEY qualifier, then all such

If more than one property has the KEY qualifier, then all such properties

properties collectively form the key (a compound key). Usage Rule: Keys

collectively form the key (a compound key). Usage Rule: Keys are

are written once at object instantiation and must not be modified thereafter.

written once at object instantiation and must not be modified thereafter. It

It does not make sense to apply a default value to a KEY-qualified property.

does not make sense to apply a default value to a KEY-qualified property.

Properties which are of an array type must not be qualified with KEY.

</td>

<td width=89 valign=top style='width:66.8pt;border-top:none;border-left:none;

Line 1307

Line 1366

data providers or agents. See Section

2.5.5 <span

style='font-size:9.0pt;color:navy'>and <span style='font-size:9.0pt;

color:black'>2.5.6 for more

color:black'>2.5.6 for more details.<span

details.<o:p></o:p>

style='font-size:10.0pt;color:black'><o:p></o:p>

<![if !supportEmptyParas]> <![endif]><o:p></o:p>

</td>

<td width=89 valign=top style='width:66.8pt;border-top:none;border-left:none;

Line 1365

Line 1424

mso-border-top-alt:solid windowtext .5pt;mso-border-left-alt:solid windowtext .5pt;

padding:0in 5.4pt 0in 5.4pt'>

<span

style='font-size:9.0pt;color:navy'>Indicates the maximum cardinality of the reference

style='font-size:9.0pt;color:navy'>Indicates the maximum cardinality of the

(i.e. the maximum number of values a given reference can have for each set of

reference (i.e. the maximum number of values a given reference can have for

other reference values in the association). For example, if an association

each set of other reference values in the association). For example, if an

relates A instances to B instances, and there must be at most one A instance

association relates A instances to B instances, and there must be at most one

for each B instance, then the reference to A should have a Max(1) qualifier.<span

A instance for each B instance, then the reference to A should have a Max(1)

style='font-size:10.0pt;color:black'><o:p></o:p>

qualifier.<o:p></o:p>

<![if !supportEmptyParas]> <![endif]><o:p></o:p>

</td>

<td width=89 valign=top style='width:66.8pt;border-top:none;border-left:none;

Line 1448

Line 1507

Same as Max

Instance – Should CIMOM check in

<p class=MsoNormal style='margin-left:.25in;text-indent:-.25in;mso-list:l0 level1 lfo2;

tab-stops:list .25in'><![if !supportLists]>1)

<![endif]>requests

<p class=MsoNormal style='margin-left:.25in;text-indent:-.25in;mso-list:l0 level1 lfo2;

tab-stops:list .25in'><![if !supportLists]>2)

<![endif]>Responses

<p class=MsoNormal style='margin-left:.25in;text-indent:-.25in;mso-list:l0 level1 lfo2;

tab-stops:list .25in'><![if !supportLists]>3)

<![endif]><![if !supportEmptyParas]> <![endif]><o:p></o:p>

</td>

</tr>

Line 1557

Line 1616

mso-border-top-alt:solid windowtext .5pt;mso-border-left-alt:solid windowtext .5pt;

padding:0in 5.4pt 0in 5.4pt'>

<span

style='font-size:9.0pt;color:navy'>Indicates the minimum cardinality of the

style='font-size:9.0pt;color:navy'>Indicates the minimum cardinality of the reference

reference (i.e. the minimum number of values a given reference can have for

(i.e. the minimum number of values a given reference can have for each set of

each set of other reference values in the association). For example, if an

other reference values in the association). For example, if an association

association relates A instances to B

relates A instances to B instances,

instances, and there must be at least one A instance for each B

and there must be at least one A instance for each B instance, then the

instance, then the reference to A should have a Min(1) qualifier.<span

reference to A should have a Min(1) qualifier.<span style='font-size:

style='font-size:10.0pt;color:black'><o:p></o:p>

10.0pt;color:black'><o:p></o:p>

<![if !supportEmptyParas]> <![endif]><o:p></o:p>

</td>

<td width=89 valign=top style='width:66.8pt;border-top:none;border-left:none;

Line 1869

Line 1928

padding:0in 5.4pt 0in 5.4pt'>

<span

style='font-size:9.0pt;color:navy'>Defines a value the presence of which

indicates that the associated property is NULL – that is that the property cannot

indicates that the associated property is NULL – that is that the property

be considered as having a valid or meaningful value. The conventions and

cannot be considered as having a valid or meaningful value. The conventions

restrictions used for defining null values are the same as those applicable

and restrictions used for defining null values are the same as those

to the ValueMap qualifier. Note this qualifier cannot be overridden as it

applicable to the ValueMap qualifier. Note this qualifier cannot be

seems unreasonable to permit a subclass to return a different null value to

overridden as it seems unreasonable to permit a subclass to return a

that of the superclass.<o:p></o:p>

different null value to that of the superclass.<span style='font-size:

10.0pt;color:black'><o:p></o:p>

<![if !supportEmptyParas]> <![endif]><o:p></o:p>

</td>

<td width=89 valign=top style='width:66.8pt;border-top:none;border-left:none;

Line 2051

Line 2111

padding:0in 5.4pt 0in 5.4pt'>

<span

style='font-size:9.0pt;color:navy'>Indicates that the property, method, or

reference in the derived class overrides the similar construct (of the same name)

reference in the derived class overrides the similar construct (of the same

in the parent class in the inheritance tree, or in the specified parent

name) in the parent class in the inheritance tree, or in the specified parent

class. The<o:p></o:p>

<span

style='font-size:9.0pt;color:navy'>value of this qualifier MAY identify the

Line 2069

Line 2129

in the parent class in the inheritance tree.<o:p></o:p>

<span

style='font-size:9.0pt;color:navy'>Usage Rule: <span

style='font-size:9.0pt;color:navy'>The Override qualifier can only refer to constructs

style='font-size:9.0pt;color:navy'>The Override qualifier can only refer to

based on the same meta model. Also, it is not allowed to change a construct's

constructs based on the same meta model. Also, it is not allowed to change a

name or signature when overriding.<span style='font-size:10.0pt;

construct's name or signature when overriding.<span style='font-size:

color:black'><o:p></o:p>

10.0pt;color:black'><o:p></o:p>

<![if !supportEmptyParas]> <![endif]><o:p></o:p>

</td>

<td width=89 valign=top style='width:66.8pt;border-top:none;border-left:none;

Line 2640

Line 2700

none;border-bottom:solid windowtext .5pt;border-right:solid windowtext .5pt;

mso-border-top-alt:solid windowtext .5pt;mso-border-left-alt:solid windowtext .5pt;

padding:0in 5.4pt 0in 5.4pt'>

Superclass not terminal on create. Abstract not set if terminal

Superclass not terminal on create. Abstract not set if

set

terminal set

</td>

</tr>

<tr>

Line 2743

Line 2803

mso-border-top-alt:solid windowtext .5pt;mso-border-left-alt:solid windowtext .5pt;

padding:0in 5.4pt 0in 5.4pt'>

<span

style='font-size:9.0pt;color:navy'>NOTE: See the addenda for latest description.

style='font-size:9.0pt;color:navy'>NOTE: See the addenda for latest

The following is from V 2.2 spec.<o:p></o:p>

description. The following is from V 2.2 spec.<o:p></o:p>

<span

style='font-size:9.0pt;color:navy'><![if !supportEmptyParas]> <![endif]><o:p></o:p>

<span

style='font-size:9.0pt;color:navy'>Defines the set of permissible values for

style='font-size:9.0pt;color:navy'>Defines the set of permissible values for this

this property, method return type or method parameter. The ValueMap can be

property, method return type or method parameter. The ValueMap can be used

used alone, or in combination with the Values qualifier. When used in<span

alone, or in combination with the Values qualifier. When used in<span

style="mso-spacerun: yes"> combination with the Values qualifier, the

location of the value in the ValueMap array provides the location of the

corresponding entry in the Values array.<o:p></o:p>

<span

style='font-size:9.0pt;color:navy'>ValueMap may only be used with string and

integer values. The syntax for representing an integer value in the ValueMap array

integer values. The syntax for representing an integer value in the ValueMap

is:<o:p></o:p>

array is:<o:p></o:p>

<span

style='font-size:9.0pt;color:navy'>[+|-]digit[*digit]<o:p></o:p>

<span

Line 2828

Line 2888

padding:0in 5.4pt 0in 5.4pt'>

<span

style='font-size:9.0pt;color:navy'>Provides translation between an integer

value and an associated string. If a ValueMap qualifier is not present, the

value and an associated string. If a ValueMap qualifier is not present, the Values

Values array is indexed (zero relative) using the value in the associated

array is indexed (zero relative) using the value in the associated property,

property, method return type or method parameter. If a ValueMap qualifier is

method return type or method parameter. If a ValueMap qualifier is present,

present, the Values index is defined by the location of the property value in

the Values index is defined by the location of the property value in the

the ValueMap.<o:p></o:p>

ValueMap.<o:p></o:p>

<![if !supportEmptyParas]> <![endif]><o:p></o:p>

</td>

<td width=89 valign=top style='width:66.8pt;border-top:none;border-left:none;

Line 3094

Line 3154

padding:0in 5.4pt 0in 5.4pt'>

<span

style='font-size:9.0pt'>For associations<span style='font-size:

9.0pt'>: Indicates that the qualified association must be deleted if any of the

9.0pt'>: Indicates that the qualified association must be deleted if any of

objects referenced in the association are deleted, AND the respective object

the objects referenced in the association are deleted, AND the respective

referenced in the association is qualified with<o:p></o:p>

object referenced in the association is qualified with<o:p></o:p>

<span

style='font-size:9.0pt'>IFDELETED.<o:p></o:p>

<span

Line 3228

Line 3288

style='font-size:9.0pt'>Indicates that all objects qualified by DELETE within

the association must be<o:p></o:p>

<span

style='font-size:9.0pt'>deleted if the referenced object or the association, respectively,

style='font-size:9.0pt'>deleted if the referenced object or the association,

is deleted.<o:p></o:p>

respectively, is deleted.<o:p></o:p>

<![if !supportEmptyParas]> <![endif]><o:p></o:p>

</td>

<td width=89 valign=top style='width:66.8pt;border-top:none;border-left:none;

Line 3345

Line 3405

mso-border-top-alt:solid windowtext .5pt;mso-border-left-alt:solid windowtext .5pt;

padding:0in 5.4pt 0in 5.4pt'>

<span

style='font-size:9.0pt'>Class Indicates the property or class requires a large

style='font-size:9.0pt'>Class Indicates the property or class requires a

amount of storage space.<o:p></o:p>

large amount of storage space.<o:p></o:p>

<![if !supportEmptyParas]> <![endif]><o:p></o:p>

</td>

<td width=89 valign=top style='width:66.8pt;border-top:none;border-left:none;

Line 3654

Line 3714

mso-border-top-alt:solid windowtext .5pt;mso-border-left-alt:solid windowtext .5pt;

padding:0in 5.4pt 0in 5.4pt'>

<span

style='font-size:9.0pt;color:navy'>Defines a set of values the presence of which

style='font-size:9.0pt;color:navy'>Defines a set of values the presence of

indicates that the value of the associated property is unknown – that is<o:p></o:p>

which indicates that the value of the associated property is unknown – that

is<o:p></o:p>

<span

style='font-size:9.0pt;color:navy'>that the property cannot be considered as

style='font-size:9.0pt;color:navy'>that the property cannot be considered as having

having a valid or meaningful value. The

a valid or meaningful value. The

onventions and restrictions used<o:p></o:p>

<span

style='font-size:9.0pt;color:navy'>for defining unknown values are the same

Line 3725

Line 3786

mso-border-top-alt:solid windowtext .5pt;mso-border-left-alt:solid windowtext .5pt;

padding:0in 5.4pt 0in 5.4pt'>

<span

style='font-size:9.0pt;color:navy'>Defines a set of values the presence of

style='font-size:9.0pt;color:navy'>Defines a set of values the presence of which

which indicates that the value of the associated property is unsupported –

indicates that the value of the associated property is unsupported – that is

that is that the property cannot be<o:p></o:p>

that the property cannot be<o:p></o:p>

<span

style='font-size:9.0pt;color:navy'>considered as having a valid or<o:p></o:p>

<span

Legend:

Removed from v.1.2
changed lines
	Added in v.1.3

No CVS admin address has been configured