Return to
ReferenceNames.html
CVS log
Up to [Pegasus] / pegasus / cgi / htdocs
|
Return to
ReferenceNames.html
CVS log
|
Up to [Pegasus] / pegasus / cgi / htdocs
|
|
File: [Pegasus] / pegasus / cgi / htdocs / Attic / ReferenceNames.html
(download)
/
(as text)
Revision: 1.3, Thu Aug 28 17:10:40 2008 UTC (15 years, 9 months ago) by kumpf Branch: MAIN CVS Tags: TASK-PEP362_RestfulService-merged_out_from_trunk, TASK-PEP348_SCMO-merged_out_from_trunk, TASK-PEP317_pullop-merged_out_from_trunk, TASK-PEP317_pullop-merged_in_to_trunk, HPUX_TEST, HEAD Changes since 1.2: +0 -0 lines FILE REMOVED BUG#: 7860 TITLE: pegasus/cgi directory is obsolete DESCRIPTION: Remove unused files. |
<html>
<head>
<script>
function rTrim(tempStr){
while( tempStr.lastIndexOf(' ') == tempStr.length-1 && tempStr.length > 0 )
{
tempStr = tempStr.substring(0,tempStr.length-1)
}
document.ReferenceNames.ObjectName.value = tempStr;
}
</script>
</head>
<body bgcolor="#CCCCCC">
<table width="100%">
<tr>
<td width="50%" align="bottom"><h1>Reference Names CIM Operation</h1><td>
<td width="50%" align="right">
<img border=1 src="/pegasus/icons/OpenGroupLogo.gif">
</td>
</tr>
</table>
<hr>
<form name="ReferenceNames" METHOD=GET ACTION="/pegasus/cgi-bin/CGIClient">
<INPUT TYPE="hidden" NAME="Operation" VALUE="ReferenceNames">
<INPUT TYPE="hidden" NAME="hostaddress" VALUE="localhost:5988">
<p>
<a name="TOP"></a>
The <TT>referenceNames</TT> operation enumerates the association objects that refer to a particular target CIM Object (Class or Instance)
<p><b><a href="#NameSpace">NameSpace</a> </b> <INPUT TYPE="text" NAME="NameSpace" SIZE=30 VALUE="root/cimv2"> String that defines the target namespace. See <a href="enumeratenamespaces.html">NameSpace
Operations</a> for more information.
<p><b><a href="#ObjectName">ObjectName</a></b> <INPUT TYPE="text" NAME="ObjectName" SIZE=33> Defines
name of the Class or Instance
for which instance names are to be retrieved. This must be a legal
class in the repository or a valid Instance<p><b><a href="#ResultClass">ResultClass</a></b> <input type="text" name="ResultClass" size="34" value="NULL">
NULL or a valid CIM class name
that acts as a filter on returned set of Object Names.<p><b><a href="#Role">Role</a></b><a href="#Role"> </a> <input type="text" name="Role" size="34">
Null or valid CIM Property name.
Acts as filter on returned set of object names.
<p><INPUT TYPE="submit" VALUE="Submit Request" onClick="rTrim(document.ReferenceNames.ObjectName.value);">
<INPUT TYPE="reset" VALUE="Reset Form">
</form>
<hr>
<h2>RETURN</h2>
<p> If successful, the method returns the names of zero or more full CIM Class paths or Instance paths of Objects meeting the requested criteria. Since it is possible for CIM Objects from different hosts or namespaces to be associated, each returned path is an absolute path that includes host and namespace information.<br>
<br>
If unsuccessful, one of the following status codes 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.<br>
<ul>
<li>CIM_ERR_ACCESS_DENIED</li>
<li>CIM_ERR_NOT_SUPPORTED</li>
<li>CIM_ERR_INVALID_NAMESPACE</li>
<li>CIM_ERR_INVALID_PARAMETER (including missing, duplicate, unrecognized or otherwise incorrect parameters)</li>
<li>CIM_ERR_FAILED (some other unspecified error occurred)</li>
</ul>
<hr>
<h2>Additional Information</h2>
<p><b><a name="NameSpace">NameSpace</a></b> The NameSpace parameter is a string that defines the target
namespace. <br>
<br>
<b>
<a name="ObjectName">
ObjectName</a></b> The <TT>objectName</TT> input parameter defines the target CIM Object whose referring object names are to be returned. It may be either a Class name or an Instance name (model path).<br>
<br>
<b><a name="ResultClass">ResultClass</a> </b> - The <TT>resultClass</TT> input parameter, if not NULL, MUST be a valid CIM Class name. It acts as a filter on the returned set of Object Names by mandating that each returned Object CIMName MUST identify an Instance of this Class (or one of its subclasses), or this Class (or one of its subclasses).<br>
<br>
<b><a name="Role">Role</a></b> - The <TT>role</TT> input parameter, if not NULL, MUST be a valid CIMProperty name. It acts as a filter on the returned set of Object Names by mandating that each returned Object CIMName MUST identify an Object that refers to the target Instance via a CIMProperty whose name matches the value of this parameter.<br>
<hr>
<h2>C++ Call</h2>
<pre>virtual Array<CIMReference> referenceNames(
const String& nameSpace,
const CIMReference& objectName,
const String& resultClass = String::EMPTY,
const String& role = String::EMPTY) = 0;
</pre>
<p><a href="#TOP">Go To Top</a>
<p>
<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="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 -->Friday, June 29, 2001 07:01:54 PM<!--webbot bot="Timestamp" i-CheckSum="55121" endspan -->
Copyright @ The Open Group 2001 </font>
</body>
</html>
| No CVS admin address has been configured |
Powered by ViewCVS 0.9.2 |