pegasus/cgi/htdocs/Attic/EnumerateInstanceNames.html - diff

Return to EnumerateInstanceNames.html CVS log

Up to [Pegasus] / pegasus / cgi / htdocs / Attic

Diff for /pegasus/cgi/htdocs/Attic/EnumerateInstanceNames.html between version 1.8 and 1.9

version 1.8, 2001/06/30 15:28:09

version 1.9, 2002/01/30 21:56:39

Line 17

The <TT>enumerateInstances</TT> method enumerates instances of a CIM

The <TT>enumerateInstances</TT> CIM Operation enumerates instances of a CIM

Class in the target Namespace.

<p><b><a href="#NameSpace">NameSpace</a></b>

<INPUT TYPE="text" NAME="NameSpace" SIZE=30 VALUE="root/cimv2">  String that defines the target namespace. See <a href="getnamespaces.html">NameSpace

Line 26

name of the Class

for which instance names are to be retrieved.  This must be a legal

class in the repository

<p><b>LocalOnly</b> <INPUT TYPE="checkbox" NAME="LocalOnly" VALUE="true" checked>                       

If true only CIM Elements overridden within definition of class are

returned.

<p><b>IncludeQualifiers</b> <INPUT TYPE="checkbox" NAME="IncludeQualifiers" VALUE="true">            

If checked, show Qualifiers for class and returned Properties, Methods,

and Method Parameters.

<p><b>IncludeClassOrigins</b> <INPUT TYPE="checkbox" NAME="IncludeClassOrigins" VALUE="true">       

If checked (TRUE), CLASSORIGIN attribute will be returned for all

appropriate elements<p><b>PropertyList </b> <INPUT TYPE="text" NAME="PropertyList" SIZE=30 VALUE="NULL">

NOTE: <b> NOT IMPLEMENTED </b>Null or array of property names to filter

request. <a href="#PropertyList">See below</a>.

</form>

Line 71

Line 60

ClassName</a></b> The ClassName input parameter defines the Class that is the

basis for the enumeration. The ClassName input must be in the

repository 

LocalOnly</b></a>  If the <TT>LocalOnly</TT> input parameter is

<TT>true</TT>, this specifies that, for each returned Instance,

only elements (properties and qualifiers) overridden within the

definition of that Instance are included. If <TT>false</TT>,

all elements are returned. This parameter therefore effects a CIM

Server-side mechanism to filter certain elements of the returned object

based on whether or not they have been propagated from the parent

Class (as defined by the <TT>PROPAGATED</TT> attribute).

<p><a name="DeepInheritance"><b>DeepInheritance</b></a> If the <TT>DeepInheritance</TT> input

parameter is <TT>true</TT>, this specifies that, for each

returned Instance of the Class, all properties of the Instance MUST

be present (subject to constraints imposed by the other

parameters), including any which were added by subclassing the specified

Class. If <TT>false</TT>, each returned Instance includes only

properties defined for the specified Class.

<p><a name="IncludeQualifiers"><b>IncludeQualifiers</b></a> If the <TT>IncludeQualifiers</TT> input

parameter is <TT>true</TT>, this specifies that all Qualifiers

for each Instance (including Qualifiers on the Instance

and on any returned Properties) MUST be included as

<TT>QUALIFIER</TT> elements in the response. If false no

<TT>QUALIFIER</TT> elements are present in each

returned Instance.

<p><b><a name="IncludeClassOrigin">IncludeClassOrigin</a></b>  If the <TT>IncludeClassOrigin</TT> input

parameter is <TT>true</TT>, this specifies that the

<TT>CLASSORIGIN</TTT> attribute MUST be present on all appropriate

elements in each returned Instance. If false, no

<TT>CLASSORIGIN</TT> attributes are present in each returned

Instance.</tt>

<p>PropertyList If the <TT>PropertyList</TT> input parameter is not

<TT>NULL</TT>, the members of the array define one or more Property

names.  Each returned Instance MUST NOT include elements

for any Properties missing from this list.  Note that if

<TT>LocalOnly</TT> is specified as <TT>true</TT> (or

<TT>DeepInheritance</TT> is specified as <TT>false</TT>) this acts as an

additional filter on the set of Properties returned (for example,

if Property <TT>A</TT> is included in the

<TT>PropertyList</TT> but <TT>LocalOnly</TT> is set to true and

<TT>A</TT> is not local to a returned Instance, then it will not be

included in that Instance). If the <TT>PropertyList</TT> input parameter

is an empty array this signifies that no Properties are included in each

returned Instance. If the <TT>PropertyList</TT> input parameter is

NULL this specifies that all Properties (subject to the conditions

expressed by the other parameters) are included in each returned

Instance.

If the <TT>PropertyList</TT> contains duplicate elements,

the Server MUST ignore the duplicates but otherwise process the request

normally.  If the <TT>PropertyList</TT> contains elements which are

invalid Property names for any target Instance, the Server MUST

ignore such entries but otherwise process the request normally.

Line 136

Line 69

<PRE>

virtual Array<InstanceDecl> enumerateInstances(

virtual Array<InstanceDecl> enumerateInstanceNames(

const String& nameSpace,

const String& className,

const String& className;

Boolean deepInheritance = true,

Boolean localOnly = true,

Boolean includeQualifiers = false,

Boolean includeClassOrigin = false,

const Array<String>& propertyList = _getStringArray()) = 0;

</PRE>

<hr><p style="margin-top: 0; margin-bottom: 0"> <font size="2">Demonstration

Prepared by the OpenGroup Manageability Work Group Pegasus Development Team</font>

Line 152

Line 80

for more information on Pegasus</font>

<p style="margin-top: 0; margin-bottom: 0"> <font size="1">Last Modified <!--webbot bot="Timestamp" S-Type="EDITED"

S-Format="%A, %B %d, %Y %I:%M:%S %p" startspan -->Monday, March 26, 2001 05:01:59 PM

S-Format="%A, %B %d, %Y %I:%M:%S %p" startspan -->Wednesday, January 30, 2002 07:31:56 AM

document.EnumerateInstanceNames.hostaddress.value = top.hostAddress;

Legend:

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

No CVS admin address has been configured