version 1.1, 2001/02/17 20:03:57
|
version 1.6, 2001/06/30 15:28:09
|
|
|
</tr> | </tr> |
</table> | </table> |
<hr> | <hr> |
<form METHOD=GET ACTION="/pegasus/cgi-bin/CGIClient"> |
<form name="CreateNameSpace" 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="hostaddress" VALUE="localhost:5988"> |
|
<INPUT TYPE="hidden" NAME="debug" VALUE=""> |
<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> |
String that defines the namespace to be created. See <a href="getnamespaces.html">NameSpace |
<INPUT TYPE="text" NAME="NameSpace" SIZE=30 VALUE="root"> |
Operations</a> for more information |
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. |
| |
<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> |
|
| |
<p> ADDDITIONAL Description of Fields |
|
</form> | </form> |
------------------------------------------------------- |
|
|
|
0; |
|
|
|
/** The <TT>createInstance</TT> method creates a single CIM |
|
Instance in the target Namespace. The Instance MUST NOT already exist. |
|
|
|
In processing the creation of the new Instance, the following rules MUST be |
|
conformed to by the CIM Server: |
|
|
|
Any CLASSORIGIN and PROPAGATED attributes in the NewInstance MUST be ignored |
|
by the Server. |
|
| |
The Server MUST ensure that: |
<hr> |
|
<h2>Return Request</h2> |
<UL> |
|
<LI>Any Qualifiers in the Instance not defined in the Class are created |
|
as new elements of the Instance. |
|
<LI>All Properties of the Instance preserve their CLASSORIGIN attribute |
|
value from that defined in the Class. |
|
<LI>If a CIMProperty is specified in the ModifiedInstance parameter, the |
|
value assigned to that property in the Instance (including NULL) becomes |
|
the value of the property for the Instance. Note that it is a Client |
|
error to specify a CIMProperty that does not belong to the Class. |
|
<LI>If a CIMProperty of the Class is not specified in the Instance, then |
|
that CIMProperty is inherited without modification by the Instance. |
|
<LI>Any Qualifiers defined in the Class with a TOINSTANCE attribute |
|
value of true appear in the Instance. Qualifiers in the |
|
Class with a TOINSTANCE attribute value of false MUST NOT be propagated |
|
to the Instance. |
|
<LI>Any CIMQualifier propagated from the Class cannot be modified in the |
|
Instance if the OVERRIDABLE attribute of that CIMQualifier was set to false |
|
in the Class. It is a Client error to specify such a CIMQualifier in the |
|
NewInstance with a different definition to that in the Class (where |
|
definition encompasses the name, type and flavor attribute settings of |
|
the <QUALIFIER> element, and the value of the CIMQualifier). |
|
</UL> |
|
|
|
@param NameSpace The NameSpace parameter is a string that defines the target |
|
namespace \Ref{NAMESPACE} |
|
<p>@param newInstance The <TT>newInstance</TT> input parameter defines the new |
|
Instance. The proposed definition MUST be a correct Instance definition for |
|
the underlying CIM Class according to the CIM specification. </p> |
|
<p> |
|
| |
@return If successful, the return value defines the object path of the new |
<p>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_ALREADY_EXISTS (the CIM Instance already exists) | <LI>CIM_ERR_ALREADY_EXISTS (the CIM Instance already exists) |
<LI>CIM_ERR_FAILED (some other unspecified error occurred) | <LI>CIM_ERR_FAILED (some other unspecified error occurred) |
</UL> | </UL> |
*/ |
|
virtual void createInstance( |
|
const String& nameSpace, |
|
CIMInstance& newInstance) = |
|
------------------------------------------------------- |
|
| |
|
<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. |
|
<PRE> |
|
virtual void createInstance( |
|
const String& nameSpace, |
|
CIMInstance& newInstance) = |
|
</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 -->Friday, June 29, 2001 04:56:44 PM<!--webbot bot="Timestamp" i-CheckSum="54751" endspan --> |
|
Copyright @ The Open Group 2001 </font> |
|
|
|
<script> |
|
document.CreateNameSpace.hostaddress.value = top.hostAddress; |
|
document.CreateNameSpace.debug.value = top.debug; |
|
document.CreateNameSpace.NameSpace.value = top.NameSpace; |
|
window.focus(); |
|
</script> |
</body> | </body> |
</html> | </html> |
| |