|
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> |
| | |
Return to
createNameSpace.html
CVS log
Up to [Pegasus] / pegasus / cgi / htdocs / Attic