Contents
Figures . . . . . . . . . . . . . . vii
Tables . . . . . . . . . . . . . . .ix
About this book . . . . . . . . . . .xi
Who this book is for . . . . . . . . . . .xi
What you need to know to understand this book . .xi
How to use this book . . . . . . . . . . .xi
Terms used in this book . . . . . . . . . .xi
Summary of changes . . . . . . . . xiii
Changes for this edition (SC34-6591-00) . . . . . xiii
Part 1. Guidance for users . . . . .1
Chapter 1. Getting started . . . . . . .3
What are WebSphere MQ classes for Java? . . . .3
What are WebSphere MQ classes for Java Message
Service? . . . . . . . . . . . . . . . .3
Connection options . . . . . . . . . . . .3
Prerequisites . . . . . . . . . . . . . .5
Chapter 2. Installation and configuration 7
What is installed . . . . . . . . . . . . .7
Running WebSphere MQ Java applications under
the Java 2 Security Manager . . . . . . . . .11
Running WebSphere MQ base Java applications
under CICS Transaction Server . . . . . . . .12
Chapter 3. Using WebSphere MQ
classes for Java (WebSphere MQ base
Java) . . . . . . . . . . . . . . .13
Configuring your queue manager to accept client
connections . . . . . . . . . . . . . .13
Verifying with the sample application . . . . .14
Solving WebSphere MQ base Java problems . . .15
Chapter 4. Using WebSphere MQ
classes for Java Message Service
(WebSphere MQ JMS) . . . . . . . .17
JMS Postcard . . . . . . . . . . . . . .17
Post installation setup . . . . . . . . . . .23
Running the point-to-point IVT . . . . . . . .26
The publish/subscribe installation verification test 30
Solving problems . . . . . . . . . . . .33
Chapter 5. Using the WebSphere MQ
JMS administration tool . . . . . . .35
Invoking the administration tool . . . . . . .35
Configuration . . . . . . . . . . . . .36
Administration commands . . . . . . . . .38
Manipulating subcontexts . . . . . . . . .39
Administering JMS objects . . . . . . . . .39
Part 2. Programming with
WebSphere MQ base Java . . . . .63
Chapter 6. Introduction for
programmers . . . . . . . . . . . .65
Why should I use the Java interface? . . . . . .65
The WebSphere MQ classes for Java interface . . .65
Chapter 7. Writing WebSphere MQ base
Java applications . . . . . . . . . .67
Connection differences . . . . . . . . . . .67
Example application . . . . . . . . . . .68
Operations on queue managers . . . . . . . .69
Accessing queues and processes . . . . . . .73
Handling messages . . . . . . . . . . . .73
Handling errors . . . . . . . . . . . . .75
Getting and setting attribute values . . . . . .76
Multithreaded programs . . . . . . . . . .76
Using channel exits . . . . . . . . . . . .77
Channel compression . . . . . . . . . . .79
Connection pooling . . . . . . . . . . . .80
JTA/JDBC coordination using WebSphere MQ base
Java . . . . . . . . . . . . . . . . .86
Secure Sockets Layer (SSL) support . . . . . .90
Running WebSphere MQ base Java applications . .95
Tracing WebSphere MQ base Java programs . . .95
Chapter 8. Environment-dependent
behavior . . . . . . . . . . . . . .97
Core details . . . . . . . . . . . . . .97
Restrictions and variations for core classes . . . .98
Features outside the core . . . . . . . . . .99
Restrictions under CICS Transaction Server . . . 101
Part 3. WebSphere MQ base Java
API reference . . . . . . . . . . 103
Chapter 9. Package com.ibm.mq . . . 105
MQChannelDefinition . . . . . . . . . . 106
MQChannelExit . . . . . . . . . . . . 108
MQConnectionSecurityParameters . . . . . .112
MQDistributionList . . . . . . . . . . .114
MQDistributionListItem . . . . . . . . . .116
MQEnvironment . . . . . . . . . . . .118
MQExitChain . . . . . . . . . . . . . 127
MQExternalReceiveExit . . . . . . . . . . 128
MQExternalSecurityExit . . . . . . . . . . 129
MQExternalSendExit . . . . . . . . . . . 130
MQExternalUserExit . . . . . . . . . . . 131
MQGetMessageOptions . . . . . . . . . . 132
© Copyright IBM Corp. 1997, 2005 iii
