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 karl 1.6 <form name="CreateNameSpace" METHOD=GET ACTION="/pegasus/cgi-bin/CGIClient">
|
13 karl 1.1 <INPUT TYPE="hidden" NAME="Operation" VALUE="CreateNameSpace">
|
14 karl 1.6 <INPUT TYPE="hidden" NAME="hostaddress" VALUE="localhost:5988">
15 <INPUT TYPE="hidden" NAME="debug" VALUE="">
|
16 karl 1.1 <p>The <tt>CreateNameSpace</tt> method creates a new namespace in the Pegasus repository.
|
17 karl 1.6 <p><b><a href="#NameSpace">NameSpace</a></b>
18 <INPUT TYPE="text" NAME="NameSpace" SIZE=30 VALUE="root">
|
19 karl 1.3 Defines the root namespace where the __Namespace class is defined. (DO NOT CHANGE)
20 <p><b>New NameSpace Name</b> <INPUT TYPE="text" NAME="NewNameSpace" SIZE=30>
|
21 karl 1.2 String that defines the namespace to be created.
|
22 karl 1.5
|
23 karl 1.1 <p><INPUT TYPE="submit" VALUE="Submit Request">
24 <INPUT TYPE="reset" VALUE="Reset Form">
25
26 </form>
27
|
28 karl 1.2 <hr>
|
29 karl 1.4 <h2>Return Request</h2>
30
31 <p>If successful, the return value defines the object path of the new
|
32 karl 1.1 CIM Instance relative to the target Namespace (i.e. the Model Path as
33 defined by the CIM specification), created by the CIM Server. It is
34 returned in case one or more of the new keys of the Instance are allocated
35 dynamically during the creation process rather than specified in the
36 request.
37
38 If unsuccessful, one of the following status codes MUST be returned by this
39 method, where the first applicable error in the list (starting with the
40 first element of the list, and working down) is the error returned. Any
41 additional method-specific interpretation of the error in is given in
42 parentheses.</p>
43
44 <UL>
45 <LI>CIM_ERR_ACCESS_DENIED
46 <LI>CIM_ERR_NOT_SUPPORTED
47 <LI>CIM_ERR_INVALID_NAMESPACE
48 <LI>CIM_ERR_INVALID_PARAMETER (including missing, duplicate,
49 unrecognized or otherwise incorrect parameters)
50 <LI>CIM_ERR_INVALID_CLASS (the CIM Class of which this is to be a new
51 Instance does not exist)
52 <LI>CIM_ERR_ALREADY_EXISTS (the CIM Instance already exists)
53 karl 1.1 <LI>CIM_ERR_FAILED (some other unspecified error occurred)
54 </UL>
|
55 karl 1.5
|
56 karl 1.4 <hr>
57
58 <h2>Additional Description of Fields</h2>
59 <p>Create Namespace is not an intrinsic CIM operation today. In
60 accordance with the current CIM operations over HTTP specification, the
61 creation of namespaces is executed instances of the class __Namespace. This
62 class is defined with a single property, the name property which is the
63 key. Creation of an instance of of this class causes a new namespace
64 to be defined. If the namespace already exists, the create namespace returns
65 the error CIM_ERR_ALREADY_EXISTS.</p>
66 <p>NOTE: In the next version of CIM Operations over HTTP, the technique will
67 be changed to allow for intrinsic methods that permit both creation an
68 deletion of namespaces.</p>
69 <p>In the Pegasus implementaiton, namespace manipulation is managed
70 through a special provider __Namespace that is registered for the
71 __Namespace class and returns creates and deletes namespaces as well as
72 returning instances of __Namespace corresponding to the current set of
73 namespaces.</p>
74 <hr>
75 <hr>
76 <h2>C++ API</h2>
|
77 karl 1.5
|
78 karl 1.2 The following is the CIM operation that is used to create a new namespace.
79 <PRE>
|
80 karl 1.1 virtual void createInstance(
|
81 karl 1.2 const String& nameSpace,
|
82 karl 1.5 CIMInstance& newInstance) =
|
83 karl 1.2 </PRE>
|
84 karl 1.4 <hr><p style="margin-top: 0; margin-bottom: 0"> <font size="2">Demonstration
85 Prepared by the OpenGroup Manageability Work Group Pegasus Development Team</font>
86
87 <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>)
88 for more information on Pegasus</font>
89
90 <p style="line-height: 100%; margin-top: 0; margin-bottom: 0"><font size="1">Last
91 Modified <!--webbot bot="Timestamp" S-Type="EDITED"
|
92 karl 1.6 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 -->
|
93 karl 1.4 Copyright @ The Open Group 2001 </font>
|
94 karl 1.5
95 <script>
|
96 karl 1.6 document.CreateNameSpace.hostaddress.value = top.hostAddress;
97 document.CreateNameSpace.debug.value = top.debug;
98 document.CreateNameSpace.NameSpace.value = top.NameSpace;
99 window.focus();
|
100 karl 1.5 </script>
|
101 karl 1.1 </body>
102 </html>
103
|