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.2, Fri Jul 6 18:33:36 2001 UTC (22 years, 11 months ago) by karl Branch: MAIN CVS Tags: version_1_01, version_0_99_1, version_0_99, version_0_79_4, test, pep_88, merge_of_dev, mday-merge-start, mday-merge-pegasus/src/Pegasus/Server, mday-merge-pegasus/src/Pegasus/Common, mday-2-0-patches, main, local, dev_dead, dev, VERSION_2_1_RELEASE_HEAD, VERSION_2_1_RELEASE_BRANCH, VERSION_2_1_RELEASE, VERSION_2_1_1_RELEASE, VERSION_2_01_01, VERSION_2_00_RC_4, VERSION_2_00_RC_3, VERSION_2_00_RC_2, VERSION_2_00_RC_1, VERSION_2_00_BRANCH, VERSION_1_10, VERSION_1_09, VERSION_1_08, VERSION_1_07, TEST, SNAPSHOT_1_04, RELEASE_2_3_2-testfreeze, RELEASE_2_3_2-root, RELEASE_2_3_2-releasesnapshot, RELEASE_2_3_2-branch-freeze, RELEASE_2_3_2-branch, RELEASE_2_3_1-root, RELEASE_2_3_1-branch, RELEASE_2_3_0-root, RELEASE_2_3_0-msg-freeze, RELEASE_2_3_0-branch, RELEASE_2_2_1-snapshot, RELEASE_2_2_0_0-release, RELEASE_2_2_0-root, RELEASE_2_2_0-branch, RELEASE_2_2-root, PRE_LICENSE_UPDATE_2003, POST_LICENSE_UPDATE_2003, PEGASUS_FC_VERSION_2_2, LOCAL_ASSOCPROV-ROOT, LOCAL_ASSOCPROV-BRANCH Changes since 1.1: +11 -9 lines add assocation |
<html>
<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="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>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="getnamespaces.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
for which instance names are to be retrieved. This must be a legal
class in the repository<p><b><a href="#assocClass">AssocClass</a> </b> <input type="text" name="AssocClass" size="33">
NULL or association Class that acts as filter<p><b><a href="#ResultClass">ResultClass</a></b>
<input type="text" name="ResultClass" size="34"> 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">
<INPUT TYPE="reset" VALUE="Reset">
</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: 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, 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.ReferenceNames.hostaddress.value = top.hostAddress;
document.ReferenceNames.debug = top.debug;
document.ReferenceNames.NameSpace = top.namespace;
window.focus();
</script></pre>
</body>
</html>
| No CVS admin address has been configured |
Powered by ViewCVS 0.9.2 |