2 a.arora 1.3 <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.AssociatorNames.ObjectName.value = tempStr;
10 }
11 </script>
12 </head>
13 <body bgcolor="#cccccc">
14 <table width="100%">
15 <tr>
16 <td width="50%" align="bottom"><h1>Associator Names CIM Operation</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.3 <hr>
24 <form name="AssociatorNames" METHOD="get" ACTION="/pegasus/cgi-bin/CGIClient">
25 <INPUT TYPE="hidden" NAME="Operation" VALUE="AssociatorNames"> <INPUT TYPE="hidden" NAME="hostaddress" VALUE="localhost:5988">
26 <INPUT TYPE="hidden" NAME="debug" ID="Hidden1">
27 <p>
28 <a name="TOP"></a>The <TT>associatorNames</TT>
29 operation enumerates the names of CIM Objects (Classes or Instances) that are
30 associated to a particular source CIM Object.
31 <p><b><a href="#NameSpace">NameSpace</a></b> <INPUT TYPE="text" NAME="NameSpace" SIZE="30" VALUE="root/cimv2">
32 String that defines the target namespace. See <a href="enumeratenamespaces.html">NameSpace
33 Operations</a>
34 for more information.
35 <p><b><a href="#ObjectName">ObjectName</a> </b> <INPUT TYPE="text" NAME="ObjectName" SIZE="33">
36 Defines name of the Class or Instance for which Associator
37 names are to be retrieved. This must be a legal class in the repository
38 or a valid Instance<p><b><a href="#assocClass">AssocClass</a> </b>
39 <input type="text" name="AssocClass" size="33">
40 Association Class that acts as filter<p><b><a href="#ResultClass">ResultClass</a></b>
41 <input type="text" name="ResultClass" size="34" value="NULL">
42 NULL or a valid CIM class name that acts as a filter on returned set of Object
43 Names.<p><b><a href="#Role">Role</a></b><a href="#Role"> </a>
44 a.arora 1.3 <input type="text" name="Role" size="34">
45 Null or valid CIM Property name. Acts as filter on returned set of object
46 names.<p><b><a href="#resultRole">ResultRole</a></b> <input type="text" name="ResultRole" size="34">
47 Null or Valid CIM Property name that acts as filter on
48 returned set of names.
49 <p><INPUT TYPE="submit" VALUE="Submit Request" onClick="rTrim(document.AssociatorNames.ObjectName.value);">
50 <INPUT TYPE="reset" VALUE="Reset Form">
51 </form>
52 <hr>
53 <hr>
54 <h2>Additional Information</h2>
55 <p>The <TT>associatorNames</TT>
56 operation enumerates the names of CIM Objects (Classes or Instances) that are
57 associated to a particular source CIM Object.
58 <p><b><a name="NameSpace">NameSpace</a></b> The NameSpace parameter is a string
59 that defines the target namespace. <br>
60 <br>
61 <b><a name="ObjectName">ObjectName</a></b> The <TT>objectName</TT> input
62 parameter defines the target CIM Object whose referring object names are to be
63 returned. It may be either a Class name or an Instance name (model path).<br>
64 <br>
65 a.arora 1.3 <b><a name="assocClass">assocClass</a></b> The <TT>assocClass</TT>
66 input parameter, if not NULL, MUST be a valid CIM Association Class name. It
67 acts as a filter on the returned set of names by mandating that each returned
68 name identifies an Object that MUST be associated to the source Object via an
69 Instance of this Class or one of its subclasses.
70 <p><b><a name="resultClass">resultClass</a></b> The <TT>resultClass</TT>
71 input parameter, if not NULL, MUST be a valid CIM Class name. It acts as a
72 filter on the returned set of names by mandating that each returned name
73 identifies an Object that MUST be either an Instance of this Class (or one of
74 its subclasses) or be this Class (or one of its subclasses).
75 <p><b><a name="role">role</a></b> The <TT>role</TT>
76 input parameter, if not NULL, MUST be a valid CIMProperty name. It acts as a
77 filter on the returned set of names by mandating that each returned name
78 identifies an Object that MUST be associated to the source Object via an
79 Association in which the source Object plays the specified role (i.e. the name
80 of the CIMProperty in the Association Class that refers to the source Object
81 MUST match the value of this parameter).
82 <p><b><a name="resultRole">resultRole</a></b> The <TT>resultRole</TT> input
83 parameter, if not <TT>NULL</TT>, MUST be a valid CIMProperty name. It acts as a
84 filter on the returned set of names by mandating that each returned name
85 identifies an Object that MUST be associated to the source Object via an
86 a.arora 1.3 Association in which the named returned Object plays the specified role (i.e.
87 the name of the CIMProperty in the Association Class that refers to the
88 returned Object MUST match the value of this parameter).
89 <hr>
90 <h2>Return</h2>
91 <p>
92 If successful, the method returns zero or more full CIM Class paths or Instance
93 paths of Objects meeting the requested criteria. Since it is possible for CIM
94 Objects from different hosts or namespaces to be associated, each returned path
95 is an absolute path that includes host and namespace information. If
96 unsuccessful, one of the following status codes MUST be returned by this
97 method, where the first applicable error in the list (starting with the first
98 element of the list, and working down) is the error returned. Any additional
99 method-specific interpretation of the error in is given in parentheses.
100 <UL>
101 <LI>
102 CIM_ERR_ACCESS_DENIED
103 <LI>
104 CIM_ERR_NOT_SUPPORTED
105 <LI>
106 CIM_ERR_INVALID_NAMESPACE;
107 a.arora 1.3 <LI>
108 CIM_ERR_INVALID_PARAMETER (including missing, duplicate, unrecognized or
109 otherwise incorrect parameters)
110 <LI>
111 CIM_ERR_FAILED (some other unspecified error occurred)</LI>
112 </UL>
113 <hr>
114 <h2>C++ Call</h2>
115 <pre>
|
116 karl 1.1 virtual Array<CIMReference> associatorNames(
117 const String& nameSpace,
118 const CIMReference& objectName,
119 const String& assocClass = String::EMPTY,
120 const String& resultClass = String::EMPTY,
121 const String& role = String::EMPTY,
122 const String& resultRole = String::EMPTY) = 0;
123 <a href="#TOP">Go To Top</a> </pre>
|
124 a.arora 1.3 <hr>
125 <p style="MARGIN-TOP: 0px; MARGIN-BOTTOM: 0px">
126 <font size="2">Demonstration Prepared by the OpenGroup Manageability Work Group
127 Pegasus Development Team</font>
128 <p style="MARGIN-TOP: 0px; MARGIN-BOTTOM: 0px">
129 <font size="2">See (<a href="http://www.opengroup.org/management">http://www.opengroup.org/management</a>)
130 for more information on Pegasus</font>
131 <p style="MARGIN-TOP: 0px; MARGIN-BOTTOM: 0px">
132 <font size="1">Last Modified <!--webbot bot="Timestamp" S-Type="EDITED"
133 S-Format="%A, %B %d, %Y %I:%M:%S %p" startspan -->
134 Friday, July 06, 2001 08:43:53 PM<!--webbot bot="Timestamp" i-CheckSum="55129" endspan -->
135 Copyright @ The Open Group 2001 </font>
136 <pre> </pre>
137 <pre> <script>
138 document.AssociatorNames.hostaddress.value = top.hostAddress;
139 document.AssociatorNames.debug.value = top.debug;
140 document.AssociatorNames.NameSpace.text = top.namespace;
|