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.2 and 1.35

version 1.2, 2003/10/22 14:26:09

version 1.35, 2009/02/19 18:01:07

Line 1

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

//%LICENSE////////////////////////////////////////////////////////////////

// Licensed to The Open Group (TOG) under one or more contributor license

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

// agreements. Refer to the OpenPegasusNOTICE.txt file distributed with

// this work for additional information regarding copyright ownership.

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

// Each contributor licenses this file to you under the OpenPegasus Open

// Source License; you may not use this file except in compliance with the

// License.

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

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

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

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

// deal in the Software without restriction, including without limitation the

// to deal in the Software without restriction, including without limitation

// rights to use, copy, modify, merge, publish, distribute, sublicense, and/or

// the rights to use, copy, modify, merge, publish, distribute, sublicense,

// sell copies of the Software, and to permit persons to whom the Software is

// and/or sell copies of the Software, and to permit persons to whom the

// furnished to do so, subject to the following conditions:

// Software is furnished to do so, subject to the following conditions:

// THE ABOVE COPYRIGHT NOTICE AND THIS PERMISSION NOTICE SHALL BE INCLUDED IN

// The above copyright notice and this permission notice shall be included

// ALL COPIES OR SUBSTANTIAL PORTIONS OF THE SOFTWARE. THE SOFTWARE IS PROVIDED

// in all copies or substantial portions of the Software.

// "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT

// LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR

// PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT

// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN

// 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.

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

// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS

// OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF

// MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.

// IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY

// CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN 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 54

Line 52

#include <Pegasus/Repository/CIMRepository.h>

#include <Pegasus/Provider/CIMInstanceProvider.h>

#include <Pegasus/Provider/CIMAssociationProvider.h>

#include <Pegasus/Provider/CIMMethodProvider.h>

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 CIMInstanceProvider,

public CIMAssociationProvider,

public CIMMethodProvider

{

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 134

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 149

const CIMObjectPath & classReference,

ObjectPathResponseHandler & handler);

// Association Interfaces

// CIMAssociationProvider interface

virtual void associators(

Line 187

Line 189

const String & role,

ObjectPathResponseHandler & handler);

/**

// CIMMethodProvider interface

Standard initialization function for the provider.

virtual void invokeMethod(

const OperationContext & context,

void initialize(CIMOMHandle& cimomHandle)

const CIMObjectPath & objectReference,

{

const CIMName & methodName,

}

const Array<CIMParamValue> & inParameters,

MethodResultResponseHandler & handler);

void terminate(void)

{

}

private:

CIMObjectPath InteropProvider::_buildInstancePath(const CIMNamespaceName& name,

void initProvider();

const CIMName className,

const CIMInstance& instance);

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

CIMInstance buildInstanceSkeleton(

const CIMNamespaceName & nameSpace,

const CIMName& className,

Boolean includeQualifiers,

CIMClass& returnedClass);

Array<CIMNamespaceName> _enumerateNameSpaces();

CIMInstance buildCIMXMLCommunicationMechanismInstance(

const String& namespaceType,

const Uint16& accessProtocol,

const String& IPAddress,

const CIMClass & commMechClass);

Array<CIMInstance> enumCIMXMLCommunicationMechanismInstances();

// Repository Instance variable

Array<CIMInstance> enumHostedAccessPointInstances();

CIMRepository* _repository;

CIMClass * _cimNamespaceClass;

CIMInstance getObjectManagerInstance();

CIMNamespaceName _operationNamespace;

CIMInstance getComputerSystemInstance();

CIMInstance getHostedObjectManagerInstance();

Array<CIMInstance> enumNamespaceInstances();

CIMInstance buildNamespaceInstance(const String & nameSpace);

CIMObjectPath createNamespace(const CIMInstance & namespaceInstance);

void deleteNamespace(const CIMObjectPath & instanceName);

CIMObjectPath createProviderProfileCapabilityInstance(

const CIMInstance & profileInstance,

const OperationContext & context);

void deleteProviderProfileCapabilityInstance(

const CIMObjectPath & instanceName,

const OperationContext & context);

Array<CIMInstance> enumNamespaceInManagerInstances();

Array<CIMInstance> enumCommMechanismForManagerInstances();

void modifyObjectManagerInstance(const OperationContext & context,

const CIMObjectPath & instanceReference,

const CIMInstance& modifiedIns,

const Boolean includeQualifiers,

const CIMPropertyList& propertyList);

void extractSoftwareIdentityInfo(

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();

Array<CIMInstance> enumProviderProfileCapabilityInstances(

Boolean checkProviders = true,

Boolean includeQualifiers = false,

Boolean includeClassOrigin = false,

const CIMPropertyList &propertyList = CIMPropertyList());

#ifdef PEGASUS_ENABLE_DMTF_INDICATION_PROFILE_SUPPORT

Array<CIMInstance> enumElementCapabilityInstances(

const OperationContext & opContext);

Array<CIMInstance> enumHostedIndicationServiceInstances(

const OperationContext & opContext);

Array<CIMInstance> enumServiceAffectsElementInstances(

const OperationContext & opContext);

CIMInstance buildAssociationInstance(

const CIMName &className,

const CIMName &propName1,

const CIMObjectPath &objPath1,

const CIMName &propName2,

const CIMObjectPath &objPath2);

#endif

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);

Array<CIMInstance> getDMTFProfileInstances(

const CIMName & profileType);

// 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();

void initializeNamespaces();

bool validAssocClassForObject(

const OperationContext & context,

const CIMName & assocClass, const CIMObjectPath & objectName,

const CIMNamespaceName & opNamespace,

String & originProperty, String & targetProperty);

#ifdef PEGASUS_ENABLE_SLP

void sendUpdateRegMessageToSLPProvider(

const OperationContext & context);

#endif

// Repository Instance variable

CIMOMHandle cimomHandle;

CIMRepository * repository;

String objectManagerName;

String hostName;

CIMClass profileCapabilitiesClass;

CIMClass softwareIdentityClass;

Array<Uint16> providerClassifications;

Mutex interopMut;

bool providerInitialized;

AtomicInt updateProfileCache;

// Registration info to cache

Array<String> profileIds;

Array<CIMNameArray> conformingElements;

Array<CIMNamespaceArray> elementNamespaces;

Boolean enableSLP;

String httpPort;

String httpsPort;

};

PEGASUS_NAMESPACE_END

Legend:

Removed from v.1.2
changed lines
	Added in v.1.35

No CVS admin address has been configured