1 karl 1.1 <html>
2 <body bgcolor="#CCCCCC">
3 <table width="100%">
4 <tr>
5 <td width="50%" align="bottom"><h1>Enumerate Instances CIM Operation</h1><td>
6 <td width="50%" align="right">
|
7 karl 1.3 <img border=1 src="/pegasus/icons/OpenGroupLogo.gif">
|
8 karl 1.1 </td>
9 </tr>
10 </table>
11 <hr>
|
12 karl 1.4 <form name="EnumerateInstances" METHOD=GET ACTION="/pegasus/cgi-bin/CGIClient">
|
13 karl 1.2 <INPUT TYPE="hidden" NAME="Operation" VALUE="EnumerateInstances">
|
14 karl 1.6 <INPUT TYPE="hidden" NAME="hostaddress" VALUE="localhost:5988">
15 <INPUT TYPE="hidden" NAME="debug" VALUE="">
|
16 karl 1.1 <p>
17
18 <a name="TOP"></a>
19
|
20 karl 1.2 The <TT>enumerateInstances</TT> method enumerates instances of a CIM
21 Class in the target Namespace.
22 <p><b><a href="#NameSpace">NameSpace</a></b>
|
23 a.arora 1.8 <INPUT TYPE="text" NAME="NameSpace" SIZE=30 VALUE="root/cimv2"> String that defines the target namespace. See <a href="enumeratenamespaces.html">NameSpace
|
24 karl 1.2 Operations</a> for more information.
25 <p><b><a href="#ClassName">ClassName</a></b> <INPUT TYPE="text" NAME="ClassName" SIZE=30> Defines
26 name of the Class
27 for which instance names are to be retrieved. This must be a legal
28 class in the repository
|
29 karl 1.7 <p><b>LocalOnly</b>
30 <INPUT TYPE="checkbox" NAME="LocalOnly" VALUE="true" checked>
31 If checked (true) only CIM Elements overridden within definition of class are
32 returned. Default is true
33 <p><b>IncludeQualifiers</b> <INPUT TYPE="checkbox" NAME="IncludeQualifiers" VALUE="true"> If
34 checked (true), show Qualifiers for class and returned Properties, Methods,
|
35 karl 1.2 and Method Parameters.
|
36 a.arora 1.8 <p><b>IncludeClassOrigins</b> <INPUT TYPE="checkbox" NAME="IncludeClassOrigin" VALUE="true"> If checked (TRUE), CLASSORIGIN attribute will be returned for all
|
37 karl 1.2 appropriate elements<p><b>PropertyList </b> <INPUT TYPE="text" NAME="PropertyList" SIZE=30 VALUE="NULL">
38 NOTE: <b> NOT IMPLEMENTED </b>Null or array of property names to filter
39 request. <a href="#PropertyList">See below</a>.
40 <p><INPUT TYPE="submit" VALUE="Submit Request">
|
41 a.arora 1.8 <INPUT TYPE="reset" VALUE="Reset Form">
|
42 karl 1.2 </form>
43 <hr>
|
44 karl 1.6 <h2>Additional Information</h2>
|
45 karl 1.2
46 <P>The <TT>enumerateInstances</TT> method enumerates instances of a CIM
47 Class in the target Namespace.
48
49 NameSpace The NameSpace parameter is a string that defines the
|
50 karl 1.6 target namespace. The <TT>ClassName</TT> input parameter defines the
51 Class that is the basis for the enumeration. </P>
|
52 karl 1.2
|
53 karl 1.6 <b>
|
54 karl 1.2
|
55 karl 1.6 LocalOnly</b> If the <TT>LocalOnly</TT> input parameter is
|
56 karl 1.2 <TT>true</TT>, this specifies that, for each returned Instance,
57 only elements (properties and qualifiers) overriden within the
58 definition of that Instance are included. If <TT>false</TT>,
59 all elements are returned. This parameter therefore effects a CIM
60 Server-side mechanism to filter certain elements of the returned object
61 based on whether or not they have been propagated from the parent
|
62 karl 1.6 Class (as defined by the <TT>PROPAGATED</TT> attribute).
63 <p><b>IncludeQualifiers</b> If the <TT>IncludeQualifiers</TT> input
|
64 karl 1.2 parameter is <TT>true</TT>, this specifies that all Qualifiers
65 for each Instance (including Qualifiers on the Instance
66 and on any returned Properties) MUST be included as
67 <TT><QUALIFIER></TT> elements in the response. If false no
68 <TT><QUALIFIER></TT> elements are present in each
|
69 karl 1.6 returned Instance. </p>
70 <p><b>IncludeClassOrigin</b> If the <TT>IncludeClassOrigin</TT> input
|
71 karl 1.2 parameter is <TT>true</TT>, this specifies that the
72 <TT>CLASSORIGIN</TT> attribute MUST be present on all appropriate
73 elements in each returned Instance. If false, no
74 <TT>CLASSORIGIN</TT> attributes are present in each returned
|
75 karl 1.6 Instance. </p>
76 <p><b>PropertyList</b> If the <TT>PropertyList</TT> input parameter is not
|
77 karl 1.2 <TT>NULL</TT>, the members of the array define one or more Property
78 names. Each returned Instance MUST NOT include elements
79 for any Properties missing from this list. Note that if
80 <TT>LocalOnly</TT> is specified as <TT>true</TT> (or
81 <TT>DeepInheritance</TT> is specified as <TT>false</TT>) this acts as an
82 additional filter on the set of Properties returned (for example,
83 if Property <TT>A</TT> is included in the
84 <TT>PropertyList</TT> but <TT>LocalOnly</TT> is set to true and
85 <TT>A</TT> is not local to a returned Instance, then it will not be
86 included in that Instance). If the <TT>PropertyList</TT> input parameter
87 is an empty array this signifies that no Properties are included in each
88 returned Instance. If the <TT>PropertyList</TT> input parameter is
89 NULL this specifies that all Properties (subject to the conditions
90 expressed by the other parameters) are included in each returned
91 Instance.
92
93 If the <TT>PropertyList</TT> contains duplicate elements,
94 the Server MUST ignore the duplicates but otherwise process the request
95 normally. If the <TT>PropertyList</TT> contains elements which are
96 invalid Property names for any target Instance, the Server MUST
|
97 karl 1.6 ignore such entries but otherwise process the request normally. </p>
98 <hr>
99 <h2>Return</h2>
100 <p>If successful, the method returns zero or more named
|
101 karl 1.2 Instances that meet the required criteria.
102
103 If unsuccessful, one of the following status codes MUST be returned
104 by this method, where the first applicable error in the list (starting
105 with the first element of the list, and working down) is the error
106 returned. Any additional method-specific interpretation of the error in
|
107 karl 1.6 is given in parentheses.</p>
|
108 karl 1.2
109 <UL>
110 <LI>CIM_ERR_ACCESS_DENIED
111 <LI>CIM_ERR_NOT_SUPPORTED
112 <LI>CIM_ERR_INVALID_NAMESPACE
113 <LI>CIM_ERR_INVALID_PARAMETER (including missing,
114 duplicate, unrecognized or otherwise incorrect parameters)
115 <LI>CIM_ERR_INVALID_CLASS (the CIM Class that is the
116 basis for this enumeration does not exist)
117 <LI>CIM_ERR_FAILED (some other unspecified erroroccurred)</LI>
118 </UL>
|
119 karl 1.6 <hr>
120 <h2>C++ APIs as defined in CIMOperations.h</h2>
|
121 karl 1.1 <PRE>
|
122 karl 1.2 virtual Array<InstanceDecl> enumerateInstances(
|
123 karl 1.6 const String& nameSpace,
124 const String& className,
|
125 karl 1.2 Boolean localOnly = true,
126 Boolean includeQualifiers = false,
127 Boolean includeClassOrigin = false,
|
128 karl 1.6 const Array<String>& propertyList = _getStringArray()) = 0;
|
129 karl 1.2 </PRE>
|
130 karl 1.6 <script>
131 document.EnumerateInstances.hostaddress.value = top.hostAddress;
132 document.EnumerateInstances.debug.value = top.debug;
133 document.EnumerateInstances.NameSpace.value = top.NameSpace;
134 window.focus();
135 </script>
136 </body>
137 </html>
|
138 karl 1.1
|