IBM Software Group | WebSphere software
WebSphere MQ
Introduction to using WebSphere MQ with WebSphere Application Server and the Liberty Profile
Matthew [email protected]
IBM Software Group WebSphere SoftwareIBM Software Group WebSphere Software
© 2014 IBM Corporation
IBM Software Group | WebSphere software
WebSphere MQ
Please NoteIBM’s statements regarding its plans, directions, and intent are subject to change or withdrawal without notice at IBM’s sole discretion.
Information regarding potential future products is intended to outline our general product direction and it should not be relied on in making a purchasing decision.
The information mentioned regarding potential future products is not a commitment, promise, or legal obligation to deliver any material, code or functionality. Information about potential future products may not be incorporated into any contract. The development, release, and timing of any future features or functionality described for our products remains at our sole discretion.
Performance is based on measurements and projections using standard IBM benchmarks in a controlled environment. The actual throughput or performance that any user will experience will vary depending upon many factors, including considerations such as the amount of multiprogramming in the user’s job stream, the I/O configuration, the storage configuration, and the workload processed. Therefore, no assurance can be given that an individual user will achieve results similar to those stated here.
IBM Software Group | WebSphere software
WebSphere MQ
Resource Adapter or JMS API?
The WMQ JMS API implements the JMS standard APIProvides either Client or Bindings connectivity to a QueueManager
– Client means TCP/IP network connectivity via WMQ channels
– Bindings means in-process attach to WMQ via JNI native library
– Overloaded terms – be careful!
The WMQ Resource Adapter implements the JCA standard to connect middleware into JavaEE servers
Utilises the WMQ JMS code to connect to WMQ QueueManager
Resource Adapter (RA) and JMS API can be confused
– WMQ Resource Adapter is powered by the WMQ JMS code
4
IBM Software Group | WebSphere software
WebSphere MQ
IBM® WebSphere® Application Server
Enterprise standard Java™ Application Server
Highly scalable: single server up to massive network deployment
Web gui and command line interface (wsadmin)
5
IBM Software Group | WebSphere software
WebSphere MQ
Liberty
Lightweight, Developer focussed
Eclipse based: server.xml and WAS Developer Tools
wasdev.net
Bundled in WebSphere Application Server version 8.5.5
6
IBM Software Group | WebSphere software
WebSphere MQ
Version 6 Messaging Architecture
7
IBM Software Group | WebSphere software
WebSphere MQ
The solution now
Picture courtesy: public domainSource: http://www.livescience.com/20404-gallery-sun-gods-goddesses.html
RA
8
IBM Software Group | WebSphere software
WebSphere MQ
Introducing the IBM® WebSphere® MQ JMS Resource Adapter
wmq.jmsra.rar
9
IBM Software Group | WebSphere software
WebSphere MQ
Why have a Resource Adapter?
Java Enterprise Edition(Java EE)
Java Connector Architecture(JCA)
10
IBM Software Group | WebSphere software
WebSphere MQ
Harnessing the Resource Adapter: WAS
Deployed inside WebSphere Application Server
WAS is shipped with a validated RA
RA can be a different version to the Queue Manager
11
IBM Software Group | WebSphere software
WebSphere MQ
Harnessing the Resource Adapter: Liberty
Supported from Liberty version 8.5.5
Download from IBM Fix Central – search 'Resource Adapter'<server description="new server">
<!-- Enable features --> <featureManager> <feature>jsp-2.2</feature> <feature>localConnector-1.0</feature> <feature>ejbLite-3.1</feature> <feature>jmsMdb-3.1</feature>
<feature>jndi-1.0</feature>
<feature>wmqJmsClient-1.1</feature>
</featureManager>
<variable name="wmqJmsClient.rar.location" value="C:\MY_RA_FOLDER\wmq.jmsra.rar"/>
</server>
12
IBM Software Group | WebSphere software
WebSphere MQ
Managing the Resource Adapter
Client mode – no configuration necessary
Bindings mode: WAS: set 'native library path' on Resource Adapter
Liberty: <wmqJmsClient nativeLibraryPath="/opt/mqm/java/lib64"/>
Updates to RA: WAS: WAS Fix Packs and iFixes
Liberty: updated download from Fix Central
13
IBM Software Group | WebSphere software
WebSphere MQ
Version 7 onwards Messaging Architecture
14
IBM Software Group | WebSphere software
WebSphere MQ
Practical benefits: standardised, well-versioned connections
Photo courtesy: public domainSource: http://pixabay.com/en/industrial-mess-electric-power-69750/
Photo courtesy: public domainSource: http://pixabay.com/en/communication-connection-113613/
15
IBM Software Group | WebSphere software
WebSphere MQ
Bindings mode architecture
IBM Software Group | WebSphere software
WebSphere MQ
Decoupled Standard Architecture
WMQ Integration using Java EE standardsRA pre-installed already validated with WAS versionStandardised interface permits WAS with RA versions to be decoupled from QM versions – even in bindings modeApplying maintenance to the RA does not require QueueManager restartFully supports Activation Specs and EJB3Permits greater choice and flexibility with migration
WAS 7.0.0.19
RA 7.0.1.5
JMS
WMQ QM
JMQI native API
MQI native API
WMQ QM
JMQI native API
MQI native API
Supported WMQ QM Versions
6.0.2.7 7.0.1 7.1
WAS 8.0.0.1
RA 7.0.1.5
JMS
WAS 8.next
RA 7.next
JMS
WMQ QM
JMQI native API
MQI native API
standard interface
17
IBM Software Group | WebSphere software
WebSphere MQ
Practical benefits
Simplified maintenance
Ease of migration
Easier consumption of Multi-Version WMQ
18
IBM Software Group | WebSphere software
WebSphere MQ
Multi-instance queue manager
19
IBM Software Group | WebSphere software
WebSphere MQ
Multi-instance queue manager
20
IBM Software Group | WebSphere software
WebSphere MQ
Multi-instance queue manager
21
IBM Software Group | WebSphere software
WebSphere MQ
High availability with Multi-Instance Queue Managers
WebSphere MQ Automatic Client Reconnect is NOT supported with Java EE Application Servers
Configure WAS to automatically reconnect instead
22
IBM Software Group | WebSphere software
WebSphere MQ
High availability with Multi-Instance Queue Managerswith Activation Specifications
Connection Factory
Connection Name List – host(port) for Active instance, host(port) for standby instance CCDT (Client Channel Definition Table)
Resource Adapter
Reconnection Retry Count – default is 5Reconnection Retry Interval – default is 5 minutes
Activation Specification
Connection Name List – host(port) for Active instance, host(port) for standby instanceStop endpoint if message delivery fails
Number of sequential delivery failures before suspending endpoint
23
IBM Software Group | WebSphere software
WebSphere MQ
High availability with Multi-Instance Queue Managerswith Listener Ports
Connection Factory
Connection Name List – host(port) for Active instance, host(port) for standby instance CCDT (Client Channel Definition Table)
Message Listener Service
Maximum Retries (on listener port) – default is 0Custom property: MAX.RECOVERY.RETRIES – default is 5
Custom property: RECOVERY.RETRY.INTERVAL – default is 60 seconds
24
IBM Software Group | WebSphere software
WebSphere MQ
Product Connectivity Scenarios● Scenario-based instructions for implementing a solution in a
business context ● A single end-to-end main path taking you from the business
need to the technical solution
● Features to help you learn as you progress through the task
● Information about why you are instructed to do something
● Information about what else you might do, or want to learn about, related to what you are reading in the main window
● Samples are provided so you can try out the task steps and verify your progress
■ To suggest a new scenario or make comments about the existing scenario, send us feedback using the feedback links in the information center:http://pic.dhe.ibm.com/infocenter/prodconn/v1r0m0/index.jsp
25
IBM Software Group | WebSphere software
WebSphere MQ
Product Connectivity Scenarios (2)
The scenarios information is moving to IBM Knowledge Center – the one-stop shop for IBM technical publications: http://www.ibm.com/support/knowledgecenter. In IBM Knowledge Center you can find the scenarios with the WebSphere MQ or WebSphere Application Server product information; for example:http://www-01.ibm.com/support/knowledgecenter/SSFKSJ_7.5.0/
For more information about the product connectivity scenarios contact:WebSphere User Technologies: Ian Larner ([email protected])Sue Robertson ([email protected])
WebSphere MQ: Matthew White ([email protected])
26
IBM Software Group | WebSphere software
WebSphere MQ
IBM Product Information
See the new IBM Knowledge Center – No more infocenters from 2014!
27
IBM Software Group | WebSphere software
WebSphere MQ
Summary
WebSphere MQ JMS RA provides MQ messaging to WAS
Easier maintenance and upgrading
MuIti Instance Queue Managers – configure your Application Server
28
IBM Software Group | WebSphere software
WebSphere MQ
Links:IBM Knowledge Centre:
http://www-01.ibm.com/support/knowledgecenter/
7.1 and 7.5 RA statement of support
http://www-01.ibm.com/support/docview.wss?uid=swg27023129
Using WebSphere MQ automatic client reconnect with the WebSphere MQ classes for JMS:
http://www-01.ibm.com/support/docview.wss?uid=swg21508357
Obtaining the WebSphere MQ Resource Adapter for the Liberty profile:
http://www-01.ibm.com/support/docview.wss?uid=swg21633761
Introduction to WebSphere MQ Multi-Instance Queue Managers:
http://www-01.ibm.com/support/docview.wss?uid=swg27017382&aid=1
29
IBM Software Group | WebSphere software
WebSphere MQ
Links:Product Connectivity Scenarios
http://pic.dhe.ibm.com/infocenter/prodconn/v1r0m0/index.jsp
Resource Adapter configuration properties:
http://pic.dhe.ibm.com/infocenter/wasinfo/v8r5/index.jsp?topic=/com.ibm.websphere.ihs.doc/ihs/tihs_startadmserv.html
Activation Specification Properties:
http://pic.dhe.ibm.com/infocenter/wasinfo/v8r5/index.jsp?topic=%2Fcom.ibm.websphere.nd.multiplatform.doc%2Fae%2Fumj_pasm_advprops.html
Listener Port Properties:
http://pic.dhe.ibm.com/infocenter/wasinfo/v8r0/index.jsp?topic=%2Fcom.ibm.websphere.express.doc%2Finfo%2Fexp%2Fae%2Fumb_prolp.html
http://pic.dhe.ibm.com/infocenter/wasinfo/v8r5/index.jsp?topic=%2Fcom.ibm.websphere.nd.multiplatform.doc%2Fae%2Fumb_prolscp.html
IBM Software Group | WebSphere software
WebSphere MQ
Legal Disclaimer
• © IBM Corporation 2014. All Rights Reserved.• The information contained in this publication is provided for informational purposes only. While efforts were made to verify the completeness and accuracy of the information contained
in this publication, it is provided AS IS without warranty of any kind, express or implied. In addition, this information is based on IBM’s current product plans and strategy, which are subject to change by IBM without notice. IBM shall not be responsible for any damages arising out of the use of, or otherwise related to, this publication or any other materials. Nothing contained in this publication is intended to, nor shall have the effect of, creating any warranties or representations from IBM or its suppliers or licensors, or altering the terms and conditions of the applicable license agreement governing the use of IBM software.
• References in this presentation to IBM products, programs, or services do not imply that they will be available in all countries in which IBM operates. Product release dates and/or capabilities referenced in this presentation may change at any time at IBM’s sole discretion based on market opportunities or other factors, and are not intended to be a commitment to future product or feature availability in any way. Nothing contained in these materials is intended to, nor shall have the effect of, stating or implying that any activities undertaken by you will result in any specific sales, revenue growth or other results.
• Java and all Java-based trademarks are trademarks of Sun Microsystems, Inc. in the United States, other countries, or both.
