Adding the MCF to your Application

The MCF is available as a .NET Framework class library and as a Web Service. On a computer with the MCF installed, the MCF assembly can be directly referenced by your application.

Referencing the Local Class Library

The MCF assembly can be added to the References folder of a Visual Studio .NET project.

When adding a reference to the MCF assembly, you can use either the copy of the assembly found in the Global Assembly Cache (GAC) or the copy installed in the MCF Program Files folder. The MCF assembly name is MomConnectorFramework. Using the version in the GAC is recommended.

Referencing the MCF Web Service

In situations where the connector is not installed on a MOM Management Server, your application should use the MCF Web service. The default URI for the MCF Web service is:

http://[MOM Server]:1271/ConnectorService.asmx

The default URI for the MCFV2 Web service is:

http://[MOM Server]:1271/ConnectorServiceV2.asmx

If you are connecting to a MOM 2000 SP1 version of the MCF Web service, the URI is:

http://[MOM Server]/mcf/ConnectorService.asmx

If the Web server is capable of using the Secure Sockets Layer (SSL) protocol, you can configure the MCF Web Service to use SSL.

The MCF class library includes a pre-built Web Service proxy that connectors should use. The constructor for the FrameworkWebServiceProxy class allows the connector to specify the Web Service URL.

You can also generate your own Web Service proxy. When a Web reference to the MCF Web Service is added to your Visual Studio .NET project, Visual Studio .NET automatically generates a local proxy for the service. The proxy class, however, will include a hard-coded string to store the Web Service URL.

The MCF Web Service has dependencies on several Windows services, including IIS, and COM+. Especially when the computer running the connector is first starting up, your connector should make sure the MCF Web service is available and include retry logic if necessary.