SI Integration with Websphere MQ.ppt · 2020. 10. 19. · integration with IBM Websphere MQ Manisha...

© 2009, 2013 IBM Corporation

IBM Sterling B2B Integratorintegration with IBM Websphere MQ

Manisha Khond – Software Engineer Sterling B2B Integrator Support

20 March 2014

This session will be recorded and a replay will be available on IBM.COM sites and possibly social media sites such as YouTube. When speaking, do not state any confidential information, your name, company name or any information that you do not want shared publicly in the replay. By speaking during this presentation, you assume liability for your comments.


Agenda

Sterling B2B Integrator has Services and Adapters to communicate with Websphere MQ.

� Websphere MQ Adapter

� Websphere MQ Suite Async Receiver Adapter

� Websphere MQ Suite Open Session Service

� Websphere MQ Suite Open Queue Service

� Websphere MQ Suite Get Message Service

� Websphere MQ Suite Put Message Service

� Websphere MQ Suite Commit Service

� Websphere MQ Suite Backout Service

� Websphere MQ Suite Close Queue Service

� Websphere MQ Suite Close session Service

� MQRFH2 Service

2


Presenter

� Manisha Khond

� [email protected]

� Software Engineer, IBM Sterling B2B Integrator Support

� I have worked for IBM/Sterling Commerce since 2007 supporting Sterling B2B

Integrator product line.

3


Prerequisites before configuring services and adapters in Sterling B2B

Integrator

� Install the required client jars using install3rdparty.

� As of Sterling B2B Integrator, Version 5.2.3 and higher the following files are included in the

installation: com.ibm.mq.commonservices.jar, com.ibm.mq.jar, com.ibm.mqjms.jar,

com.ibm.mq.headers.jar, com.ibm.mq.jmqi.jar, and com.ibm.mq.pcf.jar. You will still need to

download and install the connector.jar for WebSphere MQ Suite services and adapters.

� As of Sterling B2B Integrator, Version 5.2.3 and higher installs Webspere MQ 7.0.1.6 jars.

� For communicating with higher or lower version of Websphere MQ, uninstall Webspere MQ

7.0.1.6 jars first and then install Webspere MQ client jars from Webspere MQ version you

are connecting to.

� To check if required client jars are already installed, check

/properties/dynamicclasspath.cfg.

� After installing required client jars, restart of Sterling B2B Integrator is required.

4


Websphere MQ Adapter

� Sending messages to Websphere MQ

� Receiving messages from Websphere MQ (Sync, Async)

� Used in a business process only to send data or receive data synchronously

� An adapter instance that is configured to receive asynchronously cannot be used in a

business process. This is because as soon as the adapter is configured to receive

asynchronously, it is already running. Trying to execute it would generate an error message.

5


Websphere MQ Async Receiver Adapter

� The WebSphereMQ Suite Async Receiver Adapter enables you to receive messages as

soon as they are available on the queue instead of waiting for a scheduled job to poll the

queue.

� For this adapter to work correctly, before you configure the adapter, you must download the

J2EE(TM) Connector Architecture Specification Interface Classes connector.jar file and

install it with install3rdParty.

� Used to receive messages asynchronously and invoke business processes.

� SSL

� Get Type (wsmq_type) GET, BROWSE

� Limit number of messages received wsmq_rcvMsgLimit

� Convert ASCII message to EBCDIC and vice versa wsmq_MQGMO_convert

� Group messages wsmq_groupBy

� Document tracking (wsmq_docTracking)

� Include metadata

� Bootstrap workflow and failure workflow

� Retry

6


Websphere MQ Suite Open Session Service

• Open a session, which establishes a connection to a WebSphereMQ Queue Manager.

• Turn on MQ tracing wsmq_trace

7


Websphere MQ Suite Open Queue Service

� Open a queue

� Specifies how the queue should be opened and for what type of operations will be

performed. Required

�Open queue to put messages (PUT)

�Open queue to get messages (GET)

�Open queue to browse and/or get messages (BROWSE)

�Open queue to put and get messages (PUTGET)

�Open queue to put, get or browse messages (PUTBROWSE)

8


Websphere MQ Suite Get Message Service

� To Get or Browse messages in a queue.

� All data received is placed into process data.

� Browse Lock Options, LOCK or UNLOCK (wsmq_browselock).

� Document tracking (wsmq_docTracking).

� Error Status For MQException (wsmq_errorOnMQException) Yes/No.

� Group messages (wsmq_groupBy).

� Metadata to Include.

� Receive message limit (GETALL OR BROWSEALL).

� MQGMO_SYNCPOINT (wsmq_MQGMO_syncpoint). Must be set to No for BROWSE.

9


Websphere MQ Suite Put Message Service

� To put messages on a queue.

� Batch mode document filter.

� Document tracking or not (wsmq_docTracking).

� Put a single workflow document.

� Error status for MQException (own error processing or retry) Yes/No.

� Maximum Message size (wsmq_maxMsgSize), documents larger than wsmq_maxMsgSize

are segmented.

� Ability to set fields in the Message descriptor (MQMD).

� Retry.

� MQPMO_SYNCPOINT (wsmq_MQPMO_syncpoint) Yes/No.

10


Websphere MQ Suite Commit Service

� Commit SyncPoint operations for a given WebSphereMQ Queue Manager.

