8/8/2019 Doc View 3

1/44

8/8/2019 Doc View 3

2/44

8/8/2019 Doc View 3

3/44

8/8/2019 Doc View 3

4/44

8/8/2019 Doc View 3

5/44

8/8/2019 Doc View 3

6/44

8/8/2019 Doc View 3

7/44

8/8/2019 Doc View 3

8/44

8/8/2019 Doc View 3

9/44

8/8/2019 Doc View 3

10/44

8/8/2019 Doc View 3

11/44

8/8/2019 Doc View 3

12/44

8/8/2019 Doc View 3

13/44

8/8/2019 Doc View 3

14/44

8/8/2019 Doc View 3

15/44

8/8/2019 Doc View 3

16/44

8/8/2019 Doc View 3

17/44

IBM Software Group

WebSphere Support Technical Exchange 17 of 44

Use Case Scenarios

Use Case 1:Traffic pattern is MQ-to-MQRFH2MPGW service with MQ as the front side handler,

creates MQRFH2 message and delivers themessage as datagram to the backend MQ qmgr Units-of-work (UoW)Same qmgr for both front side and back side

8/8/2019 Doc View 3

18/44

IBM Software Group

WebSphere Support Technical Exchange 18 of 44

Use Case-1 Configuration QM Object

8/8/2019 Doc View 3

19/44

IBM Software Group

WebSphere Support Technical Exchange 19 of 44

Use Case-1: MQ Front Side Handler

8/8/2019 Doc View 3

20/44

IBM Software Group

WebSphere Support Technical Exchange 20 of 44

Use case-1: Example MQMD.Format

8/8/2019 Doc View 3

21/44

IBM Software Group

WebSphere Support Technical Exchange 21 of 44

Use Case-1: Example MQRFH2 Header

8/8/2019 Doc View 3

22/44

IBM Software Group

WebSphere Support Technical Exchange 22 of 44

Use Case-2: MQRFH2-to-MQMPGW service to process messageFront side handler receives MQRFH2 messageDataPower removes the MQRFH2 headers fromthe front side

Suppress MQRFH2 header for the backendInjects MQMD.Format header for the backendMessage is created for the backend MQUoW in the MQ QM ObjectSame qmgr for both front and back sidesSSL Channel for the QM Object

f

8/8/2019 Doc View 3

23/44

IBM Software Group

WebSphere Support Technical Exchange 23 of 44

Use Case-2: Excludes headers from MQ FSH

IBM S f G

8/8/2019 Doc View 3

24/44

IBM Software Group

WebSphere Support Technical Exchange 24 of 44

Use Case-2: Example Header Injection and Suppression

IBM S f G

8/8/2019 Doc View 3

25/44

IBM Software Group

WebSphere Support Technical Exchange 25 of 44

Use Case 2: Configuring QM Object with SSL

Use of SSL Proxy ProfileForward Crypto Profile instead of SSL Key Repository

Consistent approach with HTTPS configuration

No additional tooling to create SSL Key Repository

Ciphers MUST match MQ Server Queue Manager

Careful which Cipher is used if you have a choice

IBM S f G

8/8/2019 Doc View 3

26/44

IBM Software Group

WebSphere Support Technical Exchange 26 of 44

Use Case 2: Configuring QM with SSL Continued..

IBM S ft G

8/8/2019 Doc View 3

27/44

IBM Software Group

WebSphere Support Technical Exchange 27 of 44

Use Case 2: SSL Identity and Validation Credentials

IBM S ft G

8/8/2019 Doc View 3

28/44

IBM Software Group

WebSphere Support Technical Exchange 28 of 44

MQ Routing: Complete MQMD Header Example

IBM Software Group

8/8/2019 Doc View 3

29/44

IBM Software Group

WebSphere Support Technical Exchange 29 of 44

MQ Routing: MQOD header Injection Example

MQOD headers used for Distributed MQ QueueManager (qmgr)

2 CLIENT.REPLY.QUEUE CLIENTQM

8/8/2019 Doc View 3

30/44

IBM Software Group

WebSphere Support Technical Exchange 30 of 44

MQ Routing: MQOD header Injection Example Continued

MQOD headers used for Cluster MQ QueueManager (qmgr)

8/8/2019 Doc View 3

31/44

IBM Software Group

WebSphere Support Technical Exchange 31 of 44

MQ Routing: Use of Static and Dynamic URL

Static MQ URL opener Using MQ Queue Manager configuration object URL uses dpmq:// prefix, like dpmq://QM?RequestQueue=... ,

where QM is the name of MQ QM configuration object

Dynamic MQ URL opener Doesn't require statically defined MQ Queue Manager object URL is using mq:// prefix and has the following format

mq://host:port?QueueManager=....,where QM_NAME is the name of MQ Queue Manager running on aspecific host and listening on a specific port

IBM Software Group

8/8/2019 Doc View 3

32/44

IBM Software Group

WebSphere Support Technical Exchange 32 of 44

Troubleshooting DataPower SideEnable log level to debug using trouble shootingicon on the control panelEnable probe for the particular MPGW serviceRun few transactions and observe the system log

Look for MQ Reason Code(s) and errors in thesystem logUnderstand the MQ Reason Code(s) using MQsupportpac ma0k available athttp://www-01.ibm.com/support/docview.wss?uid=swg24000652

MQ supportpac Link :http://www-01.ibm.com/support/docview.wss?rs=977&uid=swg27007205

