(file) Return to GetProperty.html CVS log (file) (dir) Up to [Pegasus] / pegasus / cgi / htdocs

  1 mike  1.1 <html>
  2 a.arora 1.9 <head>
  3             <script>
  4             	function rTrim(tempStr){
  5                                  while( tempStr.lastIndexOf(' ') == tempStr.length-1 && tempStr.length > 0 )
  6                                  { 
  7                                      tempStr = tempStr.substring(0,tempStr.length-1) 
  8                                  }
  9                                  document.GetProperty.InstanceName.value = tempStr;
 10             	}
 11             </script>
 12             </head>
 13             	<body bgcolor="#cccccc">
 14             		<table width="100%">
 15             			<tr>
 16             				<td width="50%" align="bottom"><h1>GetClassProperty</h1>
 17             				<td>
 18             				<td width="50%" align="right">
 19             					<img border="1" src="/pegasus/icons/OpenGroupLogo.gif">
 20             				</td>
 21             			</tr>
 22             		</table>
 23 a.arora 1.9 		<hr>
 24             		<form name="GetProperty" METHOD="get" ACTION="/pegasus/cgi-bin/CGIClient">
 25             			<P>
 26             				<INPUT TYPE="hidden" NAME="Operation" VALUE="GetProperty"> <INPUT TYPE="hidden" NAME="hostaddress" VALUE="localhost:5988">
 27             				<INPUT TYPE="hidden" NAME="debug" value="">
 28             			</P>
 29             			<P>The g<TT>etProperty</TT> CIM operation&nbsp;retrieves a single property value 
 30             				from a CIM Instance.
 31             			</P>
 32             			<p>NameSpace&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; <INPUT TYPE="text" NAME="NameSpace" SIZE="30" VALUE="root/cimv2">&nbsp;String 
 33             				that defines the target namespace. See <A href="enumeratenamespaces.html">NameSpace 
 34             					Operations</A>
 35             			for more information
 36             			<p>InstanceName&nbsp;&nbsp;&nbsp; <INPUT TYPE="text" NAME="InstanceName" SIZE="30"> 
 37             				Defines the Name of the instance whose property value is to be retrieved. See <A href="EnumerateInstanceNames.html">
 38             					Enumerate Instance Names</A>
 39             			for instance names for a class
 40             			<p>PropertyName&nbsp; &nbsp; <INPUT TYPE="text" NAME="PropertyName" SIZE="30">
 41             			&nbsp;Name of the property whose value is to be retrieved.
 42             			<p><INPUT TYPE="submit" VALUE="Submit Request" onClick="rTrim(document.GetProperty.InstanceName.value);">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<INPUT TYPE="reset" VALUE="Reset Form"></p>
 43             		</form>
 44 a.arora 1.9 		<hr>
 45             		<h2>
 46             			Return Results</h2>
 47             		<p>
 48             			If successful, the return value specifies the value of the requested 
 49             			CIMProperty. If the value is NULL then no element is returned. If unsuccessful, 
 50             			one of the following status codes MUST be returned by this method, where the 
 51             			first applicable error in the list (starting with the first element of the 
 52             			list, and working down) is the error returned. Any additional method-specific 
 53             			interpretation of the error in is given in parentheses.
 54             			<UL>
 55             				<LI>
 56             				CIM_ERR_ACCESS_DENIED
 57             				<LI>
 58             				CIM_ERR_INVALID_NAMESPACE
 59             				<LI>
 60             				CIM_ERR_INVALID_PARAMETER (including missing, duplicate, unrecognized or 
 61             				otherwise incorrect parameters)
 62             				<LI>
 63             				CIM_ERR_INVALID_CLASS (the CIM Class does not exist in the specified namespace)
 64             				<LI>
 65 a.arora 1.9 				CIM_ERR_NOT_FOUND (the CIM Class does exist, but the requested CIM Instance 
 66             				does not exist in the specified namespace)
 67             				<LI>
 68             				CIM_ERR_NO_SUCH_PROPERTY (the CIM Instance does exist, but the requested 
 69             				CIMProperty does not)
 70             				<LI>
 71             					CIM_ERR_FAILED (some other unspecified error occurred)</LI>
 72             			</UL>
 73             			<hr>
 74             			<h2>Additional Description of the Operation</h2>
 75             		This operation is used to retrieve a single property value from a CIM Instance 
 76             		in the target Namespace.&nbsp;<p><b>&nbsp;<a name="NameSpace">NameSpace</a></b>
 77             		&nbsp; - The NameSpace parameter is a string that defines the target namespace 
 78             		\Ref{NAMESPACE}&nbsp;<p><b><a name="InstanceName">InstanceName</a></b> - The 
 79             			InstanceName input parameter specifies the name of the Instance (model path) 
 80             			from which the CIMProperty value is requested. <a href="file://Ref{INSTANCENAME">\\Ref{INSTANCENAME</a>
 81             		}&nbsp;<p><b><a name="PropertyName">PropertyName </a></b>-&nbsp; The PropertyName 
 82             			input parameter specifies the name of the CIMProperty whose value is to be 
 83             			returned.&nbsp;
 84             			<hr>
 85             			<h2>Pegasus API in Operations.h</h2>
 86 a.arora 1.9 			<pre>
 87 karl    1.4     virtual CIMValue getProperty(
 88 karl    1.5     	const String&amp; nameSpace,
 89                 	const CIMReference&amp; instanceName,
 90                 	const String&amp; propertyName) = 0;
 91 karl    1.4     </pre>
 92 a.arora 1.9 			<hr>
 93             		<p style="MARGIN-TOP: 0px; MARGIN-BOTTOM: 0px">
 94             			<font size="2">Demonstration Prepared by the OpenGroup Manageability Work Group 
 95             				Pegasus Development Team</font>
 96             		<p style="MARGIN-TOP: 0px; MARGIN-BOTTOM: 0px">
 97             			<font size="2">See (<a href="http://www.opengroup.org/management">http://www.opengroup.org/management</a>) 
 98             				for more information on Pegasus </font>
 99             		<p style="MARGIN-TOP: 0px; MARGIN-BOTTOM: 0px">
100             			<font size="1">Last Modified <!--webbot bot="Timestamp" S-Type="EDITED"
101                 S-Format="%A, %B %d, %Y %I:%M:%S %p" startspan --> 
102             				Friday, June 29, 2001 06:45:16 PM<!--webbot bot="Timestamp" i-CheckSum="55017" endspan -->
103             				&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Copyright @ The Open Group 2001&nbsp;</font>
104             			<script>
105 karl    1.8    	   document.GetProperty.hostaddress.value = top.hostAddress;
106                    document.GetProperty.debug.value = top.debug;
107                    document.GetProperty.NameSpace.value = top.NameSpace;
108             
109             	   window.focus();
110 a.arora 1.9 			</script>
111             		</p>
112             	</body>
113 mike    1.1 </html>

No CVS admin address has been configured
Powered by
ViewCVS 0.9.2