Return to
AssociatorNames.html
CVS log
Up to [Pegasus] / pegasus / cgi / htdocs
|
Return to
AssociatorNames.html
CVS log
|
Up to [Pegasus] / pegasus / cgi / htdocs
|
|
File: [Pegasus] / pegasus / cgi / htdocs / Attic / AssociatorNames.html
(download)
/
(as text)
Revision: 1.4, 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.3: +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.AssociatorNames.ObjectName.value = tempStr;
}
</script>
</head>
<body bgcolor="#cccccc">
<table width="100%">
<tr>
<td width="50%" align="bottom"><h1>Associator Names CIM Operation</h1>
<td>
<td width="50%" align="right">
<img border="1" src="/pegasus/icons/OpenGroupLogo.gif">
</td>
</tr>
</table>
<hr>
<form name="AssociatorNames" METHOD="get" ACTION="/pegasus/cgi-bin/CGIClient">
<INPUT TYPE="hidden" NAME="Operation" VALUE="AssociatorNames"> <INPUT TYPE="hidden" NAME="hostaddress" VALUE="localhost:5988">
<INPUT TYPE="hidden" NAME="debug" ID="Hidden1">
<p>
<a name="TOP"></a>The <TT>associatorNames</TT>
operation enumerates the names of CIM Objects (Classes or Instances) that are
associated to a particular source CIM Object.
<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 Associator
names are to be retrieved. This must be a legal class in the repository
or a valid Instance<p><b><a href="#assocClass">AssocClass</a> </b>
<input type="text" name="AssocClass" size="33">
Association Class that acts as filter<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><b><a href="#resultRole">ResultRole</a></b> <input type="text" name="ResultRole" size="34">
Null or Valid CIM Property name that acts as filter on
returned set of names.
<p><INPUT TYPE="submit" VALUE="Submit Request" onClick="rTrim(document.AssociatorNames.ObjectName.value);">
<INPUT TYPE="reset" VALUE="Reset Form">
</form>
<hr>
<hr>
<h2>Additional Information</h2>
<p>The <TT>associatorNames</TT>
operation enumerates the names of CIM Objects (Classes or Instances) that are
associated to a particular source CIM Object.
<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="assocClass">assocClass</a></b> The <TT>assocClass</TT>
input parameter, if not NULL, MUST be a valid CIM Association Class name. It
acts as a filter on the returned set of names by mandating that each returned
name identifies an Object that MUST be associated to the source Object via an
Instance of this Class or one of its subclasses.
<p><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 names by mandating that each returned name
identifies an Object that MUST be either an Instance of this Class (or one of
its subclasses) or be this Class (or one of its subclasses).
<p><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 names by mandating that each returned name
identifies an Object that MUST be associated to the source Object via an
Association in which the source Object plays the specified role (i.e. the name
of the CIMProperty in the Association Class that refers to the source Object
MUST match the value of this parameter).
<p><b><a name="resultRole">resultRole</a></b> The <TT>resultRole</TT> input
parameter, if not <TT>NULL</TT>, MUST be a valid CIMProperty name. It acts as a
filter on the returned set of names by mandating that each returned name
identifies an Object that MUST be associated to the source Object via an
Association in which the named returned Object plays the specified role (i.e.
the name of the CIMProperty in the Association Class that refers to the
returned Object MUST match the value of this parameter).
<hr>
<h2>Return</h2>
<p>
If successful, the method returns 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. 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.
<UL>
<LI>
CIM_ERR_ACCESS_DENIED
<LI>
CIM_ERR_NOT_SUPPORTED
<LI>
CIM_ERR_INVALID_NAMESPACE;
<LI>
CIM_ERR_INVALID_PARAMETER (including missing, duplicate, unrecognized or
otherwise incorrect parameters)
<LI>
CIM_ERR_FAILED (some other unspecified error occurred)</LI>
</UL>
<hr>
<h2>C++ Call</h2>
<pre>
virtual Array<CIMReference> associatorNames(
const String& nameSpace,
const CIMReference& objectName,
const String& assocClass = String::EMPTY,
const String& resultClass = String::EMPTY,
const String& role = String::EMPTY,
const String& resultRole = String::EMPTY) = 0;
<a href="#TOP">Go To Top</a> </pre>
<hr>
<p style="MARGIN-TOP: 0px; MARGIN-BOTTOM: 0px">
<font size="2">Demonstration Prepared by the OpenGroup Manageability Work Group
Pegasus Development Team</font>
<p style="MARGIN-TOP: 0px; MARGIN-BOTTOM: 0px">
<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: 0px; MARGIN-BOTTOM: 0px">
<font size="1">Last Modified <!--webbot bot="Timestamp" S-Type="EDITED"
S-Format="%A, %B %d, %Y %I:%M:%S %p" startspan -->
Friday, July 06, 2001 08:43:53 PM<!--webbot bot="Timestamp" i-CheckSum="55129" endspan -->
Copyright @ The Open Group 2001 </font>
<pre> </pre>
<pre> <script>
document.AssociatorNames.hostaddress.value = top.hostAddress;
document.AssociatorNames.debug.value = top.debug;
document.AssociatorNames.NameSpace.text = top.namespace;
window.focus();
</script></pre>
</body>
</html>
| No CVS admin address has been configured |
Powered by ViewCVS 0.9.2 |