pegasus/src/Pegasus/ControlProviders/InteropProvider/InteropProvider.h - diff

Return to InteropProvider.h CVS log

Up to [Pegasus] / pegasus / src / Pegasus / ControlProviders / InteropProvider

Diff for /pegasus/src/Pegasus/ControlProviders/InteropProvider/InteropProvider.h between version 1.3.2.1 and 1.26

version 1.3.2.1, 2004/02/21 00:12:56

version 1.26, 2008/02/20 14:00:31

Line 1

//%2003////////////////////////////////////////////////////////////////////////

//%2006////////////////////////////////////////////////////////////////////////

// Company, L. P., IBM Corp., The Open Group, Tivoli Systems.

// Company, L.P.; IBM Corp.; The Open Group; Tivoli Systems.

// IBM Corp.; EMC Corporation, The Open Group.

// IBM Corp.; EMC Corporation; VERITAS Software Corporation; The Open Group.

// EMC Corporation; VERITAS Software Corporation; The Open Group.

// EMC Corporation; Symantec Corporation; The Open Group.

// Permission is hereby granted, free of charge, to any person obtaining a copy

// of this software and associated documentation files (the "Software"), to

Line 21

Line 27

// ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION

// WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

//==============================================================================

//=============================================================================

// Author: Karl Schopmeyer (k.schopmeyer@opengrooup.org)

// Modified By:

//%////////////////////////////////////////////////////////////////////////////

#ifndef InteropProvider_h

Line 58

PEGASUS_NAMESPACE_BEGIN

