Before you start
IBM® WebSphere® Message Broker V8 (hereafter called Message Broker) provides the capability to integrate with existing Microsoft® .NET® Framework (hereafter called .NET) applications. You can do this integration by wiring the new Message Broker .NETCompute node into a message flow, or by calling a .NET application from an ESQL Compute node. This series of tutorials shows you how to use the .NETCompute node integration technique.
This series of four tutorials shows you how to write and build C# code in Microsoft Visual Studio 2010 (either Express Edition or Professional Edition) using an embedded template provided by WebSphere Message Broker Toolkit. The four tutorials explore the following topics:
- Using the .NETCompute node sample
- Using the .NETCompute node to integrate with Microsoft Word
- Using the .NETCompute node to integrate with Microsoft Excel
- Using the .NETCompute node for exception handling
This tutorial describes a scenario that gradually builds in complexity as extra exception conditions are deliberately produced and then handled. You can use the .NETCompute node on Microsoft Windows brokers to construct output messages and to interact with .NET or Component Object Model (COM) applications.
WebSphere Message Broker enables you to host and run .NET code inside an execution group. The new .NETCompute node routes or transforms messages by using any Common Language Runtime (CLR) compliant .NET programming language, such as C#, Visual Basic (VB), F#, or C++/Common Language Infrastructure (CLI). This tutorial describes the new .NET API provided by WebSphere Message Broker, which enables .NET developers to interact with Message Broker's logical tree.
You can develop the .NET code in this tutorial in C# using Microsoft Visual Studio 2010 Professional Edition. The message flow development is done graphically using the WebSphere Message Broker Toolkit. To begin with, you start with a simple message flow to demonstrate how Broker exceptions are described and handled, and then gradually increase the complexity of the scenario to show some of the more advanced exception handling features of the .NETCompute node.
This tutorial is written for WebSphere Message Broker programmers who want to learn about the new .NETCompute node, and for .NET programmers who want to learn about using WebSphere Message Broker. If you have a general familiarity with C# or with Message Broker, then you should find the tutorial relatively easy to complete.
To build and execute the example in this tutorial, you will need:
- A Windows installation that includes Microsoft .NET Framework V4
- WebSphere Message Broker (Toolkit and Runtime) V8
- Microsoft Visual Studio 2010 (Express Edition or Professional Edition) to write and build the required C# code