Table Of ContentPro MSMO:
Microsoft Message
Queue Programming
AROHI RED KAR, CARLOS WALZER, SCOT BOYD,
RICHARD COSTALL, KEN RABOLD, TEJASWI REDKAR
APress Media, LLC
Pro MSMQ: Microsoft Message Queue Programming
Copyright ~2004 by Arohi Redkar, Carlos Walzer, Scot Boyd, Richard Costall,
Ken Rabold, Tejaswi Redkar
Originally published by Apress in 2004
All rights reserved. No part of this work may be reproduced or transmitted in any form or by any
means, electronic or mechanical, including photocopying. recording. or by any information storage
or retrieval system, without the prior written permission of the copyright owner and the publisher.
ISBN 978-1-59059-346-2 ISBN 978-1-4302-0732-0 (eBook)
DOI 10.1007/978-1-4302-0732-0
Trademarked names may appear in this book. Rather than use a trademark symbol with every
occurrence of a trademarked name, we use the names only in an editorial fashion and to the
benefit of the trademark owner, with no intention of infringement of the trademark.
Lead Editor: Ewan Buckingham
Technical Reviewers: Yoel Arnon, Andrew Krowczyk
Editorial Board: Steve Anglin, Dan Appleman, Ewan Buckingham, Gary Cornell, Tony Davis,
Jason Gilmore, Chris Mills, Steve Rycroft, Dominic Shakeshaft, Jim Sumser, Karen Watterson,
Gavin Wray, John Zukowski
Assistant Publisher and Project Manager: Grace Wong
Copy Editor: Liz Welch
Production Manager: Kari Brooks
Producdon Editor: Ellie Fountain
Proofreader: Elizabeth Berry
Compositor: Molly Sharp, ContentWorks
lndexer: Valerie Haynes Perry
Artist: Kinetic Publishing Services, LLC
Cover Designer: Kurt Krames
Manufacturing Manager: Tom Debolski
In the United States: phone 1-800-SPRINGER, email orders@springer-ny .com, or visit
http: I lw.M. springer-ny. com. Outside the United States: fax +49 6221 345229, email
orders@springer. de, or visit http: I lw.M. springer. de.
The information in this book is distributed on an "as is" basis, without warranty. Although every
precaution has been taken in the preparation of this work, neither the author(s) nor Apress shall
have any liability to any person or entity with respect to any loss or darnage caused or alleged to
be caused directly or indirectly by the information contained in this work.
To all those who have taught mesomething over the years.
-ScotBoyd
To Liz, Thomas and Oliver: I will always love you.
-Richard Castall
Dedicated to my wonderful wife Juli and my two boys,
Jordan and Alec. You mean the world to me.
-KenRabold
I dedicate this book to my parents, who taught me
the meaning ofthe word professionalism.
-ArohiRedkar
To my parents, thanks for being with me all the time.
- Tejaswi Redkar
Dedicated to the love of my life, Lauri.
-Carlos Walzer
Contents at a Glance
Foreward ............................................................x i
About the Authors ................................................ xiii
About the Technical Reviewers ................................... xv
Acknowledgments .................................................. xvii
Introduction ...................................................... xix
Chapter 1 Introducing Message Queuing ........................ 1
Chapter 2 System.Messaging ................................... 55
Chapter 3 Administration ..................................... 137
Chapter 4 Transactional Messaging .......................... 211
Chapter 5 MSMQ Triggers ...................................... 235
Chapter 6 MSMQ COM and Win32 API .......................... 269
Chapter 7 MSMQ 3.0 ......................................... 303
Chapter 8 MSMQ on Packet PC ............................... 361
Index .............................................................. 405
V
Contents
Foreward ............................................................x i
About the Authors ................................................ xiii
About the Technical Reviewers ................................... xv
Acknowledgments .................................................. :xvii
Introduction ...................................................... xix
Chapter Introducing Message Queuing .................
1 1
Communications Within Distributed Applications ................ 2 ·
The MSMQ Architecture .......................................... 12
Architecture Scenarios ......................................... 36
MSMQ Versions ................................................... 43
Installing MSMQ ................................................. 46
Summary ......................................................... 53
Chapter 2 System.Messaging ............................... 55
System.Messaging Namespace Programming Architecture .......... 56
Warking with Queues ............................................ 58
Referencing Queues ............................................. 69
Purging Messages Programmatically ............................. 70
Interacting with Queues ........................................ 73
Sending Camplex Messages ....................................... 91
Receiving Messages Asynchronously ............................ 117
Peeking Messages ............................................... 121
Message Timeouts ............................................... 122
Recoverable Messages .......................................... 126
Request-Response Messaging .................................... 126
Pn •o n' t1'z 1.n g Me ssages ......................................... 129
Using Acknowledgments ......................................... 130
Message Enumerator ............................................ 133
The MessageQueue Enumerator ................................... 134
Summary ........................................................ 136
Chapter 3 Administration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
137
Interfaces for Monoging a Message Queuing Network ........... 138
Monoging Queues ................................................ 140
vii
Goncents
Using the Active Directory Snap-in ........................... 152
Managing Queues Programmatically Using
the System.Messaging API .................................... 156
Managing Messages ............................................. 169
Monitaring Message Queuing .................................... 177
Testing Queues ................................................. 184
Security ....................................................... 189
The Message Queuing Control Panel Utility ................... 194
Administering a Message Queuing Network ...................... 197
Imetry Sample Network ......................................... 201
Troubleshooting Tips .......................................... 207
Summary ........................................................ 209
Chapter 4 Transactional Messaging .................... 211
Transaction Processing Fundamentals .......................... 211
Message Queuing Transactions ................................... 212
Message Queuing External Transactions in Action ............. 226
Summary ........................................................ 234
Chapter 5 MSMQ Triggers ................................. 235
Introducing Triggers .......................................... 235
Message Access ................................................. 241
Installing Triggers .........................................· . . 244
Creating Triggers ............................................. 249
Trigger Deployment ............................................ 265
Summary ........................................................ 268
Chapter 6 MSMQ COM and Win32 API ..................... 269
MSMQ COM AP I: mqoa. dll ........................................ 269
MSMQ Win32 API: mqrt. dll ...................................... 281
Summary ........................................................ 302
Chapter 7 MSMQ 3. 0 ........................................ 303
Installation Guideline ........................................ 304
Direct Messaging ............................................... 306
Internet Messaging ............................................ 308
Programmahle Management COM Interface ........................ 339
Queue Aliases .................................................. 350
viii
Contents
Multiple-Destination Messaging ................................ 352
Summary ........................................................ 358
Chapter 8 MSMQ on Packet PC. ........................... 361
Pocket PC MSMQ Featuresand Limitations ..................... 362
Implementation Scenarios ......................................
364
MSMQ Installation on Pocket PCs .............................. 365
Programming MSMQ on the Pocket PC ............................
371
Network Configurations and Troubleshooting .................. 401
Summary .................. : ..................................... 403
Index .............................................................
405
ix
Foreword
NO APPLICATION IS AN ISLANDo o oI n today's connected world, each and every
professional developer must assume that his or her applications will need to
communicate with other applications.
Distributed applications, however, present a large set of unique challenges,
like, what do I do when the network is disconnected? How do I coordinate the
actions of two separate applications? How do I handle peak times? How do I
guarantee delivery? How do I upgrade my application without breaking the
communication?
We at the Microsoft Message Queue (MSMQ) team have worked hardto
provide an elegant solution to these questions and many others. This book will
help you leverage this work by using MSMQ in your distributed applications so
that you will be able to concentrate on the business logic rather than network
problems.
What is MSMQ? MSMQ is message-oriented middleware (MOM) that
comes as a standard component ofWindows and allows applications to
exchange messages among them using queues-outgoing queues for Iilessages
waiting to be sent, and incoming queues for messages waiting to be received.
Queues-like dams-guarantee nice and controlled flow of information, even
when the network is congested or suffers frequent disconnects.
Moreover, queues are a very natural programming metaphor. Most people
would agree that working from a queue of to-do tasks is more effective than
responding to requests on the spot. The same is true for computer programs.
Programs that process queues of incoming messages tend to be simpler and
more efficient than programs acting on interrupts.
The availability of powerful, yet simple, MOMs like MSMQ on millions of
desktops and servers has changed the way programmers design and write dis
tributed applications. The simple concepts of queue and message-along with
powerful features like quality of service, transactions, and security-have enabled
a new breed of distributed applications in a wide range of industries. In addition,
MSMQ provides an excellent solution for integrating existing applications-for
the Internet or for enterprise-wide systems like ERP.
Even after nine years on the MSMQ team, I am amazed to see the number
of ways customers use this technology: in airlines and communication, fmancial
services, e-retailers, traditional department stores, and even online games.
In addition to covering the essentials of MSMQ, this book is the first book
covering the cool new features introduced in MSMQ 3.0 (which was released as
part ofWindows XP and Windows Server 2003)-features such as multicast, trig
gers, HTTP messages, and more. In addition, it is the first book covering the
novel.NET MSMQ APis: SystemoMessaging.
xi
Foreword
Today, MSMQ knowledge has become a standard requirement for a profes
sianal Windows developer, alongside such skills as Visual Basic, Visual C/C#,
SQL/IIS/ADO/COM+, and others. Reading this book is a great way to get started.
If you consider yourself a professional Windows developer, and you know
that no application is an island any longer, then this book is for you.
I am proud tobeapart of the revolution MSMQ brought to the Windows
application development world. I hope that you will enjoy using MSMQ as much
as 1-together with the other MSMQ team members-enjoyed developing it.
YoelArnon
Software Development Engineer
Microsoft Corporation
xii