/**

The InteropProvider provides information and manipulates the

* The InteropProvider services the Interop classes of the DMTF CIM Schema

following classes from the DMTF CIM_Interop schema:

* in the root/PG_InterOp namespace (as well as some related cross-namespace

CIM_Namespace - Creation and deletion of namespaces

* associations in other namespaces). Through this implementation, combined

__Namespace - Creation and deletion of namespaces (deprecated)

* with the SLP provider and one or more vendor-supplied SMI providers, the

CIM_ObjectManager - Reports on the status of the object manager

* Pegasus WBEM Server is able to provide a fully-functional implementation of

CIM_ObjectManagerCommunicationMechanism - Reports on CIMOM communications

* the SMI-S Server profile (currently, version 1.1.0).

COM_CIMXMLCommunicationMechanism - Reports on CIMXML communications

CIM_ProtocolAdapter

* The following is a list of the association and instance classes supported

* by this provider in the root/PG_InterOp namespace:

Associations

NamespaceinManager

* PG_CIMXMLCommunicationMechanism (CIM_CIMXMLCommunicationMechanism)

* PG_CommMechanismForManager (CIM_CommMechanismForManager)

creation and deletion of namespaces using the __namespace class

* PG_ComputerSystem (CIM_ComputerSystem)

Note however, that the DMTF specification model does not define a class for

* PG_ElementConformsToProfile (CIM_ElementConformsToProfile)

__namespace so that it is, a "false" class. We assume that it has the

* PG_ElementSoftwareIdentity (CIM_ElementSoftwareIdentity)

same characteristics as the CIM_namespace class defined in CIM 2.6.

* PG_HostedAccessPoint (CIM_HostedAccessPoint)

* PG_HostedObjectManager (CIM_HostedService)

This provider implements the following functions:

* PG_InstalledSoftwareIdentity (CIM_InstalledSoftwareIdentity)

- createInstance ( adds a new namespace to the repository)

* PG_Namespace (CIM_Namespace)

- getInstance ( Gets one instance containing a namespace name)

* PG_NamespaceInManager (CIM_NamespaceInManager)

- modifyInstance ( Not supported )

* PG_ObjectManager (CIM_ObjectManager)

- enumerateInstances ( Lists all namespaces as Instances)

* PG_ReferencedProfile (CIM_ReferencedProfile)

- enumerateInstanceNames ( Lists all namespace names )

* PG_RegisteredProfile (CIM_RegisteredProfile)

TBD

* PG_RegisteredSubProfile (CIM_RegisteredSubProfile)

* PG_SoftwareIdentity (CIM_SoftwareIdentity)

* PG_SubProfileRequiredProfile (CIM_SubProfileRequiresProfile)

typedef Array<CIMName> CIMNameArray;

typedef Array<CIMNamespaceName> CIMNamespaceArray;

class PEGASUS_INTEROPPROVIDER_LINKAGE InteropProvider :

public CIMInstanceProvider, public CIMAssociationProvider

{

public:

InteropProvider(CIMRepository* repository)

InteropProvider(CIMRepository* repository);

{

PEG_METHOD_ENTER(TRC_CONTROLPROVIDER,"InteropProvider::InteropProvider");

_repository = repository;

PEG_METHOD_EXIT();

}

virtual ~InteropProvider()

{

PEG_METHOD_ENTER(TRC_CONTROLPROVIDER,"InteropProvider::~InteropProvider");

PEG_METHOD_ENTER(TRC_CONTROLPROVIDER,

"InteropProvider::~InteropProvider");

PEG_METHOD_EXIT();

}

// Note: The initialize() and terminate() methods are not called for

// Control Providers.

void initialize(CIMOMHandle& handle) { }

void terminate() { }

virtual void createInstance(

const OperationContext & context,

const CIMObjectPath & instanceReference,

Line 128

Line 133

const CIMInstance& modifiedIns,

const Boolean includeQualifiers,

const CIMPropertyList& propertyList,

ResponseHandler & handler)

ResponseHandler & handler);

{

throw PEGASUS_CIM_EXCEPTION(CIM_ERR_NOT_SUPPORTED, "");

}

virtual void enumerateInstances(

const OperationContext & context,

Line 146

Line 148

const CIMObjectPath & classReference,

ObjectPathResponseHandler & handler);

// Association Interfaces

// CIMAssociationProvider interface

virtual void associators(

Line 187

Line 188

const String & role,

ObjectPathResponseHandler & handler);

/**

private:

Standard initialization function for the provider.

void initialize(CIMOMHandle& cimomHandle)

{

}

void terminate(void)

void initProvider();

{

}

private:

CIMInstance buildInstanceSkeleton(

const CIMNamespaceName & nameSpace,

const CIMName& className,

CIMClass& returnedClass);

CIMInstance buildCIMXMLCommunicationMechanismInstance(

const String& namespaceType,

const Uint16& accessProtocol,

const String& IPAddress,

const CIMClass & commMechClass);

CIMInstance _buildInstanceSkeleton(const CIMName& className);

Array<CIMInstance> enumCIMXMLCommunicationMechanismInstances();

CIMObjectPath InteropProvider::_buildInstancePath(const CIMNamespaceName& name,

Array<CIMInstance> enumHostedAccessPointInstances();

const CIMName className,

const CIMInstance& instance);

CIMClass _getClass(const CIMNamespaceName& nameSpace, const CIMName& className);

CIMInstance getObjectManagerInstance();

Array<CIMNamespaceName> _enumerateNameSpaces();

CIMInstance getComputerSystemInstance();

CIMInstance _buildInstancePGCIMXMLCommunicationMechanism(

CIMInstance getHostedObjectManagerInstance();

const String& namespaceType,

const String& IPAddress,

Array<CIMInstance> enumNamespaceInstances();

const Boolean& includeQualifiers,

const Boolean& includeClassOrigin,

CIMInstance buildNamespaceInstance(const String & nameSpace);

const CIMPropertyList& propertyList);

CIMObjectPath createNamespace(const CIMInstance & namespaceInstance);

void deleteNamespace(const CIMObjectPath & instanceName);

Array<CIMInstance> _buildInstancesPGCIMXMLCommunicationMechanism(

Array<CIMInstance> enumNamespaceInManagerInstances();

Array<CIMInstance> enumCommMechanismForManagerInstances();

void modifyObjectManagerInstance(const OperationContext & context,

const CIMObjectPath & instanceReference,

const CIMInstance& modifiedIns,

const Boolean includeQualifiers,

const Boolean includeClassOrigin,

const CIMPropertyList& propertyList);

CIMInstance _buildInstanceCIMObjectManager(const Boolean includeQualifiers,

void extractSoftwareIdentityInfo(

const Boolean includeClassOrigin,

const CIMInstance & providerInstance,

String & moduleName,

String & providerName,

String & version,

String & vendor,

Uint16 & majorVersion,

Uint16 & minorVersion,

Uint16 & revision,

Uint16 & build,

bool & extendedVersionSupplied,

String & interfaceType,

String & elementName,

String & caption);

Array<CIMInstance> enumRegisteredProfileInstances();

Array<CIMInstance> enumRegisteredSubProfileInstances();

Array<CIMInstance> enumReferencedProfileInstances();

Array<CIMInstance> getProfilesForVersion(

Array<CIMInstance>& subprofs,

const String version);

Array<CIMInstance> enumElementConformsToProfileInstances(

const OperationContext & opContext,

const CIMNamespaceName & opNamespace);

Array<CIMInstance> enumElementConformsToProfileRPRPInstances(

const OperationContext & opContext,

const CIMNamespaceName & opNamespace);

Array<CIMInstance> enumSubProfileRequiresProfileInstances();

Array<CIMInstance> enumSoftwareIdentityInstances();

Array<CIMInstance> enumElementSoftwareIdentityInstances();

Array<CIMInstance> enumInstalledSoftwareIdentityInstances();

CIMInstance buildRegisteredProfile(

const String & instanceId,

const String & profileName,

const String & profileVersion,

Uint16 profileOrganization,

const String & otherProfileOrganization,

const CIMClass & profileClass);

CIMInstance buildDependencyInstance(

const String & antecedentId,

const CIMName & antecedentClass,

const String & dependentId,

const CIMName & dependentClass,

const CIMClass & dependencyClass);

CIMInstance buildSoftwareIdentity(

const String & module,

const String & provider,

const String & vendor,

const String & version,

Uint16 majorVersion,

Uint16 minorVersion,

Uint16 revisionNumber,

Uint16 buildNumber,

bool extendedVersionSupplied,

const String & interfaceType,

const String & elementName,

const String & caption);

Array<CIMInstance> getProfileInstances(

const CIMName & profileType,

const Array<String> & defaultSniaProfiles);

// The following are internal equivalents of the operations

// allowing the operations to call one another internally within

// the provider.

Array<CIMInstance> localEnumerateInstances(

const OperationContext & context,

const CIMObjectPath & ref,

const CIMPropertyList& propertyList=CIMPropertyList());

Array<CIMInstance> localReferences(

const OperationContext & context,

const CIMObjectPath & objectName,

const CIMName & resultClass,

String & originRole,

String & targetRole,

const CIMPropertyList & propertyList=CIMPropertyList(),

const CIMName & targetClass=CIMName());

CIMInstance localGetInstance(

const OperationContext & context,

const CIMObjectPath & instanceName,

const CIMPropertyList& propertyList);

void cacheProfileRegistrationInfo();

void verifyCachedInfo();

bool validAssocClassForObject(

const OperationContext & context,

const CIMName & assocClass, const CIMObjectPath & objectName,

const CIMNamespaceName & opNamespace,

String & originProperty, String & targetProperty);

// Repository Instance variable

CIMOMHandle cimomHandle;

CIMRepository* _repository;

CIMRepository * repository;

CIMClass * _cimNamespaceClass;

String objectManagerName;

CIMNamespaceName _operationNamespace;

String hostName;

CIMInstance instanceOfCIMObjectManager;

CIMClass profileCapabilitiesClass;

CIMClass softwareIdentityClass;

Array<Uint16> providerClassifications;

Mutex interopMut;

bool providerInitialized;

// Registration info to cache

Array<String> profileIds;

Array<CIMNameArray> conformingElements;

Array<CIMNamespaceArray> elementNamespaces;

};

PEGASUS_NAMESPACE_END

Legend:

Removed from v.1.3.2.1
changed lines
	Added in v.1.26

No CVS admin address has been configured