Create and configure the IBM MQ custom channel for WCF
The IBM MQ custom channels for WCF work in the same manner as transport WCF channels offered by Microsoft. The IBM MQ custom channel for WCF can be created in one of two ways.
About this task
The IBM MQ custom channel integrates with WCF as a WCF transport channel, and as such must be paired with a message encoder and optional protocol channels, so it can create a complete channel stack that can be used by an application. Two elements are required for a complete channel stack to be created successfully:
- A binding definition: Specifies which elements are required to build the applications channel stack, including transport channel, message encoder, and any protocols, plus any general configuration settings. For the custom channel, the binding definition must be created in the form of a WCF custom binding.
- An endpoint definition: Links the service contract with the binding definition, and also provides the actual connection URI which describes where the application can connect. For the custom channel, the URI is in the form of a SOAP over JMS URI.
These definitions can be created in one of two different ways:
- Administratively; The definitions are created by providing the details in an application configuration file (for example: app.config ).
- Programmatically; The definitions are created directly from the application code.
The decision over which method to use to create the definitions must be based on the requirements of the application as follows:
- The Administrative method for configuration provides the flexibility to alter the details of the service and client post-deployment without rebuilding the application.
- The Programmatic method for configuration provides greater protection from configuration errors, and the ability to dynamically generate a configuration at run time.
- Create a WCF custom channel administratively by supplying binding and endpoint information in an application configuration file
The IBM MQ custom channel for WCF is a transport level WCF channel. An endpoint and binding must be defined to use the custom channel, and these definitions can be done by supplying the binding and endpoint information in an application configuration file.- Create a WCF custom channel by suppling binding and endpoint information programmatically
The IBM MQ custom channel for WCF is a transport level WCF channel. An endpoint and binding must be defined to use the custom channel, and these definitions can be done programmatically directly from the application code.- IBM MQ custom channel for WCF endpoint URI address format
A web service is specified using a Universal Resource Identifier (URI) that provides location and connection details. The URI format depends on whether we are using the SOAP/JMS interface or the Non-SOAP/Non-JMS interface.- WCF binding configuration options
There are two ways of applying configuration options to the custom channels binding information. You either set the properties administratively, or set them programmatically.Parent topic: Use IBM MQ custom channels for WCF