version 1.2, 2001/02/19 21:43:30
|
version 1.5, 2001/06/22 21:31:41
|
|
|
<hr> | <hr> |
<form METHOD=GET ACTION="/pegasus/cgi-bin/CGIClient"> | <form METHOD=GET ACTION="/pegasus/cgi-bin/CGIClient"> |
<INPUT TYPE="hidden" NAME="Operation" VALUE="CreateNameSpace"> | <INPUT TYPE="hidden" NAME="Operation" VALUE="CreateNameSpace"> |
|
<input type="hidden" name="hostip" value="localhost"> |
|
<input type="hidden" name="portnum" value="5988"> |
|
|
<p>The <tt>CreateNameSpace</tt> method creates a new namespace in the Pegasus repository. | <p>The <tt>CreateNameSpace</tt> method creates a new namespace in the Pegasus repository. |
<p><b>NameSpace Name</b> <INPUT TYPE="text" NAME="NameSpace" SIZE=30> |
<p><b><a href="#NameSpace">NameSpace</a></b> |
|
<INPUT TYPE="text" NAME="NameSpace" SIZE=30 VALUE="root"> |
|
Defines the root namespace where the __Namespace class is defined. (DO NOT CHANGE) |
|
<p><b>New NameSpace Name</b> <INPUT TYPE="text" NAME="NewNameSpace" SIZE=30> |
String that defines the namespace to be created. | String that defines the namespace to be created. |
| |
<p><INPUT TYPE="submit" VALUE="Submit Request"> | <p><INPUT TYPE="submit" VALUE="Submit Request"> |
<INPUT TYPE="reset" VALUE="Reset Form"> | <INPUT TYPE="reset" VALUE="Reset Form"> |
<p> <b>RETURN - </b>If successful, the return value is a single CIM Class.If unsuccessful, one of the |
|
CIM status codes show below 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_INVALID_NAMESPACE |
|
<LI>CIM_ERR_INVALID_PARAMETER (including missing, duplicate, |
|
unrecognized or otherwise incorrect parameters) |
|
<LI>CIM_ERR_ACCESS_DENIED |
|
<LI>CIM_ERR_INVALID_CLASS (the CIM Class does not exist in the |
|
specified namespace) |
|
<LI>CIM_ERR_NOT_FOUND (the CIM Class does exist, but the |
|
requested CIM Instance does not exist in the specified namespace) |
|
<LI>CIM_ERR_FAILED (some other unspecified error occurred) |
|
</LI> |
|
</UL> |
|
| |
</form> | </form> |
| |
<p><b> ADDDITIONAL Description of Fields</b> |
|
<hr> | <hr> |
<p>Create Namespace is not an intrinsic CIM operation today. In |
<h2>Return Request</h2> |
accordance with the current CIM operations over HTTP specification, the |
|
creation of namespaces is executed instances of the class __Namespace. This |
<p>If successful, the return value defines the object path of the new |
class is defined with a single property, the name property which is the |
|
key. Creation of an instance of of this class causes a new namespace |
|
to be defined. If the namespace already exists, the create namespace returns |
|
the error CIM_ERR_ALREADY_EXISTS.</p> |
|
<p>NOTE: In the next version of CIM Operations over HTTP, the technique will |
|
be changed to allow for intrinsic methods that permit both creation an |
|
deletion of namespaces.</p> |
|
<p>In the Pegasus implementaiton, namespace manipulation is managed |
|
through a special provider __Namespace that is registered for the |
|
__Namespace class and returns creates and deletes namespaces as well as |
|
returning instances of __Namespace corresponding to the current set of |
|
namespaces.</p> |
|
<p><b>Return - </b>If successful, the return value defines the object path of the new |
|
CIM Instance relative to the target Namespace (i.e. the Model Path as | CIM Instance relative to the target Namespace (i.e. the Model Path as |
defined by the CIM specification), created by the CIM Server. It is | defined by the CIM specification), created by the CIM Server. It is |
returned in case one or more of the new keys of the Instance are allocated | returned in case one or more of the new keys of the Instance are allocated |
|
|
<LI>CIM_ERR_FAILED (some other unspecified error occurred) | <LI>CIM_ERR_FAILED (some other unspecified error occurred) |
</UL> | </UL> |
| |
|
<hr> |
|
|
|
<h2>Additional Description of Fields</h2> |
|
<p>Create Namespace is not an intrinsic CIM operation today. In |
|
accordance with the current CIM operations over HTTP specification, the |
|
creation of namespaces is executed instances of the class __Namespace. This |
|
class is defined with a single property, the name property which is the |
|
key. Creation of an instance of of this class causes a new namespace |
|
to be defined. If the namespace already exists, the create namespace returns |
|
the error CIM_ERR_ALREADY_EXISTS.</p> |
|
<p>NOTE: In the next version of CIM Operations over HTTP, the technique will |
|
be changed to allow for intrinsic methods that permit both creation an |
|
deletion of namespaces.</p> |
|
<p>In the Pegasus implementaiton, namespace manipulation is managed |
|
through a special provider __Namespace that is registered for the |
|
__Namespace class and returns creates and deletes namespaces as well as |
|
returning instances of __Namespace corresponding to the current set of |
|
namespaces.</p> |
|
<hr> |
|
<hr> |
|
<h2>C++ API</h2> |
|
|
The following is the CIM operation that is used to create a new namespace. | The following is the CIM operation that is used to create a new namespace. |
<PRE> | <PRE> |
virtual void createInstance( | virtual void createInstance( |
const String& nameSpace, | const String& nameSpace, |
CIMInstance& newInstance) = | CIMInstance& newInstance) = |
</PRE> | </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> |
|
|
|
<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 |
|
Modified <!--webbot bot="Timestamp" S-Type="EDITED" |
|
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> |
|
|
|
<script> |
|
CreateClass.hostip.value = opener.top.hostip; |
|
CreateClass.portnum.value = opener.top.portnum; |
|
window.focus(); |
|
</script> |
|
|
</body> | </body> |
</html> | </html> |
| |