ibm mq tools.rar

# /*********************************************************************/ # /* */ # /* IBM Message Service Client for .NET */ # /* */ # /* FILE NAME: readme.txt */ # /* */ # /* DESCRIPTION: Important notes about the product samples */ # /* */ # /*********************************************************************/ # /* <START_COPYRIGHT> */ # /* */ # /* Licensed Materials - Property of IBM */ # /* */ # /* 5724-M21 */ # /* */ # /* (C) COPYRIGHT International Business Machines Corp. 2003, 2009 */ # /* All Rights Reserved */ # /* */ # /* U.S. Government Users Restricted Rights - use, duplication or */ # /* disclosure restricted by GSA ADP Schedule Contract with IBM Corp.*/ # /* */ # /* Status: Version 2 Release 0 */ # /* <END_COPYRIGHT> */ # /* */ # /*********************************************************************/ # /* */ # /* Updated: 31st July 2009 */ # /* */ # /*********************************************************************/ IBM Message Service Client for .NET SAMPLES README =================================================== The following sample code has been provided: XMS-C# asynchronous & synchronous consumer XMS-C# producer For messages to and from a WMQI Real Time Transport node, a WMQ Queue Manager, or a WebSphere Application Server Messaging Engine. Both source and precompiled executables are supplied. Platform differences ==================== Conventions used here --------------------- To aid readability of the document: a) Use of directory separator '/' throughout b) Scripts are referred to by filename ONLY so, for example, "xmsdemo" refers to "xmsdemo.cmd" on Windows. Windows ONLY ------------ For building the 'C#' application(s) it is assumed that Microsoft Visual Studio .NET 2003 is installed and that the MSVC build environment is set up correctly. For example: vcvars32.bat The key files ============= The source for the C# sample types are contained within their respective sub directories SampleConsumer SampleProducer The Microsoft Visual Studio .NET solution (and related projects) supplied, shows how to build the XMS C# application(s). SampleConsumer/SampleConsumer.cs -------------------------------- Receives any type of message either asynchronously or synchronously and reads the text, a named string property, and a named integer property. SampleProducer/SampleProducer.cs -------------------------------- Sends the specified message type containing text, a named string property, and a named integer property at the specified interval. SampleCommon/BaseOptions.cs --------------------------- Functions common to the samples, used to minimise unnecessary code in the samples themselves. SampleCommon/Options.cs ----------------------- Functions common to the samples, used to minimise unneccessary code in the samples themselves. SampleCommon/OptionsPresenter.cs -------------------------------- Functions common to the samples, used to minimise unneccessary code in the samples themselves. SampleCommon/XMSApp.cs ---------------------- Wraps the basic XMS .NET API providing common functionality within the sample applications. bin/xmsdemo ----------- A script which starts a C# consumer (SampleConsumer) and a C# producer (SampleProducer). Provided the settings entered by the user are valid, the producer and consumer will send and receive message respectively until the user terminates them. Pre-Compiled Binaries ===================== bin/SampleConfigCS ------------------ C# application that allows the user to specify producer and consumer properties (either WMQ, RTT or WPM) interactively, and then writes these properties to a JNDI format administered objects file which can then be used to execute each of the samples repeatedly with same parameters. To see usage of the command, specify '?' as a parameter. bin/SampleConsumerCS -------------------- C# command line asynchronous & synchronous message consumer. To see usage of the command, specify '?' as a parameter. bin/SampleProducerCS -------------------- C# command line message producer. To see usage of the command, specify '?' as a parameter. Running the demo ================ "xmsdemo" uses the pre-built versions of the sample programs to demonstrate an XMS consumer asynchronously receiving messages from an XMS producer, via either a WMQI broker, a WMQ Queue Manager or a WebSphere Application Server Message Engine. The demo requires you have one of the following: a) A WMQI broker, which has 'Real-timeOptimizedFlow' node deployed (port:1506) b) A WMQ Queue Manager (port:1414) c) A WebSphere Application Server Message Engine (port:7276) You may need to find which port number is being used. The defaults are shown in brackets after each option above After the environment has been set up all you need to do is: cd tools/samples/bin xmsdemo and enter the properties you are prompted for. If successful, two applications are then launched (1) "XMS Producer" - continually publishes XMS messages (2) "XMS Consumer" - continually receives messages from the producer Building the samples ==================== All you need to do is: Open the 'Samples.sln' Visual Studio solution file, available at: tools/samples/src and compile the solution (including both projects; SampleConsumer & SampleProducer) within the Microsoft Visual Studio .NET GUI. Trademarks ========== The following terms are trademarks of the IBM Corporation in the United States, or other countries, or both: IBM, MQSeries, SupportPac, WebSphere ActiveX, Microsoft, Visual Basic, Visual C++, Windows, and Windows NT are trademarks or registered trademarks of Microsoft Corporation in the United States, other countries, or both. Java and all Java-based trademarks and logos are trademarks or registered trademarks of Sun Microsystems, Inc. in the United States, other countries, or both. UNIX is a registered trademark of The Open Group in the United States and other countries. Other company, product, and service names may be trademarks or service marks of others.