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.3 and 1.4

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

version 1.4, 2002/04/05 10:32:42

Line 13

<o:DocumentProperties>

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

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

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

<o:Revision>14</o:Revision>

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

<o:TotalTime>305</o:TotalTime>

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

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

<o:LastSaved>2002-03-31T14:33:00Z</o:LastSaved>

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

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

<o:Words>3428</o:Words>

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

<o:Characters>19540</o:Characters>

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

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

<o:Lines>162</o:Lines>

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

<o:Paragraphs>39</o:Paragraphs>

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

<o:CharactersWithSpaces>23996</o:CharactersWithSpaces>

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

</o:DocumentProperties>

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

Line 90

17 Feb 2002, V 0.2, KS

19 Feb 2002 V 0.3 KS – Extended the definition of work for

19 Feb 2002 V 0.3 KS – Extended the definition of work for Pegasus

pegasus

29 March Status updated

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

This table defines the qualifiers that are valid for CIM effective

This table defines the qualifiers that are valid for CIM

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

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

2.2.1). It does not yet cover

addendum 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 from the existing documentation and then to define the state of

Line 265

Line 266

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

Not sure at this point

We have to add validations to the create functions.

</td>

</tr>

<tr>

Line 324

Line 325

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

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

Possible extra validation for valid use of this type.

Disallow instance

creation of abstract types

</td>

</tr>

<tr>

Line 372

Line 375

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 are

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

used together – Aggregation qualifying the association, and Aggregate

are used together – Aggregation qualifying the association, and Aggregate

specifying the "parent"

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

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

Line 388

Line 391

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

Resolution – See aggregate qualifier.

Resolution – See aggregation qualifier.

</td>

</tr>

<tr>

Line 505

Line 508

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

TBD- Until we understand future

We will ignore this qualifier based on the proposal that

it be deprecated.

</td>

</tr>

<tr>

Line 573

Line 577

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

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

Resolution – Add test - Should only apply to property that

is an array

is an array??

Check to see if really ordered or indexed if this type

set.

Need to put in a check for unordered insertions

Line 636

Line 640

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

Resolution – Test for existence of bitvalues

Resolution – Test for existence of bitvalues qualifier.

</td>

</tr>

<tr>

Line 681

Line 685

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

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

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

See the description for the BitMap qualifier.<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 881

Line 885

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>

No Action Required

</td>

</tr>

<tr>

Line 939

Line 943

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>

No action required

</td>

</tr>

<tr>

Line 981

Line 985

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

When applied to a string property or method, the DN

When applied to a string property or method, the DN qualifier

qualifier specifies that the string must be a<span style="mso-spacerun:

specifies that the string must be a

yes"> distinguished name as defined in section 9 of X.501.

distinguished name as defined in section 9 of X.501.

</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 1043

Line 1047

properties and method parameters. In indiates that the qualified entity

contains an encoding of an instance’s data. At this time the DMTF defines