IBM Software Group

http://www-01.ibm.com/support/docview.wss?uid=swg24000652http://www-01.ibm.com/support/docview.wss?uid=swg24000652

8/8/2019 Doc View 3

33/44

IBM Software Group

WebSphere Support Technical Exchange 33 of 44

Troubleshooting MQ Server SideMQ functionAccess via: su mqmDisplay queue status

Processes how many connections on get/put

Queue depth

Uncommitted messages present?

Queue Handles

Who has open connections? Are those connections input or output?

IBM Software Group

8/8/2019 Doc View 3

34/44

IBM Software Group

WebSphere Support Technical Exchange 34 of 44

Summary

Traffic Patterns such as MQ-to-MQ, MQ-to-HTTP,MQ-to-JMS, MQ-to-TIBCO and MQ-to-FTP werediscussedMQ Message Processing Modes (Datagram,Request/Reply and its variation withtransactionality were presentedConfigurations involving use case scenarios for MQ-to-MQ, MQ-to-MQRFH2 and MQRFH2-to-MQwere discussed

IBM Software Group

8/8/2019 Doc View 3

35/44

IBM Software Group

WebSphere Support Technical Exchange 35 of 44

Summary Continued..

MQ Routing based on MQMD and MQODMQ Routing based on static and dynamic URLsMQ SSL Channel configuration using SSL proxyprofileError Handling Capturing response code inresponse rule with x-dp-response-code

IBM Software Group

8/8/2019 Doc View 3

36/44

IBM Software Group

WebSphere Support Technical Exchange 36 of 44

Summary Continued..Trouble Shooting Techniques

DataPower side trouble shooting

MQ server side runmqsc to check the Queue Status

for IPPROCSCheck Queue Status with Handles

dis qs(qname) type(handles) dis qs(qname) type(handle) conname input output

IBM Software Group

8/8/2019 Doc View 3

37/44

IBM Software Group

WebSphere Support Technical Exchange 37 of 44

References

IBM WebSphere DataPower SOA ApplianceswebGUI Guide

IBM WebSphere DataPower SOA AppliancesReference Guide

MQ Series Application Programming Reference

IBM WebSphere DataPower XSLT extensionelements, extension functions, and variables Guide

IBM Software Group

8/8/2019 Doc View 3

38/44

IBM Software Group

WebSphere Support Technical Exchange 38 of 44

Additional WebSphere Product ResourcesLearn about upcoming WebSphere Support Technical Exchange webcasts, and accesspreviously recorded presentations at:http://www.ibm.com/software/websphere/support/supp_tech.html

Discover the latest trends in WebSphere Technology and implementation, participate intechnically-focused briefings, webcasts and podcasts at:http://www.ibm.com/developerworks/websphere/community/

Join the Global WebSphere User Group Community:http://www.websphere.org

Access key product show-me demos and tutorials by visiting IBM Education Assistant:http://www.ibm.com/software/info/education/assistant

View a webcast replay with step-by-step instructions for using the Service Request (SR)tool for submitting problems electronically:http://www.ibm.com/software/websphere/support/d2w.html

Sign up to receive weekly technical My Notifications emails:http://www.ibm.com/software/support/einfo.html

IBM Software Group

http://www.ibm.com/software/websphere/support/supp_tech.htmlhttp://www.ibm.com/developerworks/websphere/community/http://www.websphere.org/http://www.websphere.org/http://www.ibm.com/software/info/education/assistanthttp://www.ibm.com/software/websphere/support/d2w.htmlhttp://www.ibm.com/software/support/einfo.htmlhttp://www.ibm.com/software/support/einfo.htmlhttp://www.ibm.com/software/support/einfo.htmlhttp://www.ibm.com/software/websphere/support/d2w.htmlhttp://www.ibm.com/software/info/education/assistanthttp://www.ibm.com/software/info/education/assistanthttp://www.ibm.com/software/info/education/assistanthttp://www.websphere.org/http://www.websphere.org/http://www.websphere.org/http://www.ibm.com/developerworks/websphere/community/http://www.ibm.com/developerworks/websphere/community/http://www.ibm.com/developerworks/websphere/community/http://www.ibm.com/software/websphere/support/supp_tech.htmlhttp://www.ibm.com/software/websphere/support/supp_tech.html

8/8/2019 Doc View 3

39/44

IBM Software Group

WebSphere Support Technical Exchange 39 of 44

We Want to Hear From You!

Tell us about what you want to learn

Suggestions for future topicsImprovements and comments about our webcasts

We want to hear everything you have to say!

Please send your suggestions and comments to:wsehelp@us.ibm.com

IBM Software Group

mailto:wsehelp@us.ibm.commailto:wsehelp@us.ibm.com

8/8/2019 Doc View 3

40/44

p

WebSphere Support Technical Exchange 40 of 44

Questions and Answers

IBM Software Group

8/8/2019 Doc View 3

41/44

p

WebSphere Support Technical Exchange 41 of 44

BACKUP CHARTS

IBM Software Group

8/8/2019 Doc View 3

42/44

p

WebSphere Support Technical Exchange 42 of 44

Troubleshooting runmqsc examples

IBM Software Group

8/8/2019 Doc View 3

43/44

p

WebSphere Support Technical Exchange 43 of 44

Troubleshooting runmqsc examples

IBM Software Group

8/8/2019 Doc View 3

44/44

p

Troubleshooting runmqsc examples