Using sample applications, this chapter explains the basics of writing C# .NET messaging applications that work with webMethods Broker. The chapter's goal is to familiarize application developers with the key constructs and programming details necessary for building webMethods Broker C# messaging clients.

The webMethods Broker C# Messaging API (henceforth referred to as the C# API) is based on the JMS API; the two object models closely resemble each other. However, some important implementation differences exist. These differences stem from the fact that C# messaging clients are .NET Framework applications that execute exclusively in a Windows environment. For example, there is no built-in support for constructs such as JNDI and Java EE. Besides the many similarities, the chapter highlights the important implementation differences that distinguish between the two APIs.

The chapter examines two sample C# clients. These two samples are similar, in design and functionality, to the JMS samples described in A Basic JMS Sender-Receiver Client and JMS Request-Reply Application with a Message Selector, and is done for comparison purposes. These similarities demonstrate how the same JMS messaging constructs described in those chapters are coded using C# .NET and the webMethods C# Messaging API, instead of Java/JMS and the JMS API.