1 karl 1.1 <html>
2 <body bgcolor="#CCCCCC">
3 <table width="100%">
4 <tr>
5 <td width="50%" align="bottom"><h1>Create NameSpace CIM Operation</h1><td>
6 <td width="50%" align="right">
7 <img border=1 src="/pegasus/icons/OpenGroupLogo.gif">
8 </td>
9 </tr>
10 </table>
11 <hr>
12 <form METHOD=GET ACTION="/pegasus/cgi-bin/CGIClient">
13 <INPUT TYPE="hidden" NAME="Operation" VALUE="CreateNameSpace">
14 <p>The <tt>CreateNameSpace</tt> method creates a new namespace in the Pegasus repository.
|
15 karl 1.3 <p><b><a href="#NameSpace">NameSpace</a></b>
16 <INPUT TYPE="text" NAME="NameSpace" SIZE=30 VALUE="root">
17 Defines the root namespace where the __Namespace class is defined. (DO NOT CHANGE)
18 <p><b>New NameSpace Name</b> <INPUT TYPE="text" NAME="NewNameSpace" SIZE=30>
|
19 karl 1.2 String that defines the namespace to be created.
|
20 karl 1.1
21 <p><INPUT TYPE="submit" VALUE="Submit Request">
22 <INPUT TYPE="reset" VALUE="Reset Form">
23 <p> <b>RETURN - </b>If successful, the return value is a single CIM Class.If unsuccessful, one of the
24 CIM status codes show below MUST be returned by this method,
25 where the first applicable error in the list (starting with the first element of the list,
26 and working down) is the error returned. Any additional method-specific interpretation of
27 the error in is given in parentheses.
28 <UL>
29 <LI>CIM_ERR_INVALID_NAMESPACE
30 <LI>CIM_ERR_INVALID_PARAMETER (including missing, duplicate,
31 unrecognized or otherwise incorrect parameters)
32 <LI>CIM_ERR_ACCESS_DENIED
33 <LI>CIM_ERR_INVALID_CLASS (the CIM Class does not exist in the
34 specified namespace)
35 <LI>CIM_ERR_NOT_FOUND (the CIM Class does exist, but the
36 requested CIM Instance does not exist in the specified namespace)
37 <LI>CIM_ERR_FAILED (some other unspecified error occurred)
38 </LI>
39 </UL>
40
41 karl 1.1 </form>
42
|
43 karl 1.2 <p><b> ADDDITIONAL Description of Fields</b>
44 <hr>
45 <p>Create Namespace is not an intrinsic CIM operation today. In
46 accordance with the current CIM operations over HTTP specification, the
47 creation of namespaces is executed instances of the class __Namespace. This
48 class is defined with a single property, the name property which is the
49 key. Creation of an instance of of this class causes a new namespace
50 to be defined. If the namespace already exists, the create namespace returns
51 the error CIM_ERR_ALREADY_EXISTS.</p>
52 <p>NOTE: In the next version of CIM Operations over HTTP, the technique will
53 be changed to allow for intrinsic methods that permit both creation an
54 deletion of namespaces.</p>
55 <p>In the Pegasus implementaiton, namespace manipulation is managed
56 through a special provider __Namespace that is registered for the
57 __Namespace class and returns creates and deletes namespaces as well as
58 returning instances of __Namespace corresponding to the current set of
59 namespaces.</p>
60 <p><b>Return - </b>If successful, the return value defines the object path of the new
|
61 karl 1.1 CIM Instance relative to the target Namespace (i.e. the Model Path as
62 defined by the CIM specification), created by the CIM Server. It is
63 returned in case one or more of the new keys of the Instance are allocated
64 dynamically during the creation process rather than specified in the
65 request.
66
67 If unsuccessful, one of the following status codes MUST be returned by this
68 method, where the first applicable error in the list (starting with the
69 first element of the list, and working down) is the error returned. Any
70 additional method-specific interpretation of the error in is given in
71 parentheses.</p>
72
73 <UL>
74 <LI>CIM_ERR_ACCESS_DENIED
75 <LI>CIM_ERR_NOT_SUPPORTED
76 <LI>CIM_ERR_INVALID_NAMESPACE
77 <LI>CIM_ERR_INVALID_PARAMETER (including missing, duplicate,
78 unrecognized or otherwise incorrect parameters)
79 <LI>CIM_ERR_INVALID_CLASS (the CIM Class of which this is to be a new
80 Instance does not exist)
81 <LI>CIM_ERR_ALREADY_EXISTS (the CIM Instance already exists)
82 karl 1.1 <LI>CIM_ERR_FAILED (some other unspecified error occurred)
83 </UL>
|
84 karl 1.2
85 The following is the CIM operation that is used to create a new namespace.
86 <PRE>
|
87 karl 1.1 virtual void createInstance(
|
88 karl 1.2 const String& nameSpace,
89 CIMInstance& newInstance) =
90 </PRE>
|
91 karl 1.1 </body>
92 </html>
93
|