version 1.2, 2001/02/18 23:09:45
|
version 1.5, 2001/06/11 23:20:45
|
|
|
<body bgcolor="#CCCCCC"> | <body bgcolor="#CCCCCC"> |
<table width="100%"> | <table width="100%"> |
<tr> | <tr> |
<td width="50%" align="bottom"><h1>enumerateNameSpaces</h1><td> |
<td width="50%" align="bottom"><h1>Enumerate NameSpaces</h1><td> |
<td width="50%" align="right"> | <td width="50%" align="right"> |
<img border=1 src="/pegasus/icons/OpenGroupLogo.gif"> | <img border=1 src="/pegasus/icons/OpenGroupLogo.gif"> |
</td> | </td> |
</tr> | </tr> |
</table> | </table> |
<hr> | <hr> |
<form METHOD=GET ACTION="/pegasus/cgi-bin/CGIClient"> |
<form name="EnumerateNameSpaces" METHOD=GET ACTION="/pegasus/cgi-bin/CGIClient"> |
<INPUT TYPE="hidden" NAME="Operation" VALUE="EnumerateInstanceNames"> |
<INPUT TYPE="hidden" NAME="Operation" VALUE="EnumerateNameSpaces"> |
|
<input type="hidden" name="hostip" value="localhost"> |
|
<input type="hidden" name="portnum" value="8888"> |
<p> | <p> |
|
|
<a name="TOP"></a> | <a name="TOP"></a> |
|
This request enumerates the namespaces defined in the repository. This is not a CIM intrinsic method but uses CIM enumerateInstance. |
This request enumerates the namespaces defined in the repository. This is not a CIM intrinsic method but uses CIM enumerateInstance.<p><b><a href="#NameSpace">NameSpace</a></b> |
<p><b><a href="#NameSpace">NameSpace</a></b> |
<INPUT TYPE="text" NAME="NameSpace" SIZE=30 VALUE="root"> | <INPUT TYPE="text" NAME="NameSpace" SIZE=30 VALUE="root"> |
Defined the root namespace where the __Namespace class is defined.<p><b><a href="#ClassName">ClassName</a></b> <INPUT TYPE="text" NAME="ClassName" SIZE=30 VALUE="__Namespace"> |
Defines the root namespace where the __Namespace class is defined. (DO NOT CHANGE) |
Defined the __Namespace class within the repository |
<p><b><a href="#ClassName">ClassName</a></b> <INPUT TYPE="text" NAME="ClassName" SIZE=30 VALUE="__Namespace"> |
<p><b>LocalOnly</b> <INPUT TYPE="checkbox" NAME="LocalOnly" VALUE="true" checked> |
Defines the __Namespace class within the repository. (DO NOT CHANGE)<p><b>DO |
If true only CIM Elements overridden within definition of class are |
NOT CHANGE THE ABOVE. THE FIELDS ARE PROVIDED FOR INFORMATION ONLY</b> |
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>. |
|
<p><INPUT TYPE="submit" VALUE="Submit Request"> | <p><INPUT TYPE="submit" VALUE="Submit Request"> |
<INPUT TYPE="reset" VALUE="Reset"> | <INPUT TYPE="reset" VALUE="Reset"> |
| |
<hr> | <hr> |
<p>Today the namespace manipulation defined in CIM Operations over HTTP is |
<hr> |
|
</form> |
|
<h2>Return Results</h2> |
|
If successful, the method returns zero or more named |
|
Instances that meet the required criteria. |
|
|
|
If unsuccessful, one of the following status codes MUST be returned |
|
by this method, where the first applicable error in the list (starting |
|
with the first element of the list, and working down) is the error |
|
returned. Any additional method-specific interpretation of the error in |
|
is given in parentheses. |
|
|
|
<UL> |
|
<LI>CIM_ERR_ACCESS_DENIED |
|
<LI>CIM_ERR_NOT_SUPPORTED |
|
<LI>CIM_ERR_INVALID_NAMESPACE |
|
<LI>CIM_ERR_INVALID_PARAMETER (including missing, |
|
duplicate, unrecognized or otherwise incorrect parameters) |
|
<LI>CIM_ERR_INVALID_CLASS (the CIM Class that is the |
|
basis for this enumeration does not exist) |
|
<LI>CIM_ERR_FAILED (some other unspecified error occurred)</LI> |
|
</UL> |
|
<p> </p> |
|
<h2>Additional Information on the Fields</h2> |
|
<p><a name="NameSpace"><b>NameSpace</b></a> - The NameSpace parameter is a string that defines the |
|
target namespace |
|
|
|
<p><a name="className"><b>ClassName</b></a> - The <TT>ClassName</TT> input parameter defines the Class |
|
that is the basis for the enumeration. Note that the class named is not |
|
retrieved as part of the enumeration. Thus, if there are no subclasses to |
|
the named class, zero classe names are returned. |
|
<p><b>Definition of the Namespace -</b> 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>://<namespacehandle></PRE> |
|
<P>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. |
|
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> |
|
<p><b>Implementation of Namespace Manipulation - </b>Today the namespace manipulation defined in CIM Operations over HTTP |
|
(Section 2.5) is |
proprietary in nature. It is based on a class named __Namespace | proprietary in nature. It is based on a class named __Namespace |
which creates an instance for each namespace defined for the CIMOM. The | which creates an instance for each namespace defined for the CIMOM. The |
only property in the __namespace class is the name.</p> |
only required property in the __namespace class is the name. |
<p>Within Pegasus, the namespace manipulation based on the __namespace | <p>Within Pegasus, the namespace manipulation based on the __namespace |
class can be executed through this HTML page or through the <a href="EnumerateInstanceNames.html">enumerateInstanceNames</a> | class can be executed through this HTML page or through the <a href="EnumerateInstanceNames.html">enumerateInstanceNames</a> |
operation with the classname = __namespace and the namespace | operation with the classname = __namespace and the namespace |
|
|
on the __NameSpace class are handled within Pegasus by a special provider | on the __NameSpace class are handled within Pegasus by a special provider |
that manipulates the instances of the class and also creates and deletes | that manipulates the instances of the class and also creates and deletes |
namespaces.</p> | namespaces.</p> |
<hr> |
<hr><p style="margin-top: 0; margin-bottom: 0"> <font size="2">Demonstration |
|
Prepared by the OpenGroup Manageability Work Group Pegasus Development Team</font> |
|
|
|
<p style="margin-top: 0; margin-bottom: 0"> <font size="2">See (<a href="http://www.opengroup.org/management">http://www.opengroup.org/management</a>) |
|
for more information on Pegasus</font> |
|
|
<p style="line-height: 100%; margin-top: 0; margin-bottom: 0"><font size="1">Last | <p style="line-height: 100%; margin-top: 0; margin-bottom: 0"><font size="1">Last |
Modified <!--webbot bot="Timestamp" S-Type="EDITED" | Modified <!--webbot bot="Timestamp" S-Type="EDITED" |
S-Format="%A, %B %d, %Y %I:%M:%S %p" startspan -->Monday, February 19, 2001 05:13:56 AM<!--webbot bot="Timestamp" i-CheckSum="5667" endspan --> |
S-Format="%A, %B %d, %Y %I:%M:%S %p" startspan -->Monday, March 26, 2001 02:37:32 PM<!--webbot bot="Timestamp" i-CheckSum="50314" endspan --> |
Copyright @ The Open Group 2001 </font> |
Copyright @ The Open Group 2001 </font> |
<p> |
|
</form> |
|
<p> | <p> |
</body> | </body> |
</html> | </html> |