(file) Return to GetInstance.html CVS log (file) (dir) Up to [Pegasus] / pegasus / cgi / htdocs

 1 karl  1.1 <html>
 2             <body bgcolor="#CCCCCC">
 3               <table width="100%">
 4                 <tr>
 5           	<td width="50%" align="bottom"><h1>GetClass Operation</h1><td>
 6           	<td width="50%" align="right">
 7           	  <img border=1 src="http://localhost/pegasus/icons/OpenGroupLogo.gif
 8           	  ">
 9                   </td>
10                 </tr>
11               </table>
12               <hr></hr>
13               <form METHOD=GET ACTION="/pegasus/cgi-bin/CGIClient">
14                 <INPUT TYPE="hidden" NAME="Operation" VALUE="GetClass">
15           	  <P>The <<TT>GetInstance</TT> method returns a single CIM Instance from the target
16           	  Namespace based on the InstanceName parameter provided.
17           
18                 <p><b>NameSpace</b> <INPUT TYPE="text" NAME="NameSpace" SIZE=30 VALUE="root/cimv20">
19                 The NameSpace parameter is a string that defines the target namespace.
20           
21                 <p><b>InstanceName</b> <INPUT TYPE="text" NAME="InstanceName" SIZE=30>
22 karl  1.1       The InstanceName input parameter defines the name of the Class to be
23                 retrieved.
24           
25                 <p><b>LocalOnly</b> <INPUT TYPE="checkbox" NAME="LocalOnly" VALUE="true" checked>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
26                 If the <TT>LocalOnly</TT> input parameter is true, this specifies that only CIM
27                 Elements (properties, methods and qualifiers) overriden within the definition of
28                 the Class are returned.  If false, all elements are returned.  This parameter
29                 therefore effects a CIM Server-side mechanism to filter certain elements of the
30                 returned object based on whether or not they have been propagated from the parent
31                 Class (as defined by the PROPAGATED attribute).
32           
33                 <p><b>IncludeQualifiers</b> <INPUT TYPE="checkbox" NAME="IncludeQualifiers" VALUE="true">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
34                 If the <TT>IncludeQualifiers</TT> input parameter is true, this specifies that
35                 all Qualifiers for that Class (including Qualifiers on the Class and on any
36                 returned Properties, Methods or Method Parameters) MUST be included as <QUALIFIER>
37                 elements in the response.  If false no QUALIFIER elements are present in the
38                 returned Class.
39           
40                 <p><b>IncludeClassOrigins</b> <INPUT TYPE="checkbox" NAME="IncludeClassOrigins" VALUE="true">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
41                 If the <TT>IncludeClassOrigin</TT> input parameter is true, this specifies that
42                 the CLASSORIGIN attribute MUST be present on all appropriate elements in the returned
43 karl  1.1       Class. If false, no CLASSORIGIN attributes are present in the returned Class.
44           
45                 <p><b>PropertyList </b> <INPUT TYPE="text" NAME="PropertyList" SIZE=30 VALUE="NULL">
46                 NOTE: <b> NOT IMPLEMENTED</b>.
47                 If the <TT>PropertyList</TT> input parameter is not NULL, the members of the array
48                 define one or more Property names.  The returned Class MUST NOT include elements for any
49                 Properties missing from this list. Note that if <TT>LocalOnly</TT> is specified as true this acts
50                 as an additional filter on the set of Properties returned (for example, if Property A is
51                 included in the <TT>PropertyList</TT> but <TT>LocalOnly</TT> is set to true and A is not local to the
52                 requested Class, then it will not be included in the response). If the <TT>PropertyList</TT>
53                 input parameter is an empty array this signifies that no Properties are included in
54                 the response. If the PropertyList input parameter is NULL this specifies that all
55                 Properties (subject to the conditions expressed by the other parameters) are included
56                 in the response.
57                 <p>If the <TT>PropertyList</TT> contains duplicate elements, the Server MUST ignore
58                 the duplicates but otherwise process the request normally. If the PropertyList contains
59                 elements which are invalid Property names for the target Class, the Server MUST ignore
60                 such entries but otherwise process the request normally.
61           
62                 <p><INPUT TYPE="submit" VALUE="Submit Request">
63                 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
64 karl  1.1       &nbsp;&nbsp;&nbsp;&nbsp;
65                 <INPUT TYPE="reset" VALUE="Reset Form">
66           
67           
68                 <p><b>RETURN - </b>If successful, the return value is a single CIM
69                 Class.If unsuccessful, one of the following status codes MUST be returned by this
70           	  method, where the first applicable error in the list (starting with the first element of
71           	  the list, and working down) is the error returned. Any additional method- specific
72           	  interpretation of the error in is given in parentheses
73                 <p>&nbsp;
74           	</form>
75           
76             </body>
77           </html>
78           

No CVS admin address has been configured
Powered by
ViewCVS 0.9.2