1 mike 1.1 <html>
2 <body bgcolor="#CCCCCC">
3 <table width="100%">
4 <tr>
|
5 karl 1.4 <td width="412" align="bottom"><h1>Get Property CIM Operation</h1><td width="2">
6 <td width="340" align="right">
7 <p align="right">
8 <img border=1 src="/pegasus/icons/OpenGroupLogo.gif" align="right">
9 </p>
|
10 mike 1.1 </td>
11 </tr>
12 </table>
|
13 karl 1.4 <hr>
|
14 mike 1.1 <form METHOD=GET ACTION="/pegasus/cgi-bin/CGIClient">
15 <INPUT TYPE="hidden" NAME="Operation" VALUE="GetProperty">
|
16 karl 1.4 <p>The <tt>getProperty</tt> CIM operation retrieves a single property value from a CIM Instance.
|
17 karl 1.5 <p><a href="#NameSpace"><b>NameSpace</b></a>
18 <INPUT TYPE="text" NAME="NameSpace" SIZE=30 VALUE="root/cimv20">
19 Target Namespace for the Operation
20 <p><b><a href="#InstanceName">InstanceName </a></b>
21 <INPUT TYPE="text" NAME="InstanceName" SIZE=30>
22 Name of the Instance from which Property is requested
23 <p><b><a href="#PropertyName">PropertyName</a></b>
24 <INPUT TYPE="text" NAME="PropertyName" SIZE=30>
25 Name of the CIM Property for which value is to be returned.
|
26 karl 1.4 <p><INPUT TYPE="submit" VALUE="Submit" name="Submit">
27 <INPUT TYPE="reset" VALUE="Reset">
|
28 mike 1.1 </form>
|
29 karl 1.4
30 <hr>
31 <h2>
32
33 Return Results</h2>
34 <p>
35
36 If successful, the return value specifies the value of the requested
37 CIMProperty. If the value is NULL then no element is returned.
38
39 If unsuccessful, one of the following status codes MUST be returned by this
40 method, where the first applicable error in the list (starting with the
41 first element of the list, and working down) is the error returned. Any
42 additional method-specific interpretation of the error in is given in
43 parentheses.
44 <UL>
45 <LI>CIM_ERR_ACCESS_DENIED
46 <LI>CIM_ERR_INVALID_NAMESPACE
47 <LI>CIM_ERR_INVALID_PARAMETER (including missing, duplicate,
48 unrecognized or otherwise incorrect parameters)
49 <LI>CIM_ERR_INVALID_CLASS (the CIM Class does not exist in the specified
50 karl 1.4 namespace)
51 <LI>CIM_ERR_NOT_FOUND (the CIM Class does exist, but the requested CIM
52 Instance does not exist in the specified namespace)
|
53 karl 1.5 <LI>CIM_ERR_NO_SUCH_PROPERTY (the CIM Instance does exist, but the
|
54 karl 1.4 requested CIMProperty does not)
55 <LI>CIM_ERR_FAILED (some other unspecified error occurred)
56 </UL>
57
58 <hr>
59 <h2>Additional Description of the Operation</h2>
60
61 This operation is used to retrieve a single property value from a CIM
|
62 karl 1.5 Instance in the target Namespace. <p><b> <a name="NameSpace">NameSpace</a></b>
63 - The NameSpace parameter is a string that defines the target
64 namespace \Ref{NAMESPACE} <p><b><a name="InstanceName">InstanceName</a></b>
65 - The InstanceName input parameter specifies the name of the Instance
|
66 karl 1.4 (model path) from which the CIMProperty value is
|
67 karl 1.5 requested. <a href="file://Ref{INSTANCENAME">\\Ref{INSTANCENAME</a>} <p><b><a name="PropertyName">PropertyName
68 </a></b>- The PropertyName input parameter specifies the name of the
|
69 karl 1.4 CIMProperty whose value is to be returned.
70 <hr>
71 <h2>Pegasus API in Operations.h</h2>
72
73 <pre>
74 virtual CIMValue getProperty(
|
75 karl 1.5 const String& nameSpace,
76 const CIMReference& instanceName,
77 const String& propertyName) = 0;
|
78 karl 1.4 </pre>
79
80 <hr>
81
82 <p style="margin-top: 0; margin-bottom: 0"> <font size="2">Demonstration
83 Prepared by the OpenGroup Manageability Work Group Pegasus Development Team</font>
84
85 <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>)
86 for more information on Pegasus </font>
87
88 <p style="margin-top: 0; margin-bottom: 0"> <font size="1">Last Modified <!--webbot bot="Timestamp" S-Type="EDITED"
|
89 karl 1.5 S-Format="%A, %B %d, %Y %I:%M:%S %p" startspan -->Thursday, March 29, 2001 02:32:59 PM<!--webbot bot="Timestamp" i-CheckSum="6845" endspan -->
|
90 karl 1.4 Copyright @ The Open Group 2001 </font>
91
|
92 mike 1.1 </body>
93 </html>
|