version 1.1, 2001/02/17 20:03:57
|
version 1.2, 2001/02/19 21:43:30
|
|
|
<INPUT TYPE="hidden" NAME="Operation" VALUE="CreateNameSpace"> | <INPUT TYPE="hidden" NAME="Operation" VALUE="CreateNameSpace"> |
<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>NameSpace Name</b> <INPUT TYPE="text" NAME="NameSpace" SIZE=30> |
String that defines the namespace to be created. See <a href="getnamespaces.html">NameSpace |
String that defines the namespace to be created. |
Operations</a> for more information |
|
| |
<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"> |
|
|
</LI> | </LI> |
</UL> | </UL> |
| |
<p> ADDDITIONAL Description of Fields |
|
</form> | </form> |
------------------------------------------------------- |
|
| |
0; |
<p><b> ADDDITIONAL Description of Fields</b> |
|
<hr> |
/** The <TT>createInstance</TT> method creates a single CIM |
<p>Create Namespace is not an intrinsic CIM operation today. In |
Instance in the target Namespace. The Instance MUST NOT already exist. |
accordance with the current CIM operations over HTTP specification, the |
|
creation of namespaces is executed instances of the class __Namespace. This |
In processing the creation of the new Instance, the following rules MUST be |
class is defined with a single property, the name property which is the |
conformed to by the CIM Server: |
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 |
Any CLASSORIGIN and PROPAGATED attributes in the NewInstance MUST be ignored |
the error CIM_ERR_ALREADY_EXISTS.</p> |
by the Server. |
<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 |
The Server MUST ensure that: |
deletion of namespaces.</p> |
|
<p>In the Pegasus implementaiton, namespace manipulation is managed |
<UL> |
through a special provider __Namespace that is registered for the |
<LI>Any Qualifiers in the Instance not defined in the Class are created |
__Namespace class and returns creates and deletes namespaces as well as |
as new elements of the Instance. |
returning instances of __Namespace corresponding to the current set of |
<LI>All Properties of the Instance preserve their CLASSORIGIN attribute |
namespaces.</p> |
value from that defined in the Class. |
<p><b>Return - </b>If successful, the return value defines the object path of the new |
<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 |
|
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) = |
|
------------------------------------------------------- |
|
|
|
| |
|
The following is the CIM operation that is used to create a new namespace. |
|
<PRE> |
|
virtual void createInstance( |
|
const String& nameSpace, |
|
CIMInstance& newInstance) = |
|
</PRE> |
</body> | </body> |
</html> | </html> |
| |