IMS Connect, TMRA and SOAP for IMS Callout - IMS UG June 2013 Sao Paulo


Published on

Published in: Technology
  • Be the first to comment

  • Be the first to like this

No Downloads
Total views
On SlideShare
From Embeds
Number of Embeds
Embeds 0
No embeds

No notes for slide

IMS Connect, TMRA and SOAP for IMS Callout - IMS UG June 2013 Sao Paulo

  1. 1. © 2013 IBM CorporationIMS Connect, TMRA and SOAP Gateway forIMS CalloutIMS Regional User GroupSao Paulo, June 6
  2. 2. © 2013 IBM CorporationAcknowledgements and DisclaimersAvailability. References in this presentation to IBM products, programs, or services do not imply that they will be available in allcountries in which IBM operates.© Copyright IBM Corporation 2013. All rights reserved.– U.S. Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contractwith IBM Corp.IBM, the IBM logo,, IMS, DB2, CICS and WebSphere MQ are trademarks or registered trademarks of International BusinessMachines Corporation in the United States, other countries, or both. If these and other IBM trademarked terms are marked on their firstoccurrence in this information with a trademark symbol (® or ™), these symbols indicate U.S. registered or common law trademarksowned by IBM at the time this information was published. Such trademarks may also be registered or common law trademarks in othercountries. A current list of IBM trademarks is available on the Web at “Copyright and trademark information” company, product, or service names may be trademarks or service marks of others.The workshops, sessions and materials have been prepared by IBM or the session speakers and reflect their own views. They areprovided for informational purposes only, and are neither intended to, nor shall have the effect of being, legal or other guidance or adviceto any participant. While efforts were made to verify the completeness and accuracy of the information contained in this presentation, it isprovided AS-IS without warranty of any kind, express or implied. IBM shall not be responsible for any damages arising out of the use of,or otherwise related to, this presentation or any other materials. Nothing contained in this presentation is intended to, nor shall have theeffect of, creating any warranties or representations from IBM or its suppliers or licensors, or altering the terms and conditions of theapplicable license agreement governing the use of IBM software.All customer examples described are presented as illustrations of how those customers have used IBM products and the results they mayhave achieved. Actual environmental costs and performance characteristics may vary by customer. Nothing contained in thesematerials is intended to, nor shall have the effect of, stating or implying that any activities undertaken by you will result in any specificsales, revenue growth or other results.
  3. 3. © 2013 IBM CorporationIMS Connect
  4. 4. © 2013 IBM CorporationIMS Connect Overview• Provides high performance TCP/IP and local z/OS®communications between multiple TCP/IP clients and IMSsystems• Supports both IMS DB and IMS TM systems– OTMA through XCF– ODBM through SCIIMSConnectOTMAIMS DBIMSJournalingJournalingproductproductArchivejournalXCFTCP/IPIMSAPPIMSCatalogTCP/IP Clients:-IMS TMRA-IMS SOAP Gateway-IMS Connect API-IMS Universal DriversODBMSCISCISCISCI
  5. 5. © 2013 IBM CorporationIMS Connect Configuration• No changes are needed in the IMS Connect configurationmember HWSCFGxx of the IMS PROCLIB to support IMSCallout• XML transformations for SOAP Gateway messages– User Message Exit HWSSOAP1– Add the ADAPTER statement– Concatenate DSN for XML converters in STEPLIB of the startup JCL
  6. 6. © 2013 IBM CorporationIMS SOAP Gateway
  7. 7. © 2013 IBM CorporationIMS Enterprise Suite SOAP Gateway Overview• A Light-weight Web Service solution for IMS without the need of aJava EE server• Integrates IMS assets into the Service-Oriented Architecture (SOA)• Provides end-to-end interactions between IMS transactions and webservices clients in an On Demand environment• Enables IMS as Provider and Consumer of Web Services• Secure• Tooling support– Utilizes Rational Developer for System z tooling to create converters for transformingXML messages to IMS messages and vice versa– No need to change existing IMS application code (provider scenario)
  8. 8. © 2013 IBM Corporation• Eclipse-based application development tool for modernizing and developingSystem z applications– COBOL, PL/I, C, C++, HL Assembler, Java– Supports IMS, CICS, Batch, USS, etc..– Interactive access to z/OS system– Access PDS and run JCL from your workstation• Premier IBM Integrated Development Environment for development and test ofIMS applications– Drag-and-drop code snippet function for IMS DLI callsIMS application development and modernization: Rational Developerfor System z (RDz)• Also supports IMS SOA enablement– Enables CICS and IMS applications for WebServices and SOA– Built-in wizard for SOAP Gateway and Web 2.0– Generate XML COBOL/PLI converters for XMLtransformation– Generate WSDL, correlator files for WebServices access
  9. 9. © 2013 IBM CorporationExecutionExecutionGenerationGeneration<SOAP><LL><ZZ><DATA>SOAP clientsXMLAdapterAdapterTaskManagerXMLConvertersIMS ConnectIMSIMSAppz/OSLLZZTRCDDATALLZZDATATCP/IP<LL><ZZ><TRCD><DATA><LL><ZZ>DATA>SOAP GatewayHTTPSOAPendpointGatewayconnectorSOAPprocessorUDDIRegistryJavaClient.NETClientHTTP/SOAP<SOAP><LL><ZZ><TRCD><DATA>RD/z Bottom-Up WizardWSDLCorrelatorFilePublishRD/zGenerateExisting COBOLCopybookXMLDocumentLog…/server/logs/imssoap.logDevelopmentEnvironmentDevelopmentenvironmentRuntime environment<XMLDocument><XMLDocument>IMS SOAP Gateway Development & Runtime (Provider)
  10. 10. © 2013 IBM CorporationDescriptornameTimeoutRequest Area LengthResponse Area LengthOutput returncodesICALAIBIOAreasCOBOL Application with ICAL
  11. 11. © 2013 IBM CorporationOTMA DescriptorDescriptor name XML ConverterXML AdapterTPIPESOAP Gateway Management UtilityDescriptor and SOAP configuration
  12. 12. © 2013 IBM CorporationIMSIMS App1z/OSz/OS, zLinux, Win, AIX etc..DL/I ICALDescriptor nameTimeoutIMS Enterprise SuiteSOAP Gateway ServerIMSConnectReceive Callout Request in XMLSend Callout Response in XMLWebServiceAXMLAdapterMsg1Msg2TPIPESend ACKXMLConverter123567Development & Runtime Environment4ExecutionExecutionGenerationGenerationRD/z Meet-In-The-MiddleWizardExisting WSDLCorrelatorFileRD/zGenerateTaskExisting COBOLCopybookDevelopmentenvironmentError Handling: If Web Services returns a Web Service Fault error, SOAP Gateway sends an error response with the Fault message to the DLI callSynchronous Callout Flow
  13. 13. © 2013 IBM CorporationCallout with SOAP Gateway – Generate artifacts• Use Rational Developer for System z (RDz) to generate callout artifacts– Meet-in-the-middle• Maps WSDL with COBOL data structures– Generates XML Converters• Runs in IMS Connect• Converts callout request from bytes to XML and vice versa– Generates Correlator file• Used by SOAP Gateway to identify which Web Service to invoke at runtime and specify calloutproperties– Deploy WSDL• Contains URL address for the outbound web service
  14. 14. © 2013 IBM CorporationIMSIMS App1z/OSz/OS, zLinux, Win, AIX etc..:ISRT ALTPCBIMSSOAP1SYNCPT Starts..IMS Enterprise SuiteSOAP Gateway ServerIMSConnectIMS App2WebServiceAInitiatingClientXMLAdapterMsg1Msg2TPIPEDFSYDTxIMSSOAP1TYPE = IMSCONTMEMBER=SM01TPIPE=TP3SMEM=YADAPTER = HWSXMLA0CONVERTR=SOAPITSend ACKSOAPXMLConverterConnectionBundle(CBA)TPIPE = TP1,TP3…1234678Runtime Environment5Receive Callout Request in XMLSend Callout Response in XMLAsynchronous Callout with Response
  15. 15. © 2013 IBM CorporationIMS ApplicationExistingBusiness Logic• IMS application sends out a business event data using ISRT ALTPCBcall• RDz generates artifacts to convert IMS business events data toWBE/WBM formats• SOAP Gateway emits business events data asynchronously to WBMand WBECapturePointDEST1EV1HWS1DescriptorIMS ConnectIMSOTMATPIPEEV1Send EventWebSphereBusinessEventsBytesEvent ActionWebSphereBusinessMonitorSOAPGatewayXMLPayload SOAPXMLAdapterXMLConverterRESTWebSphereApplication ServerWSDLISRTALTPCBIBM ConfidentialBusiness Event support with SOAP Gateway
  16. 16. © 2013 IBM CorporationCallout with IMS TM Resource Adapter
  17. 17. © 2013 IBM CorporationIMS Transaction Message Resource Adapter (TMRA)• Deployed in a Java EE 1.4 or later application server• Used by– Java Applications– Enterprise Edition applications– Web Services• Implements the JEE Connection Architecture (JCA) tomanage– Connections– Transactions– Security• Implements JCA Common Client Interface– For your applications to communicate with IMS Transaction Manager
  18. 18. © 2013 IBM CorporationWebSphere and IMS TM Resource Adapter• Enable IMS transaction as Web Service with full SOAsupport– Integrate with a variety of Java EE or WebSphere-based servers with built-inQoS support (2PC, connection pooling, security management)– Java EE Connector Architecture (JCA/J2C) compliant– Recommended when Java EE server (e.g. WAS) is already in-use– Supports rapid application development with Rational toolingWAS/WPS/WTX/WMB/WESBIMS TMIMS TMresourceresourceadapteradapterWebServiceTCP/IPWebComponentEnterpriseBeanIMSConnectIMS DB *IMSIMS AppRational ApplicationDeveloper (RAD) orWebSphere IntegrationDeveloper (WID)IMS appSource(COBOL, PLI,C, MFS)Generates* Binary, text or XML data
  19. 19. © 2013 IBM CorporationCallout to WebSphere Java EE application using IMS TMResource Adapter• A Java Message-driven bean (MDB) can be written to listen for calloutrequests from IMS via IMS TM Resource Adapter• IMS TM Resource Adapter implements the JCA Inbound specificationand deliver callout messages to MDB using standard interfaces– Hides the low-level IMS Connect and OTMA protocols– Use Resume Tpipe Auto (with alternate client ID) with Wait-forever– Handles the correlation token internally– User specifies the callout properties using the ActivationSpec– Can process responses from MDBs concurrently– Auto reconnect to IMS Connect
  20. 20. © 2013 IBM CorporationSynchronous Callout with IMS TM Resource Adapter• Callout to WAS MDB using IMS TM Resource Adapter– Support JCA Inbound– Retrieve Asynchronous callout, Synchronous callout messages as well asAsynchronous output messages from IMS and deliver to WAS MDBWebSphere Application ServerIMSConnectz/OSIMSIMS Application2 ICAL SENDRECV ICODEST1HELLO FROM IMSHELLO FROMWEBSPHERE MDBTPIPEICOPIPE1Message DrivenBean (MDB)Response13ActivateHELLO FROM IMSonMessageHELLO FROMWEBSPHEREMDBIMSTMResourceAdapterInitiating ClientICODEST1ICOTPIPE1HWS1OTMA DescriptorWebService,EJB orMDBHWS1
  21. 21. © 2013 IBM Corporationpublic class IMSCalloutIVPMDBBean implements javax.ejb.MessageDrivenBean, {::public javax.resource.cci.Record onMessage(javax.resource.cci.Record arg0, javax.resource.cci.InteractionSpec event)throws javax.resource.ResourceException {SYNCCALLOUTREQUEST request = new SYNCCALLOUTREQUEST();SYNCCALLOUTRESPONSE response = new SYNCCALLOUTRESPONSE();// Requestrequest.setBytes(((IMSInputStreamRecord)event).getBytes());System.out.println("Synchronous callout request from IMS: " +request.getSync__callout__request__str());// Responseresponse.setSync__callout__response__str("HELLO FROM WEBSPHERE MDB");System.out.println("Synchronous callout response from WAS MDB: " +response.getSync__callout__response__str());return response;}}Callout with IMS TM RA – Sample MDB code
  22. 22. © 2013 IBM CorporationTPIPENameIMS Connectconnection infoand DatastorenameCallout with IMS TM RA – Deploy the RAR/ConfigureActivationSpec
  23. 23. © 2013 IBM CorporationCallout with IMS TM RA – Deploy the MDB
  24. 24. © 2013 IBM CorporationThank You!