pegasus/cgi/htdocs/AssociatorNames.html - annotate

Return to AssociatorNames.html CVS log

Up to [Pegasus] / pegasus / cgi / htdocs

1 karl 1.1 <html>
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;
141 karl 1.1 window.focus(); 142 </script></pre>
143 a.arora 1.3 </body>
144 karl 1.1 </html>

No CVS admin address has been configured