version 1.9, 2006/01/30 16:17:59
|
version 1.10, 2008/01/16 11:35:10
|
|
|
// | // |
//============================================================================== | //============================================================================== |
// | // |
// Author: Mike Brasher (mbrasher@bmc.com) |
|
// Marek Szermutzky (MSzermutzky@de.ibm.com) PEP#139 Stage2 |
|
// |
|
// Modified By: Nitin Upasani, Hewlett-Packard Company (Nitin_Upasani@hp.com) |
|
// Yi Zhou, Hewlett-Packard Company (yi_zhou@hp.com) |
|
// Nag Boranna, Hewlett-Packard Company (nagaraja_boranna@hp.com) |
|
// Roger Kumpf, Hewlett-Packard Company (roger_kumpf@hp.com) |
|
// Carol Ann Krug Graves, Hewlett-Packard Company |
|
// (carolann_graves@hp.com) |
|
// Jair Santos, Hewlett-Packard Company (jair.santos@hp.com) |
|
// David Dillard, VERITAS Software Corp. |
|
// (david.dillard@veritas.com) |
|
// |
|
//%///////////////////////////////////////////////////////////////////////////// | //%///////////////////////////////////////////////////////////////////////////// |
#ifndef Pegasus_CIMManagedClient_h | #ifndef Pegasus_CIMManagedClient_h |
#define Pegasus_CIMManagedClient_h | #define Pegasus_CIMManagedClient_h |
| |
#include "CIMClientConnectionManager.h" | #include "CIMClientConnectionManager.h" |
| |
// #define CDEBUG(X) PEGASUS_STD(cout) << "CIMManagedClient:" << X << PEGASUS_STD(endl) |
|
#define CDEBUG(X); | #define CDEBUG(X); |
| |
PEGASUS_NAMESPACE_BEGIN | PEGASUS_NAMESPACE_BEGIN |
|
|
| |
@param port - input parameter, string containing port of CIMOM | @param port - input parameter, string containing port of CIMOM |
| |
@param nameSpace The nameSpace parameter is a string that defines the target |
@param nameSpace parameter nameSpace is a string that defines the target |
namespace. See defintion of | namespace. See defintion of |
\URL[Namespace]{DefinitionofTerms.html#NAMESPACE}. | \URL[Namespace]{DefinitionofTerms.html#NAMESPACE}. |
| |
|
|
| |
Only elements (properties, methods and qualifiers) defined or | Only elements (properties, methods and qualifiers) defined or |
overridden within the class are included in the response. Propagated | overridden within the class are included in the response. Propagated |
properties are not included because their values are based on another class’ |
properties are not included because their values are based on another class |
information. If not specified, all elements of the class’ definition are | information. If not specified, all elements of the class’ definition are |
returned. Note: When instances are returned, the InstanceName must include | returned. Note: When instances are returned, the InstanceName must include |
all keys, including propagated keys. Therefore, these attributes are | all keys, including propagated keys. Therefore, these attributes are |
|
|
| |
@param host - input parameter, string containing hostname of CIMOM | @param host - input parameter, string containing hostname of CIMOM |
@param port - input parameter, string containing port of CIMOM | @param port - input parameter, string containing port of CIMOM |
@param nameSpace The nameSpace parameter is a string that defines the target |
@param nameSpace Parameter nameSpace is a string that defines the target |
namespace. See defintion of | namespace. See defintion of |
\URL[Namespace]{DefinitionofTerms.html#NAMESPACE}. | \URL[Namespace]{DefinitionofTerms.html#NAMESPACE}. |
@param className The <TT>className</TT> input parameter defines the Class | @param className The <TT>className</TT> input parameter defines the Class |
|
|
Class. If false, no <TT>CLASSORIGIN</TT> attributes are present in each | Class. If false, no <TT>CLASSORIGIN</TT> attributes are present in each |
returned Class. | returned Class. |
| |
@return If successful, the method returns zero or more Classes that meet the |
@return If successful, method returns zero or more Classes that meet the |
required criteria. | required criteria. |
| |
If unsuccessful, one of the following status codes MUST be returned by | 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 |
this method, where the first applicable error in the list (starting with |
first element of the list, and working down) is the error returned. Any |
the first element of the list, and working down) is the error returned. |
additional method-specific interpretation of the error in is given in |
Any additional method-specific interpretation of the error in is given in |
parentheses. | parentheses. |
| |
<UL> | <UL> |
|
|
Boolean includeClassOrigin = false | Boolean includeClassOrigin = false |
); | ); |
| |
/** The <TT>enumerateClassNames</TT> operation is used to enumerate the |
/** The <TT>enumerateClassNames</TT> operation is used to enumerate |
names of subclasses of a CIM Class in the target Namespace. |
the names of subclasses of a CIM Class in the target Namespace. |
| |
@param host - input parameter, string containing hostname of CIMOM | @param host - input parameter, string containing hostname of CIMOM |
@param port - input parameter, string containing port of CIMOM | @param port - input parameter, string containing port of CIMOM |
@param nameSpace The nameSpace parameter is a string that defines the target |
@param nameSpace Parameter nameSpace is a string that defines the target |
namespace. See defintion of | namespace. See defintion of |
\URL[Namespace]{DefinitionofTerms.html#NAMESPACE}. | \URL[Namespace]{DefinitionofTerms.html#NAMESPACE}. |
@param className The <TT>className</TT> input parameter defines the Class | @param className The <TT>className</TT> input parameter defines the Class |
that is the basis for the enumeration. | that is the basis for the enumeration. |
@param deepInheritance If the <TT>deepInheritance</TT> input parameter is | @param deepInheritance If the <TT>deepInheritance</TT> input parameter is |
true, this specifies that the names of all subclasses of the specified Class |
true, this specifies that the names of all subclasses of the specified |
should be returned (if the ClassName input parameter is absent, this implies |
Class should be returned (if the ClassName input parameter is absent, this |
that the names of all Classes in the target Namespace should be returned). |
implies that the names of all Classes in the target Namespace should be |
|
returned). |
If false, only the names of immediate child subclasses are returned (if the | If false, only the names of immediate child subclasses are returned (if the |
className input parameter is NULL, this implies that the names of all base | className input parameter is NULL, this implies that the names of all base |
Classes in the target Namespace should be returned). @return If successful, |
Classes in the target Namespace should be returned). |
the method returns zero or more names of Classes that meet the requested |
|
criteria. If unsuccessful, one of the following status codes MUST be |
@return If successful, the method returns zero or more names of Classes |
returned by this method, where the first applicable error in the list |
that meet the requested criteria. If unsuccessful, one of the following |
(starting with the first element of the list, and working down) is the error |
status codes MUST be returned by this method, where the first applicable |
returned. Any additional method-specific interpretation of the error in is |
error in the list (starting with the first element of the list, and |
given in parentheses. |
working down) is the error returned. Any additional method-specific |
|
interpretation of the error in is given in parentheses. |
| |
<UL> | <UL> |
<LI>CIM_ERR_ACCESS_DENIED | <LI>CIM_ERR_ACCESS_DENIED |
|
|
| |
@param host - input parameter, string containing hostname of CIMOM | @param host - input parameter, string containing hostname of CIMOM |
@param port - input parameter, string containing port of CIMOM | @param port - input parameter, string containing port of CIMOM |
@param nameSpace (Required) The <TT>nameSpace</TT> parameter is a CIMName |
@param nameSpace (Required) The <TT>nameSpace</TT> parameter is |
object that defines the target Namespace. See definition of |
a CIMName object that defines the target Namespace. See definition of |
\URL[Namespace]{DefinitionofTerms.html#NAMESPACE}. | \URL[Namespace]{DefinitionofTerms.html#NAMESPACE}. |
@param className (Required)The <TT>className</TT> input parameter is a CIMName |
@param className (Required)The <TT>className</TT> input parameter is |
object that defines the name of the Class to be retrieved. |
a CIMName object that defines the name of the Class to be retrieved. |
@param localOnly (Boolean, Optional, default = true, Input) If the | @param localOnly (Boolean, Optional, default = true, Input) If the |
<TT>localOnly</TT> input | <TT>localOnly</TT> input |
parameter is true, this specifies that only CIM Elements (properties, | parameter is true, this specifies that only CIM Elements (properties, |
methods and qualifiers) overridden within the definition of the Class are |
methods and qualifiers) overridden within the definition of the Class |
returned. If false, all elements are returned. This parameter therefore |
are returned. If false, all elements are returned. This parameter |
effects a CIM Server-side mechanism to filter certain elements of the |
therefore effects a CIM Server-side mechanism to filter certain |
returned object based on whether or not they have been propagated from the |
elements of the returned object based on whether or not they have been |
parent Class (as defined by the PROPAGATED attribute). |
propagated from the parent Class (as defined by |
|
the PROPAGATED attribute). |
@param includeQualifiers (Boolean, Optional, default = true, Input) If the |
|
<TT>includeQualifiers</TT> input parameter is true, this specifies that |
@param includeQualifiers (Boolean, Optional, default = true, Input) |
all Qualifiers for that Class (including Qualifiers on the Class and on |
If the <TT>includeQualifiers</TT> input parameter is true, this |
any returned Properties, Methods or CIMMethod Parameters) MUST be included |
specifies that all Qualifiers for that Class (including Qualifiers |
as elements in the response. If false no QUALIFIER elements are present |
on the Class and on any returned Properties, Methods or |
|
CIMMethod Parameters) MUST be included as elements in the response. |
|
If false no QUALIFIER elements are present |
in the returned Class object. | in the returned Class object. |
| |
@param includeClassOrigin (Boolean,Optional, default = false, Input) If | @param includeClassOrigin (Boolean,Optional, default = false, Input) If |
the <TT>includeClassOrigin</TT> input parameter is true, this specifies | the <TT>includeClassOrigin</TT> input parameter is true, this specifies |
that the CLASSORIGIN attribute MUST be present on all appropriate elements |
that the CLASSORIGIN attribute MUST be present on all appropriate |
in the returned Class. If false, no CLASSORIGIN attributes are present in |
elements in the returned Class. If false, no CLASSORIGIN attributes |
the returned Class. |
are present in the returned Class. |
| |
@param propertyList (optional, Input) If the <TT>propertyList</TT> | @param propertyList (optional, Input) If the <TT>propertyList</TT> |
CIMPropertyList input parameter is not NULL, the members of the array | CIMPropertyList input parameter is not NULL, the members of the array |
define one or more CIMProperty names. The returned Class WILL NOT include |
define one or more CIMProperty names. The returned Class WILL NOT |
elements for any Properties missing from this list. Note that if |
include elements for any Properties missing from this list. Note that |
LocalOnly is specified as true this acts as an additional filter on the |
if LocalOnly is specified as true this acts as an additional filter on |
set of Properties returned (for example, if CIMProperty A is included in |
the set of Properties returned (for example, if CIMProperty A is |
the PropertyList but LocalOnly is set to true and A is not local to the |
included in the PropertyList but LocalOnly is set to true and A is |
requested Class, then it will not be included in the response). If the |
not local to the requested Class, then it will not be included in |
PropertyList input parameter is an empty array this signifies that no |
the response). |
Properties are included in the response. If the PropertyList input |
If the PropertyList input parameter is an empty array this signifies |
parameter is NULL this specifies that all Properties (subject to the |
that no Properties are included in the response. If the PropertyList |
conditions expressed by the other parameters) are included in the |
input parameter is NULL this specifies that all Properties (subject |
response. |
to the conditions expressed by the other parameters) are included |
|
in the response. |
@see CIMPropertyList | @see CIMPropertyList |
| |
If the <TT>propertyList</TT> contains duplicate elements, the Server | If the <TT>propertyList</TT> contains duplicate elements, the Server |
|
|
| |
@return If successful, the return value is a single CIMClass objcet. | @return If successful, the return value is a single CIMClass objcet. |
| |
If unsuccessful, an exception is executed. If the error is local, this may |
If unsuccessful, an exception is executed. If the error is local, |
be any local exception. |
this may be any local exception. |
If the error is in the host normally a CIMException is returned with one of the |
If the error is in the host normally a CIMException |
|
is returned with one of the |
following CIMException codes, where the first applicable error in the | following CIMException codes, where the first applicable error in the |
list (starting with the first element of the list, and working down) is the error |
list (starting with the first element of the list, and working down) |
returned. Any additional method-specific interpretation of the error is given |
is the error returned. Any additional method-specific interpretation |
in parentheses. |
of the error is given in parentheses. |
<UL> | <UL> |
<LI>CIM_ERR_ACCESS_DENIED | <LI>CIM_ERR_ACCESS_DENIED |
<LI>CIM_ERR_INVALID_NAMESPACE | <LI>CIM_ERR_INVALID_NAMESPACE |
|
|
| |
@param port - input parameter, string containing port of CIMOM | @param port - input parameter, string containing port of CIMOM |
| |
@param nameSpace The nameSpace parameter is a CIMName that defines the target |
@param nameSpace Parameter nameSpace is a CIMName that defines the target |
namespace. See defintion of | namespace. See defintion of |
\URL[Namespace]{DefinitionofTerms.html#NAMESPACE}. | \URL[Namespace]{DefinitionofTerms.html#NAMESPACE}. |
| |
@param qualifierName CIMName <TT>qualifierName</TT> input parameter identifies |
@param qualifierName CIMName <TT>qualifierName</TT> input parameter |
the CIMQualifier whose declaration to be deleted. |
identifies the CIMQualifier whose declaration to be deleted. |
| |
@return If successful, the specified CIMQualifier declaration MUST have been deleted |
@return If successful, the specified CIMQualifier declaration MUST have |
from the Namespace with a normal return from the call. |
been deleted from the Namespace with a normal return from the call. |
| |
If there is any error one of the CIMException errors is returned. The | If there is any error one of the CIMException errors is returned. The |
errors are based on the CIM error codes defined below: | errors are based on the CIM error codes defined below: |
|
|
<LI>CIM_ERR_ACCESS_DENIED | <LI>CIM_ERR_ACCESS_DENIED |
<LI>CIM_ERR_NOT_SUPPORTED | <LI>CIM_ERR_NOT_SUPPORTED |
<LI>CIM_ERR_INVALID_NAMESPACE | <LI>CIM_ERR_INVALID_NAMESPACE |
<LI>CIM_ERR_INVALID_PARAMETER (including missing, duplicate, unrecognized or |
<LI>CIM_ERR_INVALID_PARAMETER (including missing, |
otherwise incorrect parameters) |
duplicate, unrecognized or otherwise incorrect parameters) |
<LI>CIM_ERR_FAILED (some other unspecified error occurred)</LI> | <LI>CIM_ERR_FAILED (some other unspecified error occurred)</LI> |
</UL> | </UL> |
@exception CIMexception - May return any of the CIMException codes defined above. |
@exception CIMexception - May return any of the CIMException codes |
|
defined above. |
@exception Exception | @exception Exception |
<pre> | <pre> |
// simple function to delete qualifier named "Expensive". Exceptions ignored. |
// simple function to delete qualifier named "Expensive". |
|
// Exceptions ignored. |
CIMClient client; | CIMClient client; |
client.connect("localhost", 5988, String::EMPTY, String::EMPTY); | client.connect("localhost", 5988, String::EMPTY, String::EMPTY); |
CIMName qualifierName("Expensive"); | CIMName qualifierName("Expensive"); |
|
|
| |
@param port - input parameter, string containing port of CIMOM | @param port - input parameter, string containing port of CIMOM |
| |
@param nameSpace The nameSpace parameter is a CIMNameSpace object that defines |
@param nameSpace Parameter nameSpace is a CIMNameSpace object that defines |
the target namespace. See defintion of | the target namespace. See defintion of |
\URL[Namespace]{DefinitionofTerms.html#NAMESPACE}. | \URL[Namespace]{DefinitionofTerms.html#NAMESPACE}. |
| |
@param qualifierName The <TT>qualifierName</TT> input parameter is a CIMName object |
@param qualifierName The <TT>qualifierName</TT> input parameter |
that identifies the CIMQualifier whose declaration to be retrieved. |
is a CIMName object that identifies the CIMQualifier |
|
whose declaration to be retrieved. |
| |
@return If successful, the method returns the CIMQualifier declaration for | @return If successful, the method returns the CIMQualifier declaration for |
the named CIMQualifier. | the named CIMQualifier. |
|
|
| |
@param port - input parameter, string containing port of CIMOM | @param port - input parameter, string containing port of CIMOM |
| |
@param nameSpace The nameSpace parameter is a CIMName that defines the target |
@param nameSpace The nameSpace parameter is a CIMName that defines |
namespace. See defintion of |
the target namespace. See defintion of |
\URL[Namespace]{DefinitionofTerms.html#NAMESPACE}. | \URL[Namespace]{DefinitionofTerms.html#NAMESPACE}. |
| |
@param CIMQualifierDecl The <TT>CIMQualifierDecl</TT> input parameter is a | @param CIMQualifierDecl The <TT>CIMQualifierDecl</TT> input parameter is a |
|
|
CIMQualifier name already existed, then it MUST have been replaced by the | CIMQualifier name already existed, then it MUST have been replaced by the |
new declaration. | new declaration. |
| |
If unsuccessful, a CIMException with one of the following status codes MUST be returned |
If unsuccessful, a CIMException with one of the following |
|
status codes MUST be returned |
by this method, where the first applicable error in the list (starting with | 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 | 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 | additional method-specific interpretation of the error in is given in |
|
|
} | } |
catch(Exception& e) | catch(Exception& e) |
{ | { |
PEGASUS_STD(cerr) << "Error: " << e.getMessage() << PEGASUS_STD(endl); |
PEGASUS_STD(cerr) << "Error: " |
|
<< e.getMessage() << PEGASUS_STD(endl); |
exit(1); | exit(1); |
} | } |
for (Uint32 i = 0; i < qualifierDecls.size(); i++) | for (Uint32 i = 0; i < qualifierDecls.size(); i++) |
|
|
@param instanceName The <TT>instanceName</TT> input parameter specifies the | @param instanceName The <TT>instanceName</TT> input parameter specifies the |
name of the Instance (model path) from which the CIMProperty value is | name of the Instance (model path) from which the CIMProperty value is |
requested. \\Ref{INSTANCENAME} | requested. \\Ref{INSTANCENAME} |
It is a full specified object path, thus it consists also of target namespace, |
It is a full specified object path, thus it consists also |
hostname and port |
of target namespace, hostname and port |
| |
@param propertyName The <TT>propertyName</TT> input parameter specifies the | @param propertyName The <TT>propertyName</TT> input parameter specifies the |
name of the CIMProperty whose value is to be returned. | name of the CIMProperty whose value is to be returned. |
|
|
@param instanceName The <TT>instanceName</TT> input parameter specifies the | @param instanceName The <TT>instanceName</TT> input parameter specifies the |
name of the Instance (model path) for which the CIMProperty value is to be | name of the Instance (model path) for which the CIMProperty value is to be |
updated. | updated. |
It consists of a full specified object path, thus it consists also of target namespace, |
It consists of a full specified object path, thus it consists also |
hostname and port |
of target namespace, hostname and port |
| |
@param propertyName The <TT>propertyName</TT> input parameter specifies the | @param propertyName The <TT>propertyName</TT> input parameter specifies the |
name of the CIMProperty whose value is to be updated. | name of the CIMProperty whose value is to be updated. |
|
|
| |
@param instanceName The <TT>instanceName</TT> input parameter defines | @param instanceName The <TT>instanceName</TT> input parameter defines |
the name (model path) of the Instance to be deleted. | the name (model path) of the Instance to be deleted. |
It is a full specified object path, thus it consists also of target namespace, |
It is a full specified object path, thus it consists also |
hostname and port |
of target namespace, hostname and port |
| |
@return If successful, the specified Instance MUST have been removed | @return If successful, the specified Instance MUST have been removed |
by the CIM Server. | by the CIM Server. |
|
|
@param newInstance The <TT>newInstance</TT> input parameter defines the new | @param newInstance The <TT>newInstance</TT> input parameter defines the new |
Instance. The proposed definition MUST be a correct Instance definition for | Instance. The proposed definition MUST be a correct Instance definition for |
the underlying CIM Class according to the CIM specification. | the underlying CIM Class according to the CIM specification. |
It consists of a full specified object path, thus it consists also of target namespace, |
It consists of a full specified object path, thus it consists also |
hostname and port |
of target namespace, hostname and port |
| |
@return If successful, the return value defines the object path of the new | @return If successful, the return value defines the object path of the new |
CIM Instance relative to the target Namespace (i.e. the Model Path as | CIM Instance relative to the target Namespace (i.e. the Model Path as |
|
|
| |
@param instanceName CIMobjectpath that identifies this CIM instance. | @param instanceName CIMobjectpath that identifies this CIM instance. |
This must include all of the keys. | This must include all of the keys. |
It is a full specified object path, thus it consists also of target namespace, |
It is a full specified object path, thus it consists also |
hostname and port |
of target namespace, hostname and port |
| |
@param localOnly If true, only properties and qualifiers overridden | @param localOnly If true, only properties and qualifiers overridden |
or defined in the returned Instance are included in the response. | or defined in the returned Instance are included in the response. |
|
|
| |
@param includeClassOrigin If true, CLASSORIGIN attribute MUST be | @param includeClassOrigin If true, CLASSORIGIN attribute MUST be |
present on all appropriate elements in each returned Object. If false, | present on all appropriate elements in each returned Object. If false, |
no CLASSORIGIN attributes are present in each returned Object. The CLASSORIGIN |
no CLASSORIGIN attributes are present in each returned Object. |
attribute is defined in the DMTF's Specification for the Representation of CIM |
The CLASSORIGIN attribute is defined in the DMTF's Specification for |
in XML. CLASSORIGIN is an XML tag identifying the following text as a class name. |
the Representation of CIM in XML. |
It is attached to a property or method (when specified in XML), to indicate the |
CLASSORIGIN is an XML tag identifying the following text as a class name. |
class where that property or method is first defined. Where the same property |
It is attached to a property or method (when specified in XML), to indicate |
name is locally defined in another superclass or subclass, the Server will |
the class where that property or method is first defined. |
return the value for the property in the lowest subclass. |
Where the same property name is locally defined in another superclass or |
|
subclass, the Server will return the value for the property |
|
in the lowest subclass. |
| |
@param propertyList If the PropertyList input parameter is not NULL, the | @param propertyList If the PropertyList input parameter is not NULL, the |
members of the array define one or more Property names. Each returned Object |
members of the array define one or more Property names. |
MUST NOT include elements for any Properties missing from this list. |
Each returned Object MUST NOT include elements for any Properties |
|
missing from this list. |
Note that if LocalOnly is specified as true this acts as an additional | Note that if LocalOnly is specified as true this acts as an additional |
filter on the set of Properties returned (for example, if Property A is | filter on the set of Properties returned (for example, if Property A is |
included in the PropertyList but LocalOnly is set to true and A is not local |
included in the PropertyList but LocalOnly is set to true and A is |
to a returned Instance, then it will not be included in that Instance). |
not local to a returned Instance, then it will not be included in that |
|
Instance). |
If the PropertyList input parameter is an empty array this signifies that | If the PropertyList input parameter is an empty array this signifies that |
no Properties are included in each returned Object. If the PropertyList | no Properties are included in each returned Object. If the PropertyList |
input parameter is NULL this specifies that all Properties (subject to | input parameter is NULL this specifies that all Properties (subject to |
|
|
changes (which MUST be correct amendments to the Instance as | changes (which MUST be correct amendments to the Instance as |
defined by the CIM Specification) to be made to the current Instance | defined by the CIM Specification) to be made to the current Instance |
definition. | definition. |
It consists of a full specified object path, thus it consists also of target namespace, |
It consists of a full specified object path, thus it consists also |
hostname and port |
of target namespace, hostname and port |
| |
In processing the modifcation of the Instance, the following rules MUST | In processing the modifcation of the Instance, the following rules MUST |
be conformed to by the CIM Server: | be conformed to by the CIM Server: |
|
|
<LI>Any Qualifiers defined in the Class with a <TT>TOINSTANCE</TT> | <LI>Any Qualifiers defined in the Class with a <TT>TOINSTANCE</TT> |
attribute value of <TT>true</TT> appear in the Instance (it is not | attribute value of <TT>true</TT> appear in the Instance (it is not |
possible remove a propagated CIMQualifier from an Instance. Qualifiers | possible remove a propagated CIMQualifier from an Instance. Qualifiers |
in the Class with a <TT>TOINSTANCE</TT> attribute value of <TT>false</TT> |
in the Class with a <TT>TOINSTANCE</TT> attribute value of |
MUST NOT be propagated to the Instance. |
<TT>false</TT> MUST NOT be propagated to the Instance. |
<LI>Any CIMQualifier propagated from the Class cannot be modified by the | <LI>Any CIMQualifier propagated from the Class cannot be modified by the |
Server if the <TT>OVERRIDABLE</TT> attribute of that CIMQualifier was | Server if the <TT>OVERRIDABLE</TT> attribute of that CIMQualifier was |
set to <TT>false</TT> in the Class. It is a Client error to specify such | set to <TT>false</TT> in the Class. It is a Client error to specify such |
|
|
| |
@param instanceName The <TT>instanceName</TT> parameter is a CIMReference | @param instanceName The <TT>instanceName</TT> parameter is a CIMReference |
that defines the CIM instance for which the method is defined | that defines the CIM instance for which the method is defined |
It consists of a full specified object path, thus it consists also of target namespace, |
It consists of a full specified object path, thus it consists also |
hostname and port |
of target namespace, hostname and port |
| |
@param methodName The <TT>methodName</TT> parameter is a String with the | @param methodName The <TT>methodName</TT> parameter is a String with the |
name of the method to be executed. | name of the method to be executed. |
|
|
@param objectName The <TT>objectName</TT> input parameter defines the source | @param objectName The <TT>objectName</TT> input parameter defines the source |
CIM Object whose associated names are to be returned. This is either a Class | CIM Object whose associated names are to be returned. This is either a Class |
name or Instance name (model path). | name or Instance name (model path). |
It is a full specified object path, thus it consists also of target namespace, |
It is a full specified object path, thus it consists also |
hostname and port |
of target namespace, hostname and port |
| |
@param assocClass The <TT>assocClass</TT> input parameter, if not NULL, | @param assocClass The <TT>assocClass</TT> input parameter, if not NULL, |
MUST be a valid CIM Association Class name. It acts as a filter on the | MUST be a valid CIM Association Class name. It acts as a filter on the |
|
|
@param objectName The <TT>objectName</TT> input parameter defines the source | @param objectName The <TT>objectName</TT> input parameter defines the source |
CIM Object whose associated Objects are to be returned. This may be either | CIM Object whose associated Objects are to be returned. This may be either |
a Class name or Instance name (model path). | a Class name or Instance name (model path). |
It is a full specified object path, thus it consists also of target namespace, |
It is a full specified object path, thus it consists also of |
hostname and port |
target namespace, hostname and port |
| |
@param assocClass The <TT>assocClass</TT> input parameter, if not NULL, MUST | @param assocClass 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 | be a valid CIM Association Class name. It acts as a filter on the returned |
|
|
@param objectName The <TT>objectName</TT> input parameter defines the target | @param objectName The <TT>objectName</TT> input parameter defines the target |
CIM Object whose referring Objects are to be returned. This is either a | CIM Object whose referring Objects are to be returned. This is either a |
Class name or Instance name (model path). | Class name or Instance name (model path). |
It is a full specified object path, thus it consists also of target namespace, |
It is a full specified object path, thus it consists also of |
hostname and port |
target namespace, hostname and port |
| |
@param resultClass The <TT>resultClass</TT> input parameter, if not NULL, | @param resultClass 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 | MUST be a valid CIM Class name. It acts as a filter on the returned set of |
|
|
/** The <TT>referenceNames</TT> operation enumerates the association | /** The <TT>referenceNames</TT> operation enumerates the association |
objects that refer to a particular target CIM Object (Class or Instance). | objects that refer to a particular target CIM Object (Class or Instance). |
| |
@param objectName The <TT>objectName</TT> input parameter defines the target |
@param objectName <TT>objectName</TT> input parameter defines the target |
CIM Object whose referring object names are to be returned. It may be either | CIM Object whose referring object names are to be returned. It may be either |
a Class name or an Instance name (model path). | a Class name or an Instance name (model path). |
It consists of a full specified object path, thus it consists also of target namespace, |
It consists of a full specified object path, thus it consists also of |
hostname and port |
target namespace, hostname and port |
| |
@param resultClass The <TT>resultClass</TT> input parameter, if not NULL, | @param resultClass 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 | MUST be a valid CIM Class name. It acts as a filter on the returned set of |
|
|
| |
private: | private: |
// @exception TypeMismatchException | // @exception TypeMismatchException |
void hasHostandNameSpace(const String& _host, const CIMNamespaceName& nameSpace); |
void hasHostandNameSpace( |
|
const String& _host, |
|
const CIMNamespaceName& nameSpace); |
| |
// @exception TypeMismatchException | // @exception TypeMismatchException |
void hasHostandNameSpace(const CIMObjectPath& inObjectPath); | void hasHostandNameSpace(const CIMObjectPath& inObjectPath); |
|
|
// @exception TypeMismatchException | // @exception TypeMismatchException |
void hasHostandNameSpace(const CIMInstance& inInstance); | void hasHostandNameSpace(const CIMInstance& inInstance); |
| |
CIMClientRep* getTargetCIMOM(const String& _host,const String& _port, const CIMNamespaceName& _nameSpace) const; |
CIMClientRep* getTargetCIMOM( |
|
const String& _host, |
|
const String& _port, |
|
const CIMNamespaceName& _nameSpace) const; |
CIMClientRep* getTargetCIMOM(const CIMObjectPath& inObjectPath) const; | CIMClientRep* getTargetCIMOM(const CIMObjectPath& inObjectPath) const; |
| |
void setPegasusDefaultPort(void); | void setPegasusDefaultPort(void); |