� Should be called after SyncPoint put and/or get operations have been performed.

� This service is not necessary at all if SyncPoint operations are not performed. And even

though this service is not mandatory even with SyncPoint operations, because the

QueueManager (on some platforms) will perform the commits automatically, its use is

recommended to ensure expected results.

11


Websphere MQ Suite Backout Service

� To backout SyncPoint operations for a given WebSphereMQ Queue Manager.

� Should only be called if SyncPoint operations need to be backed out.

12


Websphere MQ Suite Close Queue Service

� Close a queue.

� Should be called after all puts and/or gets have been performed to a given queue.

13


Websphere MQ Suite Close session Service

� Close an existing session and disconnect from the WebSphereMQ Queue Manager.

� Should be called last after all other operations have been performed.

14


MQRFH2 Service

� Adds the MQ Rules and Formatting Header 2 to the beginning of the primary document.

15



16



BPML – Sending a file

MANISHA.QUEUE

DATAGRAM

TEST2013

4

1417

17



18



19



20



21


Websphere MQ Async Receiver Adapter

22


Websphere MQ Async Receive Adapter

� .

23



� Contents of the Queue before Adapter execution

24



After Adapter picks up the messages in queue:

25



26



27


Websphere MQ Suite Services

9.113.209.76

QM_SWAROOPA

1417

SYSTEM.DEF.SVRCONN

Yes

28



MANISHA.QUEUE

PUT

MANISHA.QUEUE

TEST890

29



MANISHA.QUEUE

30



31



32



33



34



35


MQRFH2 Service

9.113.209.76

QM_SWAROOPA

1417

SYSTEM.DEF.SVRCONN

Yes

36


MQRFH2 Service

MANISHA.QUEUE

PUT

37


MQRFH2 Service

38


MQRFH2 Service

true

39


MQRFH2 Service

MANISHA.QUEUE

TEST2014

RFH2_TEST

B2B_Integrator

4

40


MQRFH2 Service

MANISHA.QUEUE

41


MQRFH2 Service

42


MQRFH2 ServicePrimary document Step 0

43


MQRFH2 ServicePrimary Document Step 4

44


MQRFH2 ServiceInstance Data MQRFH2 Service

45


MQRFH2 Service

46


Websphere MQ Suite Get Message Service – Receive message with RFH2 header

9.113.209.76

QM_SWAROOPA

1417

SYSTEM.DEF.SVRCONN

Yes

47



MANISHA.QUEUE

GET

48



MANISHA.QUEUE

GETALL

GROUP

CORID

No

Yes

0

No

Yes

Yes

No

No

Yes

49



MANISHA.QUEUE

50



51



Contents of the queue before WebsphereMQ Suite Get Message Service execution

52



53



54



55


Summary

� Prerequisites before implementing Sterling B2B Integrator integration with IBM Websphere

MQ

� Adapters and Services available in Sterling B2B Integrator

� Considerations

56


Additional References

� Learn about upcoming Support Technical Exchange webcasts, and access previously recorded presentations at:https://www-304.ibm.com/connections/communities/service/html/communityview?communityUuid=d58614c7-a87a-4bea-a0d3-572710d530db

� IBM Electronic Support Introductionhttp://www.ibm.com/support/electronicsupport/about.html

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

� developerWorks Forums, Communities and Technical Topicshttp://www.ibm.com/developerworks/

� Quick Reference Guide for Using Service Request Toolhttp://www.ibm.com/support/docview.wss?uid=swg21207945

� IBM Support Assistanthttp://www.ibm.com/software/support/isa/

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

57


Questions and Answers

58

This Support Technical Exchange session will be recorded and a replay will be available on IBM.COM sites and possibly social media sites such as YouTube. When speaking, do not state any confidential information, your name, company name or any information you do not want shared publicly in the replay. By speaking in during this presentation, you assume liability for your comments.


THE INFORMATION CONTAINED IN THIS PRESENTATION IS PROVIDED FOR

INFORMATIONAL PURPOSES ONLY. WHILE EFFORTS WERE MADE TO VERIFY THE

COMPLETENESS AND ACCURACY OF THE INFORMATION CONTAINED IN THIS

PRESENTATION, IT IS PROVIDED “AS IS” WITHOUT WARRANTY OF ANY KIND,

EXPRESS OR IMPLIED. IN ADDITION, THIS INFORMATION IS BASED ON IBM’S

CURRENT 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 PRESENTATION OR ANY

OTHER DOCUMENTATION, NOTHING CONTAINED IN THIS PRESENTATION 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 ANY AGREEMENT OR LICENSE GOVERNING THE

USE OF IBM PRODUCT OR SOFTWARE.

Copyright and Trademark Information

IBM, The IBM Logo and IBM.COM are trademarks of International Business Machines Corp.,

registered in many jurisdictions worldwide. Other product and service names might be

trademarks of IBM or other companies. A current list of IBM trademarks and others are

available on the web under “Copyright and Trademark Information” located at

www.ibm.com/legal/copytrade.shtml.

59

Date post:	19-Feb-2021
Category:	Documents
Upload:	others
View:	7 times
Download:	1 times

SI Integration with Websphere MQ.ppt · 2020. 10. 19. · integration with IBM Websphere MQ Manisha...

Documents