Contents

Figures
Tables
About this book
Who this book is for
What you need to know to understand this book
How to use this book
Terms used in this book
Summary of changes
Changes for this edition (SC34-6591-00)
Guidance for users
Getting started
What are WebSphere MQ classes for Java?
What are WebSphere MQ classes for Java Message Service?
Connection options
Prerequisites
Installation and configuration
What is installed
Running WebSphere MQ Java applications under the Java 2 Security Manager
Running WebSphere MQ base Java applications under CICS Transaction Server
Using WebSphere MQ classes for Java (WebSphere MQ base Java)
Configuring your queue manager to accept client connections
Verifying with the sample application
Solving WebSphere MQ base Java problems
Using WebSphere MQ classes for Java Message Service (WebSphere MQ JMS)
JMS Postcard
Post installation setup
Running the point-to-point IVT
The publish/subscribe installation verification test
Solving problems
Using the WebSphere MQ JMS administration tool
Invoking the administration tool
Configuration
Administration commands
Manipulating subcontexts
Administering JMS objects
Programming with WebSphere MQ base Java
Introduction for programmers
Why should I use the Java interface?
The WebSphere MQ classes for Java interface
Writing WebSphere MQ base Java applications
Connection differences
Example application
Operations on queue managers
Accessing queues and processes
Handling messages
Handling errors
Getting and setting attribute values
Multithreaded programs
Using channel exits
Channel compression
Connection pooling
JTA/JDBC coordination using WebSphere MQ base Java
Secure Sockets Layer (SSL) support
Running WebSphere MQ base Java applications
Tracing WebSphere MQ base Java programs
Environment-dependent behavior
Core details
Restrictions and variations for core classes
Features outside the core
Restrictions under CICS Transaction Server
WebSphere MQ base Java API reference
Package com.ibm.mq
MQChannelDefinition
MQChannelExit
MQConnectionSecurityParameters
MQDistributionList
MQDistributionListItem
MQEnvironment
MQExitChain
MQExternalReceiveExit
MQExternalSecurityExit
MQExternalSendExit
MQExternalUserExit
MQGetMessageOptions
MQJavaLevel
MQManagedObject
MQMD
MQMessage
MQOD
MQPoolToken
MQProcess
MQPutMessageOptions
MQQueue
MQQueueManager
MQReceiveExitChain
MQSendExitChain
MQSimpleConnectionManager
MQC
MQReceiveExit
MQSecurityExit
MQSendExit
MQException
Programming with WebSphere MQ JMS
Writing WebSphere MQ JMS applications
The JMS model
Building a connection
Obtaining a session
Sending a message
Receiving a message
Closing down
Handling errors
Using Secure Sockets Layer (SSL)
Writing WebSphere MQ JMS publish/subscribe applications
Introduction
Getting started with WebSphere MQ JMS and publish/subscribe
Writing a simple publish/subscribe application connecting through WebSphere(R) MQ
Using topics
Subscriber options
Solving publish/subscribe problems
Writing WebSphere MQ JMS 1.1 applications
The JMS 1.1 model
Building a connection
Obtaining a session
Destinations
Sending a message
Receiving a message
JMS persistent messages
Asynchronous delivery
Consumer cleanup utility for the publish/subscribe domain
Closing down
Handling errors
Using channel exits
Using Secure Sockets Layer (SSL)
JMS messages
Message selectors
Mapping JMS messages onto WebSphere MQ messages
WebSphere MQ JMS Application Server Facilities
ASF classes and functions
Application server sample code
Examples of ASF use
WebSphere MQ JMS API reference
Package com.ibm.jms
JMSBytesMessage
JMSMapMessage
JMSMessage
JMSObjectMessage
JMSStreamMessage
JMSTextMessage
Package com.ibm.mq.jms
Cleanup
MQConnection
MQConnectionFactory
MQConnectionMetaData
MQDestination
MQJMSLevel
MQMessageConsumer
MQMessageProducer
MQQueue
MQQueueBrowser
MQQueueConnection
MQQueueConnectionFactory
MQQueueEnumeration
MQQueueReceiver
MQQueueSender
MQQueueSession
MQSession
MQTemporaryQueue
MQTemporaryTopic
MQTopic
MQTopicConnection
MQTopicConnectionFactory
MQTopicPublisher
MQTopicSession
MQTopicSubscriber
MQXAConnection
MQXAConnectionFactory
MQXAQueueConnection
MQXAQueueConnectionFactory
MQXAQueueSession
MQXASession
MQXATopicConnection
MQXATopicConnectionFactory
MQXATopicSession
JMSC
BrokerCommandFailedException
FieldNameException
FieldTypeException
IntErrorException
ISSLException
JMSInvalidParameterException
JMSListenerSetException
JMSMessageQueueOverflowException
JMSNotActiveException
JMSNotSupportedException
JMSParameterIsNullException
MulticastHeartbeatTimeoutException
MulticastPacketLossException
NoBrokerResponseException
SyntaxException
Package com.ibm.mq.jms.services
MQJMS_Messages
Appendixes
Appendix A. Mapping between administration tool properties and programmable properties
Appendix B. Scripts provided with WebSphere MQ classes for Java Message Service
Appendix C. Connecting to other products
Setting up a publish/subscribe broker
Transformation and routing with WebSphere MQ Integrator V2
Configuring WebSphere MQ JMS for a direct connection to WebSphere Business Integration Event Broker, Version 5.0 and WebSphere Business Integration Message Broker, Version 5.0
Appendix D. SSL CipherSpecs and CipherSuites
Appendix E. Notices
Trademarks
Index