pegasus/cgi/htdocs/Attic/createNameSpace.html - diff

Return to createNameSpace.html CVS log

Up to [Pegasus] / pegasus / cgi / htdocs / Attic

Diff for /pegasus/cgi/htdocs/Attic/createNameSpace.html between version 1.1 and 1.5

version 1.1, 2001/02/17 20:03:57

version 1.5, 2001/06/22 21:31:41

Line 11

<hr>

<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

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>     <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>

-------------------------------------------------------

/** 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

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

Line 107

Line 53

<LI>CIM_ERR_ALREADY_EXISTS (the CIM Instance already exists)

<LI>CIM_ERR_FAILED (some other unspecified error occurred)

</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>

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 -->Monday, March 26, 2001 02:37:32 PM

CreateClass.hostip.value = opener.top.hostip;

CreateClass.portnum.value = opener.top.portnum;

window.focus();

</script>

</body>

</html>

Legend:

Removed from v.1.1
changed lines
	Added in v.1.5

No CVS admin address has been configured