twoo possible encodings – character striing encoded in MOF (INSTANCE OF abc

{…}: or an XML representation (<INSTANCECLASSNAME=”abc”>…</INSTANCE>).

{…}: or an XML representation

It is desirable that the encoding of the embedded object data match the

(<INSTANCECLASSNAME=”abc”>…</INSTANCE>). It is desirable that the

encoding of the instance/indication that contains this property or method

encoding of the embedded object data match the encoding of the

parameter. This allows the same parsing engine that decodes the instance/indication

instance/indication that contains this property or method parameter. This

envelope to decode the EmbeddedObject string. (However, encodings are defined

allows the same parsing engine that decodes the instance/indication envelope

by an implementation and are not the subject of this document). Please see

to decode the EmbeddedObject string. (However, encodings are defined by an

Appendis H for examples and furher

implementation and are not the subject of this document). Please see Appendis

H for examples and furher

explanation.

</td>

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

Line 1072

Line 1077

We need to add validation to assure that the object is

XML.

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

NOTE: This qualifier not needed in V2 Pegasus

NOTE: This qualifier not needed in V2 Pegasus. The above

is for 2.1 and after

</td>

</tr>

<tr>

Line 1131

Line 1137

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>

Nothing planned for version 2

</td>

</tr>

<tr>

Line 1174

Line 1180

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

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

.Applicable

only to integer types. Represents an integer which may increase or decrease

only to integer types. Represents an integer which may increase or decrease in

in any order or magnitude. The value of a Gauge is capped at the implied

any order or magnitude. The value of a Gauge is capped at the implied limits

limits of the effected property’s datatype. If and while the information

of the effected property’s datatype. If and while the information being

being modeled exceeds an implied limit, the value represented will instead be

modeled exceeds an implied limit, the value represented will instead be that

that limit; values do not wrap. For unsigned integers, the limits are zero

limit; values do not wrap. For unsigned integers, the limits are zero (0) to

(0) to 2^n-1, inclusive. For signed integers, the limits are –(2^(n-1)) to 2^(n-1)-1,

2^n-1, inclusive. For signed integers, the limits are –(2^(n-1)) to

inclusive. N can be 8, 16, 32, or 64 depending on the datatype of the

2^(n-1)-1, inclusive. N can be 8, 16, 32, or 64 depending on the datatype of

property to which the qualifier is applied. <span

the property to which the qualifier is applied.

style='color:black'>

</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 1296

Line 1302

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

Reference Indicates that the property is part of the

Reference Indicates that the property is part of the namespace

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

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

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

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

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

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

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

Line 1366

Line 1372

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

color:black'>2.5.6 for more

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

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

Line 1622

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 reference

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

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

reference (i.e. the minimum 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,

association relates A instances to B

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

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

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

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

10.0pt;color:black'><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 1928

Line 1934

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

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

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

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

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

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

applicable to the ValueMap qualifier. Note this qualifier cannot be

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

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

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

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

that of the superclass.<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 2111

Line 2116

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

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

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

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 2147

Line 2152

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

Part of general create class validation and processing

that we may need to extend. Verify

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

Treated as part of cimclass::resolve.

ACTION: Review:

</td>

</tr>

<tr>

Line 2684

Line 2688

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

<span

style='font-size:9.0pt;color:navy'>Indicate that the class can have no

subclasses. If such a subclass is declared the compiler will generate an

subclasses. If such a subclass is declared the compiler will generate an error.

error. Note this qualifier cannot coexist with the Abstract qualifier. If

Note this qualifier cannot coexist with the Abstract qualifier. If both are

both are specified the compiler generates an error.<span

specified the compiler generates an error.<span style='font-size:10.0pt;

style='font-size: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 2808

Line 2812

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

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

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

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

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

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

Line 2887

Line 2891

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'>Provides translation between an integer

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

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

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

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

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

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

Line 3008

Line 3012

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 keys of the referenced class

style='font-size:9.0pt'>Indicates that the keys of the referenced class include

include the keys of the other participants in the association. This qualifier

the keys of the other participants in the association. This qualifier is used

is used when the identity of the<o:p></o:p>

when the identity of the<o:p></o:p>

<span

style='font-size:9.0pt'>referenced class depends on the identity of the other

participants in the association. No more than one reference to any given

Line 3174

Line 3178

<span

style='font-size:9.0pt'>Usage Rule:

Applications must to chase associations according to the modeled semantic and

delete objects appropriately. Note: This usage rule must be verified when

delete objects appropriately. Note: This usage rule must be verified when the

the CIM security model is defined.<o:p></o:p>

CIM security model is defined.<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 3718

Line 3722

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 having

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

a valid or meaningful value. The

having 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 3786

Line 3790

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 unsupported – that is

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

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

that is 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

style='font-size:9.0pt;color:navy'>meaningful value. The conventions and

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

<span

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

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

same as those applicable to the ValueMap qualifier.<o:p></o:p>

as those applicable to the ValueMap qualifier.<o:p></o:p>

<span

style='font-size:9.0pt;color:navy'>Note this qualifier cannot be overridden

as it seems unreasonable to permit a<o:p></o:p>

Legend:

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

No CVS admin address has been configured